Wait for Adapter Message

The Wait for Adapter Message activity is used to listen to messages sent by publishers, and the messages must conform to the custom schema specified by a user. The following figure illustrates when Publication Service publishes a message and the Wait for Adapter Message activity receives the message in a business process.

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 WaitforAdapterMessage.
Adapter Service	No	The preconfigured Publication Service. You must specify the adapter service when configuring the adapter. Click to locate the appropriate service for this activity.
Custom Schema	No	Select or clear the check box 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. 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).
body	Complex	A complex schema type specified for the adapter service or a complex schema type designated by a user.

Fault

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

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

Fault	Thrown 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.