Freigeben über


Transformieren von Daten mit einer ForEach-Aktivität

Mit der ForEach-Aktivität wird eine wiederholte Ablaufsteuerung in Ihrer Pipeline definiert. Diese Aktivität wird verwendet, um eine Sammlung zu durchlaufen. Sie führt die angegebenen Aktivitäten in einer Schleife aus. Die Schleifenimplementierung dieser Aktivität ähnelt einer ForEach-Schleifenstruktur in Programmiersprachen.

Hinzufügen einer ForEach-Aktivität zu einer Pipeline

In diesem Abschnitt wird die Verwendung einer ForEach-Aktivität in einer Pipeline beschrieben.

Voraussetzungen

Um zu beginnen, müssen die folgenden Voraussetzungen erfüllt sein:

Erstellen der Aktivität

  1. Erstellen Sie eine neue Pipeline in Ihrem Arbeitsbereich.

  2. Suchen Sie im Bereich mit den Pipelineaktivitäten nach ForEach, und fügen Sie der Pipelinecanvas eine ForEach-Aktivität hinzu. Wenn sie anfänglich nicht angezeigt wird, verwenden Sie den Pfeil auf der rechten Seite der Symbolleiste für Aktivitäten, um nach rechts zu scrollen, um sie zu finden.

    Screenshot of the Fabric UI with the Activities pane and ForEach activity highlighted.

  3. Wählen Sie die neue benutzerdefinierte Aktivität in der Canvas aus, wenn sie noch nicht ausgewählt ist.

    Screenshot showing the General settings tab of the ForEach activity.

  4. Geben Sie auf der Registerkarte Allgemein unten in der Canvas einen Namen für die Aktivität in der Eigenschaft „Name“ ein.

  5. (Optional) Sie können auch eine Beschreibung eingeben.

ForEach-Einstellungen

Wählen Sie die Registerkarte Einstellungen aus, auf der Sie angeben können, ob die Verarbeitung der Elemente im Batch sequenziell (oder andernfalls parallel) erfolgen soll. Sie können auch eine maximale Anzahl von Elementen angeben, die gleichzeitig mit Batch count verarbeitet werden sollen. Schließlich müssen Sie eine Liste mit durch Trennzeichen getrennten Elementen angeben, die parametrisiert werden oder dynamische Inhalte enthalten können. Fügen Sie der Liste Elemente wie im Beispiel gezeigt einige Elemente hinzu.

Screenshot showing the ForEach settings tab with several items added to the Items list.

ForEach-Aktivitäten

Im Bereich ForEach-Aktivitäten definieren Sie außerdem Aktivitäten, die für jedes Element der Liste ausgeführt werden sollen.

Screenshot showing the ForEach activities pane.

Wählen Sie die Schaltfläche + aus, um dem Bereich eine neue Aktivität hinzuzufügen. Es wird eine Liste der auszuwählenden Aktivitäten angezeigt. Sie können der ForEach-Aktivität mehrere Aktivitäten hinzufügen, die jeweils für jedes Element in der Liste Elemente ausgeführt werden. Unabhängig davon, ob die Option Sequenziell in den ForEach-Einstellungen ausgewählt ist, werden alle untergeordneten Aktivitäten im Bereich ForEach-Aktivitäten sequenziell für jedes Element verarbeitet. Wenn jedoch Sequenziell nicht ausgewählt ist, werden mehrere Elemente parallel verarbeitet, die jeweils sequenziell anhand der Liste der angegebenen untergeordneten Aktivitäten ausgeführt werden.

Screenshot showing a ForEach activity with multiple child activities specified, and the + button highlighted showing a list of child activities to choose from when adding new activities to the pane.

Verweisen auf ein Element innerhalb einer Aktivität

Wählen Sie eine der untergeordneten Aktivitäten im Bereich ForEach-Aktivitäten aus, und wechseln Sie zur Registerkarte Einstellungen. In diesem Beispiel wurde eine Aktivität Gespeicherte Prozedur ausgewählt. Füllen Sie die Einstellungen für die Aktivität so mit Daten auf, wie Sie normalerweise eine Verbindung und eine gespeicherte Prozedur auswählen würden. Sie können den @item() -Iterator verwenden, um auf das aktuelle Element zu verweisen, das an einer beliebigen Stelle innerhalb einer Aktivität verarbeitet wird, die dynamische Inhalte unterstützt. Hier wurde @item() als Wert für den FruitName-Parameter verwendet, der an eine gespeicherte Prozedur übergeben wird.

Screenshot showing a stored procedure child activity with a parameter using the current @item() from the ForEach items list for its value.