Ändern vorhandener Serviceanforderungen

Verwenden Sie die folgenden Endpunkte, um eine Serviceanforderung zu ändern, ohne sie in ihrem Lebenszyklus zu befördern.

PATCHen von Serviceanforderungen

Verwenden Sie zum PATCHen einer Serviceanforderung:

  • PATCH /claims/{claimId}/service-requests/{serviceRequestId}

Sie können in der Basiskonfiguration kein Feld PATCHen, da alle Felder nur während der Erstellung festgelegt werden können. Wenn Ihre Instanz jedoch Erweiterungsfelder für ServiceRequest oder eine zugehörige Entität enthält, können Sie diesen Endpunkt verwenden, um diese Felder zu aktualisieren.

Angeben des Änderungsgrundes

In ClaimCenter verfügt die ServiceRequest-Entität über ein History-Array, das eine Reihe von ServiceRequestChange-Instanzen enthält. Die Entität ServiceRequestChange verfügt über ein Feld Description, das zum Erfassen des Grundes für die Änderung verwendet wird.

Wenn eine Serviceanforderung über ein PATCH geändert wird, wird das Feld Description mithilfe des folgenden Anzeigeschlüssels festgelegt:

Rest.Claim.V1.ServiceRequest.PropertiesChanged = Service request values changed\: {0}

Der {0}-Platzhalter wird mit einer Liste der Schema-Eigenschaften gefüllt, die geändert wurden. Sie können den Wert des Felds Description konfigurieren, indem Sie diesen Anzeigeschlüssel ändern.

Zuweisen von Serviceanforderungen an Benutzer

Jede Serviceanforderung ist einer Gruppe und in dieser Gruppe einem Benutzer zugewiesen. Dieser Benutzer ist primär für die Verwaltung dieser Serviceanforderung verantwortlich.

Wenn Sie eine Serviceanforderung über die System-API erstellen, führt ClaimCenter automatisch die Serviceanforderung-Zuweisungsregeln aus, um die Serviceanforderung zunächst einer Gruppe und einem Benutzer zuzuweisen. Sie können den POST /claims/{claimId}/exposures/{exposureId}/assign-Endpunkt verwenden, um die Serviceanforderung nach Bedarf neu zuzuweisen

Anmerkung: Die Funktion zum Zuweisen von Serviceanforderungen ist eine Teilmenge der Funktion zum Zuweisen von Aktivitäten. Alle Zuweisungsoptionen, die für Aktivitäten und Serviceanforderungen gelten, weisen das gleiche Verhalten auf.

Zuweisungsoptionen

Eine Serviceanforderung kann über die System-API wie folgt zugewiesen werden:

  • An eine bestimmte Gruppe und einen bestimmten Benutzer in dieser Gruppe
  • Nur an eine bestimmte Gruppe (und dann verwendet ClaimCenter Zuweisungsregeln, um einen Benutzer in dieser Gruppe auszuwählen)
  • An den Eigentümer des Schadenfalls
  • Durch erneutes Ausführen der Serviceanforderungs-Zuweisungsregeln
    • Dies kann sinnvoll sein, wenn Sie die Serviceanforderung seit der letzten Ausführung der Zuweisungsregeln geändert haben und die Änderung sich darauf auswirken kann, wem die Serviceanforderung zugewiesen wird.

Die Stammressource für die /{serviceRequestId}/assign-Endpunkte ist ServiceRequestAssignee. Diese Ressource gibt Zuweisungskriterien an. Das Schema ServiceRequestAssignee umfasst die folgenden Felder:

Feld Typ Beschreibung
autoAssign Boolesch Ob die Serviceanforderung mithilfe von Zuweisungsregeln zugewiesen wird
claimOwner Boolesch Ob die Serviceanforderung dem Eigentümer des Schadenfalls zugewiesen wird
groupId Zeichenfolge Die ID der Gruppe, der die Serviceanforderung zugewiesen werden soll
userId Zeichenfolge Die ID des Benutzers, dem die Serviceanforderung zugewiesen werden soll

Die Ressource Assignee darf nicht leer sein. Sie muss eine einzelne Zuweisungsoption angeben (Gruppe und Benutzer, nur Gruppe, Eigentümer des Schadenfalls oder automatische Zuweisung).

Weitere Informationen darüber, wie Zuweisungsregeln die Zuweisung durchführen, finden Sie im Gosu-Regeln.

Beispiel für eine Zuweisung – Zuweisung an eine bestimmte Gruppe (und einen bestimmten Benutzer)

Im Folgenden wird die Serviceanforderung cc:102 (von Schadenfall demo_saple:20) an die Gruppe demo_sample:31 (Auto1 - TeamA) und den Benutzer demo_sample:2 (Sue Smith) zugewiesen.

POST /claim/v1/claims/demo_sample:20/service-requests/cc:102/assign

{
  "data": {
    "attributes" : {
      "groupId" : "demo_sample:31",
      "userId" : "demo_sample:2"
    }
  }
}

Im Folgenden wird die Serviceanforderung cc:102 (von Schadenfall demo_sample:20) an die Gruppe demo_sample:31 (Auto1 - TeamA) zugewiesen. Da kein Benutzer angegeben wurde, führt ClaimCenter Zuweisungsregeln aus, um die Serviceanforderung einem Benutzer in der Gruppe demo_sample:31 zuzuweisen.

POST /claim/v1/claims/demo_sample:20/service-requests/cc:102/assign

{
  "data": {
    "attributes" : {
      "groupId": "demo_sample:31"
    }
  }
}

Beachten Sie, dass derzeit kein Endpunkt vorhanden ist, der Gruppen oder Gruppen-IDs zurückgibt. Um Serviceanforderungen einer bestimmten Gruppe zuzuweisen, muss die aufrufende Anwendung die Gruppen-ID mithilfe einer anderen Methode als einer Gruppen-System-API ermitteln.

Beispiel für eine Zuweisung – Zuweisung an den Eigentümer des Schadenfalls

Im Folgenden wird die Serviceanforderung cc:102 (von Schadenfall demo_sample:20) an die Gruppe und den Benutzer zugewiesen, die bzw. der Eigentümer des übergeordneten Schadenfalls (demo_sample:20) ist.

POST /claim/v1/claims/demo_sample:20/service-requests/cc:102/assign

{
  "data": {
    "attributes" : {
        "claimOwner" : true
    }
  }
}

Beispiel für eine Zuweisung – Verwenden einer automatisierten Zuweisung

Im Folgenden wird die Serviceanforderung cc:102 (aus Schadenfall demo_samle:20) mithilfe automatisierter Zuweisungsregeln zugewiesen.

POST /claim/v1/claims/demo_sample:20/service-requests/cc:102/assign

{
  "data": {
    "attributes": {
        "autoAssign" : true
    }
  }
}