The Integration Point Interaction element enables you to obtain and manipulate information from other applications and databases by utilizing a relevant integration point that is stored on the Interaction Server. Integration Point elements allow you to:
- Get data (from other applications and databases) and use it in your Interaction, (e.g., get a customer record from Siebel).
- Set information in other applications and databases, based on inputs and decisions already made in your Interaction.
Using an Integration Point in an Interaction involves inserting the element into the Interaction, selecting the appropriate integration point, and then configuring input and output parameters, as explained in the sections below.
To insert an Integration Point element:
- From the Insert menu, select Integration Point. Alternatively, from the toolbar, click IconIntegrationPoint, and then click inside the Interaction Map.
The Integration Point Definition dialog opens, with the General tab displayed by default.
Configuring General Settings
Configuring general settings involves defining a name for the Interaction element and then selecting the required web service integration point. Both SOAP and REST protocols are supported.
|Reference name||The name of the Interaction element. The name should be unique, so it can be used for referencing. The reference name appears only in Design view. It is not visible to users.|
|Data||Contains a list (in tree format) of all configured integration points.|
Once you select an integration point, the Details frame is automatically populated with basic information about the selected integration point.
Configuring Input Parameters
This tab enables you to assign input parameters for the selected integration point. Possible parameters that can be assigned are displayed in the Parameters frame.
Input parameters can be set in one of the following ways:
- Check the Use existing element checkbox, and then select the relevant parameter from the dropdown list.
- Clear the Use existing element checkbox, and then enter the parameter in the textbox.
Configuring Output Response
This tab enables you to assign a Variable element in which to put the return value. Appropriate defined Variables are displayed in a dropdown list in the Response frame.
To assign a Variable, select the relevant Variable, and then click OK.
Handling Integration Point Behavior
The IP Status system variable returns a value indicating whether an Integration Point (IP) behaved as expected. When this variable is used in an Interaction, the Interact Server updates the value of the variable after each run of the Integration Point. The value is determined by whether the Integration Point succeeded, or failed to perform as expected.
In your Interaction, you can add a Decision element after the Integration Point element to check the success of the Integration Point, based on the value of the IP Status variable. In the event of IP failure, you can build appropriate logic involving calling the Integration Point again, displaying a message to the user, and so on.