Using the Insert Component Interface activity

Requirements

The project must already have a PeopleSoft endpoint Otherwise, input and output mapping will be disabled.
Note: If you have not already done so, compile, copy and install the required PeopleSoft .jar files, as detailed in Compiling and Importing PeopleSoft .jar files.
Configuring this activity requires the following procedures:

Adding a PeopleSoft activity to an orchestration

  1. In an active orchestration, open the Activities tab and expand the PeopleSoft folder contents.
  2. Drag the Insert Component Interface activity onto the orchestration.
  3. When the activity displays in the orchestration, the Insert Component Interface Checklist is displayed below.

Changing the activity name

  1. In the Checklist, click Summary.
  2. Review the contents of the Activity Name field and make any required changes.

Picking a PeopleSoft endpoint

  1. In the Checklist, click Pick Endpoint.
  2. Click Browse and use the Project Explorer dialog box to select the relevant PeopleSoft endpoint. More than one may be listed.
    Tip: You can create the needed endpoint by clicking New. For more information, see Creating or editing a PeopleSoft endpoint.
  3. When you click OK, the endpoint-specific configuration options are displayed in a read-only state.
    Note: If you need to make changes to the selected endpoint configuration, click Edit to activate the options. Any changes will globally affect all uses of this endpoint in active orchestrations.

Configuring the activity

  1. In the Checklist, click Configure.
  2. In the Component Interface Name field, click Browse.
  3. In the Browse Component Interface dialog box, select the relevant interface and click Select.
  4. In the Checklist, click Retry.
  5. Review the default settings and make any needed changes. For more information, see Specifying retry parameters for PeopleSoft activities.

Mapping the Inputs

If you have not already inserted the endpoint for the other data source in this orchestration, do so before proceeding with this step. Inputs represent data that is transmitted from the orchestration (variables) to the PeopleSoft endpoint (parameters).

  1. In the Checklist, click Map Inputs. A set of options is displayed to the right, and the To Activity list shows the PeopleSoft interface-specific variables.
  2. Click Select Inputs (above the From Orchestration list).
  3. The Select Inputs dialog box lists all of the variables associated with the other endpoint.
    Tip: If no orchestration variables are displayed, complete the steps in Creating a custom variable to add them to this dialog box.
  4. Choose a variable, then click OK.
    Note: A single variable may contain one or more parameters.
  5. To link the activities, click and drag a variable from the From Orchestration list onto a parameter listed in the To Activity list.

    If the link is viable, a line, linking the two, is displayed.

  6. Repeat this procedure to link other orchestration variables to PeopleSoft parameters.
  7. To test the input links, click Test.

    The Input Test Files table lists all linked variables/parameters.

  8. In the Location column, click the small blue button.
  9. Use the Browse dialog box to select an input test file.
  10. Click Run Test.

    Test results are displayed in the columns below.

Tip: You can replace a variable used in the map without changing the links of the map. For more information, see Replacing a Variable used in a Map.

Creating a custom variable

To create a custom variable in the From Orchestration list, complete these steps.
  1. Click Select Input above the From Orchestration list.
  2. In the Select Inputs dialog box, click New.
  3. In the Create New Variable wizard, browse the listed components.
  4. Select a data type or schema from the list.
  5. Click Next.
  6. In the second wizard, rename this variable (optional).
  7. Click Finish.

    When the Select Inputs dialog box is redisplayed, the custom variable will be listed and selected.

  8. Click OK to add this variable to the From Orchestration list.
  9. You can now link the input variable with an activity.

Mapping the Outputs

If you have not already inserted the endpoint for the other data source in this orchestration, do so before proceeding with this step.
Note: "Outputs" represent data that is transmitted from the PeopleSoft endpoint (parameters) to the orchestration (variables).
  1. In the Checklist, click Map Outputs.
  2. Review the parameters listed in the From Activity list.
  3. If you want to create new orchestration variables that match the output parameters of the current activity, select a parameter and then click Copy.
  4. In the Copy Parameters dialog box, choose one or more parameters, then click OK to add them to the To Orchestration list. The data type, schema, or schema fragment of the selected output parameter is applied to the new variable.
  5. Click Select Inputs (above the From Orchestration list).

    The Select Inputs dialog box lists all of the variables associated with the other endpoint.

  6. If no orchestration variables is displayed, complete the steps in Creating a custom variable to add them to this dialog box.
  7. Choose one or more variables, then click OK to add them to this list.
    Note: A single activity may contain one or more parameters.
  8. Drag a parameter from the From Activity list onto a variable listed in the To Orchestration list.

    If the link is viable, a line, linking the two, is displayed.

  9. Repeat this procedure to link other parameters and variables.
  10. To test the output links, click Test.

    A variable is listed in an Input Test Files table.

  11. In the Location column, click the small blue button.
  12. Use the Browse dialog box to select an input test file.
  13. Click Run Test.

    Test results are displayed in the columns below.