Unterprozesse

Überblick

Ein Teilprozess ist eine Sammlung anderer Aufgaben und Teilprozesse, die dazu beitragen, einen komplexen Prozess in besser verwaltbare und navigierbare Teile aufzuteilen.

Hinweis:

• Wählen Sie eine Aktivität, wenn Sie einen zusätzlichen Prozess entweder innerhalb desselben Projekts oder aus einem separaten Projekt anwenden müssen. Ein solcher agentischer Prozess mit einem unabhängigen Wert kann entweder als eigenständiger Prozess oder von anderen Prozessen aufgerufen werden, was automatisch die Erstellung einer neuen Instanz auslöst.
• Arbeiten Sie mit Teilprozessen, wenn eine bestimmte Logik zur Vereinfachung des übergeordneten Prozesses eingekapselt werden muss. Als inhärenter Bestandteil derselben Instanz trägt der Teilprozess zur Optimierung der Gesamtorchestrierung bei.

Weitere Informationen zur BPMN-Unterstützung finden Sie unter Prozessmodellierung.

Variablen zwischen Teilprozessen übergeben und abrufen

Teilprozesse kapseln wiederverwendbare Logik, müssen jedoch häufig Daten mit dem übergeordneten Prozess oder anderen Teilprozessen austauschen. Maestro bietet klare Regeln dafür, wie Variablen definiert und übergeben werden, damit Ihre Daten über Ebenen hinweg konsistent bleiben.

Zugriff auf Eingaben innerhalb eines Teilprozesses

Um auf die Ausgabe einer vorherigen Aktivität innerhalb desselben Teilprozesses zuzugreifen, ist keine zusätzliche Konfiguration erforderlich.

Beispiel: Wenn eine Aktivität foo eine Ausgabevariable namens foo_op festlegt und eine nachfolgende Aktivität bar im selben Teilprozess vorhanden ist, kann bar direkt auf foo_op verweisen.

Wichtige Regel: In einer Aktivität definierte Variablen sind für jede folgende Aktivität innerhalb desselben Teilprozesses zugänglich, einschließlich geschachtelter Elemente. Sie müssen sie nicht explizit als Teilprozesseingaben übergeben.

Anzeigen von Ausgaben eines Teilprozesses

Benötigt ein übergeordneter Prozess Zugriff auf Ausgabedaten einer Aktivität innerhalb eines geschachtelten Teilprozesses, stehen Ihnen zur Bereitstellung zwei Ansätze zur Verfügung.

Ansatz 1: Mithilfe von Ausgabevariablen

1. Definieren Sie im inneren Teilprozess eine Ausgabevariable, z. B. inner_sp_op, und weisen Sie ihr den Wert der Ausgabe der inneren Aktivität (bar_op) zu.
2. Definieren Sie im äußeren Teilprozess (oder übergeordneten Prozess) eine weitere Ausgabevariable, z. B. outer_sp_op, und weisen Sie ihr den Wert der Ausgabe des inneren Teilprozesses (inner_sp_op) zu.
3. Nachgeschaltete Aktivitäten (z. B. qux) im übergeordneten Prozess können jetzt auf outer_sp_op verweisen.

Ansatz 2: Mithilfe von Endereignisvariablen

1. Konfigurieren Sie im inneren Teilprozess das Endereignis, um eine Ausgabevariable wie ee_inner_op zu deklarieren und ihr den Wert von bar_op zuzuweisen.
2. Konfigurieren Sie im äußeren Teilprozess das entsprechende Endereignis, um eine Ausgabevariable wie ee_outer_op zu deklarieren und ihr den Wert von ee_inner_op zuzuweisen.
3. Aktivität qux im übergeordneten Prozess kann jetzt auf ee_outer_op verweisen.

Tipp: Endereignisvariablen werden automatisch an den übergeordneten Bereich weitergegeben, ohne dass eine separate Konfiguration der Ausgabevariablen erforderlich ist.

Inspektion von Teilprozessvariablen

Sie können Variablenwerte zur Entwurfsphase (über die Debug-API) oder zur Runtime (über die Instanz-API) überprüfen, um den Geltungsbereich und die Datenweitergabe zu verifizieren.

Debug-API – Variablen anzeigen

GET /v1/debug-instances/{instanceId}/variables?parentElementId=outer_subprocess

Verfügbare Variablen:

• foo_op
• inner_subprocess_op
• ee_outer_op

GET /v1/debug-instances/{instanceId}/variables?parentElementId=inner_subprocess

Verfügbare Variablen:

• bar_op
• ee_inner_op

Runtime-API – Variablen anzeigen

GET /v1/instances/{instanceId}/variables?parentElementId=outer_subprocess

Verfügbare Variablen:

• foo_op
• inner_subprocess_op
• ee_outer_op

GET /v1/instances/{instanceId}/variables?parentElementId=inner_subprocess

Verfügbare Variablen:

• bar_op
• ee_inner_op

Marker für Mehrfachinstanzen

Teilprozesse unterstützen Marker für Mehrfachinstanzen, bei denen jedes Element mehrmals ausgeführt wird. Elemente, die sich als Mehrfachinstanz markieren lassen, können alle Aufgabentypen sein, außer bei Teilprozessen.

Verschachtelte Marker

Folgende Variablen in einer Zeichenfolge werden als verschachtelte Iteratoren unterstützt:

Kategorie	Attribute	Verwendung/Zugriff
OuterSP – Abrufen von Kontaktinformationen für jeden Benutzer	InputCollection	var.GetUsers
OuterSP – Abrufen von Kontaktinformationen für jeden Benutzer	Iterator-Element	iterator.item.gid
InnerSP – Alle E-Mails für jeden Kontakt abrufen	InputCollection	iterator[0].item.contactArray
InnerSP – Alle E-Mails für jeden Kontakt abrufen	Iterator-Element	iterator[1].item.ContactId
E-Mail senden (Send E-Mail)	InputCollection	iterator[1].item.EmailArray
E-Mail senden (Send E-Mail)	Iterator-Element	iterator[2].item.emailAddress