Freigeben über


Verwenden der Switch-Aktivität zur bedingten Branchausführung in einer Pipeline

Die Switch-Aktivität in Microsoft Fabric bietet die gleiche Funktionalität wie eine Switch-Anweisung in Programmiersprachen. Sie wertet eine Gruppe von Aktivitäten aus, die einem Fall entsprechen, der der Bedingungsauswertung entspricht.

Voraussetzungen

Um zu beginnen, müssen Sie die folgenden Voraussetzungen erfüllen:

Hinzufügen einer Lookup-Aktivität zu einer Pipeline mit der Benutzeroberfläche

Führen Sie die folgenden Schritte aus, um eine Switch-Aktivität in einer Pipeline zu verwenden:

Erstellen der Aktivität

  1. Erstellen Sie eine neue Pipeline in Ihrem Arbeitsbereich.

  2. Suchen Sie auf der Symbolleiste Aktivitäten der Pipeline nach der Switch-Aktivität, und wählen Sie diese Option aus, um sie zur Pipelinecanvas hinzuzufügen. Möglicherweise müssen Sie die Liste der Aktivitäten mithilfe der Schaltfläche + erweitern, da mehr Aktivitäten verfügbar sind, als normalerweise in den Platz für die Symbolleiste passen.

    Screenshot der Fabric-Benutzeroberfläche mit hervorgehobenem Bereich

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

    Screenshot mit der Registerkarte

Informationen zum Konfigurieren der Einstellungsregisterkarte Allgemein finden Sie in der Anleitung zu allgemeinen Einstellungen.

Einstellungen für Aktivitäten

Wählen Sie die Registerkarte Aktivitäten aus. Daraufhin wird der Standardfall angezeigt, der der Liste der Fälle bereits hinzugefügt wurde.

In der Expression-Klausel stellen Sie einen Ausdruck bereit, der ausgewertet und mit den optionen Case verglichen werden soll, und unterstützt dynamische Inhalte, mit denen Sie Parameter, Systemvariablen, Funktionen und lokale Variablen aus Ihrem Projekt verwenden können, um mit den verschiedenen Fällen zu vergleichen.

Sie können das Stiftsymbol rechts neben jedem Fall auf der Registerkarte Aktivitäten verwenden, um die Aktivitäten zu konfigurieren, die ausgeführt werden, wenn dieser Fall mit dem Ausdruckübereinstimmt. Sie können die Schaltfläche + Fall hinzufügen verwenden, um neue Fälle neben dem Standard hinzuzufügen, der ausgeführt wird, wenn kein anderer Fall mit dem Ergebnis für Ausdruck übereinstimmt. Sie können Fälle und Aktivitäten auch direkt auf der Switch-Aktivitätsschnittstelle auf der Pipeline-Canvas selbst hinzufügen, indem Sie die Schaltfläche + auswählen, um einen Fall hinzuzufügen, oder das Stiftsymbol neben den aufgeführten Fällen, um Aktivitäten für jeden Fall zu konfigurieren.

Screenshot: Registerkarte für die Einstellungen der Lookup-Aktivität, auf der die Registerkarte und die Option zum Auswählen einer neuen Verbindung hervorgehoben sind

Konfigurieren von Fallaktivitäten

Wenn Sie die Aktivitäten für einen Fall bearbeiten, indem Sie das Stiftsymbol daneben auswählen, wird der Aktivitäten-Editor des Falls entweder im Einstellungsbereich Aktivitäten oder direkt über die Schnittstelle für die Switch-Aktivität in der Pipelinecanvas angezeigt. Dies ähnelt dem Pipeline-Editor, aber spezifisch für den ausgewählten Fall. Sie können eine beliebige Anzahl von Aktivitäten hinzufügen, genau wie bei einer Pipeline, und diese werden ausgeführt, wenn der ausgewählte Fall mit dem Ausdruck für die Switch-Aktivität übereinstimmt. In diesem Beispiel wurde dem Standardfall eine Copy-Aktivität hinzugefügt, und sie wird immer dann ausgeführt, wenn keiner der anderen Fälle mit dem in der Switch-Aktivität definierten Ausdruck übereinstimmt.

Screenshot: Editor-Bereich mit den Fallaktivitäten für den Standardfall sowie einer hinzugefügten Beispiel-Copy-Aktivität

Beachten Sie die Pipeline und den Fall in der oberen linken Ecke des Aktivitäten-Editors für den Fall. Wenn Sie die Konfiguration der Aktivitäten des Falls abgeschlossen haben, können Sie dort den Pipelinenamenlink auswählen, um erneut zum Standard-Pipeline-Editor zurückzukehren.

Speichern und Ausführen oder Planen der Pipeline

Wechseln Sie oben im Pipeline-Editor zur Registerkarte Start, und wählen Sie die Schaltfläche „Speichern“ aus, um Ihre Pipeline zu speichern. Klicken Sie auf Ausführen, um sie direkt auszuführen. Alternativ können Sie Planen auswählen, um sie zu planen. Sie können den Ausführungsverlauf auch hier anzeigen oder andere Einstellungen konfigurieren.

Screenshot: Registerkarte „Start“ im Pipeline-Editor mit den hervorgehobenen Schaltflächen „Name“, „Speichern“, „Ausführen“ und „Planen“ der Registerkarte