Process Starter

Dieser Adapter führt einen Technical Process in einem beliebigen Benutzerordner in <X4>/X4DB mit einer Prozessinstanz-ID synchron oder asynchron aus. Als Input erhält der gestartete Prozess den Input des Adapters. Wenn der Funktions-Adapter asynchron ausgeführt wird, dann gibt der Adapter unmittelbar ein XML-Dokument aus, das die Prozessinstanz-ID des gestarteten Prozesses enthält; Wenn der Funktions-Adapter synchron ausgeführt wird, dann wartet er auf das Ergebnis des gestarteten Technical Processes (falls vorhanden) und gibt dieses aus.

Mit dem Process Starter können Sie über dynamische Parameter den Prozessnamen (und -pfad) zur Laufzeit setzen. Außerdem besitzt jeder über den Process Starter Adapter gestartete Technical Process eine eigene Prozessinstanz-ID, wird in einem separaten Thread ausgeführt und er kann daher nicht auf Variablen des aufrufenden Technical Processes zugreifen.

Allgemeine Eigenschaften und Parameter

Eigenschaften (Properties)

Operation

Bestimmt, welche Operation der Adapter durchführt

Mögliche Werte: Run: Prozess starten

Parameter

Adapter	Hauptklasse des Adapters (nicht verändern!) Mögliche Werte: `de.softproject.integration.adapter. processstarter.ProcessStarter`: Hauptklasse (Standard)
User	Benutzer-ID (X4DB-Benutzerordner, in dem sich der zu startende Prozess befindet) Mögliche Werte: Beliebige gültige Benutzer-ID (z.B. `999`) `1`: Standard-Benutzerordner (Standard)
Process	Repository-Pfad zu einem Technical Process, der die Eigenschaft `In service`: `true` besitzt Mögliche Werte: Beliebiger Pfad im X4 Repository ohne führenden Schrägstrich (z.B. `Project/Folder/Process.wrf`)
synchron	Technical Process synchron oder asynchron ausführen Mögliche Werte: `True`: Warten, bis die gestartete Prozessinstanz beendet ist, und ggf. deren Ergebnis ausgeben, siehe unten (Standard) `False`: Die Prozessinstanz-ID in einem XML-Dokument ausgeben und unmittelbar den darauf folgenden Prozess-Schritt ausführen, siehe unten
forceNewThread	Auch bei synchroner Ausführung einen neuen Thread starten Mögliche Werte: `True`: Bei synchroner Ausführung einen neuen Thread starten; Diese Option ermöglicht, den mit den Threads assoziierten Zustand besser zu verwalten, z.B. bei Transaktionen. (Standard) `False`: Bei synchroner Ausführung keinen neuen Thread starten (ursprüngliches Verhalten)

Synchron gestartete Technical Processes

Wenn Sie Technical Processes synchron starten (mit Parameter synchron: True), dann wartet der Adapter, bis der gestartete Technical Process vollständig ausgeführt wurde und gibt ggf. dessen Ergebnis inklusive Statuscode aus, bevor der nächste Prozess-Schritt ausgeführt wird.

Statuswerte

`1`	(Oder jeder andere positive Wert) Der Adapter wurde erfolgreich synchron ausgeführt. Der Statuscode des synchron gestarteten Technical Processes wird vom Process Starter übernommen oder ggf. verändert ausgegeben (siehe Hinweis unten). Wenn der Adapter Status `1` ausgibt, heißt das nicht notwendigerweise, dass der gestartete Technical Process ein Ergebnis ausgibt.
`0`	Der zu startende Technical Process ist entweder nicht aktiv (Eigenschaft `In service`: `false`) und wurde daher nicht ausgeführt, oder im gestarteten Technical Process werden leere Bausteine verwendet, oder der gestartete Technical Process gibt den Status `0` aus.
`-1`	Der Funktions-Adapter konnte nicht ausgeführt werden (der zu startende Technical Process wurde nicht gefunden oder der gestartete Technical Process wirft Fehler).
(Jeder negative Wert)	Der gestartete Technical Process wurde möglicherweise ausgeführt und erzeugte einen negativen Statuswert, z.B. über ein XSL-Mapping mit `ConditionState`, siehe Dynamische Statuswerte mit `ConditionState`. Bei asynchron gestarteten Technical Processes wird deren Status vom Process Starter übernommen. Die weitere Prozessausführung wird abgebrochen, falls die Technical Process-Eigenschaft `Stop on error`: `true` ist.

Beachten Sie:

Wenn ein synchron gestarteter Technical Process einen Statuswert zwischen 950 und 999 zurückgibt, wird dieser Status vom Process Starter verändert (Statuswert minus 50) und es werden Statuswerte zwischen 900 und 949 ausgegeben. Dies ist erforderlich, um die Save Point-Funktion des X4 Servers nicht zu beeinflussen.
Wenn ein synchron gestarteter Technical Process einen Statuswert zwischen -999 und -950 zurückgibt, wird dieser Status vom Process Starter verändert (Statuswert plus 50) und es werden Statuswerte zwischen -900 und -949 ausgegeben. Dies ist erforderlich, um Fehler in der Prozess-Ausführung zu vermeiden.

Asynchron gestartete Technical Process

Wenn Sie Technical Process asynchron starten (Parameter synchron: False), dann wird nach dem Start des aufgerufenen Technical Process dessen Prozessinstanz-ID in einem XML-Dokument ausgeben und der unmittelbar darauf folgende Prozess-Schritt ausgeführt.

Statuswerte

1 (successful)	Der Funktions-Adapter wurde erfolgreich asynchron ausgeführt. Wenn der gestartete Technical Process nicht aktiv ist (Eigenschaft In service: false) oder Fehler wirft, dann wird dennoch Status 1 ausgegeben; Das Ergebnis-XML-Dokument enthält in diesen Fällen die Prozessinstanz-ID -1.
-1 (error)	Der Funktions-Adapter konnte nicht ausgeführt werden (der zu startende Technical Process wurde nicht gefunden).