uCosminexus Service Platform, Basic Development Guide
This activity defines an interface for returning a response or fault to request messages received synchronously from service requesters by the business process. A reply activity must be defined if synchronous reception is defined for the communication model of the corresponding receive activity.
You can define the details of reply activities in the Reply Activity dialog box.
- Organization of this subsection
- (1) Definition procedure
- (2) Notes on definition
(1) Definition procedure
To define a reply activity:
- Deploy a reply 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 Reply Activity dialog box:
- Double-click a reply activity on the canvas.
- Select and right-click a reply activity on the canvas, and then select Setting.
The Reply Activity dialog box appears.
- Enter the necessary information in the Reply Activity dialog box.
For details about the display and input contents of the Reply Activity dialog box, see 1.4.8 Reply 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 Reply 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.
- An operation name must be specified.
- If a fault name is specified, the fault returns.
- Allocated variables must be specified.
- For reply activities having the same operation name, specify the same allocated variable name.
- Specify a single allocated variable that corresponds to the fault names of the reply activities of the same operation.
- When a synchronous receive activity is specified, specify a reply activity that corresponds to the operation of the receive activity.
- Do not specify another reply activity between a receive activity and the reply activity that corresponds to the operation of the receive activity.
- Specify a variable of the message type (XML) for the allocated variable that is set to allocate fault handling. Note that you cannot specify a variable of the message type (non-XML or any).
- Care is required when changing the definition information for a reply 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.