Top
Systemwalker Runbook Automation Studio User's Guide
Systemwalker

9.1.3 Defining Data Mappings for Subprocesses

When data is to flow between parent and subprocess, you map the UDA of the parent process definition to the corresponding UDA of the subprocess definition. Also, you specify in which directions values are to be passed between parent and subprocess definition.

Prerequisites:

Auto data mapping for parent process definition and subprocess definition

When the pre-requisites mentioned above are fulfilled and you connect the parent process definition and the subprocess definition, data mapping between them is automatically completed. The UDAs of the parent process definition are mapped to the UDAs of the subprocess that have the same data types as that of the parent process definition. To view the automatically mapped UDAs, click the subprocess node of the parent process definition and select the Data Mapping tab. The mapped UDAs are displayed in All Data Mappings area along with their data flow directions.

Editing data mapping

To delete unwanted mappings, select them in All Data Mappings area and click the Delete button.

You need to manually edit the UDA mappings in the following scenarios:

To manually edit UDA mappings

  1. Select the Data Mapping tab of the subprocess node in the parent process definition.

  2. To map a UDA:

    1. From the Mapping Type drop-down list, select the data type of the UDA you want to map. This drop-down list displays all data types that occur in the parent process definition. The UDA in the parent process definition and UDA in the subprocess definition drop-down lists are populated with the UDAs of the same mapping type as selected in the Mapping Type drop-down list.

    2. Select the UDA in the parent process definition and the corresponding UDA of the same type as that of the parent process definition UDA in the subprocess definition.

    3. Click Add.

      In the All Data Mappings area, the mapped UDAs are displayed.

  3. If the UDA type is XML then click in the corresponding XPath column field. A drop-down list is displayed. Select from the drop-down list, the XPath expression that specifies where the data can be found in the XML string of the Source UDA. This field is active only if you have selected a UDA of type XML. The XPath expressions related to the selected UDA are displayed in the XPath drop-down list.

  4. Optional: If you want to edit the XPath expression that you selected in the XPath drop-down list, click the ellipsis (...) button that is displayed next to the XPath drop-down list. XPath Editor dialog box is displayed with the selected XPath expression in its editor area. You can edit this XPath expression and click OK to use the edited XPath expression.

    Note

    The edited XPath expression is displayed as the latest XPath in the XPath drop-down list.

    Note

    The XPath expressions related to the selected XML UDA are displayed in the XPath drop-down list. When XML Schema is defined in selected UDA, the XPath list that can be used with this XML Schema is displayed. When Initial value is defined in selected UDA, the XPath list that can be used with this Initial value is displayed. When both are defined, Xpath list of XML Schema is displayed.

    Note

    XPath Editor only validates the syntax of the XPath. It does not check if the edited XPath expression exists or not.

  5. In the All Data Mappings area, specify the data flow between process definitions:

    1. When the data value passes from the parent to the subprocess, click Input.

    2. When the data value passes from the subprocess to the parent process, click Output.

      Figure 9.2 Defining Data Mappings