Ressourcen

Der primäre Mechanismus zum Übergeben von Informationen zwischen der aufrufenden Anwendung und ClaimCenter ist die Ressource. Eine Ressource ist eine Instanz von Daten, die Sie erstellen, ändern, löschen oder abfragen können. Ressourcen werden in JSON-Schemadateien definiert.

Jede Ressource hat einen Typ. Der Typ definiert die Guidewire-Datenmodellentitäten, denen die Ressource zugeordnet ist. Beispielsweise werden Activity-Ressourcen der Activity-Datenmodellentität zugeordnet. In den meisten Fällen wird jede Ressource einer einzelnen Datenmodellentität zugeordnet. Es gibt jedoch einige Ressourcen, die mehreren Datenmodellentitäten zugeordnet sind. Beispielsweise wird die Ressource ClaimContact in ClaimCenter drei Datenmodellentitäten zugeordnet: ClaimContact,Contact und ClaimContactRole.

Ressourcen enthalten eine Reihe von Feldern. Jedes Feld speichert Informationen über die Ressource. Je nach Kontext werden Felder auch als Eigenschaften oder Attribute bezeichnet.

Ressourcen werden in den Nutzdaten der Anforderungs- und Antwortobjekte ausgetauscht. Die Nutzdaten sind ein Textblock im JSON-Format, der Felder aus den relevanten Ressourcen und deren Werte enthält. Das Folgende ist ein Teil der Antwort-Nutzdaten für eine Activity-Ressource.

"attributes": {
    "assignedGroup": {
        "displayName": "Auto1 - TeamA",
        "id": "demo_sample:31"
    },
    "assignedUser": {
        "displayName": "Andy Applegate",
        "id": "demo_sample:1"
    },
    "dueDate": "2020-11-16T08:00:00.000Z",
    "id": "xc:20",
    "priority": {
        "code": "urgent",
        "name": "Urgent"
    "subject": "Contact claimant"
}

Beachten Sie, dass ein Feld Folgendes speichern kann:

  • Einen skalaren Wert, z. B. das Feld subject.
  • Eine Reihe von Werten, z. B. das Feld assignedUser. Dies wird auch als Inline-Objekt bezeichnet.
  • Ein Array von Objekten. (Dafür gibt es in Activity kein Beispiel. Wenn dies der Fall wäre, würden dem Feldnamen eckige Klammern ([ und ]) folgen, die das Array trennen. Jedes Array-Mitglied wird in geschweiften Klammern ({ und }) aufgeführt.

Jede Ressource kann durch ihre Ressourcen-ID eindeutig definiert werden. Dieser Wert wird dem Feld PublicID der Datenmodellentität zugeordnet. Die Aktivität im vorherigen Beispiel lautet xc:20.

Eine einzelne Ressource wird als Element bezeichnet. Beispielsweise ist /contact/xc:203 ein Element. (In REST-API-Dokumentation wird dies mitunter auch als Singleton bezeichnet.)

Eine Gruppe von Ressourcen wird als Sammlung bezeichnet. Beispiel: /contact/xc:203/address (die Adressen, die mit dem Kontakt xc:203 verknüpft sind) ist eine Sammlung.