| title | Append variable activity |
|---|---|
| description | Learn how to set the Append Variable activity to add a value to an existing array variable defined in Fabric pipeline. |
| ms.reviewer | makromer |
| ms.topic | how-to |
| ms.custom | pipelines |
| ms.date | 12/18/2024 |
Use the Append Variable activity to add a value to an existing array variable defined in a Fabric pipeline.
To get started, you must complete the following prerequisites:
[!INCLUDEbasic-prerequisites]
To use an Append Variable activity in a pipeline, complete the following steps:
-
Create a new pipeline in your workspace.
-
Before you use the Append Variable activity, you need an array type variable in your pipeline. First select the pipeline canvas background, so the pipeline settings appear on the lower part of the screen. There, select the Variables tab, and then select + New, to add a variable of Array type.
:::image type="content" source="media/append-variable-activity/add-append-variable-activity.png" alt-text="Screenshot showing the creation of a new array type variable to a pipeline.":::
-
Now that you have an array type variable in your pipeline, search for Append Variable in the pipeline Activities pane, and select it to add it to the pipeline canvas. You may need to expand the list of available activities using the dropdown + button at the far right of the toolbar.
:::image type="content" source="media/append-variable-activity/add-append-variable-activity.png" alt-text="Screenshot of the Fabric UI with the Activities pane and "Append Variable" activity highlighted.":::
-
Select the new activity on the canvas if it isn't already selected.
:::image type="content" source="media/append-variable-activity/append-variable-general-settings.png" alt-text="Screenshot showing the General settings tab of the "Append Variable" activity.":::
Refer to the General settings guidance to configure the General settings tab.
Select the Settings tab, then use the Name dropdown to select your previously created array type variable. You can also use the + New button to create a new variable in the pipeline directly if you didn't create one previously. Provide data to be appended to the array variable. You can use dynamic expressions here or directly enter data, of which the type is always string.
:::image type="content" source="media/append-variable-activity/configure-append-variable-settings.png" alt-text="Screenshot showing the "Append Variable" activity settings tab, highlighting the tab.":::
Although Append Variable is typically used with other activities, it can be run directly as is.
[!INCLUDEsave-run-schedule-pipeline]