Creating Arrays of Working Data

Prerequisites:

You performed the steps in Creating a Practice Process App for Data Mapping.

On the Data Mapping tab of the orchestration workflow Property Editor, you can create an array of working data to use in orchestrations. To do this, you first create an array container data element, then the array, and then the array elements.

Procedure Summary

  1. Select an orchestration workflow to display it in the orchestration workflow editor.
  2. Click the Data Mapping tab of the orchestration workflow Property Editor.
  3. Create the array container data element by right-clicking the Working Data step input and then selecting Add New DataElement.
  4. Rename the new array container data element, if you want.
  5. Right-click the array container data element, point to Type[String], and then select Private Complex.
  6. Create the array by right-clicking the array container data element again and then selecting Add Child DataElement.
  7. Right-click the array, and then select Properties Mode, if it is not already selected.

  8. In the properties area under Misc, select the IsUnbounded row.
  9. Click the down arrow next to False, and then select True.
  10. Close the properties area by right-clicking the array and then selecting Mapping Mode.
  11. Rename the array and change its data type, if you want.
  12. Create an array data element by right-clicking the array and then selecting Add Array Element. (The new array data element inherits the name and data type of the array. You cannot change this.)
  13. Repeat the previous step to add more array data elements.

In the following exercise, you will create an array container data element (ArrayContainer) that contains one array (Array) with three array elements (Array[1], Array[2], and Array[3]).

To create an array of working data elements:

  1. In App Explorer, select DataMappingOrchWF under the Orchestration Workflows heading.
  2. In the orchestration workflow Property Editor, click the Data Mapping tab.

    The WorkingData step input should be visible under the name of the orchestration workflow (DataMappingOrchWF) in the Working data column. (If it is not, click a blank area in the orchestration workflow editor.)

  3. Right-click the WorkingData step input, and then select Add New DataElement.

    A new data element (DataElement), which is the array container, is added under the WorkingData step input.

  4. While DataElement is still selected, type ArrayContainer, and then press the Tab key.
  5. Right-click ArrayContainer, point to Type[String], and then select Private Complex. (Type[String] indicates that the original data type of ArrayContainer was String.)

    The string icon changes to complex.

  6. Right-click ArrayContainer, and then select Add Child DataElement.

    A new DataElement is added under ArrayContainer.

  7. While DataElement is still selected, type Array, and then press the Tab key.
  8. Right-click Array, and then select Properties Mode.

    The properties area opens on the right side of the orchestration workflow Property Editor.

  9. In the properties area under Misc, select the IsUnbounded row.
  10. Click the down arrow next to False, and then select True.

    A left and right square bracket are added to the array name (Array[]) to indicate that the data element is an array.

  11. To close the properties area, right-click Array[], and then select Mapping Mode.

    The number of array elements is displayed in parentheses to the right of Array[]. The number begins at 0 (zero) and increases by one each time you add an array element.

  12. Right-click Array[], and then select Add Array Element.

    A new array element (Array[1]) is added under Array[].

  13. Repeat step 12 two more times.

    Array elements Array[2] and Array[3] are added to Array[] under Array[1], and (3 elements) is added to the right of Array[].

Related Topics

Using Data Mapping