Human Task

Mit Human Task-Bausteinen lassen sich menschliche Aktivitäten abbilden. Bei der Automatisierung des Business Processes werden diese Human Tasks mit ausführbaren .humantask-Dateien verknüpft.

Ein Human Task (.humantask) ermöglicht die Konfiguration der Task Management Web App und damit die Interaktion mit von Menschen ausgeführten Aufgaben, die im Case Management als Vorgang modelliert werden. Weitere Informationen finden Sie unter Case Management – Vorgänge und Workflows realisieren.

Eigenschaften

Label

Beschriftung des Symbols im Prozessdiagramm

Human Tasks anlegen und verwenden

Um menschliche Interaktionen in Business Processes besser abzubilden, können bei der Modellierung von Business Processes Human Tasks verwendet werden. Diese lassen sich anschließend mit einer Human-Task-Datei (.humantask) verknüpfen, in der die Konfiguration des Tasks vorgenommen wird.

Human Tasks (.humantask) werden unterhalb des Business Processes über das Kontextmenü New > Human Task oder über die Symbolleiste > Add Human Task angelegt. Nach dem Anlegen wird der Human Task im X4 Designer geöffnet und kann wie folgt parametriert werden:

Title: Titel der Aufgabe in der Task Management Web App

Description: Optionale Beschreibung der Aufgabe
Registerkarte General: Besitzer, zugewiesenen Benutzer oder Gruppe und Frist für die Abarbeitung definieren

Owner: Besitzer der Aufgabe
Assigned User/Group: Zugewiesener Benutzer oder Gruppe für die Aufgabe

Hinweis:

Die beteiligten Benutzer und Gruppen werden in Keycloak angelegt und verwaltet.

In den Eingabefeldern für Owner, Assigned user/group kann der Benutzer bzw. die Gruppe als Freitext ohne Verknüpfung zum Identity Provider (z. B. Keycloak) eingegeben werden. Der eingebene Name für Owner, Assigned user/group muss identisch mit dem Namen des Users/der Group im Identity Provider sein. Hier werden die Benutzer und Gruppen über ein Token im Identity Provider validiert.

Deadline: Frist für die Abarbeitung der Aufgabe mit folgenden Optionen:
- No deadline: Keine Frist
- Duration: Dauer der Frist in Tagen, Stunden und Minuten
- Until: Datum und Uhrzeit zu dem die Aufgabe abgearbeitet werden muss
- Case State: Case State, der automatisch ausgeführt wird, wenn die Frist des Human Tasks erreicht wurde

Hinweis:

Wird ein Human Task mit einer festgelegten Frist ausgeführt, wird der Prozess automatisch mit dem konfigurierten Case State fortgesetzt, nachdem die Frist erreicht wurde. Der Human Task wird in diesem Fall automatisch geschlossen und innerhalb der Task Management Web App im Navigator-Ordner Verfallen angezeigt. Hier werden alle Human Tasks angezeigt, die die Frist überschritten haben und automatisch geschlossen worden sind.

Ist hingegen kein Case State gesetzt, wird der Prozess auch nicht automatisch fortgesetzt.

Registerkarte Business Data: anzuzeigende Informationen für die Task Management Web App definieren

Key Identifier: Case-Feature als Schlüsselkennzeichnung in der Task Management Web App
Kategorien, Feature-Gruppen und Features werden in einer baumartigen Struktur angezeigt und können ausgewählt werden für die Sichtbarkeit in der Task Management Web App
Kategorien werden als Tabs in der Task Management Web App angezeigt.
Display Name: Anzeigename der ausgewählten Kategorie, der Feature-Gruppe oder des Features
read only: Ausgewählte Kategorie, Feature-Gruppe und Feature als schreibgeschützt kennzeichnen

Registerkarte Actions: auszuführende Aktionen für die Task Management Web App definieren

Unter Actions können die Statuswerte angegeben werden, die vom Benutzer in der Task Management Web App für einen Vorgang gesetzt werden können
Display Name: Anzeigename des ausgewählten Case States in der Task Management Web App

Registerkarte Settings: Erweiterte Einstellungen für die Ver- und Bearbeitung von Vorgängen

Im Bereich Advanced das Ablehnen und Weiterleiten von Tasks erlauben sowie den Zugriff auf Human Tasks über eine Schnittstelle erlauben, siehe Über ReST-Schnittstelle auf Human Tasks zugreifen.

Task can be declined: Tasks können abgelehnt werden
Task can be forwarded: Tasks können weitergeleitet werden
Task can be resubmitted: Tasks können auf Wiedervorlage gesetzt werden
Enable access via API: Den Zugriff auf des Task über eine Schnittstelle erlauben

Über den (7.4.0-de) Task Management Adapter lassen sich zusätzliche Aktionen für einen Human Task definieren.

Im Bereich Documents das Hinzufügen, Bearbeiten und Löschen von Dokumenten zu einem Vorgang erlauben.

Enable Documents: Die Verarbeitung von Dokumenten erlauben
Documents can be added/edited: Das Hinzufügen und Bearbeiten von Dokumenten erlauben
Documents can be deleted: Das Löschen von Dokumenten erlauben

Ausführung auf dem X4 Server

Läuft ein Business Process während der Ausführung auf einen Human Task, wird die Ausführung des Prozesses angehalten und die menschlichen Aufgabe generiert. Der Prozess wartet auf die notwendige menschliche Interaktion innerhalb der Task Management Web App und setzt die Ausführung fort, sobald die menschliche Aufgabe zu dem Prozess abgeschlossen ist.

Human Task über einen Technical Process dynamisch parametrieren

Human Tasks lassen sich nicht nur über Human-Task-Dateien konfigurieren, sondern auch dynamisch über Technical Processes.

Folgende Einstellungen des Human Tasks lassen sich im Technical Process übersteuern:

Owner
Assignee
Deadline

Der Technical Process zur Parametrierung des Human Tasks wird über das Kontextmenü New > Process als Private File direkt unter dem Human Task angelegt und kann auch nicht verschoben werden.

Das Input- und Output-Dokument für den Technical Process sieht wie folgt aus:

Struktur des Input- und Output-Dokuments

XML

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<HumanTask>
    <TaskId>3acf3d51-7e45-410b-be4f-8cd57c01a103</TaskId>
    <Owner>OwnerName</Owner>
    <Assignee>
        <name>AsigneeName</name>
        <type>user|group</type>
    </Assignee>
     
    <!-- Deadline types (NoDeadline, DurationDeadline, UntilDeadline)-->
    <NoDeadline />
 
    <DurationDeadline>
        <Days>7</Days>
        <Hours>4</Hours>
        <Minutes>45</Minutes>
    </DurationDeadline>
 
    <UntilDeadline>2019-04-18T14:30:49+02:00</UntilDeadline>
</HumanTask>

Hinweis:

Die im Input des als Private File angelegten Prozesses enthaltene Task-ID (<TaskId>) ist eine UUID, die beispielsweise an eine externe Task-App weitergegeben werden kann.

Über ReST-Schnittstelle auf Human Tasks zugreifen

Hinweis

Die Anmeldung über BasicAuth wird für X4 API nicht mehr unterstützt. Für den Aufruf der X4 API ist jetzt ein Bearer-Token erforderlich. Dieses kann über http://localhost:8080/X4/X4Api/ oder mit dem Adapter Keycloak Token abgerufen werden.

Dieser Hinweis gilt nur für X4 API, für die anderen Services ist BasicAuth weiterhin verfügbar.

Die Dokumentation der ReST-Schnittstelle finden Sie unter http://localhost:8080/X4/X4Api/.

Anstelle der Task Management Web App können auch andere Anwendungen für die Anzeige und Bearbeitung von Human Tasks verwendet werden. Die Anbindung findet über eine Webservice-basierte Schnittstelle statt, die alle Funktionalitäten bietet, die auch in der Task Management Web App verfügbar sind.

Der Zugriff auf den Human Task über die ReST-Schnittstelle kann pro .humantask-Datei ermöglicht werden.

Um die Anbindung über die ReST-Schnittstelle zu ermöglichen, müssen folgende Einstellungen im Human Task vorgenommen werden:

Öffnen Sie den Human Task.
Wählen Sie die Registerkarte Settings aus.
Wählen Sie im Bereich Advanced die Option Enable access via API aus.
Der Zugriff ist nun ausschließlich über die Schnittstelle möglich.