uCosminexus Service Platform, Basic Development Guide
This activity defines transmission of a request message to an already defined HCSC component.
You define the details of service invocation activities in the Invoke Service Activity dialog box.
- Organization of this subsection
- (1) Definition procedure
- (2) Notes on definition
(1) Definition procedure
To define a receive activity:
- Deploy a invoke service 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 Invoke Service Activity dialog box:
- Double-click a invoke service activity on the canvas.
- Choose and right-click a invoke service activity on the canvas, and choose Setting.
The Invoke Service Activity dialog box opens.
- Enter the necessary information in the Invoke Service Activity dialog box.
For details on display/input contents of [Invoke service activity] dialog, see "1.4.9 Invoke service activity dialog" in the "Service Platform Reference Guide".
- When editing the contents of variable to be set in [Body assigned variable for request message] and [Body assigned variable for reply message]
Click [Edit] button. You can edit the contents of variable, in the displayed [Variable/correlation set list] dialog. In this item, you can set the variable of the message type (XML, non-XML or any). For details on [Variable/correlation set list] dialog, see "1.4.1 Variable/correlation set list dialog" in the "Service Platform Reference Guide".
When setting a message format defined in invoked service components, you can set by using [Incorporate a message format] dialog. For the procedure to set the message format defined in service components invoked by using [Incorporate a message format] dialog, see "Points" described after this procedure.
For details on [Incorporate a message format], see "1.4.5 Incorporate a message format dialog" in the "Service Platform Reference Guide".
- When setting a variable in [Header assigned variable for request message] and [Header assigned variable in reply message]
Click [Settings] button. Set the assigned variable in the displayed [Header assigned variable] dialog. In this item, you can set the variable of message type (XML). You cannot set the variable of message type (non-XML or any). For details on [Header assigned variable] dialog, see "1.4.2 Header assigned variable dialog" in the "Service Platform Reference Guide".
- When setting the [Assigned correlation sets]
- When setting a [Assigned correlation sets]
Click [Settings] button. Set up the assigned correlation set in the displayed [Assigned correlation sets] dialog. For details on the [Assigned correlation sets], see "1.4.3 Assigned correlation sets dialog" in the "Service Platform Reference Guide".
- Click OK.
- Hint
- How to set the message format defined in the service component to be invoked to variable is explained below. Note that the following steps are explained for the request messages, but the steps for the response messages are also same:
- Specify the service name and operation name to be invoked in the Invoke Service Activity dialog box.
- Click Edit in Variable allocated for Request Message.
The Variable-Correlation Set dialog box opens.
- Specify the variable name.
- Click Get Format.
The Get Message Format dialog box opens.
The values specified in step 2. are set in the service name and operation name. Also, Request Message is set in Message Type.
- Specify the message format name in the Message Format.
- Click OK.
The Get Message Format dialog box closes and the user returns to Variable-Correlation Set dialog box.
- Click Add.
The defined variable is added to the Variable List.
- Choose the added variable from the variable list.
- Click OK.
The Variable-Correlation Set dialog box closes and the user returns to Invoke Service Activity dialog box.
(2) Notes on definition
- Specify activity name such that it is unique in the business process (and also within scope).
- Set defined HCSC components and their operation in the service name and operation name. Also, match the communication model of the set operation with the communication model of the defined operation.
- Specify activity name within 64 bytes.
- Do not specify a control character in the input field of dialog.
- Set the invoked service name.
- In case of synchronous invoking, set the assigned variables for reply message without fail.
- In case of non-persistence business process, do not set the asynchronous invoke service activity.
- Match the message type variables )XML, non-XML, any) specified in body assigned variable with the message type of invoked HCSC component. In case of mismatch, error occurs in invoked HCSC components, except for the case of invoking a business process from the business process definition.
All Rights Reserved. Copyright (C) 2015, Hitachi, Ltd.