Für jede/n (For Each)

Die Aktivität For Each iteriert über Arrays und führt eine definierte Reihe von Schritten für jedes Array-Element aus. Verwenden Sie die Aktivität For each , um API-Antworten zu verarbeiten, die Objekt-Arrays enthalten, z. B. Listen von Benutzern, Aufträgen oder Datensätzen, die eine individuelle Verarbeitung erfordern.

So aggregieren Sie Daten in einem Array

Ein gängiger Anwendungsfall für die For Each- Aktivität ist das Aggregieren von Daten aus mehreren API-Aufrufen in ein strukturiertes Array mithilfe der Script- Aktivität.

Die Aktivität For Each sammelt automatisch die Ausgabe der letzten Aktivität innerhalb ihres Textkörper -Flows und kompiliert sie in einem Array, das in ihrer eigenen Ausgabe verfügbar ist.

Verwenden der For Each-Aktivität

So fügen Sie Ihrem Workflow eine For each- Aktivität hinzu:

1. Wählen Sie auf der Arbeitsfläche Ihres API-Workflow-Designers das Pluszeichen (+) aus. Das Menü Aktivität hinzufügen wird angezeigt.
2. Wählen Sie Loop und dann ForEach aus.
3. Konfigurieren Sie im Eigenschaftenbereich die folgenden Felder:
   • In– Verwenden Sie den Ausdrucks-Editor, um das Array für die Iteration anzugeben. Normalerweise stammt dieses Array aus einer vorherigen API-Antwort.
   • Elementname– Weisen Sie einen Referenznamen für Array-Elemente zu (Standard ist currentItem). Verwenden Sie diese Referenz, um während der Iteration auf jedes Element zuzugreifen.
4. Fügen Sie im Textkörper der ForEach- Schleife die Aktivitäten hinzu, um die Array-Elemente zu verarbeiten.
5. Fügen Sie nach Bedarf Aktivitäten zu den Then- und Else- Verzweigungen hinzu.
6. Debuggen Sie den Workflow, um die Aktivität auszuführen und Ausgabefelder für die spätere Verwendung zu generieren.

Beispiel für die Aktivität For Each

Im folgenden Beispiel wird ein Array von Mitarbeiterobjekten durchlaufen, der Vor- und Nachname jedes Mitarbeiters kombiniert und die aggregierten Ergebnisse in einer strukturierten Antwort zurückgegeben.

Öffnen Sie das Fenster Konfigurationsfenster debuggen , und fügen Sie dann die folgende JSON-Syntax ein und speichern Sie sie:

{
    "employees": [
        {
            "first_name": "Bobbie",
            "last_name": "Draper",
            "position": "administration",
            "email": "[e-mail]"
        },
                {
            "first_name": "James",
            "last_name": "Holden",
            "position": "manager",
            "email": "[e-mail]"
        }
    ]
}

1. Fügen Sie auf der Canvas Ihres API-Workflowdesigners eine For Each- Aktivität hinzu.
2. Konfigurieren Sie die „For Each “-Felder wie folgt:
   • In– Verwenden Sie den Ausdruckseditor, um auf das employees -Array aus der Ausführungskonfiguration zu verweisen:

     $workflow.input.employees

   • Elementname– Weisen Sie einen Referenznamen für Array-Elemente zu (Standard ist currentItem). Verwenden Sie diese Referenz, um während der Iteration auf jedes Element zuzugreifen.
3. Fügen Sie eine Skript -Aktivität im Textkörper der Für jede -Schleife hinzu.
4. Verwenden Sie für die Aktivität Script den Ausdruckseditor, um ein JSON-Objekt zu erstellen, das die Eigenschaften first_name und last_name in einem Objekt kombiniert:

   return {
       "name": $currentItem.first_name + " " + $currentItem.last_name
   }

5. Speichern Sie die Konfiguration.
6. Fügen Sie am Ende des Workflows eine Antwortaktivität hinzu.
7. Konfigurieren Sie die Antwort wie folgt:
   • Typ– Erfolg
   • Details– Öffnen Sie den Ausdruckseditor und schreiben Sie Folgendes:

     $context.outputs.For_Each_2

   Dieser Schritt fügt am Anfang des Workflows eine Validierung hinzu, um zu bestätigen, dass vor der Verarbeitung eine gültige Transaktion vorhanden ist.
8. Debuggen Sie den Workflow, um die Aktivität auszuführen.
9. Überprüfen Sie den Ausgabebereich , um die Antwort zu überprüfen.