Antworten auf ein POST

Bei jedem erfolgreichen POST wird ein Antwortobjekt mit Antwort-Nutzdaten generiert. Diese Nutzdaten können Werte enthalten, die von ClaimCenter während der Ressourcenerstellung generiert werden und von der aufrufenden Anwendung benötigt werden. Beispiel:

  • Die öffentliche ID der Ressource (dies ist auch der Wert für die System-API-id)
  • Generierte, von einem Benutzer lesbare ID-Werte, z. B. die Schadenfallnummer
  • Von einem Geschäftsablauf generierte Werte, z. B.:
    • Der Benutzer und die Gruppe, dem/der die Ressource zugewiesen wurde
    • Zur Verarbeitung der Ressource generierte Aktivitäten

Ähnlich wie Anforderungsschemas folgen Antwortschemas bestimmten Mustern, um das Ressourcenschema mit Daten-Envelopes zu umschließen. In vielen Fällen stimmen das Anforderungs- und das Antwortschema überein.

Felder mit null-Werten werden ausgelassen

Ähnlich wie GETs enthalten die Antwort-Nutzdaten für POSTs nur Felder, deren Werte ungleich null sind. Felder mit null-Werten werden bei den Antwort-Nutzdaten ausgelassen.

Wenn ein bestimmtes Feld in den Antwort-Nutzdaten erwartet wird, aber fehlt, liegt dies häufig daran, dass der Wert null war.

POSTs und Abfrageparameter

Sie können den Abfrageparameter fields mit einem POST verwenden, um die Felder zu steuern, die in den Antwort-Nutzdaten angezeigt werden. Im Folgenden wird beispielsweise eine Notiz für die Aktivität xc:20 basierend auf den Anforderungs-Nutzdaten erstellt. Die Antwort-Nutzdaten haben die Standardfelder.

POST /activities/xc:20/notes

Im Folgenden wird auch eine Notiz für die Aktivität xc:20 basierend auf den Anforderungs-Nutzdaten erstellt. Die Antwort-Nutzdaten enthalten jedoch nur das Feld id.

POST /activities/xc:20/notes?fields=id