uCosminexus Service Platform, Basic Development Guide
This section describes the support range of BPEL files and rules for converting to business process definitions for BPEL1.1.
Service Platform does not support some elements and attributes defined in the BPEL file for BPEL1.1. The following table indicates the elements and attributes defined in the BPEL file for BPEL1.1 that are supported or not supported in Service Platform.
Table E-2 Elements and attributes defined in the BPEL file for BPEL1.1 that are supported or not supported in Service Platform
Category | Element | Lower element or attribute | Support range | ||
---|---|---|---|---|---|
Elements related to overall business process definitions | process element | name attribute | N | ||
targetNamespace attribute | N | ||||
queryLanguage attribute | N | ||||
expressionLanguage attribute | N | ||||
suppressJoinFailure attribute | N | ||||
enableInstanceCompensation attribute | N | ||||
abstractProcess attribute | N | ||||
partnerLinks element | N | ||||
partners element | N | ||||
correlationSets element | N | ||||
variables element | variable element | name attribute | Y | ||
messageType attribute | Y | ||||
type attribute | Y | ||||
element attribute | N | ||||
faultHandlers element | catch element | faultName attribute | N | ||
faultVariable attribute | Y | ||||
activity#1 | Y | ||||
catchAll element | activity#1 | Y | |||
compensationHandler element | N | ||||
eventHandlers element | N | ||||
activity#1 | Y | ||||
Elements related to basic activities | receive element | name attribute | Y | ||
joinCondition attribute | N | ||||
suppressJoinFailure attribute | N | ||||
partnerLink attribute | N | ||||
portType attribute | N | ||||
operation attribute | Y | ||||
variable attribute | Y | ||||
createInstance attribute | C | ||||
target element | N | ||||
source element | N | ||||
correlations element | N | ||||
reply element | name attribute | Y | |||
joinCondition attribute | N | ||||
suppressJoinFailure attribute | N | ||||
partnerLink attribute | N | ||||
portType attribute | N | ||||
operation attribute | Y | ||||
variable attribute | Y | ||||
faultName attribute | Y | ||||
target element | N | ||||
source element | N | ||||
correlations element | N | ||||
invoke element | name attribute | Y | |||
joinCondition attribute | N | ||||
suppressJoinFailure attribute | N | ||||
partnerLink attribute | N | ||||
portType attribute | Y | ||||
operation attribute | Y | ||||
inputVariable attribute | Y | ||||
outputVariable attribute | Y | ||||
target element | N | ||||
source element | N | ||||
correlations element | N | ||||
catch element | faultName attribute | N | |||
faultVariable attribute | Y | ||||
activity#1 | Y | ||||
catchAll element | activity#1 | Y | |||
assign element | name attribute | Y | |||
joinCondition attribute | N | ||||
suppressJoinFailure attribute | N | ||||
target element | N | ||||
source element | N | ||||
copy element | from element | variable attribute | Y | ||
expression attribute | Y | ||||
part attribute | N | ||||
partnerLink attribute | N | ||||
endpointReference attribute | N | ||||
property attribute | N | ||||
opaque attribute | N | ||||
query attribute | N | ||||
Tag value#2 | Y | ||||
to element | variable attribute | Y | |||
part attribute | N | ||||
partnerLink attribute | N | ||||
property attribute | N | ||||
query attribute | N | ||||
empty element | name attribute | Y | |||
joinCondition attribute | N | ||||
suppressJoinFailure attribute | N | ||||
target element | N | ||||
source element | N | ||||
throw element | faultName attribute | N | |||
faultVariable attribute | Y | ||||
name attribute | Y | ||||
joinCondition attribute | N | ||||
suppressJoinFailure attribute | N | ||||
target element | N | ||||
source element | N | ||||
wait element | name attribute | Y | |||
joinCondition attribute | N | ||||
suppressJoinFailure attribute | N | ||||
target element | N | ||||
source element | N | ||||
for attribute | Y | ||||
until attribute | Y | ||||
terminate element#3 | name attribute | Y | |||
joinCondition attribute | N | ||||
suppressJoinFailure attribute | N | ||||
target element | N | ||||
source element | N | ||||
compensate element#3 | name attribute | Y | |||
joinCondition attribute | N | ||||
suppressJoinFailure attribute | N | ||||
scope attribute | N | ||||
target element | N | ||||
source element | N | ||||
Elements related to structure activities | scope element | name attribute | Y | ||
joinCondition attribute | N | ||||
suppressJoinFailure attribute | N | ||||
variableAccessSerializable attribute | N | ||||
target element | N | ||||
source element | N | ||||
correlationSets element | N | ||||
variables element | variable element | name attribute | Y | ||
messageType attribute | Y | ||||
type attribute | Y | ||||
element attribute | N | ||||
faultHandlers element | catch element | faultName attribute | N | ||
faultVariable attribute | Y | ||||
activity#1 | Y | ||||
catchAll element | activity#1 | Y | |||
compensationHandler element | N | ||||
eventHandlers element | N | ||||
activity#1 | Y | ||||
while element | name attribute | Y | |||
joinCondition attribute | N | ||||
condition attribute | Y | ||||
suppressJoinFailure attribute | N | ||||
target element | N | ||||
source element | N | ||||
activity#1 | Y | ||||
switch element | name attribute | Y | |||
joinCondition attribute | N | ||||
suppressJoinFailure attribute | N | ||||
target element | N | ||||
source element | N | ||||
case element | condition attribute | Y | |||
activity#1 | Y | ||||
otherwise element | activity#1 | Y | |||
flow element | name attribute | Y | |||
joinCondition attribute | N | ||||
suppressJoinFailure attribute | N | ||||
target element | N | ||||
source element | N | ||||
links element | N | ||||
activity#1 | Y | ||||
sequence element | name attribute | N | |||
joinCondition attribute | N | ||||
suppressJoinFailure attribute | N | ||||
target element | N | ||||
source element | N | ||||
activity#1 | Y | ||||
pick element#3 | name attribute | Y | |||
joinCondition attribute | N | ||||
suppressJoinFailure attribute | N | ||||
createInstance attribute | N | ||||
target element | N | ||||
source element | N | ||||
onAlarm element | N | ||||
onMessage element | N |
This subsection explains the conversion of the elements defined in the BPEL file that are the contents related to the overall business process (such as settings of the business process and variables used).
The process element and its lower elements and attributes are converted to the contents related to the overall business process definitions.
The following table describes the conversion details.
Table E-3 Converting the process element
Elements of the BPEL file | Business process definitions | ||
---|---|---|---|
Definition item | Explanation | ||
process element | variables element | Variable | For details, see (1)(b) Converting the variables element. |
correlationSets element | Correlation set | For details, see (1)(c) Converting the correlationSets element. | |
faultHandlers element | Fault handling | For details, see (1)(d) Converting the faultHandlers element. | |
activity# | Activity | This element is converted to activities that constitute a business process. | |
-- | Business process name | This item is set to the business process name specified in the dialog box for adding a business process definition. | |
-- | Business process version | This item is set to 1. | |
-- | Persistence | This item is set to the persistence settings (persistent or non-persistent) specified in the dialog box for adding business process definitions. |
For practice about the elements converted to each activity of a business process, see (2) Converting elements related to basic activities and (3) Converting elements related to structure activities.
The variables element and its lower elements and attributes are converted to definitions of the variables set in the business process (or in the scope). After importing the definitions, you can change the definitions in the List Of Variables And Correlation Sets dialog box.
The table below describes the conversion details. The names in the Item column in the following table are the item names in the List Of Variables And Correlation Sets dialog box.
Table E-4 Converting the variables element
Lower element or attribute of the variables element | Business process definitions | ||
---|---|---|---|
Item | Explanation | ||
variable element | name attribute | Variable name | This attribute is set to the name of the variable. |
messageType attribute | Type | If this attribute has been defined, the type attribute is converted to the string type (string). For this reason, after converting the attribute, you must change the variable type to the message type (XML), and register the message format. |
|
type attribute | Type | This attribute is set to the following variable types:
|
|
-- | Part Specifications | No value is set in part specifications of a variable. To use part specifications, specify settings in the List Of Variables And Correlation Sets dialog box after importing the definitions. |
The definition information of the correlationSets element corresponds to a correlation set in business process definitions. No value is set even if you create a business process by importing a BPEL file.
To use a correlation set in a business process, after importing the business process, first define a correlation set in the List Of Variables And Correlation Sets dialog box. Then, allocate the correlation set by using the Allocating Correlation Set Group dialog box for the activity that uses the correlation set.
The faultHandlers element and its lower elements and attributes are converted to the definitions of the fault handling within the business process. You can change the converted definitions in the Fault Handler dialog box.
The table below describes the conversion details. The names listed in the Item column in the following table are the item names in the Fault Handler dialog box.
Table E-5 Converting the faultHandlers element
Lower element or attribute of the faultHandlers element | Business process definitions | ||
---|---|---|---|
Item | Explanation | ||
catch element | faultVariable attribute | Allocated variable | For details about the variable, see also the notes in (1)(b) Converting the variables element. |
activity# | Activity | This element is converted to activities that constitute a business process. | |
catchAll element | activity# | Activity | This element is converted to activities that constitute a business process. |
-- | Allocated variable | catch-all is set at all times. | |
-- | Transition destination | If the catch or catchAll element is defined, the transition destination of the fault handling is set automatically. |
This subsection explains the conversion of the elements defined in the BPEL file that are converted to basic activities.
The receive element and its lower elements and attributes are converted to the definition contents of the receive activity. After importing the definitions, you can change the definitions in the Receive Activity dialog box.
The table below describes the conversion details. The names in the Item column in the following table are the item names in the Receive Activity dialog box.
Table E-6 Converting the receive element
Lower element or attribute of the receive element | Business process definitions | |
---|---|---|
Item | Explanation | |
operation attribute | Operation name | If a receive element with a different portType attribute value and the same operation attribute value is already defined, n (n is an integer value of 1 or more) is appended at the end of the operation name. |
variable attribute | Allocated variable | For details about the variable, see also the notes in (1)(b) Converting the variables element. |
createInstance attribute | Instance generation | This attribute is converted to yes, regardless of the attribute value. |
name attribute | Activity name | An activity name 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) is appended at the end of the activity name. |
-- | Communication model | Sync or Async is set according to the contents of the business process definition. |
The reply element and its lower elements and attributes are converted to the definition contents of the reply activity. After importing the definitions, you can change the definitions in the Reply Activity dialog box.
The table below describes the conversion details. The names in the Item column in the following table are the item names in the Reply Activity dialog box.
Table E-7 Converting the reply element
Lower element or attribute of the reply element | Business process definitions | |
---|---|---|
Item | Explanation | |
operation attribute | Operation name | If n (n is an integer value of 1 or more) is appended at the end of the operation name of a receive element where the portType attribute value and the operation attribute value match (see the operation attribute in Table E-6), the same value n is also appended at the end of the operation name of the reply element. Figure E-1 shows the conversion of a receive element and a reply element where the portType attribute value and the operation attribute value match. |
variable attribute | Allocated variable | For details about the variable, see also the notes in (1)(b) Converting the variables element. |
faultName attribute | Fault name | The fault name is converted to a local name if a prefix is assigned. |
name attribute | Activity name | An activity name 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) is appended at the end of the activity name. |
Figure E-1 Conversion of a receive element and a reply element where the portType attribute value and the operation attribute value match
The invoke element and its lower elements and attributes are converted to the definition contents of the invoke service activity. Furthermore, if a catch element or catchAll element is defined as a lower element of the invoke element, these elements are converted to a fault handler (an activity connected with a fault connection) for the invoke service activity. After importing the definitions, you can change the definitions in the Invoke Service Activity dialog box or Fault Handler dialog box.
The table below describes the conversion details. The names listed in the Item column in the following table are the item names in the Invoke Service Activity dialog box or Fault Handler dialog box.
Table E-8 Converting the invoke element
Lower element or attribute of the invoke element | Business process definitions | ||
---|---|---|---|
Item | Explanation | ||
portType attribute | Service name | This attribute is converted only when the corresponding service components and operations exist in the repository. The service name is converted to a local name. | |
operation attribute | Operation name | This attribute is converted only when the corresponding service components and operations exist in the repository. | |
inputVariable attribute | Body allocated variable for request message | This attribute is set only when the corresponding service components and operations exist in the repository. For details about the variable, see also the notes in (1)(b) Converting the variables element. |
|
outputVariable attribute | Body allocated variable for reply message | This attribute is set when the service components and operations exist in the repository, and the communication type is synchronous. For details about the variable, see also the notes in (1)(b) Converting the variables element. |
|
name attribute | Activity name | An activity name 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) is appended at the end of the activity name. | |
catch element | faultVariable attribute | Allocated variable | This element is an item in the Fault Handler dialog box. For details about the variable, see also the notes in (1)(b) Converting the variables element. |
activity# | Activity | This element is converted to activities that constitute a business process. | |
catchAll element | activity# | Activity | This element is converted to activities that constitute a business process. |
-- | Allocated variable | This element is an item in the Fault Handler dialog box. catch-all is set at all times. |
The assign element and its lower elements and attributes are converted to the definition contents of the assign activity. After importing the definitions, you can change the definitions in the Assign Activity dialog box or Assign Activity sub-dialog box.
The table below describes the conversion details. The names listed in the Item column in the following table are the item names in the Assign Activity dialog box or Assign Activity sub-dialog box.
Table E-9 Converting the assign element
Lower element or attribute of the assign element | Business process definitions | |||
---|---|---|---|---|
Item | Explanation | |||
name attribute | Activity name | An activity name 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) is appended at the end of the activity name. | ||
copy element | from element | variable attribute | Name (under Variable in the Copy source frame) | This attribute is an item in the Assign Activity sub-dialog box. For details about the variable, see also the notes in (1)(b) Converting the variables element. |
expression attribute | Value (under Expression in the Copy source frame) | This attribute is an item in the Assign Activity sub-dialog box. This attribute is not converted if the variable attribute has been defined. |
||
Tag value# | Value (under Expression in the Copy source frame) | This attribute is an item in the Assign Activity sub-dialog box. If the variable and expression attributes are not defined, the tag value is set as the value of the expression. |
||
to element | variable attribute | Variable name (in the Copy destination frame) | This attribute is an item in the Assign Activity sub-dialog box. For details about the variable, see also the notes in (1)(b) Converting the variables element. |
The empty element is converted to the definition contents of the empty activity. After importing the definitions, you can change the definitions in the Empty Activity dialog box.
The table below describes the conversion details. The names in the Item column in the following table are the item names in the Empty Activity dialog box.
Table E-10 Converting the empty element
Lower element or attribute of the empty element | Business process definitions | |
---|---|---|
Item | Explanation | |
name attribute | Activity name | An activity name 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) is appended at the end of the activity name. |
The throw element and its lower elements and attributes are converted to the definition contents of the throw activity. After importing the definitions, you can change the definitions in the Throw Activity dialog box.
The table below describes the conversion details. The names in the Item column in the following table are the item names in the Throw Activity dialog box.
Table E-11 Converting the throw element
Lower element or attribute of the throw element | Business process definitions | |
---|---|---|
Item | Explanation | |
faultVariable attribute | Allocated variable | For details about the variable, see also the notes in (1)(b) Converting the variables element. |
name attribute | Activity name | An activity name 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) is appended at the end of the activity name. |
The wait element is converted to the definition contents of the standby activity. After importing the definitions, you can change the definitions in the Wait Activity dialog box.
The table below describes the conversion details. The names in the Item column in the following table are the item names in the Wait Activity dialog box.
Table E-12 Converting the wait element
Lower element or attribute of the wait element | Business process definitions | |
---|---|---|
Item | Explanation | |
name attribute | Activity name | An activity name 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) is appended at the end of the activity name. |
for attribute# | Expression | This attribute sets information about the standby interval. The For radio button is selected. |
until attribute# | Expression | This attribute sets information about the standby time period. The Until radio button is selected. |
This subsection explains the conversion of the elements defined in the BPEL file that are converted to structure activities.
The scope element and its lower elements and attributes are converted to the definition contents of the scope activity. After importing the definitions, you can change the definitions in the Scope Activity dialog box.
Furthermore, the variables, correlation sets, fault handling, and transaction control information defined within the scope element can be changed in the List Of Variables And Correlation Sets dialog box and Fault Handler dialog box.
The following table describes the conversion details.
Table E-13 Converting the scope element
Lower element or attribute of the scope element | Business process definitions | |
---|---|---|
Item | Explanation | |
name attribute | Activity name | An activity name 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) is appended at the end of the activity name. |
-- | Transaction control | This item specifies whether to execute transaction control. Commit after each activity is selected by default. |
variables element | Variable | This element sets information about the variables used in the scope. For details about variables, see (1)(b) Converting the variables element. |
correlationSets element | Correlation set | This element sets information about the correlation sets used in the scope. For details about correlation sets, see (1)(c) Converting the correlationSets element. |
faultHandlers element | Fault handling | This item sets information about the fault handling in the scope. For details about fault handling, see (1)(d) Converting the faultHandlers element. |
activity# | Activity | This element is converted to activities that constitute a business process. |
The while element and its lower elements and attributes are converted to the definition contents of the while activity. After importing the definitions, you can change the definitions in the While Activity dialog box and Condition Setting dialog box.
The table below shows the conversion details. The names listed in the Item column in the following table are the item names in the While Activity dialog box or Condition Setting dialog box.
Table E-14 Converting the while element
Lower element or attribute of the while element | Business process definitions | |
---|---|---|
Item | Explanation | |
name attribute | Activity name | An activity name 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) is appended at the end of the activity name. |
condition attribute | Condition Expression | Values are set in the conditional expression in the Condition Setting dialog box. |
activity# | Activity | This element is converted to activities that constitute a business process. |
-- | Max Loop Count | This item is automatically set to 100. |
The switch element and its lower elements and attributes are converted to the definition contents of the switch start activity. After importing the definitions, you can change the definitions in the Switch Activity dialog box and Condition Setting dialog box.
The table below describes the conversion details. The names listed in the Item column in the following table are the item names in the Switch Activity dialog box or Condition Setting dialog box.
Table E-15 Converting the switch element
Lower element or attribute of the switch element | Business process definitions | ||
---|---|---|---|
Item | Explanation | ||
name attribute | Activity name | An activity name 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) is appended at the end of the activity name. | |
case element | activity# | Activity | This element is converted to activities that constitute a business process. |
condition attribute | Condition Expression | Values are set in the conditional expression in the Condition Setting dialog box. | |
-- | Condition name | This attribute is an item in the Switch Activity dialog box. This item is automatically set to condition n. n indicates a unique integer within the switch. |
|
-- | Priority | This attribute is an item in the Switch Activity dialog box. Priorities are assigned according to the occurrence order of the conditions within the switch element. |
|
otherwise element | activity# | Activity | This element is converted to activities that constitute a business process. |
-- | Priority | This attribute is an item in the Switch Activity dialog box. This item is set to the default value. |
|
-- | Transition destination | This attribute is an item in the Switch Activity dialog box. This item is set according to the definitions of the case and otherwise elements. |
The flow element and its lower elements and attributes are converted to the definition contents of the flow start activity. After importing the definitions, you can change the definitions in the Flow Start Activity dialog box.
The table below describes the conversion details. The names in the Item column in the following table are the item names in the Flow Activity dialog box.
Table E-16 Converting the flow element
Lower element or attribute of the flow element | Business process definitions | |
---|---|---|
Item | Explanation | |
name attribute | Activity name | An activity name 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) is appended at the end of the activity name. |
activity# | Activity | This element is converted to activities that constitute a business process. |
The sequence element is converted to the definition contents of the sequence activity. You cannot modify the definition contents.
The sequence element does not have any lower attributes to be converted.
In Service Platform, only the sequence elements specified at the positions described in 5.6.17 Sequence Activity are converted to business process definitions.
All Rights Reserved. Copyright (C) 2015, Hitachi, Ltd.