I-edit

Ibahagi sa

Use the Until activity to control execution flow

The Until activity provides the same functionality that a do-until looping structure provides in programming languages. It executes a set of activities in a loop until the condition associated with the activity evaluates to true. If an inner activity fails, the Until activity doesn't stop. You can specify a timeout value for the until activity.

Prerequisites

To get started, you must complete the following prerequisites:

Add an Until activity to a pipeline with UI

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

Create the activity

  1. Create a new pipeline in your workspace.

  2. Search for Until in the pipeline Activities pane, and select it to add it to the pipeline canvas.

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

  3. Select the new Until activity on the canvas if it isn't already selected.

    Screenshot showing the General settings tab of the Until activity.

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

Add a pipeline variable

In this simple example, we test the value of a pipeline variable. Select the background of the pipeline editor canvas, then select the Variables tab, and add a new integer type variable called TestVariable with the value 0.

Screenshot showing the pipeline Variables tab with a variable added called TestVariable, having its value set to 0.

Until activity settings

  1. Select the Until activity again on the pipeline canvas, and then select the Settings tab. Select the Expression field, and then select Add dynamic content, and provide the following expression: @equals(variables('TestVariable'), 1).

    Screenshot showing the expression for the Until activity.

  2. Select the Activities tab and then select the pencil icon to edit/add activities to the Until activity, or select the + icon on the Until activity on the pipeline editor canvas. Find the Set Variable activity and select it to add it to the list of child activities for the Until activity.

    Screenshot showing the addition of the Set Variable activity to the Until activity's child activity list.

  3. Select the newly added Set Variable activity from where it appears within the Until activity's Activities pane on the pipeline editor canvas, and then select its Settings tab from the activity properties pane. For Variable type, select Pipeline variable, and then choose your previously created TestVariable from the dropdown list. For this example, provide a Value of 1.

    Screenshot showing the settings of the Set Variable child activity of the Until activity.

Save and run or schedule the pipeline

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 runs at specific times or intervals. For more information on pipeline runs, see: schedule pipeline runs.

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

After running, you can monitor the pipeline execution and view run history from the Output tab below the canvas.

This simple pipeline will execute the child activity of the Until activity exactly 1 time, changing the pipeline variable value from 0 to 1, after which the Until expression evaluates to true and terminate.

Related content

  • Last updated on