Configuring the Actions in the Service Request

In the Service Request design page, use the Available Actions area to define actions that you want the service request to perform. After you define the actions, you can place the actions in the proper order in the Order of Execution area as described in Defining the Order of Execution in the Service Request.

To configure the actions for the service request:

1. In the Available Actions area, complete the following fields to specify the EnterpriseOne form that contains the controls you want to load:

   • Application. Enter the ID of the EnterpriseOne application.

   • Form. Enter the form ID.

   • Version. Enter the version of the EnterpriseOne application.

   • Form Mode. (Available with Release 9.2.0.3) Click the drop-down menu and select the appropriate form mode: Add, Update, or Inquiry.

     The form mode determines the controls that are displayed for the form. At runtime, the controls that appear on an EnterpriseOne form are dependent on the form mode as specified in Form Design Aid (FDA). This ensures that you can see all of the form controls in the Orchestrator Studio that are available in the form at runtime.

   • Application Stack. Click this check box if you want to use application stack processing. See Understanding the Application Stack Option for more information.

2. Click the Load Form button.

   The Orchestrator Studio loads the controls and fields for the form in the grid.

   If the action involves more than one form, you can search on another form and the Orchestrator Studio will load the controls for the form in a collapsible node at the end of the grid.

3. To map service request inputs to EnterpriseOne fields:

   1. Select the row with the field in which you want to be mapped.

   2. In the Mapped Value column, enter a variable name to use for the mapping.

      When a service request is added to an orchestration, the inputs in the orchestration should match the inputs defined in the service request. You can also use the "Transformations" feature to map non-matching input names. See Adding Inputs to an Orchestration and Configuring Transformations for more information.

4. If the service request task involves selecting the first grid row in the EnterpriseOne form, in the "Select First Row" row, click the Add Action button to move it to the "Order of Execution" area.

5. If the service request task requires updating a particular row in an input capable grid, then map the appropriate input value containing the row number to the "Row Number for Update" row, or specify the row number in the Default Value column.

6. In the Default Value column, you can perform the following actions to configure the default values for the controls:

   1. If the control is a check box or a radio button, you can select it to include it. If there are multiple radio buttons on a form, select only one. If you select more than one, only the last radio button in the Order of Execution list will be used.

   2. If the control is a combo box (a list of items in a drop-down menu), then the Studio displays a drop-down menu in the Default Value column in which you can select the appropriate item from the list.

   3. If the field is editable, you can enter a hard-coded value to map for the input. You can also enter a value to be used if the mapped value returns a null.

   Fields that are grayed out in this column are not editable.

7. Select the Return check box next to the fields that contain values that you want returned in the orchestration response. If you do not specify any return values, all values on the form will be returned.

   Important: If using the Application Stack option:

8. To use text substitution to combine input values into a text string for input into an EnterpriseOne field, perform these steps:

   Note: If you use text substitution for the input, the field cannot contain a mapped value. The substituted text string becomes the default value for the field when you add it to the Order of Execution list.

   1. In the field that you want to substitute the input with text, click the Add Text Substitution button (plus symbol).

   2. In the pop-up dialog box, in the Text Substitution field, enter the following variable (with brackets) to use for the first input:

      {0}

   3. In the Variable field, enter the input variable name.

   4. Click the Add button (plus symbol) to add the variable for the text substitution.

   5. Add the next variable, {1}, and then in the next blank row below the Variable field, enter the input variable name.

      If you add a variable by mistake, click the Remove Variable button.

   6. Click the Add button to add it to the text substitution.

   7. Click the OK button to save the variables for the text substitution.

      The following image shows an example of variables added for a temperature input value and a date input value:

      

9. As you finish configuring the applicable rows in the Available Actions area, in the right-most column, click the Add Action button to move the configured rows to the "Order of Execution" area.

   Next, order the actions as appropriate as described in Defining the Order of Execution in the Service Request.