Wait for Adapter Request

The adapter sends a request using a preconfigured service, and the process implements the request. The process sends any required responses back to the adapter service by placing the Respond to Adapter Request activity at a later point in the process.

Adapter Request-Response Invocation Service is configured during adapter configuration, and the activity uses the information in the adapter configuration to configure this activity.

The following figure illustrates a Wait for Adapter Request activity waiting for a request from Request-Response Invocation Service. In the business process, a Respond to Adapter Request activity sends the response at a later point.

General

The General tab has the following fields:

Field	Module Property?	Description
Name	No	The name displayed as the label for the activity in the process definition. The default value is WaitforAdapterRequest.
Adapter Service	No	The preconfigured Request-Response Invocation Service. You must specify the adapter service when configuring the adapter. Click to locate the appropriate service for this activity.
Operation	No	Operations defined by the schema used in the selected adapter service. Select the operation that this process definition implements from the list.
Custom Schema	No	Select or clear the checkbox to specify whether you want to supply an output class for this activity. Cleared (default): The Output Editor tab is read-only. Selected: The Output Editor tab is editable. Note: The feature of Custom Schema in TIBCO ActiveMatrix BusinessWorks 6 is the same as CustomAESchema in TIBCO ActiveMatrix BusinessWorks 5.
Transport Configuration		Click the Transport Configuration link to configure a transport in the Advanced tab.

Description

In the Description tab, you can enter a short description for the activity.

Event

The Event tab has the following fields:

Field	Module Property?	Description
Event Timeout (seconds)	No	A Timeout specified in seconds. The default value is 60. If no value is specified in this field, the message waits indefinitely. If zero(0) is specified, the event is discarded immediately, unless this activity has already been executed.
Activity Timeout (msec)	No	The amount of time (in milliseconds) to wait if the message arrives before this activity is executed in the process instance. If the event times out, an error is logged and the event is discarded. This field contains an XPath expression that specifies the timeout value for the activity. To edit the XPath expression, click .

Field

Module Property?

Description

Event Timeout (seconds)

No

A Timeout specified in seconds. The default value is 60.

If no value is specified in this field, the message waits indefinitely.

If zero(0) is specified, the event is discarded immediately, unless this activity has already been executed.

Activity Timeout (msec)

No

The amount of time (in milliseconds) to wait if the message arrives before this activity is executed in the process instance. If the event times out, an error is logged and the event is discarded.

This field contains an XPath expression that specifies the timeout value for the activity.

To edit the XPath expression, click .

Advanced

The Advanced tab contains the Transport Type field. You can select a transport type in the Transport Type list. For more information, see Transport Type.

Output Editor

The Output Editor tab defines the schema used for messages: Map, Stream, or XML Text. Map messages are name or value pairs.

You can use the schema to define the structure of the outgoing request and the incoming reply. The schema defined in the Output Editor tab becomes the body of the message in the Output tab.

Conversations

You can initiate the conversation here. Click Add New Conversation to initiate multiple conversations.

For details about conversations, see TIBCO ActiveMatrix BusinessWorks Application Development.

Output

The following table lists the output items for this activity:

Output Item	Data Type	Description
subject	String	The subject of the message.
replySubject	String	The reply subject of the message.
certifiedSequence Number	String	This element contains the sequence number in which this message was received. It is available only when Tibrv Certified is the transport.
certifiedSender	String	This element contains the CM name of the message sender. It is available only when Tibrv Certified is the transport.
MessageID	String	The ID of the message. This element is available only when JMS Queue or JMS Topic is the transport.
trackingInfo	Complex	The AE tracking information of the sender. This element is a concatenation of "BW". + Application_Name + Module_Name + Process_Name + Activity_Name + User_Part (Business_Key).
JMSHeaders	Complex	This element contains the message header fields for the message. Only properties applicable to this type of message are displayed. It is available only when JMS Queue or JMS Topic is the transport. For more information about message header fields, see "JMS Properties" in TIBCO ActiveMatrix BusinessWorks Bindings and Palette Reference.
body	Complex	A complex schema type specified for the adapter service or a complex schema type designated by user.

Fault

The Fault tab lists the possible exceptions generated by this activity.

Note: This tab plays the same role as the Error Output tab in TIBCO ActiveMatrix BusinessWorks 5.x.

Fault	Generated When...
TransportException	The transport cannot be created.
DeserializationException	The outgoing message cannot be serialized.
ConfirmationException	The message cannot be confirmed.
ActivityTimeoutException	A timeout error occurs.