Configuring a Form Request to Retrieve a Data Set

Note: Data sets from grids on a power form are not supported.

1. In the Form Requests design page, locate the row <Form Name> - Grid node in the Available Actions grid.

2. In the <Form Name> - Grid row, enter a name for the data set in the Variable column.

   If you configure the orchestration to pass the data in the data set to a subsequent orchestration step, you enter this variable name in the Iterate Over column of the orchestration step to which you want to pass the data.

3. For each row that you want to include in the data set, slide the toggle in the Return column.

4. For each row that you want to include in the data set, enter a variable name so that the returned column can be mapped to a subsequent orchestration step.

Starting with Tools Release 9.2.8.2, you can reorder the outputs of a form request by clicking the Edit Returns icon on the Return Form Data action and by dragging and dropping the rows. The system preserves the order that you set when you Save the changes and reflects this order in Orchestration Outputs when the Form Request is added to an orchestration. This feature improves readability and enables orchestrations to easily integrate with user interfaces or third-party systems that might be sensitive to the order of outputs.

Note: Order of name-value pairs in JSON is not important or guaranteed but in most cases, the orchestration output reflects the order set at design time. If you use Output Array to File to create a CSV, XML, or JSON file, the system reflects the order of grid data specified at design time.

For more information about configuring a form request, see Configuring a Form Request in the Orchestrator Studio.