Shared Datasets

This article covers the following topics:

Shared Datasets Overview

Creating & Managing Shared Datasets

Available Parameters

Overview


Like variables, datasets are used to represent data in a task that may be different each time a task runs. But unlike standard variables, datasets can contain multiple rows and columns. In AutoMate BPA Server 9, datasets have the capability to become ā€¯shared", which means that they can be accessible throughout an entire workflow. Unlike normal datasets that are created and shared within a single task, the value of a shared dataset can be read by other objects or tasks that reside in the same workflow.

Shared datasets are declared at the workflow level. This informs the workflow that the contents of the dataset can be shared between all objects in the workflow. For example, if a dataset created in Task A running on Agent A, is declared by the workflow as a shared dataset, the values of that dataset can be retrieved and modified in Task B, C or D running on other Agents within the same workflow.

Creating & Managing Shared Datasets


In order for a dataset to be declared as a shared dataset, it must be added to the Shared Datasets tab of the Workflow Designer.

To add a shared dataset to a workflow:

  1. From the Workflow Designer, select the Shared Datasets tab.

  2. Right click anywhere inside the Shared Datasets pane. This will display a context menu. Select the Add Dataset option as shown below, circled in red.

  1. A dialog titled Workflow Dataset appears as shown below.

  2. Enter the required information and click OK to save changes and close the dialog box.

To delete an existing shared dataset:

  1. From the Shared Datasets tab, right-click the dataset to delete. To select more than one dataset, hold down CTRL during selection.

  2. Select Delete Dataset from the right-clcik menu that appears.

  3. To delete all selected datasets, select Delete Selected Datasets.

To edit an existing shared dataset:

  1. From the Shared Datasets tab, right-click the dataset to edit.

  2. Select Edit Dataset from the context menu that appears.

  3. The Workflow Dataset dialog appears.

  4. Make the appropriate modifications and click OK to save changes.

To rename an existing shared dataset:

  1. From the Shared Datasets tab, right-click the dataset to rename.

  2. Select Rename Datasets from the context menu that appears.

  3. Enter a new name for the dataset . Make sure that associated workflows or tasks point to the new dataset name. otherwise an error will occur during execution.

Available Parameters


The Workflow Dataset dialog box is used to enter the properties of the shared dataset. The available parameters are described in the table below.

General Tab Properties

Property

Description

Name

The name of the dataset that should be shared throughout the workflow.

Initial Value

This parameter is inactive because datasets are only created and populated during task/workflow execution.

Description

An optional text description that describes the purpose of the shared dataset.

See Also


About Datasets | Workflow Designer | Multi-machine Workflows | Shared Arrays | Shared Variables | Expression Builder | Constants