Zuweisen von Aktivitäten
Schließlich wird jede Aktivität einer Gruppe und einem Benutzer in dieser Gruppe zugewiesen. Dieser Benutzer ist primär für das Schließen der Aktivität verantwortlich.
Aktivitäten können temporär Warteschlangen zugewiesen werden. Eine Warteschlange ist eine zu einer Gruppe gehörende Datenbank, die Aktivitäten enthält, die der Gruppe, aber keinem Benutzer in der Gruppe zugewiesen wurden Benutzer in der Gruppe können dann die Zuständigkeit für Aktivitäten bei Bedarf manuell übernehmen.
Wenn Sie eine Aktivität über die System-API erstellen, führt ClaimCenter automatisch die Aktivitätenzuweisungsregeln aus, um die Aktivität zunächst einer Gruppe und einem Benutzer zuzuweisen. Sie können den Endpunkt /{activityId}/assign verwenden, um die Aktivität nach Bedarf neu zuzuweisen.
Zuweisungsoptionen
- 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 eine bestimmte Gruppe und Warteschlange
- An den Eigentümer des Schadenfalls
- Durch erneutes Ausführen der Aktivitätenzuweisungsregeln
- Dies kann sinnvoll sein, wenn Sie die Aktivität seit der letzten Ausführung der Zuweisungsregeln geändert haben und die Änderung sich darauf auswirken kann, wem die Aktivität zugewiesen wird.
Die Stammressource für den /{activityId}/assign-Endpunkt ist Assignee. Diese Ressource gibt Zuweisungskriterien an. Das Schema Assignee umfasst die folgenden Felder:
| Feld | Typ | Beschreibung |
|---|---|---|
autoAssign |
Boolescher Wert | Ob die Aktivität mithilfe von Zuweisungsregeln zugewiesen wird |
claimOwner |
Boolescher Wert | Ob die Aktivität dem Eigentümer des Schadenfalls zugewiesen wird |
groupId |
Zeichenfolge | Die ID der Gruppe, der die Aktivität zugewiesen werden soll |
queueId |
Zeichenfolge | Die ID der Warteschlange, der die Aktivität zugewiesen werden soll |
userId |
Zeichenfolge | Die ID des Benutzers, dem die Aktivität zugewiesen werden soll |
Das Assignee-Objekt muss eine Zuweisungsoption festlegen. Es darf nicht leer sein.
Zuweisungsbeispiele
Beim Zuweisen von Aktivitäten zu Benutzern muss der Benutzer aktiv sein und über die Systemberechtigung „Eigene Aktivität“ verfügen.
Zuweisung an eine bestimmte Gruppe (und einen bestimmten Benutzer)
Die folgenden Nutzdaten weisen die Aktivität xc:1 der Gruppe demo_sample:31 und dem Benutzer demo_sample:1 zu.
POST /common/v1/activities/xc:1/assign
{
"data": {
"attributes" : {
"groupId" : "demo_sample:31",
"userId" : "demo_sample:1"
}
}
}
Die folgenden Nutzdaten weisen die Aktivität xc:1 der Gruppe demo-sample:31 zu. Da kein Benutzer angegeben wurde, führt ClaimCenter Zuweisungsregeln aus, um die Aktivität einem Benutzer in der Gruppe demo-sample:31 zuzuweisen.
POST /common/v1/activities/xc:1/assign
{
"data": {
"attributes" : {
"groupId": "demo_sample:31"
}
}
}
Beachten Sie, dass derzeit kein Endpunkt vorhanden ist, der Gruppen oder Gruppen-IDs zurückgibt. Um Aktivitäten einer bestimmten Gruppe zuzuweisen, muss die aufrufende Anwendung die Gruppen-ID mithilfe einer anderen Methode als einer Gruppen-System-API ermitteln.
Zuweisung an eine bestimmte Warteschlange
Die folgenden Nutzdaten weisen die Aktivität xc:1 der Warteschlange cc:32 zu. Jede Warteschlange ist mit einer einzelnen Gruppe verknüpft, sodass die Aktivität auch dieser Gruppe zugewiesen wird. Benutzer in dieser Gruppe, die Zugriff auf diese Warteschlange haben, können dann manuell die Zuständigkeit für die Aktivität übernehmen.
POST /common/v1/activities/xc:1/assign
{
"data": {
"attributes" : {
"queueId": "cc:32"
}
}
}
Beachten Sie, dass derzeit kein Endpunkt vorhanden ist, der Warteschlangen oder Warteschlangen-IDs zurückgibt. Um Aktivitäten einer bestimmten Warteschlange zuzuweisen, muss die aufrufende Anwendung die Warteschlangen-ID mithilfe einer anderen Methode als einer Warteschlangen-System-API ermitteln.
Zuweisung an den Eigentümer des Schadenfalls
Die folgenden Nutzdaten weisen die Aktivität xc:1 der Gruppe und dem Benutzer zu, die bzw. der für den Schadenfall zuständig ist, mit dem die Aktivität verknüpft ist.
POST /common/v1/activities/xc:1/assign
{
"data": {
"attributes" : {
"claimOwner" : true
}
}
}
Automatisierte Zuweisung verwenden
Die folgenden Nutzdaten weisen die Aktivität xc:1 mithilfe automatisierter Zuweisungsregeln zu.
POST /common/v1/activities/xc:1/assign
{
"data": {
"attributes": {
"autoAssign" : true
}
}
}
Weitere Informationen zu Zuweisungsregeln finden Sie im Gosu-Regeln.
Abrufen empfohlener Beauftragter
Wenn ClaimCenter-Benutzer Aktivitäten manuell zuweisen, enthält die Benutzeroberfläche eine Dropdown-Liste mit den „empfohlenen Beauftragten“. In der Regel enthält diese Liste:
- Die Option zum Verwenden von Zuweisungsregeln
- Die Option, die Aktivität dem Benutzer zuzuweisen, der Eigentümer des Schadenfalls der Aktivität ist
- Benutzer in der Gruppe, der die Aktivität aktuell zugewiesen ist
- Alle Warteschlangen, die zu der Gruppe gehören, der die Aktivität aktuell zugewiesen ist
Der Inhalt dieser Dropdown-Liste wird von einer anwendungsspezifischen SuggestedAssigneeBuilder-Klasse generiert. Sie können auf denselben Inhalt zugreifen, indem Sie ein GET mit einem der folgenden /assignee Endpunkte ausführen:
| Endpunkt | Rückgaben |
|---|---|
/common/v1/activity/{activityId}/assignee |
Die Liste der vorgeschlagenen Beauftragten für diese Aktivität |
|
|
Die Liste der vorgeschlagenen Beauftragten für Aktivitäten zu diesem Schadenfall |
Das Folgende ist ein Teil einer Beispielantwort vom /assignee-Endpunkt der Common-API.
GET /common/v1/activities/cc:301/assignees
{
"count": 16,
"data": [
{
"attributes": {
"autoAssign": true,
"name": "Use automated assignment"
}
},
{
"attributes": {
"claimOwner": true,
"name": "Claim/Exposure Owner"
}
},
{
"attributes": {
"groupId": "demo_sample:31",
"name": "Sue Smith (Auto1 - TeamA)",
"userId": "demo_sample:2"
}
},
{
"attributes": {
"groupId": "demo_sample:31",
"name": "Andy Applegate (Auto1 - TeamA)",
"userId": "demo_sample:1"
}
},
...
{
"attributes": {
"name": "FNOL - Acme Insurance",
"queueId": "default_data:1"
}
}
],
...