First, go to the download section and import into IBM Process Designer v751 the *.twx file
named:
- LaptopOrder_-_EditModifyDeliver1 START.twx
Once imported, you will see a new Process Application named ‘BPMN20 Samples’. Select the PA and click on ‘Open in Designer’:
Once open, look at the BPDs (business processes) included in this PA:
There are three processes, and you may or may not have a closer look at
them. You actually might know these processes if you have done the ‘Event Gateway’
sample, or the ‘Monitor your first process’ sample published here in the BPM
wiki:
- LaptopOrder_Deliver: This process cares about the proper delivery of
the laptop once the process named LaptopOrder_EditAndFile completes. The
process is automatically started once the Process named LaptopOrder_EditAndFile
completes after having filed the order
- LaptopOrder_EditAndFile: This is the first process that will be
started once we run the sample. Here a laptop order is specified, and if
positively completed, the order is filed. Filing the order triggers the start
of the process named LaptopOrder_Deliver using the concept of process message
end and process message start events
- LaptopOrder_Modify: This process can be used to enforce a cancellation
or modification of the laptop order specified in the process named
LaptopOrder_EditAndFile, using the Order ID as the correlation key between the
two processes.
Now, before we can exploit the process message end and process message
start events, we have to first create a UCA that deals with the messages, and a
general system service serving as the implementation of the new UCA.
To create the new general system service, select ‘Implementations’ and click on the ‘+’ button next to it:
Click on General System Service to create a new general system service:
In the upcoming dialog, add the name of the new service: Service_TransportOrder
The new generic system services is opened presenting its diagram view. Here select the sequence flow icon and connect the start node with the end node:
When done, switch to the variables tab, click on ‘Add Input’, name the input ‘Order’, and select the ‘Order’ from the list (actually the ‘Order’ data object is hosted in a toolkit) of available variable types.
Repeat this step to specify the output variable the same way. Expand the ‘Order’ variable to see what you’ve added:
Now, save your work.
This is the service that is later be used by the UCA we need for the
process message end and process message start events, which we create now.
Open the process named LaptopOrder_EditAndFile, scroll to its end and select the ‘End’ message which is connected to the task named ‘File Laptop Order’. Look at the properties window, select the ‘Implementation’ tab. On the ‘End Event Details’ drop down list select ‘Message’ as the implementation type:
You may decide to give the process message end event a name to have
others understand when looking at the BPD what message is sent once the process
instance ends.
Once this is selected, you will see that now – for the implementation – a UCA is required:
Now, click on New to create a new UCA.
On the new window, name the UCA ‘UCA_TransportOrder’, and click the Select button to specify the service implementing the UCA:
From the list, select the service we have create a minute ago, named ‘Service_TransportOrder’, then click Finish to complete the implementation of the UCA.
The UCA definitions are opened. You do not have to do anything here, as the UCA is completely specified.
Now, save your work, and go back to the process message end event
implementation tab. You see that the new UCA is used as the implementation of
this event.
Now click on the data mapping tab to specify what data should be given to the UCA:
Select the Order variable used in the service, and therefore used in the UCA:
Once this is done, all is fine from the ‘sending site’.
Now, save your work.
No we have to specify the process message start event at the process named ‘LaptopOrder_Deliver’. Open the process named ‘LaptopOrder_Deliver’, select the start event, and on the Implementation tab select Message, similar to what you’ve done when selecting the message implementation for the process message end event:
Again, we need to specify a UCA. This time we can select the UCA we just created for the process message end event. Click the Select button, and select the UCA named ‘’UCA_TransportMessage’:
Be sure that the flag for message consumption is checked:
Now, click on the data map tab and perform the data mapping, again mapping to the Order variable:
With this, all we need to do is done, and please save your work.
This is it! Move on to the run the sample section to see it in action.