7.12 Integration Activity

The Integration activity provides a way to use a Web service to process workflow data. For detailed information about using the Integration activity, see Section 8.0, Working with Integration Activities.

7.12.1 Properties

The Integration activity has the following properties.

Table 7-23 Integration Activity Properties

Property Name

Description

Name

Provides a name for the activity.

WSDL Resource

Specifies a WSDL file for the Web service to be used in the Integration activity. After it is specified, the WSDL is incorporated into the provisioning request definition file.

When you select a WSDL file, a dialog box is displayed that you use to select the Web service port type and operation that you want to use in the Integration activity.

Timeout

Specifies a dynamic expression that defines the period of time allotted for the Integration activity to complete. The timeout interval applies each time the activity is executed by the addressee.

For details on building ECMA expressions, see Section 9.0, Working with ECMA Expressions. For descriptions of the system variables available in a workflow, see Section 6.5.3, Understanding Workflow Data.

Retry Count

Specifies the number of times to retry the activity in the event of a timeout.

When an activity times out, the workflow process can try to complete the activity again, depending on the retry count specified for the activity. If the last retry times out, the activity can be marked as success, fault, error, or timed out, depending on the final timeout action specified for the activity.

Final Timeout Action

Determines the final state of the request in the event that the Integration activity times out. The choices are

  • success

  • fault

  • error

  • timedout

7.12.2 Data Item Mapping

To bind the data items associated with the Integration activity, you define pre-activity and post-activity mappings. The pre-activity mappings map values retrieved from the flowdata object to attributes in the Input message for the Web service that will be accessed by the Integration Activity. The post-activity mappings map the response from the Web service back into the flowdata object. For more information about data item mapping for Integration activities, see Section 8.3, Moving Data to and from the Integration Activity.

Table 7-24 Integration Activity Data Item Mappings

Setting

Description

Pre-Activity

Allows you to specify one or more pre-activity mappings. When this option is selected, you can double-click a cell in the Source Expression column to specify where the Integration activity gets data for a particular Web service input field.

NOTE:When the Pre-Activity option is selected, the cells in the Web Service Input Field column are not editable.

Post-Activity

Allows you to specify one or more post-activity mappings. When this radio button is selected, you can double-click a cell in the Target Expression column to specify where data from a Web service output field should be copied after the form has been processed.

NOTE:When the Post-Activity option is selected, the cells in the Web Service Output Field column are not editable.

Source Expression

Specifies a source expression. When you click a cell in the Source Expression column, the ECMA expression builder displays to help you define your expression. For example, flowdata.get('Start/RequestRate/Country1') for a Web service input, or flowdata.Start/RequestRate/Country1 for a Web service output field.

Web Service Input Field

This column displays all of the input fields for the port type and operation specified when the WSDL file was selected. The fields in this column are automatically populated. If you want to remove an input field, click Mapping, expand the nodes of the sample document and de-select any input fields that you want to remove.

Web Service Output Field

This column displays all of the output fields for the port type and operation specified when the WSDL file was selected. The fields in this column are automatically populated. If you want to remove an output field, click Mapping, expand the nodes of the sample document and deselect any output fields that you want to remove.

Mapping

Displays a hierarchical view of the sample document for the inputs to or outputs from the Web service. You can use this feature to deselect input or output fields (by default, all Web service input and output fields are selected).

7.12.3 E-Mail Notification

Not supported with this activity.