Marker für Mehrfachinstanzen

Überblick

Konfigurieren Sie mithilfe von Markern die Ausführung eines bestimmten Aufgabentyps so, dass mehrere Ausführungen durch Iteration über eine Variable aus einer Liste erstellt werden. Weitere Details finden Sie unter Marker im Kapitel BPMN-Primer.

Wenn Sie einen beliebigen Typ ausgewählt haben, wählen Sie Element ändern und einen der Markertypen.

So fügen Sie einen Multi-Instanz-Marker hinzu

Sie können jede unterstützte Aufgabe im BPMN-Designer in eine Multi-Instanz-Aufgabe umwandeln:

1. Wählen Sie eine Aufgabe auf der Arbeitsfläche aus.
2. Wählen Sie in der Element-Symbolleiste über der Aufgabe die Option Element ändern aus.
3. Wählen Sie den Marker für Mehrfachinstanzen (sequenzielles oder paralleles Symbol) aus.
   • Dadurch wird der BPMN-Marker an die Aufgabe angehängt.
4. Öffnen Sie den Eigenschaftenbereich und erweitern Sie den Abschnitt Mehrfachinstanz, um die Liste Elemente zu konfigurieren.

Hinweise

• Durch das Hinzufügen des BPMN-Markers werden keine zusätzlichen Steuerelemente wie Alias oder Modus angezeigt. Die einzige Konfiguration wird im Abschnitt Mehrfachinstanz unter Elemente angezeigt.
• Der Marker ist deklarativ; Maestro bestimmt den Ausführungsmodus automatisch.
• Die Mehrfachinstanz wird nur für Aufgaben unterstützt, nicht für Teilprozesse.

Verwendungszweck

Verwenden Sie die Multiinstanzausführung, um eine Aktivität über eine Sammlung hinweg zu verteilen – beispielsweise:

• Validieren einer Liste von Rechnungs-IDs
• Anreicherung von Datensätzen
• Senden von Benachrichtigungen pro Empfänger

Dieses Muster skaliert besser als eine manuelle Schleife und bewahrt die Beobachtbarkeit.

Konfiguration

• Wählen Sie die Aufgabe aus, die Sie für jedes Element einer Liste ausführen möchten.
• Erweitern Sie im Eigenschaftenbereich „Multi-Instanz“.
• Wählen Sie unter Elemente die Listenvariable aus, die die Elemente enthält, die Sie iterieren möchten (z. B. ).
  Maestro erstellt eine Ausführung pro Listenelement.
  Verweisen Sie auf das aktuelle Element mithilfe des Index oder seiner Eigenschaften (vars.invoiceList[index].id).
• (optional) Erweitern Sie Error Handling und schalten Sie die Option wiederholen bei Fehlschlag um, um einzelne Elementausführungen erneut zu versuchen.
• Führen Sie den Prozess aus oder Debug ihn, um eine Aktivitätsinstanz pro Listenelement im Ausführungspfad anzuzeigen.

Iterator-Ausdruck (wenn verfügbar)

Einige Aktivitäten bieten ein eigenes Feld, um das aktuelle Element dem genauen Eingabewert pro Ausführung zuzuordnen.

Beispiele:

• item.invoiceId
• item.customer.email
• { id: item.id, flags: ["recheck"] }

Iteratoren stellen einzelne Elemente dar, wenn eine Aufgabe mit mehreren Instanzen eine Sammlung Processes verarbeitet.

Die korrekte Syntax hängt davon ab, wo die Iteration stattfindet:

iterator.item – Wenn auf eine Aufgabe ein Mehrfachmarker angewendet wird

Anleitung im Eigenschaftenbereich

• Aktion: Wählen Sie aus, wie die Aufgabe ausgeführt wird (Integration Service-Aktion, Agent-Aktion oder Keine für die Modellierung).
• Eingaben: Geben Sie Werte für jede Iteration an.
  Beispiel:
  • Eingabe: invoiceId
  • Value: vars.invoiceList[index].id
• Ausgaben: Maestro aggregiert alle Ausgaben automatisch.
• Variablen aktualisieren: Wählen Sie aus, was nach jeder Iteration oder nach Abschluss des Teilprozesses aktualisiert werden soll.

iterator[0].item – Bei der Arbeit in einem Teilprozess, der aus einer Aufgabe mit mehreren Instanzen aufgerufen wird

Anleitung im Eigenschaftenbereich

• Aktion: Konfigurieren Sie, wie der Teilprozess mit dem externen System, der API oder dem Agent interagiert.
• Eingaben: Ordnen Sie das aktuelle Element oder dessen Eigenschaften zu.

Beispiel:

• Eingabe: currentItemId
• Value: vars.itemsToProcess[index].id

Beispiel: Validieren Sie eine Liste von Rechnungen mithilfe der Mehrfachinstanzausführung

Dieses Beispiel zeigt, wie eine Serviceaufgabe konfiguriert wird, die einmal pro Rechnung ausgeführt wird.

1. Vorbereiten einer Listenvariable

1. Data Manager öffnen.
2. Variable erstellen:
   • Name: invoiceList
   • Typ: Array von Objekten oder Array von Strings
   • Beispielwert: ["INV-001", "INV-002", "INV-003"]

2. Serviceaufgabe hinzufügen

1. Fügen Sie eine Serviceaufgabe hinzu und benennen Sie sie Validieren der Rechnung.
2. Öffnen Sie den Eigenschaftenbereich und erweitern Sie Multiinstanz.
3. Wählen Sie unter Elemente die Option invoiceList.

3. Verwenden Sie das aktuelle Element in Eingaben

Im Abschnitt Eingaben:

• Beispiel: Legen Sie InvoiceId = vars.invoiceList[index]fest.
• Wenn die Liste Objekte enthält:
  Verwenden Sie vars.invoiceList[index].Id.

4. Implementierung konfigurieren

Im Abschnitt Implementierung:

• Aktion: Starten und auf Agent warten
• Agent: Ihr Rechnungsvalidierungs-Agent

5. Debug den Prozess

1. Wählen Sie Schrittweise debuggen.
2. Pro Element wird eine Ausführung von Validieren der Rechnung angezeigt.
3. Der Ausführungspfad zeigt die Ausführung jedes Elements separat an.

Beispiel für eine parallele Mehrfachinstanz

1. Fügen Sie eine Serviceaufgabe mit dem Namen Validierung der Rechnung hinzu.
2. Wählen Sie Element ändern → Parallele Mehrfachinstanz.
3. Erweitern Sie im Eigenschaftenbereich „Mehrfachinstanz“.
4. Wählen Sie unter Elemente die Listenvariable aus (z. B. Variablevars.invoiceList).
5. Debuggen Sie den Prozess, um eine Aktivitätsinstanz pro Listenelement im Ausführungspfad anzuzeigen.

Schleifenunterstützung

Verwenden Sie Mehrfachinstanz, um manuelle Schleifen zu ersetzen. Behandeln Sie die Sammlung als Schleifenbegrenzung. Der Sequential-Modus verarbeitet Elemente in der richtigen Reihenfolge und wartet, bis jedes fertig gestellt ist, bevor der nächste gestartet wird.Der Parallelmodus startet viele Elemente gleichzeitig und wird abgeschlossen, wenn alle fertig gestellt sind oder wenn Ihre Anhaltebedingung erfüllt ist.Halten Sie die Arbeit pro Element idempotent und kurzlebig. Verwenden Sie Aggregation, wenn Sie eine einzige kombinierte Ausgabe benötigen.

Runtime-Verhalten

1. Fan‑out / Fan‑in: Maestro erstellt eine Aktivitätsinstanz pro Element und schließt die Gruppe ab, wenn alle Instanzen fertig gestellt sind (oder früher, wenn Sie eine benutzerdefinierte Anhaltrichtlinie nachgeschaltet verwenden).
2. Bestellung: Garantiert im sequenziellen Modus; nicht garantiert im parallelen Modus.
3. Gleichzeitigkeit: Im Parallelmodus werden Elemente gleichzeitig ausgeführt, vorbehaltlich Plattformlimits und Ressourcenverfügbarkeit.
4. Fehler: Behandeln Sie das Ergebnis jedes Elements unabhängig. Die Downstream-Logik sollte definieren, wie Teilfehler behandelt werden (z. B. fortfahren, wiederholen oder anhalten basierend auf Schwellenwerten).
5. Beobachtbarkeit: Jede Elementausführung wird nachverfolgt, sodass der Status pro Element und aggregierte Ergebnisse ermöglicht werden.

Beispiel

Szenario: Sie erhalten eine Liste mit Rechnungs-IDs von einer externen API und müssen jede Rechnung über eine zweite API validieren.

Plan:

1. Rufen Sie eine dynamische Liste der Rechnungs-IDs ab (aus einem vorherigen Schritt oder einer externen Abfrage).

2. Wenden Sie einen Marker für parallele Mehrfachinstanzen auf die Validierungsaktivität an, um eine Aktion pro Rechnung zu verteilen.

3. Verwenden Sie Aggregation, um eine einzige kombinierte Ausgabe (z. B. eine Liste von {invoiceId, isValid, errors}) für nachgelagerte Schritte zu erstellen.

   

Best Practices

1. Validieren Sie die Sammlung vor dem Fan-out (leere, null oder übermäßig große Listen).
2. Halten Sie die Arbeit pro Element kurzlebig und fehlertolerant; fügen Sie gegebenenfalls Wiederholungen hinzu.
3. Aggregieren Sie nur das, was Sie benötigen. Große Aggregationen können sich auf die Leistung und Lesbarkeit auswirken.
4. Machen Sie Success-Kriterien explizit (z. B. proceed if ≥95% items succeed).

Hinweis:

Derzeit führt die parallele Mehrfachinstanz Elemente in Stapeln von 50 aus.

Lesen Sie Marker (BPMN Primer) für Notation und konzeptionelle Anleitung sowie BPMN-Unterstützung für die vollständige Liste der BPMN-Elemente, die in Maestro unterstützt werden.

Arbeiten Sie in einem Teilprozess oder einer Aufrufaktivität? Informationen zum Variablen-Scoping, zu Eingabe-/Ausgabe-Zuordnungen und zu Endereignisvariablen finden Sie unter Unterprozesse.