Einstellungen
(1) Name: Der Name des Workflows (also der Workflow-Definition).
(2) Im Portal/DataCockpit sichtbar: Wenn diese Option gesetzt ist, dann wird der Workflow auch im Zusatzmodul DataCockpit angezeigt und kann dort gestartet werden.
(3) Dateien können angehängt werden: Dem Workflow können Dateien zugeordnet werden. Siehe auch Abschnitt Rechte für Workflow-Dateien.
(4) Benutzer/Rollen: Diese Lobster-Integration-Benutzer (Anmeldename) und DataCockpit-Benutzer dürfen Jobs für diesen Workflow starten.
(5) Anlage-Verhalten: Es können entweder beliebig viele Workflow-Jobs dieses Workflows gleichzeitig laufen oder nur einer. Läuft bereits ein Workflow-Job und es ist nur einer erlaubt, dann kann kein weiterer Workflow-Job gestartet werden. Der Versuch wird dann entweder ignoriert oder er erzeugt einen Fehler (je nach Einstellung hier).
(6) HTTP aktivieren: Ist diese Checkbox gesetzt, dann können Jobs dieses Workflows per REST (HTTP-Methode GET) gesteuert werden. Logs für Anfragen dieser Art finden Sie in den Server-Logs unter internal/message.log. Hinweis: Siehe allgemein auch den Abschnitt REST API.
Den <URL-Schlüssel> finden Sie unterhalb von (6), den <Display-Namen> können Sie frei vergeben (später ist dieser zu finden in der Workflow-System-Variable VAR_SYS_WF_DISPLAYNAME).
Den <Workflow-Job-Link> finden Sie über das Control Center → Jobs → Workflows → Kontextmenü des Workflow-Jobs → Aktuelle Informationen → Workflow-System-Variable VAR_SYS_WF_LINK, bzw. in der Response des create-Aufrufs (→ id).
create:
Starten eines Jobs für diesen Workflow.
https://<URL/IP des Integration Servers>/dw/wf/v1/create/<URL-Schlüssel>?display=<Der Display-Name für den zu erzeugenden Workflow-Job> |
Beispiel: https://localhost/dw/wf/v1/create/V0YtLTI4NDAyMTExMw?display=MyWorkflow_1
kill:
Beendet den Workflow-Job. Es wird keine finale Aktion ausgeführt.
https://<URL/IP des Integration Servers>/dw/wf/v1/kill/<Workflow-Job-Link> |
dump:
Liefert Informationen zum Workflow-Job zurück (Name, Zustand, Lobster-Integration-/DataCockpit-Benutzer-Liste für Zustand, Workflow-Variablen, usw.).
https://<URL/IP des Integration Servers>/dw/wf/v1/dump/<Workflow-Job-Link> |
action:
Geht in die Prüfung einer speziellen Transition. Damit dies einen Effekt hat, muss der Workflow-Job aktuell auch in dem Zustand sein, von dem diese Transition ausgeht.
https://<URL/IP des Integration Servers>/dw/wf/v1/action/<Workflow-Job-Link>?action=<Name der Transition> |
Alternativ kann in die automatische Transitionsprüfung gegangen werden, d. h. es werden alle Transitionen des aktuellen Zustands des Workflow-Jobs überprüft. Dazu muss aber die Option Nächste Transition automatisch finden & ausführen gesetzt sein im aktuellen Zustand.
https://<URL/IP des Integration Servers>/dw/wf/v1/action/<Workflow-Job-Link> |
Zusätzlich können dabei mit der HTTP-Methode POST Workflow-Variablen gesetzt werden. Verwenden Sie dazu folgendes JSON-Format im Request-Body (die Request-URL bleibt gleich).
{
"variables"
: [
{
"name"
:
"VAR_DEMO"
,
"type"
:
"String"
,
"value"
:
"hello"
},
{
"name"
:
"VAR_DEMO2"
,
"type"
:
"String"
,
"value"
:
"world"
} ]
}
(7) Anmeldung: Hier kann eingestellt werden, ob für einen REST-Request (6) eine Authentifizierung notwendig ist. Dafür kann ein Lobster-Integration-Benutzer verwendet werden. Alternativ kann hier direkt ein Benutzer und ein Passwort definiert werden. Die Authentifizierung erfolgt entweder über Basic Authentication (also im Header) oder direkt in der URL. Beispiel: https://localhost/dw/wf/v1/create/V0YtLTI4NDAyMTExMw?user=myuser&passwd=mypassword&display=MyWorkflow
Ist eine Lobster-Integration-Benutzer ausgewählt, dann muss dabei dessen Anmeldename und Passwort verwendet werden, zudem muss dieser Lobster-Integration-Benutzers eines der Benutzer-Rechte Administrator, Administration via REST, Workflow verwalten oder Workflow haben.
(8) Dokumentation: Hier können Sie eine beliebige URL angeben, die eine Dokumentation dieses Workflows enthält. Über das Icon rechts kann diese aufgerufen werden. Dort können auch System-Konstanten in die URL eingefügt werden.
(9) Datei hochladen: Hier können Sie ein Bild für diesen Eintrag hochladen. Sichtbar ist dieses z. B. in der Übersicht, wenn die Kachelansicht ausgewählt ist.
(10) Backup laden: Hier kann ein Backup geladen werden. Ein Backup wird immer erzeugt, wenn der Workflow gespeichert wird.
(11) Icon rechts von "ID": Hier können Sie den Such-Index des Workflows anzeigen. Diese Werte können in der Expertensuche abgefragt werden.