Receive Notification

Copyright © Cloud Software Group, Inc. All Rights Reserved

Chapter 5 General Activities Palette : Receive Notification

Receive Notification

Activity

The Receive Notification process starter starts a process when another process executes a Notify activity with a matching key and Notify Configuration resource. The key specified in the Key field of the Configuration tab creates a relationship between the Receive Notification process starter and the corresponding Notify activity.

The same Notify Configuration shared configuration resource must be specified by corresponding Receive Notification and Notify activities so that data can be passed from the process containing the Notify activity to the process started with Receive Notification. The schema in the Notify Configuration resource can be empty, if you do not want to pass data between processes.

The Wait, Receive Notification, and Notify activities allow running process instances to communicate. See TIBCO ActiveMatrix BusinessWorks Process Design for more information on inter-process communication.

Configuration

The Configuration tab has the following fields.

Field

Description

Name

The name to appear as the label for the activity in the process definition.

Description

Short description of the activity.

Shared Configuration

The Notify Configuration shared configuration resource that defines a data schema for this activity. See Notify Configuration for more information.

The Notify Configuration resource is required, but the schema can be empty if you do not want to pass data between processes.

Key

The key that coordinates a Receive Notification process starter with the corresponding Notify activity. For example, in an order handling process, the order ID might be the key that Receive Notification uses to determine which Notify activity corresponds to this process starter.

The key must be a fixed string. You may use global variables, but XPath expressions cannot be used.

See TIBCO ActiveMatrix BusinessWorks Process Design for more information and examples of choosing the key for Wait, Notify, and Receive Notification.

Misc

The Misc tab contains the following fields:

Field

Description

Sequencing Key

This field can contain an XPath expression that specifies which processes should run in order. Process instances with sequencing keys that evaluate to the same value will be executed sequentially in the order the process instance was created.

See TIBCO ActiveMatrix BusinessWorks Process Design for more information about controlling the execution order of process instances and about XPath expressions.

Custom Id

This field can contain an XPath expression that specifies a custom ID for the process instance. This ID is displayed in the View Service dialog of TIBCO Administrator, and it is also available in the $_processContext process variable.

Output

The output for the activity is the following.

Output Item

Datatype

Description

schema

complex

The schema specified by the Shared Configuration field on the Configuration tab. This schema is used to pass data from the process instance containing the Notify activity into this process instance.

Field	Description
Name	The name to appear as the label for the activity in the process definition.
Description	Short description of the activity.
Shared Configuration	The Notify Configuration shared configuration resource that defines a data schema for this activity. See Notify Configuration for more information. The Notify Configuration resource is required, but the schema can be empty if you do not want to pass data between processes.
Key	The key that coordinates a Receive Notification process starter with the corresponding Notify activity. For example, in an order handling process, the order ID might be the key that Receive Notification uses to determine which Notify activity corresponds to this process starter. The key must be a fixed string. You may use global variables, but XPath expressions cannot be used. See TIBCO ActiveMatrix BusinessWorks Process Design for more information and examples of choosing the key for Wait, Notify, and Receive Notification.

Field	Description
Sequencing Key	This field can contain an XPath expression that specifies which processes should run in order. Process instances with sequencing keys that evaluate to the same value will be executed sequentially in the order the process instance was created. See TIBCO ActiveMatrix BusinessWorks Process Design for more information about controlling the execution order of process instances and about XPath expressions.
Custom Id	This field can contain an XPath expression that specifies a custom ID for the process instance. This ID is displayed in the View Service dialog of TIBCO Administrator, and it is also available in the $_processContext process variable.

Output Item	Datatype	Description
schema	complex	The schema specified by the Shared Configuration field on the Configuration tab. This schema is used to pass data from the process instance containing the Notify activity into this process instance.