Verwenden der Filteraktivität zum Filtern von Elementen aus einem Array

Sie können eine Filter-Aktivität in einer Pipeline verwenden, um einen Filterausdruck auf ein Eingabearray anzuwenden.

Voraussetzungen

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

Hinzufügen einer Filteraktivität zu einer Pipeline mit der Benutzeroberfläche

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

Erstellen der Aktivität

  1. Erstellen Sie eine neue Pipeline in Ihrem Arbeitsbereich.

  2. Wählen Sie im Bereich „Pipelineeinstellungen“ die Registerkarte Variablen aus, und wählen Sie dann + Neu aus, um eine neue Pipelinevariable vom Typ „Array“ hinzuzufügen.

    Screenshot showing the creation of a new Array type pipeline variable called AnimalsArray with some animal names as its values.

  3. Suchen Sie im Bereich mit den Pipelineaktivitäten nach „‘Filter“, und fügen Sie der Pipelinecanvas diese Aktivität hinzu. Möglicherweise müssen Sie die vollständige Liste der Aktivitäten erweitern, indem Sie die Schaltfläche + ganz rechts auf der Symbolleiste auswählen.

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

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

    Screenshot showing the General settings tab of the Filter activity.

Informationen zum Konfigurieren der Registerkarte Allgemein finden Sie unter Allgemeine Einstellungen.

Filtereinstellungen

  1. Wählen Sie die Registerkarte Einstellungen aus, auf der Sie eine Arrayliste mit Elementen und eine Bedingung angeben können, die auf jedes Element angewendet werden soll. Beide Einstellungen unterstützen dynamische Inhalte.

    Screenshot showing the Lookup activity settings tab highlighting the tab, and where to choose a new connection.

  2. In diesem einfachen Beispiel wird das Array nach „dog“ (Hund) gefiltert. In der Praxis kann die Verwendung jedoch bei Bedarf komplexer sein, indem Funktionen und Werte verwendet werden, die im dynamischen Ausdrucks-Generator verfügbar sind. Wählen Sie Dynamischen Inhalt hinzufügen für Elemente und dann die Registerkarte Variablen im Pipeline Ausdrucksgenerator aus, und wählen Sie dann das zuvor erstellte Array „AnimalsArray“ aus. Klicken Sie anschließend auf OK.

    Screenshot showing the Pipeline expression builder with the previously created AnimalsArray selected.

  3. Wählen Sie erneut Dynamischen Inhalt hinzufügen aus, diesmal für die Einstellung Bedingung. Der Ausdruck „item()“ gibt den Wert des aktuellen Elements zurück, wenn die Filteraktivität die angegebene Liste der Arrayelemente durchläuft. Mithilfe der Funktion „equals()“ können wir sie mit dem Element vergleichen, um für jedes Element „true“ oder „false“ zurückzugeben. Nur Elemente, die „true“ zurückgeben, werden in das Ausgabearray der Filteraktivität aufgenommen, die dann in jeder anderen Aktivität verwendet werden kann.

    Screenshot showing the Condition setting value to select for a specific animal.

Speichern und Ausführen oder Planen der Pipeline

Nachdem Sie alle zusätzlichen erforderlichen Aktivitäten mithilfe des Ausgabearrays der Filteraktivität hinzugefügt haben, wechseln Sie oben im Pipeline-Editor zur Registerkarte Start, und wählen Sie die Schaltfläche „Speichern“ aus, um Ihre Pipeline zu speichern. Wählen Sie Ausführen aus, um sie direkt auszuführen, oder Planen, um sie zu planen. Sie können hier auch den Ausführungsverlauf anzeigen oder andere Einstellungen konfigurieren.

Screenshot showing the Home tab in the pipeline editor with the tab name, Save, Run, and Schedule buttons highlighted.