Mapping Orchestration Inputs

On the Orchestration design page, access the Transformations dialog box to map orchestration inputs to the inputs that are defined in an orchestration step, such as inputs in a rule, cross reference, white list, or any other component. The Transformations dialog box includes an Auto Map button for automatically mapping any matching inputs in the orchestration and the orchestration step.

If an orchestration and an orchestration component use different input names to identify the same data, you can use the grid in the Transformations dialog box to map the inputs. This facilitates the reuse of components, and eliminates the need to create a new component to match the input names (from a third-party application or device) in a new orchestration.

To better understand how to map inputs, see the example depicted in Figure. In this example, the orchestration inputs have the same name as the inputs in the service request. These inputs were automatically mapped using the Auto Map button.

Initially, when you have a small number of orchestrations in your system, it is recommended to keep all the input names consistent among the orchestration and all the components (orchestration steps) used by the orchestration. But as your library of orchestrations and orchestration components increases, instead of creating new components with input names that match the names of the orchestration inputs, you can use transformations to map the orchestration inputs to an existing component.

To map inputs:

1. In the orchestration design page, click the component to which you want to map orchestration inputs.

   The action control icons are displayed for the component.

2. Click the Transformations icon.

3. In the Transformations dialog box, click the Auto Map button to map matching inputs. The Studio automatically maps inputs with the same name, and the matching orchestration inputs appear in the Available Values column next to the matching input in the Input column.

4. To map an orchestration input to an orchestration step input that does not have the same name:

   1. In the grid, click the drop-down menu in the Available Values column.

   2. Select the orchestration input to map to the orchestration step input.

5. You can map a literal value to the orchestration step input by entering a value in the Default Value column.

   Starting with Tools Release 9.2.6.3, when mapping values, you can select <Space> from the Default Value drop-down menu.

6. If you are mapping values from an array, you can configure the orchestration to iterate over the orchestration step so that the step is called once for each row in the array:

   1. After defining the array in the Inputs and Values dialog box, click the Iterate Over drop-down list in the Transformations dialog box and select the name of the array input.

   2. Map the orchestration inputs for the array to the inputs that are defined in the orchestration step.