Appendix E.2 Importing a business process definition of BPEL2.0

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)

ClassificationElementLower element or attributeSupport range
Elements related to the overall business process definitionsprocess elementname attributeN
targetNamespace attributeN
queryLanguage attributeN
expressionLanguage attributeN
suppressJoinFailure attributeN
exitOnStandardFault attributeN
partnerLinks elementN
correlationSets elementN
variables elementdocumentation elementN
variable elementname attributeY
messageType attributeY
type attributeY
element attributeN
documentation elementN
From elementN
faultHandlers elementdocumentation elementN
catch elementfaultName attributeN
faultVariable attributeY
faultMessageType attributeN
faultElement attributeN
documentation elementN
activity#1Y
catchall elementdocumentation elementN
activity#1Y
eventHandlers elementN
import elementN
messageExchanges elementN
documentation elementN
activity#1Y
Elements related to the basic activityreceive elementname attributeY
suppressJoinFailure attributeN
partnerLink attributeN
portType attributeN
operation attributeY
variable attributeY
createInstance attributeC
messageExchange attributeN
targets elementN
sources elementN
documentation elementN
correlations elementN
fromParts elementN
reply elementname attributeY
suppressJoinFailure attributeN
partnerLink attributeN
portType attributeN
operation attributeY
variable attributeY
faultName attributeY
messageExchange attributeN
targets elementN
sources elementN
documentation elementN
correlations elementN
toParts elementN
invoke elementname attributeY
suppressJoinFailure attributeN
partnerLink attributeN
portType attributeY
operation attributeY
inputVariable attributeY
outputVariable attributeY
targets elementN
sources elementN
documentation elementN
correlations elementN
toParts elementN
fromParts elementN
catch elementfaultName attributeN
faultVariable attributeY
faultMessageType attributeN
faultElement attributeN
documentation elementN
activity#1Y
catchall elementdocumentation elementN
activity#1Y
assign elementname attributeY
suppressJoinFailure attributeN
validate attributeN
targets elementN
sources elementN
documentation elementN
copy elementkeepSrcElementName attributeN
ignoreMissingFromData attributeN
documentation elementN
from elementvariable attributeY
expressionLanguage attributeN
part attributeN
partnerLink attributeN
endpointReference attributeN
property attributeN
documentation elementN
literal elementY
query elementqueryLanguage attributeN
to elementvariable attributeY
part attributeN
partnerLink attributeN
expressionLanguage attributeN
property attributeN
documentation elementN
query elementqueryLanguage attributeN
empty elementname attributeY
suppressJoinFailure attributeN
targets elementN
sources elementN
documentation elementN
throw elementname attributeY
suppressJoinFailure attributeN
faultName attributeN
faultVariable attributeY
targets elementN
sources elementN
documentation elementN
wait elementname attributeY
suppressJoinFailure attributeN
targets elementN
sources elementN
documentation elementN
for elementY
+expressionLanguage attributeN
until elementY
+expressionLanguage attributeN
compensate element#2name attributeY
suppressJoinFailure attributeN
targets elementN
sources elementN
documentation elementN
extensionActivity element#2anyElementQName#3name attributeY
suppressJoinFailure attributeN
anyAttribute#3N
targets elementN
sources elementN
documentation elementN
any#3N
rethrow element#2name attributeY
suppressJoinFailure attributeN
targets elementN
sources elementN
documentation elementN
exit element#2name attributeY
suppressJoinFailure attributeN
targets elementN
sources elementN
documentation elementN
validate element#2name attributeY
suppressJoinFailure attributeN
variables attributeN
targets elementN
sources elementN
documentation elementN
compensateScope element#2name attributeY
suppressJoinFailure attributeN
target attributeN
targets elementN
sources elementN
documentation elementN
Elements related to the structure activityscope elementname attributeY
suppressJoinFailure attributeN
exitOnStandardFault attributeN
isolated attributeN
targets elementN
sources elementN
documentation elementN
correlationSets elementN
variables elementdocumentation elementN
variable elementname attributeY
messageType attributeY
type attributeY
element attributeN
documentation elementN
From elementN
faultHandlers elementdocumentation elementN
catch elementfaultName attributeN
faultVariable attributeY
faultMessageType attributeN
faultElement attributeN
documentation elementN
activity#1Y
catchall elementdocumentation elementN
activity#1Y
compensationHandler elementN
eventHandlers elementN
terminationHandle elementN
partnerLinks elementN
messageExchanges elementN
activity#1Y
while elementname attributeY
suppressJoinFailure attributeN
targets elementN
sources elementN
documentation elementN
condition elementY
+expressionLanguage attributeN
activity#1Y
if elementname attributeY
suppressJoinFailure attributeN
targets elementN
sources elementN
documentation elementN
condition elementY
+expressionLanguage attributeN
elseif elementdocumentation elementN
condition elementY
activity#1Y
else elementdocumentation elementN
activity#1Y
activity#1Y
flow elementname attributeY
suppressJoinFailure attributeN
targets elementN
sources elementN
documentation elementN
links elementN
activity#1Y
sequence elementname attributeY
suppressJoinFailure attributeN
targets elementN
sources elementN
documentation elementN
activity#1Y
pick element#2name attributeY
suppressJoinFailure attributeN
createInstance attributeN
targets elementN
sources elementN
documentation elementN
onAlarm elementN
onMessage elementN
forEach element#2name attributeY
suppressJoinFailure attributeN
counterName attributeN
parallel attributeN
targets elementN
sources elementN
documentation elementN
startCounterValue elementN
finalCounterValue elementN
completionCondition elementN
scope elementN
repeatUntil element#2name attributeY
suppressJoinFailure attributeN
targets elementN
sources elementN
documentation elementN
condition elementN
Legend:
Y: Supported.
C: Supported, but with restrictions.
N: Not supported.
#1
In reality, elements such as the receive element, the reply element, and the invoke element are entered in activity.
#2
Because this is an unsupported activity, this will be incorporated as an empty activity in which only the name attribute is applied.
#3
In reality, an element expressing the extension activity is entered in anyElementQName. anyAttribute indicates an attribute specific to the extension activity, while any indicates an element specific to the extension activity.

Organization of this subsection
(1) Converting elements related to the overall business process definitions
(2) Converting elements related to the Basic Activity
(3) Converting elements related to the Structure Activity

(1) Converting elements related to the overall business process definitions

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.

(a) process element conversion

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 fileDefinition contents of the business process
Definition contentExplanation
process elementvariables elementVariableFor details, see Appendix E.2(1)(b) variables element conversion.
correlationSets elementCorrelation setFor details about the variables, see Appendix E.2(1)(c) correlationSets element conversion.
faultHandlers elementFault handlingFor details about the variables, see Appendix E.2(1)(d) faultHandlers element conversion.
activity#ActivityConverted to the activity constituting the business process.
--Business process nameThe business process name specified in the dialog box for adding a business process definition is set.
--Business process version1 is set.
--PersistenceThe persistence existence specified in the dialog box for adding a business process definition is set.
Legend:
--: No corresponding element. Either the definition contents are set automatically, or contents specified in the dialog box for adding the business process definition are set.
#
In reality, elements such as the receive element, the reply element, and the invoke element are entered in activity.

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.

(b) variables element conversion

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.

Note
In the Cosminexus Service Platform, the variables defined in the scopes above the scope that contains the fault handler, can be defined as the allocated variables of the activities constituting the fault handler within the scope.
As a result, if the variables present in the same scope element are being used as variables in the elements below the scope/faultHandlers element of the BPEL file, redefine the assigned variables in the business process, after importing.

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 elementDefinition contents of the business process
ItemExplanation
variable elementname attributeVariable nameThe name of the variable is set.
messageType attributeTypeIf 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 attributeTypeThe following variable types are set:
  • For boolean
    boolean is set.
  • For a type# that can be represented by double
    numeric is set.
  • For other than above or when the type is not defined
    string is set.
--Part specificationsValue 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.
Legend:
--: No corresponding element.
#
The following types are applicable:
int, short, byte, unsignedInt, unsignedShort, unsignedByte, float, double

(c) correlationSets element conversion

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.

(d) faultHandlers element conversion

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.

Note
  • If the faultHandlers element is defined immediately below the process element, scope is created in the highest business process, and the faultHandlers element is defined as the fault handler of that scope. In such a case, the activities immediately below the process element moves to the scope that is created.
  • If the faultHandlers element is defined below the scope element, the fault handler is set in the upper scope.

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 elementDefinition contents of the business process
ItemExplanation
catch elementfaultVariable attributeAllocated variableFor details about the variable, also see the notes in Appendix E.2(1)(b) variables element conversion.
activity#ActivityConverted to the activity constituting the business process.
catchall elementactivity#ActivityConverted to the activity constituting the business process.
--Allocated variablecatch-all is set always.
--Transition destinationIf the catch element or catchAll element is defined, the transition destination of the fault handler is set automatically.
Legend:
--: No corresponding element. The definition contents are set automatically.
#
In reality, elements such as the receive element, the reply element, and the invoke element are entered in activity.

(2) Converting elements related to the Basic Activity

Of the elements defined in the BPEL file, the conversion of the elements converted to the Basic Activity is explained below.

(a) receive element conversion

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.

Note
If more than one receive element fulfilling the following conditions is defined, the second receive element onwards will be converted to an empty activity:
  • The portType attribute is the same
  • The operation attribute is the same

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 elementDefinition contents of the business process
ItemExplanation
operation attributeOperation nameIf 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 attributeAllocated variableFor details about the variable, also see the notes in Appendix E.2(1)(b) variables element conversion.
createInstance attributeInstance generationConverted to yes, without any concern with the attribute value.
name attributeActivity nameThe 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 modelSync or Async is set based on the contents of the business process definition.
Legend:
--: No corresponding element. The definition contents are set automatically.

(b) reply element conversion

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 elementDefinition contents of the business process
ItemExplanation
operation attributeOperation nameIf 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 attributeAllocated variableFor details about the variable, also see the notes in Appendix E.2(1)(b) variables element conversion.
faultName attributeFault nameConverted to a local name, if a prefix is attached.
name attributeActivity nameThe 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

[Figure]

(c) invoke element conversion

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 elementDefinition contents of the business process
ItemExplanation
portType attributeService nameConverted only when the corresponding service components and operations exist in the repository. Converted to a local name.
operation attributeOperation nameConverted only when the corresponding service components and operations exist in the repository.
inputVariable attributeRequest message variableSet 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 attributeReply message variableSet 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 attributeActivity nameThe 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 elementfaultVariable attributeAllocated variableAn 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#ActivityConverted to the activity configuring a business process.
catchall elementactivity#ActivityConverted to the activity configuring a business process.
--Allocated variableAn item of the Fault Handler dialog box.
catch-all is set always.
Legend:
--: No corresponding element. The definition contents are set automatically.
#
In reality, elements such as the receive element, the reply element, and the invoke element are entered in activity.

(d) assign element conversion

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 elementDefinition contents of the business process
ItemExplanation
name attributeActivity nameThe 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 elementfrom elementvariable attributeName (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 elementValue (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 elementValue (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 elementvariable attributeVariable 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 elementValue set in the Assign Activity sub dialog box
variable attributeliteral elementquery element
1NNNNo value is set.
2YNNThe value specified in the variable attribute is set in Name in Variable of the Copy source.
3NYNThe value specified in the literal element is set in Value in Expression of the Copy source.
4NNYThe value specified in the query element is set in Value in Expression of the Copy source.
5YYNThe value specified in the variable attribute is set in Name in Variable of the Copy source.
6YNYThe value specified in the query element is set in Value in Expression of the Copy source.
7NYYThe assign element is not converted (an error occurs).
8YYYThe assign element is not converted (an error occurs).
Legend:
Y: Indicates that a value is set.
N: Indicates that no value is set.

(e) empty element conversion

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 elementDefinition contents of the business process
ItemExplanation
name attributeActivity nameThe 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.
(f) throw element conversion

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 elementDefinition contents of the business process
ItemExplanation
faultVariable attributeAllocated variableFor details about the variable, also see the notes in Appendix E.2(1)(b) variables element conversion.
name attributeActivity nameThe 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.
(g) Transforming the wait element

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 elementDefinition contents of the business process
ItemExplanation
name attributeActivity nameThe 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 elementExpressionInformation about the standby interval. Interval becomes ON.
until elementExpressionInformation about the standby time period. Time Period becomes ON.

(3) Converting elements related to the Structure Activity

Of the elements defined in the BPEL file, the conversion of the elements converted to the Basic Activity is explained below.

(a) scope element conversion

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 elementDefinition contents of the business process
ItemExplanation
name attributeActivity nameThe 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 elementVariableInformation about the variables used in scope.
For details about the variables, see Appendix E.2(1)(b) variables element conversion.
correlationSets elementCorrelation setInformation about the correlation sets used in scope.
For details about the correlation set information, see Appendix E.2(1)(c) correlationSets element conversion.
faultHandlers elementFault handlingInformation about the fault handlers used in scope.
For details about the fault handler information, see Appendix E.2(1)(d) faultHandlers element conversion.
activity#ActivityConverted to the activity configuring a business process.
#
In reality, elements such as the receive element, reply element, and invoke element are entered in activity.

(b) while element conversion

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 elementDefinition contents of the business process
ItemExplanation
name attributeActivity nameThe 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 elementCondition ExpressionA value is set in the condition expression of the Condition Setting dialog box.
activity#ActivityConverted to the activity constituting the business process.
--Maximum Loop Count100 is set automatically.
Legend:
--: No corresponding element. The definition contents are set automatically.
#
In reality, elements such as the receive element, the reply element, and the invoke element are entered in activity.

(c) if element conversion

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.

Note
The Switch End Activity is set automatically when the elements below the if element are converted to the Switch Start Activity. In such a case, _end is added to the name of the Switch Start Activity to set the name of the Switch End Activity.

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 elementDefinition contents of the business process
ItemExplanation
name attributeActivity nameThe 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 elementCondition ExpressionA value is set in the condition expression of the Condition Setting dialog box.
activity#ActivityConverted to the activity constituting the business process.
--PriorityAn item of the Switch Activity dialog box.
1 is set at all times.
elseif elementcondition elementCondition ExpressionA value is set in the condition expression of the Condition Setting dialog box.
activity#ActivityConverted to the activity configuring a business process.
--Condition nameAn item of the Switch Activity dialog box.
condition n is set automatically. n indicates a unique integer within switch.
--PriorityAn item of the Switch Activity dialog box.
Set in the order of occurrence starting from 2.
else elementactivity#ActivityConverted to the activity configuring a business process.
--PriorityAn item of the Switch Activity dialog box.
The default value is set.
Legend:
--: No corresponding element. The definition contents are set automatically.
#
In reality, elements such as the receive element, the reply element, and the invoke element are entered in activity.

(d) flow element conversion

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.

Note
  • The link definitions (definitions below the links element in the BPEL file) are not converted.
  • The Flow End Activity is set automatically when the elements below the flow element are converted to the Flow Start Activity. In such a case, _end is added to the name of the Flow Start Activity to set the name of the Flow End Activity.

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 elementDefinition contents of the business process
ItemExplanation
name attributeActivity nameThe 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#ActivityConverted to the activity constituting the business process.
#
In reality, elements such as the receive element, reply element, and invoke element are entered in activity.

(e) sequence element conversion

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.