Marker für Mehrfachinstanzen

Überblick

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

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

So fügen Sie eine Mehrinstanzmarkierung hinzu

Sie können jede unterstützte Aufgabe über den BPMN-Designer in eine Aufgabe mit mehreren Instanzen umwandeln:

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

Hinweise

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

Verwendungszweck

Verwenden Sie die Ausführung in mehreren Instanzen, um eine Aktivität in einer Sammlung aufzuführen – zum Beispiel:

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

Dieses Muster skaliert besser als eine manuelle Schleife und gewährleistet die Beobachtung.

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 durchlaufen möchten (z. B. vars.invoiceList).
  Maestro erstellt eine Ausführung pro Listenelement.
  Verweisen Sie mit dem Index oder seinen Eigenschaften auf das aktuelle Element (vars.invoiceList[index].id).
• (Optional) Erweitern Sie die Fehlerbehandlung und schalten Sie Bei Fehler wiederholen um, um einzelne Elementausführungen zu wiederholen.
• Führen Sie den Prozess aus oder debuggen Sie ihn, um eine Aktivitätsinstanz pro Listenelement im Ausführungspfad anzuzeigen.

Iterator-Ausdruck (wenn verfügbar)

Einige Aktivitäten bieten ein spezielles 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 verarbeitet.

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

iterator.item – wenn auf eine Aufgabe eine Mehrinstanzmarkierung angewendet wurde

Anleitung zum Eigenschaftenbereich

• Aktion: Wählen Sie aus, wie die Aufgabe ausgeführt wird.
• 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 Beendigung des Unterprozesses aktualisiert werden soll.

iterator[0].item – wenn Sie innerhalb eines Unterprozesses arbeiten, der von einer Aufgabe mit mehreren Instanzen aufgerufen wurde

Anleitung zum Eigenschaftenbereich

• Aktion: Konfigurieren Sie, wie der Unterprozess mit dem externen System, der API oder dem Agenten interagiert.
• Eingaben: Ordnen Sie das aktuelle Element oder seine Eigenschaften zu.

Beispiel:

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

Beispiel: Validieren Sie eine Liste von Rechnungen mithilfe der Ausführung mehrerer Instanzen

Dieses Beispiel zeigt, wie eine Dienstaufgabe so konfiguriert wird, dass sie einmal pro Rechnung ausgeführt wird.

1. Bereiten Sie eine Listenvariable vor

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

2. Fügen Sie eine Dienstaufgabe hinzu

1. Fügen Sie eine Serviceaufgabe hinzu und nennen Sie sie Rechnung validieren.
2. Öffnen Sie den Eigenschaftenbereich, erweitern Sie Multi-Instanz.
3. Wählen Sie unter Elemente die Option invoiceList aus.

3. Verwenden Sie das aktuelle Element in Eingaben

Im Abschnitt Eingaben :

• Beispiel: InvoiceId = vars.invoiceList[index] festlegen.
• 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 Agent zur Rechnungsvalidierung

5. Debuggen Sie den Prozess

1. Wählen Sie Schrittweise debuggen.
2. Sie sehen eine Ausführung der Rechnung validieren pro Listenelement.
3. Der Ausführungspfad zeigt die Ausführung jedes Elements separat an.

Beispiel für parallele Mehrfachinstanzen

1. Fügen Sie eine Serviceaufgabe mit dem Namen Rechnung validieren hinzu.
2. Wählen Sie Element ändern → Parallele Mehrfachinstanz aus .
3. Erweitern Sie im Eigenschaftenbereich Multi-Instanz.
4. Wählen Sie in Elemente die Listenvariable aus (z. B. vars.invoiceList).
5. Debug the process to view one activity instance per list element in the Execution trail.

Schleifenunterstützung

Verwenden Sie mehrere Instanzen, um manuelle Schleifen zu ersetzen. Behandeln Sie die Sammlung als Schleifengrenze. Der sequenzielle Modus bearbeitet Elemente der Reihe nach und wartet, bis jedes beendet ist, bevor das nächste gestartet wird. Der parallele Modus startet viele Elemente auf einmal und wird abgeschlossen, wenn alle fertig sind oder wenn Ihre Stoppbedingung erfüllt ist. Halten Sie die Arbeit pro Objekt idempotent und kurzzeitig. Verwenden Sie die Aggregation, wenn Sie eine einzelne kombinierte Ausgabe benötigen.

Runtime-Verhalten

1. Fan-out/ Fan-in: Maestro erstellt eine Aktivitätsinstanz pro Element und vervollständigt die Gruppe, wenn alle Instanzen beendet sind (oder früher, wenn Sie eine benutzerdefinierte Stopprichtlinie nachgelagert verwenden).
2. Sortierung: Im sequenziellen Modus garantiert; wird im parallelen Modus nicht garantiert.
3. Gleichzeitigkeit: Im Parallelmodus werden Elemente gleichzeitig ausgeführt, vorbehaltlich Plattformbeschränkungen und Ressourcenverfügbarkeit.
4. Fehler: Behandeln Sie das Ergebnis jedes Elements unabhängig voneinander. Die nachgelagerte Logik sollte definieren, wie teilweise Fehler behandelt werden (z. B. Fortfahren, Wiederholen oder Anhalten basierend auf Schwellenwerten).
5. Beobachtbarkeit: Jede Elementausführung wird nachverfolgt, wodurch 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.

Planen:

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

2. Wenden Sie eine parallele Mehrinstanzmarkierung auf die Validierungsaktivität an, um eine Aktion pro Rechnung aufzuführen.

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

   

Best Practices

1. Validieren Sie die Sammlung vor dem Fanout (leere, null oder übermäßig große Listen).
2. Halten Sie die Arbeit pro Element kurzzeitig und fehlertoleranz; Fügen Sie ggf. Wiederholungen hinzu.
3. Aggregieren Sie nur das, was Sie benötigen. Große Aggregationen können die Leistung und Lesbarkeit beeinträchtigen.
4. Machen Sie die Erfolgskriterien 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 Starter) für Notation und konzeptionelle Anleitung sowie BPMN-Unterstützung für die vollständige Liste der in Maestro unterstützten BPMN-Elemente.

Sie arbeiten in einem Unterprozess oder in einer Aufrufaktivität? Informationen zum Variablen-Scope, zu Eingabe-/Ausgabezuordnungen und zu Endereignisvariablen finden Sie unter Teilprozesse.