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 PolicyCenter 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

Eine Aktivität kann auf folgende Weise über die System-APIs zugewiesen werden:

An eine bestimmte Gruppe und einen bestimmten Benutzer in dieser Gruppe
Nur an eine bestimmte Gruppe (und dann verwendet PolicyCenter Zuweisungsregeln, um einen Benutzer in dieser Gruppe auszuwählen)
An eine bestimmte Gruppe und Warteschlange
An den Benutzer, der eine bestimmte Rolle für das übergeordnete Konto, den Job oder die Police innehat
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
`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
`role`	TypeKeyReference (`UserRole`)	Die Rolle des übergeordneten Objekts, die den Benutzer identifiziert, dem 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 PolicyCenter 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 einen Benutzer mit einer bestimmten Rolle

Wenn eine Aktivität nach Rolle zugewiesen wird, prüft PolicyCenter das übergeordnete Element der Aktivität (Konto, Job oder Police) und identifiziert den Benutzer mit der entsprechenden Rolle. Die Aktivität wird dann diesem Benutzer zugewiesen. Die Rolle muss ein Code aus der Typenliste UserRole sein.

Wenn beispielsweise eine Kontoaktivität der Rolle „Underwriter“ zugewiesen werden soll und der Underwriter für das Konto Bruce Baker ist, wird die Aktivität Bruce Baker zugewiesen.

Wenn Sie versuchen, eine Aktivität nach Rolle zuzuweisen und es keinen Benutzer für das übergeordnete Objekt mit der angegebenen Rolle gibt, führt PolicyCenter Folgendes aus:

Es identifiziert den Benutzer, der das Objekt erstellt hat (dies ist der Benutzer mit der Rolle „Creator“).
Es fügt die ausgewählte Rolle diesem Benutzer hin.
Es weist die Aktivität diesem Benutzer zu.

Als Beispiel folgende Annahme: Es gibt ein Konto, das von Christine Craft erstellt wurde. Das Konto hat keinen Underwriter. Wenn eine System-API versucht, eine Aktivität für dieses Konto der Rolle „Underwriter“ zuzuweisen, fügt PolicyCenter Christine Craft die Underwriter-Rolle hinzu und weist ihr die Aktivität zu.

Die folgenden Nutzdaten weisen die Aktivität xc:1 dem Benutzer des übergeordneten Aktivitätenelements zu, der die Underwriter-Rolle hat.

POST /common/v1/activities/xc:1/assign

{
  "data": {
    "attributes" : {
        "role" : {
	   "code" : "Underwriter"
        } 
    }
  }
}

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 PolicyCenter-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 Rollen, die Benutzer im übergeordneten Objekt innehaben
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
`/account/v1/accounts/{accountId}/activity-assignees`	Die Liste der vorgeschlagenen Beauftragten für Aktivitäten in diesem Konto
`/job/v1/jobs/{jobId}/activity-assignees`	Die Liste der vorgeschlagenen Beauftragten für Aktivitäten zu diesem Job
`/policy/v1/policies/{policyId}/activity-assignees`	Die Liste der vorgeschlagenen Beauftragten für Aktivitäten zu dieser Police

Das Folgende ist ein Teil einer Beispielantwort vom /assignee-Endpunkt der Common-API.

GET /common/v1/activities/pc:301/assignees

{
    "count": 5,
    "data": [
        {
            "attributes": {
                "name": "Creator",
                "role": {
                    "code": "Creator",
                    "name": "Creator"
                }
            }
        },
        {
            "attributes": {
                "groupId": "systemTables:1",
                "name": "Edward Lee (Enigma Fire & Casualty)",
                "userId": "pc:23"
            }
        },
        {
            "attributes": {
                "groupId": "systemTables:1",
                "name": "Alice Applegate (Enigma Fire & Casualty)",
                "userId": "pc:8"
            }
        },
        ...
    ],
    ...