uCosminexus Service Platform, Basic Development Guide
This activity defines an interface required for a business process to receive a request message from a service requester. If a single business process contains multiple operations to be open to service requesters, a receive activity must be defined for each operation.
You can define the details of receive activities in the Receive Activity dialog box.
- Organization of this subsection
- (1) Definition procedure
- (2) Notes on definition
(1) Definition procedure
To define a receive activity:
- Deploy a receive activity on the canvas.
For details about how to deploy activities, see 5.4.1 Deploying Activities.
- Use one of the following methods to open the Receive Activity dialog box:
- Double-click a receive activity on the canvas.
- Select and right-click a receive activity on the canvas, and then select Setting.
The Receive Activity dialog box appears.
- Enter the necessary information in the Receive Activity dialog box.
For details about the display and input contents of the Receive Activity dialog box, see 1.4.7 Receive Activity Dialog in the manual uCosminexus Service Platform Reference Guide.
- When editing the contents of the variable to be specified in Body allocated variable
Click Edit. The List Of Variables And Correlation Sets dialog box appears. In this dialog box, you can edit the contents of the variable. In this item, you can specify a variable of the message type (XML, non-XML, or any). For details about the List Of Variables And Correlation Sets dialog box, see 1.4.1 List Of Variables And Correlation Sets Dialog in the manual uCosminexus Service Platform Reference Guide.
Note that if you have already defined a user-defined reception that has relevant operations, you can set the message format for the user-defined reception to a variable. Specify this setting in the Take In Message Format dialog box. The Take In Message Format dialog box appears when you click Take In in the List Of Variables And Correlation Sets dialog box.
If you specify an operation name in the Receive Activity dialog box beforehand, the message format for the relevant operation within the user-defined reception is already selected when the Take In Message Format dialog box appears.
For details about the Take In Message Format dialog box, see 1.4.5 Take In Message Format Dialog in the manual uCosminexus Service Platform Reference Guide.
- When specifying settings in Header allocated variable
Click Setting. The Header allocated variable dialog box appears. In this dialog box, you can specify a variable to be allocated to the header. In this item, you can specify a variable of the message type (XML). Note that you cannot specify a variable of the message type (non-XML or any). For details about the Header allocated variable dialog box, see 1.4.2 Header allocated variable dialog in the manual uCosminexus Service Platform Reference Guide.
- When specifying settings in Allocating Correlation Set Group
Click Setting. The Allocating Correlation Set Group dialog box appears. In this dialog box, you can specify the correlation sets to be allocated. For details about the Allocating Correlation Set Group dialog box, see 1.4.3 Allocating Correlation Set Group Dialog in the manual uCosminexus Service Platform Reference Guide.
- Click OK.
(2) Notes on definition
- Specify activity names that are unique within a business process (and also within a scope).
- An activity name must be no more than 64 bytes.
- Do not specify any control characters in the input fields of the dialog box.
- Specify operation names that are unique within a business process (and also within a scope).
- When a synchronous receive activity is specified, specify a reply activity that corresponds to the operation of the receive activity.
- When a synchronous receive activity is specified, do not specify another receive activity between the receive activity and the reply activity corresponding to the operation of that receive activity.
- Specify all receive activities generating instances so that they use the same correlation set.
- Create at least one receive activity that generates instances.
- Care is required when changing the definition information for a receive activity after upgrading the version of a business process. For details, see 5.9.4(3) Points to be noted when upgrading the version of business process.
All Rights Reserved. Copyright (C) 2015, Hitachi, Ltd.