Page Comparison

The Quick Start guide explains how to set up and start the WSO2 BPS, model a BPEL process, deploy and test it using the WSO2 BPS management console. The guide for WSO2 BPS has the following sections:How do I...?

Set up BPS

WSO2 BPS setup is very simple. While more details of the installation can be found in the Getting Started section, this guide provides a basic summary to get you started fast.

1. Ensure that the following are installed in your environment.
   
   • JDK 1.6.* or higher.
   • JAVA_HOME environment variable is set to <JDK_HOME>. For example, JAVA_HOME=c:\Program Files\java\jdk1.6.0_27.
2. Download the BPS binary distribution from http://wso2.com/products/business-process-server/.
3. Extract the zip file to a folder which will be referred to as <PRODUCT_HOME> throughout the rest of this guide.
4. Open a command prompt (or a shell in Linux) and go to the <PRODUCT_HOME>\bin directory.
5. Start the BPS server by executing wso2server.sh (or wso2server.bat in Windows).
6. The operation log keeps running until the server starts, which usually takes several seconds. Wait until the server fully boots up and displays a message similar to "WSO2 Carbon started in n seconds."

Model a BPEL process

1. Download and setup WSO2 Developer Studio. (http://wso2.com/products/developer-studio)
2. Open the Developer Studio and select File > New > Other.
   
3. From the window that appears, select Carbon Application Project and click Next.
   
4. Provide a suitable name to the Carbon application project. For the purposes of this example, name it as "WS_NumberAdderCarbon". Click Finish once done.
   The Carbon application project is created and you can see it on Project Explore pane on the left of your Developer Studio screen.
5. Create a new BPEL project. To do this, right-click on the project which is on the Project Explore pane and choose New > BPEL WorkFlow.
6. On the “Create New BPEL Project” wizard, select Create New BPEL workflow and click Next to continue.
7. Provide suitable names, a namespace and select the matching template for your BPEL process and project. 
8. In this example, we use "BPELNumberAdder" as the project name. Also provide a valid namespace as the process namespace. Since we are creating the synchronous business process, select the template “Synchronous BPEL Process”.
   
   • Process Name : AdderProcess
   • Namespace : http://NumberAdder.com
   • Template : Synchronous BPEL Process
   Image Removed
9. Click Finish to close the wizard.
10. Expand the "WS_NumberAdderCarbon" project folder in the "Project Explore" pane to view another folder named "BPELNumberAdder". The "BPELNumberAdder" project is used here for BPEL process development. The “Project Explorer” window and the AdderProcess.bpel file will look like the following.
    Image Removed
    This point onwards you have to design your BPEL process by adding business logic to the BPEL process. In this guide we will be designing a simple process to add two integers.
11. Open “AdderProcessArtifacts.wsdl” file in BPELNumberAdder Project in order to set input parameters. Click on the arrow next to "Adder Process Request".
    Image Removed
    It will open another tab called “Inline Schema of Add”. By default it will have a single variable named “input” with type string. Rename it as x and set the type to int.
12. You need to add another element. To add another element right-click on "AdderProcessRequestType" and “add an element” after it. Name it "y" and set the "type" as "int". Now it should look like the follwing image.
    Image Removed

13. Now lets design the simple business logic. Open the AdderProcess.bpel file. You need to add business logic in the place of where “FIX_ME-Add_Business_Logic_Here” activity resides. Delete the “FIX_ME-Add_Business_Logic_Here” element. You will have the following process.

    Info
    To delete, right-click on the element and choose delete.

    Image Removed

14. Now you need to add an Assign activity in between “receiveInput” and “callbackClient” activities. To add Assign activity drag it from the Action section of the Action Palette.

    Info
    Another way to add activity element to the editor is right-click on element and use add-before option.

    Image Removed

15. Now you need to configure Assign activity. Click on “Assign” element which is on BPEL process and then click on “Details” tab in ”property window”. 
16. Click on “New” which will lead you to the following view in “property window”
    Image Removed
17. We will use an Xpath expression to compute the addition of two variables and assign the result to the output variable. To do that choose “Expression” from “From” drop down list and choose “Variable” from “To” drop down list.
18. Choose “Xpath 1.0 in BPEL 2.0 ” as Expression Language.
19. The Expression which we need to evaluate is “ $input.payload/tns:x + $input.payload/tns:y ”. Include this in the box below “Expression Language”.
20. Select “result:string” under “To” as the assigned variable.
21. While you configure the variables, The editor will send you a message asking you to initialize the variables. Click Yes. It will automatically generate an XML string for variable initialization. The property window of Assign activity should look like the following once you have completed the steps.
    Image Removed
22. Now you need to define inbound and out bound interfaces. Open the deploy.xml file which is in the BPEL project. Choose AdderProcessPort as the inbound address port from the given list. The rest of the parameters will be automatically filled once you select it. There will not be any ports for outbound interfaces as we do not have external invocations in this business process.
    Image Removed
23. Include the BPEL process as a dependency of the Carbon Application (WS_NumberAdderCarbon). To include it, open “pom.xml” of Carbon application project and select BPELNumberAdder as a dependency. 
    Image Removed

Deploy and test the BPEL process

After modelling the BPEL process, it can be deployed in the WSO2 BPS.

1. In Developer Studio, right-click on the "Servers" window and select New -> Server. If it is not visible, select Window -> Show View -> Servers.
2. The New Server window appears. From the List, expand the WSO2 folder and select WSO2 Carbon 4.0 based server as shown below. Carbon 4.0 based server is selected here since BPS 3.0.0 is based on Carbon 4.0.2. If needed, specify the Server name here. In this example, we specify it as WSO2 BPS. Click Next.
   Image Removed
3. Set the CARBON_HOME by clicking the Browse button and selecting WSO2 Business Process Server home folder. Click Finish once done or Next if more settings of the server need to be configured such as the 'service port', 'web console port' etc.
   Image Removed
4. Once done, WSO2 BPS is added to Servers List as shown below.
   Image Removed
5. The next step is to deploy the carbon application in WSO2 BPS. Simply click on "WS_NumberAdderCarbon" project in "Project Explore" window and drag and drop it on Server.  The server will be automatically started.
6. If the server does not get started automatically, run the server by right-clicking on it and selecting "Start". In Console window, note the server process's log.
7. WSO2 BPS login page will be opened automatically in the default web browser. Login using admin as username and admin as password.
   

8. Select "processes →list" menu from the "Main" menu. The "Deployed Processes" window opens with the "AdderProcess" deployed.

   Info
   The "Process ID" is generated in the format {"Process NameSpace"} ProcessName-VersionNo. Click the Process ID.

   Image Removed

9. The "Process Information" window appears with the details of the process. Click on the "Try It" link. 
   Image Removed
10. A browser window opens to enter the required input parameters. Enter the values and click "Send" for the answer.
    Image Removed

Model a BPMN process

1. Download and setup Eclipse (Recommended Packs - 3.7 - 4.2.1 (Indigo - Juno) or 4.3 (Kepler)).

   Note
   Note: The instructions in this section are verified on Eclipse Kepler and Indigo. Note that Eclipse Helios is NOT supported.

2. Under the Help menu, click Install New Software. In the resulting panel, click the Add button to add a repository and fill in the following fields:
   Image RemovedFill in the following repository details for BPMN.
   
   • Name: Activiti BPMN 2.0 designer
   • Location: http://activiti.org/designer/update/
3. Click OK to add the plugin. Once this is done, click Finish and restart Eclipse.
4. Once Eclipse restarts, navigate to File > New > Other. From the window that appears select Activiti > Activiti Project and click Next. 
   Image Removed

5. Provide a suitable Project Name and click Finish. 

6. Right click on your project and navigate to New > Other.

7. From the window that appears, select Activiti > Activiti Diagram.

8. Select the project in the viewer and enter a File name.

   Image Removed

   Tip

   Tip: The following example expands on creating a business process scenario, The manager invokes an order approval process where it is possible to set the product ID. Additionally, an employee from a good division can set the quantity and the unit price of the product. The quantity and the unit price are used to calculate the total cost. If the total cost is above 100,000, the order will have to be approved by an employee from the the orderApproval Group before the order mail is dispatched. Alternatively, if the cost is below 100,000, the order mail is dispatched without approval. In this example, the process is named “OrderApproval”.

9. Click Finish. You are presented with a canvas as shown below to model your BPMN package.
   Image RemovedThe palette is positioned on the right side of the screen. You can drag and drop models from the palette onto the canvas and do your modelling.
10. To implement the OrderApproval, drag and drop a Start Event element, two User Task elements, a Mail Task element and a Terminate Event element on the canvas.
    Image Removed

11. Link up the flow according to the business logic. 

    Tip
    Tip: According to the business logic in this example, the Start Event should trigger the Fill Order Form User Task. So connect the Start Event to the Fill Order Form User Task.

12. In the Connection tab, select Sequence Flow. Connect the Start Event to the Fill Order Form User Task.

    Tip

    Tip: It is useful to understand the condition logic for this sequence. Here, if the total cost calculated from the quantity and unit price is above 100,000 a user task has to be executed or the mail task comes into play. In order to add this condition statement, click on the Fill Order Form User Task and you will be able to see few tooltips hovering around the Fill Order Form User Task on the canvas. The diamond shape with a cross in the middle implies an Exclusive Gateway.

13. Select the Fill Order Form User Task by clicking on it and click on the Exclusive Gateway tooltip on the right of the tool.
    Image Removed
14. Once you click the Exclusive Gateway, a bigger diamond with a cross in the middle should appear on the canvas next to the Fill Order Form User Task. The Fill Order Form User Task will point to it. 
    Image Removed 
15. The rest of the flow is fairly straightforward. Use the Sequence Flow to connect the tools and the final diagram will be similar to what is shown below.
    Image RemovedAfter the diagram has been constructed, you must configure the properties of each element to fulfil the business logic.

16. Click on the Start Event element and set the following properties in the general tab.

    • Id: fillOrderDetails

    • Name: Enter Order Details

17. In order to get the order details, you must create a form to get the product ID from the manager who invokes the process. Click on the Form tab in the properties of the Start Event.
    Image Removed