10.11 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 Working with Integration Activities.

10.11.1 Properties

The Integration activity has the following properties.

Table 10-24 Integration Activity Properties

Property Name

Description

Identifier

A unique string value that identifies the activity. Workflow Builder auto-generates this value in Integration_<N> format, where <N> represents an alphanumeric value that contains 7 characters.

Name

Specifies a name for the activity.

WSDL Resource

Specifies a Web Services Description Language (WSDL) file for the Web service to be used in the Integration activity. After it is specified, the WSDL is incorporated into the workflow definition file.

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

You can also specify a SOAP endpoint for the Integration activity and configure authentication for the SOAP service. For more information about specifying a WSDL file and configuring the Integration activity, see Adding an 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.

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

10.11.2 Data Items

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 Moving Data to and from the Integration Activity.

Table 10-25 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 click the edit icon 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 option is selected, you can click the edit icon 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 the edit icon 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 deselect 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).

10.11.3 Email Template

Email templates are not supported with this activity.

10.11.4 Problems

The Problems tab provides details of the errors and warnings associated with the activity in a workflow. For more information about validating workflow activities, see Validating a Workflow.