uCosminexus Service Platform, Basic Development Guide
This section describes the support range of a BPEL file and rules for converting to a business process definition for BPEL2.0.
The Cosminexus Service Platform does not support some elements and attributes defined in a BPEL file for BPEL2.0. The following table describes whether or not the elements and attributes defined in a BPEL file in BPEL2.0 are supported in Cosminexus Service Platform:
Table E-17 Support range of elements and attributes defined in a BPEL file (For BPEL2.0)
Classification | Element | Lower element or attribute | Support range | |||
---|---|---|---|---|---|---|
Elements related to the overall business process definitions | process element | name attribute | N | |||
targetNamespace attribute | N | |||||
queryLanguage attribute | N | |||||
expressionLanguage attribute | N | |||||
suppressJoinFailure attribute | N | |||||
exitOnStandardFault attribute | N | |||||
partnerLinks element | N | |||||
correlationSets element | N | |||||
variables element | documentation element | N | ||||
variable element | name attribute | Y | ||||
messageType attribute | Y | |||||
type attribute | Y | |||||
element attribute | N | |||||
documentation element | N | |||||
From element | N | |||||
faultHandlers element | documentation element | N | ||||
catch element | faultName attribute | N | ||||
faultVariable attribute | Y | |||||
faultMessageType attribute | N | |||||
faultElement attribute | N | |||||
documentation element | N | |||||
activity#1 | Y | |||||
catchall element | documentation element | N | ||||
activity#1 | Y | |||||
eventHandlers element | N | |||||
import element | N | |||||
messageExchanges element | N | |||||
documentation element | N | |||||
activity#1 | Y | |||||
Elements related to the basic activity | receive element | name attribute | Y | |||
suppressJoinFailure attribute | N | |||||
partnerLink attribute | N | |||||
portType attribute | N | |||||
operation attribute | Y | |||||
variable attribute | Y | |||||
createInstance attribute | C | |||||
messageExchange attribute | N | |||||
targets element | N | |||||
sources element | N | |||||
documentation element | N | |||||
correlations element | N | |||||
fromParts element | N | |||||
reply element | name attribute | Y | ||||
suppressJoinFailure attribute | N | |||||
partnerLink attribute | N | |||||
portType attribute | N | |||||
operation attribute | Y | |||||
variable attribute | Y | |||||
faultName attribute | Y | |||||
messageExchange attribute | N | |||||
targets element | N | |||||
sources element | N | |||||
documentation element | N | |||||
correlations element | N | |||||
toParts element | N | |||||
invoke element | name attribute | Y | ||||
suppressJoinFailure attribute | N | |||||
partnerLink attribute | N | |||||
portType attribute | Y | |||||
operation attribute | Y | |||||
inputVariable attribute | Y | |||||
outputVariable attribute | Y | |||||
targets element | N | |||||
sources element | N | |||||
documentation element | N | |||||
correlations element | N | |||||
toParts element | N | |||||
fromParts element | N | |||||
catch element | faultName attribute | N | ||||
faultVariable attribute | Y | |||||
faultMessageType attribute | N | |||||
faultElement attribute | N | |||||
documentation element | N | |||||
activity#1 | Y | |||||
catchall element | documentation element | N | ||||
activity#1 | Y | |||||
assign element | name attribute | Y | ||||
suppressJoinFailure attribute | N | |||||
validate attribute | N | |||||
targets element | N | |||||
sources element | N | |||||
documentation element | N | |||||
copy element | keepSrcElementName attribute | N | ||||
ignoreMissingFromData attribute | N | |||||
documentation element | N | |||||
from element | variable attribute | Y | ||||
expressionLanguage attribute | N | |||||
part attribute | N | |||||
partnerLink attribute | N | |||||
endpointReference attribute | N | |||||
property attribute | N | |||||
documentation element | N | |||||
literal element | Y | |||||
query element | queryLanguage attribute | N | ||||
to element | variable attribute | Y | ||||
part attribute | N | |||||
partnerLink attribute | N | |||||
expressionLanguage attribute | N | |||||
property attribute | N | |||||
documentation element | N | |||||
query element | queryLanguage attribute | N | ||||
empty element | name attribute | Y | ||||
suppressJoinFailure attribute | N | |||||
targets element | N | |||||
sources element | N | |||||
documentation element | N | |||||
throw element | name attribute | Y | ||||
suppressJoinFailure attribute | N | |||||
faultName attribute | N | |||||
faultVariable attribute | Y | |||||
targets element | N | |||||
sources element | N | |||||
documentation element | N | |||||
wait element | name attribute | Y | ||||
suppressJoinFailure attribute | N | |||||
targets element | N | |||||
sources element | N | |||||
documentation element | N | |||||
for element | Y | |||||
+ | expressionLanguage attribute | N | ||||
until element | Y | |||||
+ | expressionLanguage attribute | N | ||||
compensate element#2 | name attribute | Y | ||||
suppressJoinFailure attribute | N | |||||
targets element | N | |||||
sources element | N | |||||
documentation element | N | |||||
extensionActivity element#2 | anyElementQName#3 | name attribute | Y | |||
suppressJoinFailure attribute | N | |||||
anyAttribute#3 | N | |||||
targets element | N | |||||
sources element | N | |||||
documentation element | N | |||||
any#3 | N | |||||
rethrow element#2 | name attribute | Y | ||||
suppressJoinFailure attribute | N | |||||
targets element | N | |||||
sources element | N | |||||
documentation element | N | |||||
exit element#2 | name attribute | Y | ||||
suppressJoinFailure attribute | N | |||||
targets element | N | |||||
sources element | N | |||||
documentation element | N | |||||
validate element#2 | name attribute | Y | ||||
suppressJoinFailure attribute | N | |||||
variables attribute | N | |||||
targets element | N | |||||
sources element | N | |||||
documentation element | N | |||||
compensateScope element#2 | name attribute | Y | ||||
suppressJoinFailure attribute | N | |||||
target attribute | N | |||||
targets element | N | |||||
sources element | N | |||||
documentation element | N | |||||
Elements related to the structure activity | scope element | name attribute | Y | |||
suppressJoinFailure attribute | N | |||||
exitOnStandardFault attribute | N | |||||
isolated attribute | N | |||||
targets element | N | |||||
sources element | N | |||||
documentation element | N | |||||
correlationSets element | N | |||||
variables element | documentation element | N | ||||
variable element | name attribute | Y | ||||
messageType attribute | Y | |||||
type attribute | Y | |||||
element attribute | N | |||||
documentation element | N | |||||
From element | N | |||||
faultHandlers element | documentation element | N | ||||
catch element | faultName attribute | N | ||||
faultVariable attribute | Y | |||||
faultMessageType attribute | N | |||||
faultElement attribute | N | |||||
documentation element | N | |||||
activity#1 | Y | |||||
catchall element | documentation element | N | ||||
activity#1 | Y | |||||
compensationHandler element | N | |||||
eventHandlers element | N | |||||
terminationHandle element | N | |||||
partnerLinks element | N | |||||
messageExchanges element | N | |||||
activity#1 | Y | |||||
while element | name attribute | Y | ||||
suppressJoinFailure attribute | N | |||||
targets element | N | |||||
sources element | N | |||||
documentation element | N | |||||
condition element | Y | |||||
+ | expressionLanguage attribute | N | ||||
activity#1 | Y | |||||
if element | name attribute | Y | ||||
suppressJoinFailure attribute | N | |||||
targets element | N | |||||
sources element | N | |||||
documentation element | N | |||||
condition element | Y | |||||
+ | expressionLanguage attribute | N | ||||
elseif element | documentation element | N | ||||
condition element | Y | |||||
activity#1 | Y | |||||
else element | documentation element | N | ||||
activity#1 | Y | |||||
activity#1 | Y | |||||
flow element | name attribute | Y | ||||
suppressJoinFailure attribute | N | |||||
targets element | N | |||||
sources element | N | |||||
documentation element | N | |||||
links element | N | |||||
activity#1 | Y | |||||
sequence element | name attribute | Y | ||||
suppressJoinFailure attribute | N | |||||
targets element | N | |||||
sources element | N | |||||
documentation element | N | |||||
activity#1 | Y | |||||
pick element#2 | name attribute | Y | ||||
suppressJoinFailure attribute | N | |||||
createInstance attribute | N | |||||
targets element | N | |||||
sources element | N | |||||
documentation element | N | |||||
onAlarm element | N | |||||
onMessage element | N | |||||
forEach element#2 | name attribute | Y | ||||
suppressJoinFailure attribute | N | |||||
counterName attribute | N | |||||
parallel attribute | N | |||||
targets element | N | |||||
sources element | N | |||||
documentation element | N | |||||
startCounterValue element | N | |||||
finalCounterValue element | N | |||||
completionCondition element | N | |||||
scope element | N | |||||
repeatUntil element#2 | name attribute | Y | ||||
suppressJoinFailure attribute | N | |||||
targets element | N | |||||
sources element | N | |||||
documentation element | N | |||||
condition element | N |
Among the elements defined in the BPEL file, the conversion of the contents related to the overall business process (such as settings of the business process and variables used) is explained below.
The process element and its lower elements and attributes are converted to the contents related to the overall business process definitions.
The table below describes the conversion details.
Table E-18 process element conversion
Element of the BPEL file | Definition contents of the business process | ||
---|---|---|---|
Definition content | Explanation | ||
process element | variables element | Variable | For details, see Appendix E.2(1)(b) variables element conversion. |
correlationSets element | Correlation set | For details about the variables, see Appendix E.2(1)(c) correlationSets element conversion. | |
faultHandlers element | Fault handling | For details about the variables, see Appendix E.2(1)(d) faultHandlers element conversion. | |
activity# | Activity | Converted to the activity constituting the business process. | |
-- | Business process name | The business process name specified in the dialog box for adding a business process definition is set. | |
-- | Business process version | 1 is set. | |
-- | Persistence | The persistence existence specified in the dialog box for adding a business process definition is set. |
For details about the elements converted to each activity of a business process, see Appendix E.2(2) Converting elements related to the Basic Activity and Appendix E.2(3) Converting elements related to the Structure Activity.
The variables element and its lower elements and attributes are converted to definitions of the variables set in the business process (or in scope). After importing, you can change the definition contents using the List Of Variables And Correlation Sets dialog box.
The table below describes the conversion details. The names indicated in Item are the item names of the List Of Variables And Correlation Sets dialog box.
Table E-19 variables element conversion
Lower elements or attributes of the variables element | Definition contents of the business process | ||
---|---|---|---|
Item | Explanation | ||
variable element | name attribute | Variable name | The name of the variable is set. |
messageType attribute | Type | If this attribute is defined, the type attribute is converted to the string type (string). As a result, after conversion you must change the type of variable to the message type (messageType), and register the message format. |
|
type attribute | Type | The following variable types are set:
|
|
-- | Part specifications | Value is not set in part specifications of a variable. When you want to use part specifications, perform the setting with the List Of Variables And Correlation Sets dialog box, after importing. |
The definition contents of the correlationSets element correspond to Correlation set in the business process definition. The value will not be set even when you import the BPEL file and create a business process.
When you want to use a correlation set in the business process, you define the correlation set with the List Of Variables And Correlation Sets dialog box after importing, and then allocate the correlation set with the Allocating Correlation Set Group dialog box of the activity that uses the correlation set.
The faultHandlers element and its lower elements and attributes are converted to the definition contents of the fault handler within the business process. You can change the definition contents after conversion using the Fault Handler dialog box.
The table below describes the conversion details. The names indicated in Item are the item names of the Fault Handler dialog box.
Table E-20 faultHandlers element conversion
Lower elements or attributes of the faultHandlers element | Definition contents of the business process | ||
---|---|---|---|
Item | Explanation | ||
catch element | faultVariable attribute | Allocated variable | For details about the variable, also see the notes in Appendix E.2(1)(b) variables element conversion. |
activity# | Activity | Converted to the activity constituting the business process. | |
catchall element | activity# | Activity | Converted to the activity constituting the business process. |
-- | Allocated variable | catch-all is set always. | |
-- | Transition destination | If the catch element or catchAll element is defined, the transition destination of the fault handler is set automatically. |
Of the elements defined in the BPEL file, the conversion of the elements converted to the Basic Activity is explained below.
The receive element and its lower elements and attributes are converted to the definition contents of the Receive Activity. After importing, you can change the definition contents with the Receive dialog box.
The table below describes the conversion details. The names indicated in Item are the item names of the Receive dialog box.
Table E-21 receive element conversion
Lower elements or attributes of the receive element | Definition contents of the business process | |
---|---|---|
Item | Explanation | |
operation attribute | Operation name | If a receive element with a different portType attribute and the same operation attribute is already defined, n (n is an integer value of 1 or more) is added at the end of the operation name. |
variable attribute | Allocated variable | For details about the variable, also see the notes in Appendix E.2(1)(b) variables element conversion. |
createInstance attribute | Instance generation | Converted to yes, without any concern with the attribute value. |
name attribute | Activity name | The name of the activity is set. If an activity with the same name is already defined in the business process, n (n is an integer value of 1 or more) will be added at the end of the activity name. |
-- | Communication model | Sync or Async is set based on the contents of the business process definition. |
The reply element and its lower elements and attributes are converted to definition contents of the Reply Activity. After importing, you can change the definition contents with the Reply dialog box.
The table below describes the conversion details. The names indicated in Item are the item names of the Reply dialog box.
Table E-22 reply element conversion
Lower elements or attributes of the reply element | Definition contents of the business process | |
---|---|---|
Item | Explanation | |
operation attribute | Operation name | If n (n is an integer value of 1 or more) is added at the end of the operation name of a receive element with the same portType attribute and the operation attribute (see the operation attribute in Table E-21), the same n will be added at the end of the operation name of the reply element as well. The conversion of the receive element and the reply element with the same portType attribute and the operation attribute is shown in Figure E-2. |
variable attribute | Allocated variable | For details about the variable, also see the notes in Appendix E.2(1)(b) variables element conversion. |
faultName attribute | Fault name | Converted to a local name, if a prefix is attached. |
name attribute | Activity name | The name of the activity is set. If an activity with the same name is already defined in the business process, n (n is an integer value of 1 or more) will be added at the end of the activity name. |
Figure E-2 Conversion of receive element and reply element with the same portType attribute and operation attribute
The invoke element and its lower elements and attributes are converted to definition contents of the Invoke Service Activity. Furthermore, if the catch element or catchAll element is defined as a lower element of the invoke element, these elements are converted to the fault handler (activity connected with the fault connection) in the Invoke Service Activity. After importing, you can change the definition contents with the Invoke Service Activity dialog box or Fault Handler dialog box.
The table below describes the conversion details. The names indicated in Item are the item names of the Invoke Service Activity dialog box or Fault Handler dialog box.
Table E-23 invoke element conversion
Lower elements or attributes of the invoke element | Definition contents of the business process | ||
---|---|---|---|
Item | Explanation | ||
portType attribute | Service name | Converted only when the corresponding service components and operations exist in the repository. Converted to a local name. | |
operation attribute | Operation name | Converted only when the corresponding service components and operations exist in the repository. | |
inputVariable attribute | Request message variable | Set when the service components and operations exist in the repository. For details about the variable, also see the notes in Appendix E.2(1)(b) variables element conversion. |
|
outputVariable attribute | Reply message variable | Set when the service components and operations exist in the repository, and the communication type is synchronous. For details about the variable, also see the notes in Appendix E.2(1)(b) variables element conversion. |
|
name attribute | Activity name | The name of the activity is set. If an activity with the same name is already defined in the business process, n (n is an integer value of 1 or more) will be added at the end of the activity name. | |
catch element | faultVariable attribute | Allocated variable | An item of the Fault Handler dialog box. For details about the variable, also see the notes in Appendix E.2(1)(b) variables element conversion. |
activity# | Activity | Converted to the activity configuring a business process. | |
catchall element | activity# | Activity | Converted to the activity configuring a business process. |
-- | Allocated variable | An item of the Fault Handler dialog box. catch-all is set always. |
The assign element and its lower elements and attributes are converted to the definition contents of the Assign Activity. After importing, you can change the definition contents using the Assign Activity dialog box or Assign Activity sub dialog box.
The table below describes the conversion details. The names indicated in Item are the item names of the Assign Activity dialog box or Assign Activity sub dialog box.
Table E-24 assign element conversion
Lower elements or attributes of the assign element | Definition contents of the business process | |||
---|---|---|---|---|
Item | Explanation | |||
name attribute | Activity name | The name of the activity is set. If an activity with the same name is already defined in the business process, n (n is an integer value of 1 or more) will be added at the end of the activity name. | ||
copy element | from element | variable attribute | Name (variable of the copy source) | An item of the Assign Activity sub dialog box. The value set in the Assign Activity sub dialog box differs depending on the specification of the variable attribute, the literal element, and the query element. For details, see Table E-25. For details about the variable, also see the notes in Appendix E.2(1)(b) variables element conversion. |
literal element | Value (expression of the copy source) | An item of the Assign Activity sub dialog box. The value set in the Assign Activity sub dialog box differs depending on the specification of the variable attribute, the literal element, and the query element. For details, see Table E-25. |
||
query element | Value (expression of the copy source) | An item of the Assign Activity sub dialog box. The value set in the Assign Activity sub dialog box differs depending on the specification of the variable attribute, the literal element, and the query element. For details, see Table E-25. |
||
to element | variable attribute | Variable name (copy destination) | An item of the Assign Activity sub dialog box. For details about the variable, also see the notes in Appendix E.2(1)(b) variables element conversion. |
The following table describes the values set in the Assign Activity sub dialog box according to the specification of the variable attribute, the literal element, and the query element:
Table E-25 Values set in the Assign Activity sub dialog box
Item No. | Attributes of the from element under the assign element | Value set in the Assign Activity sub dialog box | ||
---|---|---|---|---|
variable attribute | literal element | query element | ||
1 | N | N | N | No value is set. |
2 | Y | N | N | The value specified in the variable attribute is set in Name in Variable of the Copy source. |
3 | N | Y | N | The value specified in the literal element is set in Value in Expression of the Copy source. |
4 | N | N | Y | The value specified in the query element is set in Value in Expression of the Copy source. |
5 | Y | Y | N | The value specified in the variable attribute is set in Name in Variable of the Copy source. |
6 | Y | N | Y | The value specified in the query element is set in Value in Expression of the Copy source. |
7 | N | Y | Y | The assign element is not converted (an error occurs). |
8 | Y | Y | Y | The assign element is not converted (an error occurs). |
The empty element is converted to definition contents of the Empty Activity. After importing, you can change the definition contents with the Empty dialog box.
The table below describes the conversion details. The names indicated in Item are the item names of the Empty Activity dialog box.
Table E-26 empty element conversion
Lower elements or attributes of the empty element | Definition contents of the business process | |
---|---|---|
Item | Explanation | |
name attribute | Activity name | The name of the activity is set. If an activity with the same name is already defined in the business process, n (n is an integer value of 1 or more) will be added at the end of the activity name. |
The throw element and its lower elements and attributes are converted to the definition contents of the Fault Handler Activity. After importing, you can change the definition contents with the Fault Handler dialog box.
The table below describes the conversion details. The name indicated in Item is the item name of the Fault Handler dialog box.
Table E-27 throw element conversion
Lower elements or attributes of the throw element | Definition contents of the business process | |
---|---|---|
Item | Explanation | |
faultVariable attribute | Allocated variable | For details about the variable, also see the notes in Appendix E.2(1)(b) variables element conversion. |
name attribute | Activity name | The name of the activity is set. If an activity with the same name is already defined in the business process, n (n is an integer value of 1 or more) will be added at the end of the activity name. |
The wait element is transformed into the definition contents of the standby activity. After importing this element, you can change the definition contents in the standby activity dialog box.
The following table describes the details of transformation. The names described in the Item column in the table are the item names from the standby activity dialog box.
Table E-28 Transforming the wait element
Lower elements or attributes of the wait element | Definition contents of the business process | |
---|---|---|
Item | Explanation | |
name attribute | Activity name | The activity name is set up. If an activity with the same name is already defined in the business process, n (n is an integer value of 1 or more) is added at the end of the activity name. |
for element | Expression | Information about the standby interval. Interval becomes ON. |
until element | Expression | Information about the standby time period. Time Period becomes ON. |
Of the elements defined in the BPEL file, the conversion of the elements converted to the Basic Activity is explained below.
The scope element and its lower elements and attributes are converted to definition contents of the Scope Activity. After importing, you can change the definition contents with the Scope Activity dialog box.
Furthermore, the variables, correlation sets, and information about the fault handlers defined within the scope element can be changed with the List Of Variables And Correlation Sets dialog box and Fault Handler dialog box.
The table below describes the conversion details.
Table E-29 scope element conversion
Lower elements or attributes of the scope element | Definition contents of the business process | |
---|---|---|
Item | Explanation | |
name attribute | Activity name | The name of the activity is set. If an activity with the same name is already defined in the business process, n (n is an integer value of 1 or more) will be added at the end of the activity name. |
variables element | Variable | Information about the variables used in scope. For details about the variables, see Appendix E.2(1)(b) variables element conversion. |
correlationSets element | Correlation set | Information about the correlation sets used in scope. For details about the correlation set information, see Appendix E.2(1)(c) correlationSets element conversion. |
faultHandlers element | Fault handling | Information about the fault handlers used in scope. For details about the fault handler information, see Appendix E.2(1)(d) faultHandlers element conversion. |
activity# | Activity | Converted to the activity configuring a business process. |
The while element and its lower elements and attributes are converted to definition contents of the While Activity. After importing, you can change the definition contents with the While Activity dialog box and Condition Setting dialog box.
The table below describes the conversion details. The names indicated in Item are the item names of the While Activity dialog box or Condition Setting dialog box.
Table E-30 while element conversion
Lower elements or attributes of the while element | Definition contents of the business process | |
---|---|---|
Item | Explanation | |
name attribute | Activity name | The name of the activity is set. If an activity with the same name is already defined in the business process, n (n is an integer value of 1 or more) will be added at the end of the activity name. |
condition element | Condition Expression | A value is set in the condition expression of the Condition Setting dialog box. |
activity# | Activity | Converted to the activity constituting the business process. |
-- | Maximum Loop Count | 100 is set automatically. |
The if element and its lower elements and attributes are converted to definition contents of the Switch Start Activity. After importing, you can change the definition contents with the ConBranch Activity dialog box and Condition setting dialog box.
The table below describes the conversion details. The names indicated in Item are the item names of the Switch Activity dialog box or Condition Setting dialog box.
Table E-31 if element conversion
Lower elements or attributes of the if element | Definition contents of the business process | ||
---|---|---|---|
Item | Explanation | ||
name attribute | Activity name | The name of the activity is set. If an activity with the same name is already defined in the business process, n (n is an integer value of 1 or more) will be added at the end of the activity name. | |
condition element | Condition Expression | A value is set in the condition expression of the Condition Setting dialog box. | |
activity# | Activity | Converted to the activity constituting the business process. | |
-- | Priority | An item of the Switch Activity dialog box. 1 is set at all times. |
|
elseif element | condition element | Condition Expression | A value is set in the condition expression of the Condition Setting dialog box. |
activity# | Activity | Converted to the activity configuring a business process. | |
-- | Condition name | An item of the Switch Activity dialog box. condition n is set automatically. n indicates a unique integer within switch. |
|
-- | Priority | An item of the Switch Activity dialog box. Set in the order of occurrence starting from 2. |
|
else element | activity# | Activity | Converted to the activity configuring a business process. |
-- | Priority | An item of the Switch Activity dialog box. The default value is set. |
The flow element and its lower elements and attributes are converted to the definition contents of the Flow Start Activity. After importing, you can change the definition contents using the Flow Start Activity dialog box.
The table below describes the conversion details. The names indicated in Item are the item names of the Flow Activity dialog box.
Table E-32 flow element conversion
Lower elements or attributes of the flow element | Definition contents of the business process | |
---|---|---|
Item | Explanation | |
name attribute | Activity name | The activity name is set up. If an activity with the same name is already defined in the business process, n (n is an integer value of 1 or more) is added at the end of the activity name. |
activity# | Activity | Converted to the activity constituting the business process. |
The sequence element is converted to definition contents of the Sequence Activity. You cannot modify the definition contents.
The sequence element does not have any lower attributes to be converted.
With the Cosminexus Service Platform, only the sequence elements described at the positions corresponding to 5.6.17 Sequence Activity are converted to a business process definition.
All Rights Reserved. Copyright (C) 2015, Hitachi, Ltd.