تحرير

مشاركة عبر

Use the Filter activity to filter items from an array

  • مقالة

You can use a Filter activity in a pipeline to apply a filter expression to an input array.

Prerequisites

To get started, you must complete the following prerequisites:

Add a Filter activity to a pipeline with UI

To use a Filter activity in a pipeline, complete the following steps:

Creating the activity

  1. Create a new pipeline in your workspace.

  2. Select the Variables tab in the pipeline settings area, and then select + New to add a new pipeline variable of Array type.

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

  3. Search for Filter in the pipeline Activities pane, and select it to add it to the pipeline canvas. You may need to expand the full list of activities by selecting the + button to the far right of the toolbar.

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

  4. Select the new Filter activity on the canvas if it isn't already selected.

    Screenshot showing the General settings tab of the Filter activity.

Refer to the General settings guidance to configure the General settings tab.

Filter settings

  1. Select the Settings tab, where you can provide an array list of Items and a Condition to be applied to each item. Both settings support dynamic content.

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

  2. This simple example filters the array to dog, but a real world use can be as complex as necessary, using any of the functions and values available in the dynamic expression builder. Select Add dynamic content for the Items, and then select the Variables tab in the Pipeline expression builder, and choose the previously created AnimalsArray. Then select OK.

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

  3. Select Add dynamic content again, this time for the Condition setting. The item() expression returns the value of the current item as the Filter activity iterates through the provided list of array items. Using the equals() function, we can compare it against the item to return true or false for each item. Only items that return true will be included in the output array of the Filter activity, which can then be used in any other activity.

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

Save and run or schedule the pipeline

After adding any additional necessary activities using the output array of the Filter activity, switch to the Home tab at the top of the pipeline editor, and select the save button to save your pipeline. Select Run to run it directly, or Schedule to schedule it. You can also view the run history here or configure other settings.

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

Related content