{"type":"doc","content":[{"type":"paragraph","content":[{"text":"WSO2 Enterprise Integrator (EI) is a comprehensive solution that brings together application integration, business process management and data integration capabilities, to support modern enterprise integration requirements. ","type":"text"}]},{"type":"paragraph","content":[{"text":"Let's go through the fundamental capabilities of WSO2 EI.","type":"text"}]},{"type":"bodiedExtension","attrs":{"extensionType":"com.atlassian.confluence.macro.core","extensionKey":"localtabgroup","parameters":{"macroParams":{},"macroMetadata":{"macroId":{"value":"b979d1a5-91d3-449a-bf5d-7b4222cd3efa"},"schemaVersion":{"value":"1"},"placeholder":[{"type":"icon","data":{"url":"https://us.navitabs-static-assets.aws.bitvoodoo.cloud/static/4.0.5/images/macro-icon.png"}}],"title":"Tab Group"}}},"content":[{"type":"extension","attrs":{"extensionType":"com.atlassian.confluence.migration","extensionKey":"legacy-content","text":"","parameters":{"nestedContent":{"type":"doc","content":[{"type":"bodiedExtension","attrs":{"extensionType":"com.atlassian.confluence.macro.core","extensionKey":"localtab","parameters":{"macroParams":{"active":{"value":"true"},"title":{"value":"Application Integration"}},"macroMetadata":{"macroId":{"value":"7a7a4c65-78cb-4817-a028-5c0a8456e25c"},"schemaVersion":{"value":"1"},"placeholder":[{"type":"icon","data":{"url":"https://us.navitabs-static-assets.aws.bitvoodoo.cloud/static/4.0.5/images/macro-icon.png"}}],"title":"Tab (Deprecated)"}}},"content":[{"type":"paragraph","content":[{"text":"Let's take a look at a basic application integration use case of WSO2 EI using a sample scenario. ","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Introducing the sample","type":"text"}]},{"type":"paragraph","content":[{"text":"This is a healthcare system in which a user reserves a medical appointment by providing his/her personal details, preferred hospital, doctor's name, credit card information etc. ","type":"text"}]},{"type":"paragraph","content":[{"text":"The Enterprise Integrator processes the user's request and returns an appointment confirmation or a refusal. The following diagram shows how the Enterprise Integrator handles all the service calls and payload manipulations involved in a reservation:","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"align-start","width":1280,"widthType":"pixel"},"content":[{"type":"media","attrs":{"width":1280,"id":"8a67ed3f-66f2-435f-aab9-baacab064b81","collection":"contentId-46728239","type":"file","height":714}}]},{"type":"paragraph","content":[{"text":"Note the following regarding the diagram:","type":"text"}]},{"type":"orderedList","attrs":{"order":1},"content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"When a patient makes a request to reserve an appointment, the request is sent to a REST API that is configured in the Enterprise Integrator. The REST API processes the incoming request and forwards it to the hospital service, which does the appointment reservation.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"The REST API processes the appointment reservation response and sends a service call to the hospital service to get the doctor's channeling fee and receives the response.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"The REST API processes the channeling fee response and sends a service call to the hospital service t o get the user's eligibility for a discount. ","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"When the responses for these service calls are returned, the REST API calculates the actual fee for the appointment and creates a new request with the payment details to be sent to the healthcare service.The healthcare service processes the payment settlement and returns the response to the REST API. ","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"The REST API takes the payment settlement response and generates the response to be sent to the user.","type":"text"}]}]}]},{"type":"paragraph","content":[{"text":"Let's go through the main features of WSO2 EI using this healthcare service as an example.","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Deploying the sample to create mediation artifacts","type":"text"}]},{"type":"paragraph","content":[{"text":"Instead of creating the artifacts that are required to run this sample scenario from scratch, let's deploy them using a Composite Application Archive (CAR) file. The CAR file consists of mediation artifacts such as the REST API, the ","type":"text"},{"text":"endpoints","type":"text","marks":[{"type":"link","attrs":{"href":"https://docs.wso2.com/display/ESB500/Key+Concepts#KeyConcepts-Endpoints"}}]},{"text":" (backend services the requests are sent to), and the ","type":"text"},{"text":"sequences","type":"text","marks":[{"type":"link","attrs":{"href":"https://docs.wso2.com/display/ESB500/Key+Concepts#KeyConcepts-Sequences"}}]},{"text":" (list of mediators) that allow the Enterprise Integrator to process the requests.","type":"text"}]},{"type":"panel","attrs":{"panelType":"success"},"content":[{"type":"paragraph","content":[{"text":"Tip","type":"text","marks":[{"type":"strong"}]},{"text":": For information on how to create all the required Enterprise Integrator artifacts in a composite application project, see the following tutorial: ","type":"text"},{"text":"Sending a Simple Message","type":"text","marks":[{"type":"link","attrs":{"href":"https://wso2docs.atlassian.net/wiki/spaces/EI600/pages/46728243"}}]},{"text":". ","type":"text"}]}]},{"type":"panel","attrs":{"panelType":"success"},"content":[{"type":"paragraph","content":[{"text":"Before you begin","type":"text","marks":[{"type":"strong"}]},{"text":",","type":"text"}]},{"type":"orderedList","attrs":{"order":1},"content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Install Oracle Java SE Development Kit (JDK) version 1.8.* and set the JAVA_HOME environment variable.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Download the WSO2 EI ZIP file from ","type":"text"},{"text":"here","type":"text","marks":[{"type":"link","attrs":{"href":"http://wso2.com/integration/"}}]},{"text":", and then extract the ZIP file. ","type":"text"},{"type":"hardBreak"},{"text":"The path to this folder will be referred to as ","type":"text"},{"text":"","type":"text","marks":[{"type":"code"}]},{"text":" throughout this quick start guide.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Download ","type":"text"},{"text":"WSO2QuickStartGuideCapp_1.0.0.car","type":"text","marks":[{"type":"code"}]},{"text":" from ","type":"text"},{"text":"here","type":"text","marks":[{"type":"link","attrs":{"href":"https://github.com/wso2-docs/ESB/blob/master/ESB-Artifacts/QuickStartGuide/artifacts/WSO2QuickStartGuideCapp_1.0.0.car"}}]},{"text":" and save it in a preferred location in your computer.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"If you are running on Windows, download the ","type":"text"},{"text":"snappy-java_1.1.1.7.jar","type":"text","marks":[{"type":"code"}]},{"text":" from ","type":"text"},{"text":"here","type":"text","marks":[{"type":"link","attrs":{"href":"http://mvnrepository.com/artifact/org.xerial.snappy/snappy-java/1.1.1.7"}}]},{"text":" and copy the JAR file to ","type":"text"},{"text":"\\lib","type":"text","marks":[{"type":"code"}]},{"text":" directory.","type":"text"}]}]}]}]},{"type":"paragraph","content":[{"text":"Let's get started!","type":"text"}]},{"type":"paragraph","content":[{"text":"Follow the steps below to deploy the healthcare sample:","type":"text"}]},{"type":"orderedList","attrs":{"order":1},"content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Set the following properties in the ","type":"text"},{"text":"/conf/synapse.properties","type":"text","marks":[{"type":"code"}]},{"text":" file to ","type":"text"},{"text":"true","type":"text","marks":[{"type":"code"}]},{"text":" so that the Enterprise Integrator can publish mediation statistics:","type":"text"}]},{"type":"codeBlock","attrs":{"language":"xml"},"content":[{"text":"...\nmediation.flow.statistics.enable=true\nmediation.flow.statistics.tracer.collect.payloads=true\nmediation.flow.statistics.tracer.collect.properties=true\n...","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Open a command line terminal and start the Analytics runtime that is shipped with your EI distribution by running one of the following startup scripts from the ","type":"text"},{"text":"/wso2/analytics/bin","type":"text","marks":[{"type":"code"}]},{"text":" directory:","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"On Linux/Mac OS: ","type":"text"},{"text":"sh wso2server.sh","type":"text","marks":[{"type":"code"}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"On Windows: ","type":"text"},{"text":"wso2server.bat","type":"text","marks":[{"type":"code"}]}]}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Open a new command line terminal and start WSO2 EI by running one of the following startup scripts from the ","type":"text"},{"text":"/bin","type":"text","marks":[{"type":"code"}]},{"text":" directory( ","type":"text"},{"text":"Be sure you have successfully started the Analytics server before taking this step","type":"text","marks":[{"type":"strong"}]},{"text":" .):","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"On Linux/Mac OS: ","type":"text"},{"text":"sh integrator.sh","type":"text","marks":[{"type":"code"}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"On Windows: ","type":"text"},{"text":"integrator.bat","type":"text","marks":[{"type":"code"}]}]}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Open the Enterprise Integrator management console using ","type":"text"},{"text":"https://localhost:9443/carbon/","type":"text","marks":[{"type":"link","attrs":{"href":"https://localhost:9443/carbon/"}}]},{"text":" and log in using ","type":"text"},{"text":"admin","type":"text","marks":[{"type":"code"}]},{"text":" as the username as well as the password.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Deploy ","type":"text"},{"text":"WSO2QuickStartGuideCapp_1.0.0.car","type":"text","marks":[{"type":"code"}]},{"text":" in the Enterprise Integrator as follows:","type":"text"}]},{"type":"panel","attrs":{"panelType":"success"},"content":[{"type":"paragraph","content":[{"text":"Tip:","type":"text","marks":[{"type":"strong"}]},{"text":" The CAR file was created using ","type":"text"},{"text":"tooling","type":"text","marks":[{"type":"link","attrs":{"href":"http://wso2.com/products/enterprise-service-bus/#tools"}}]},{"text":". Find more information on Enterprise Integrator tooling from ","type":"text"},{"text":"WSO2 Enterprise Integrator Tooling","type":"text","marks":[{"type":"link","attrs":{"href":"https://wso2docs.atlassian.net/wiki/spaces/EI600/pages/46728183"}}]},{"text":".","type":"text"}]}]},{"type":"orderedList","attrs":{"order":1},"content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"On the ","type":"text"},{"text":"Main","type":"text","marks":[{"type":"strong"}]},{"text":" tab of the management console, go to ","type":"text"},{"text":"Manage","type":"text","marks":[{"type":"strong"}]},{"text":" -> ","type":"text"},{"text":"Carbon Applications","type":"text","marks":[{"type":"strong"}]},{"text":" and click ","type":"text"},{"text":"Add","type":"text","marks":[{"type":"strong"}]},{"text":". ","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Click ","type":"text"},{"text":"Choose File","type":"text","marks":[{"type":"strong"}]},{"text":", select the ","type":"text"},{"text":"WSO2QuickStartGuideCapp_1.0.0.car ","type":"text","marks":[{"type":"code"}]},{"text":"file you downloaded in the ","type":"text"},{"text":"Before you begin...","type":"text","marks":[{"type":"strong"}]},{"text":" section above, and click ","type":"text"},{"text":"Upload","type":"text","marks":[{"type":"strong"}]},{"text":". ","type":"text"}]},{"type":"panel","attrs":{"panelType":"info"},"content":[{"type":"paragraph","content":[{"text":"Note","type":"text","marks":[{"type":"strong"}]}]},{"type":"paragraph","content":[{"text":"After you upload a CAR file, you can confirm that it was successfully deployed by taking the following step:","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"On the ","type":"text"},{"text":"Main","type":"text","marks":[{"type":"strong"}]},{"text":" tab of the management console, go to ","type":"text"},{"text":"Manage","type":"text","marks":[{"type":"strong"}]},{"text":" -> ","type":"text"},{"text":"Carbon Applications","type":"text","marks":[{"type":"strong"}]},{"text":" and click ","type":"text"},{"text":"List","type":"text","marks":[{"type":"strong"}]},{"text":". The ","type":"text"},{"text":"Carbon Applications List","type":"text","marks":[{"type":"strong"}]},{"text":" screen appears. If successfully deployed, the CAR file will be listed here.","type":"text"}]}]}]}]}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Follow the steps below to enable statistics and tracing for the REST API:","type":"text"}]},{"type":"orderedList","attrs":{"order":1},"content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"On the ","type":"text"},{"text":"Main","type":"text","marks":[{"type":"strong"}]},{"text":" tab of the management console, go to ","type":"text"},{"text":"Manage","type":"text","marks":[{"type":"strong"}]},{"text":" -> ","type":"text"},{"text":"Service Bus","type":"text","marks":[{"type":"strong"}]},{"text":" and click ","type":"text"},{"text":"APIs","type":"text","marks":[{"type":"strong"}]},{"text":". The ","type":"text"},{"text":"Deployed APIs","type":"text","marks":[{"type":"strong"}]},{"text":" screen appears, and you will see the ","type":"text"},{"text":"HospitalServiceApi","type":"text","marks":[{"type":"code"}]},{"text":" listed as follows:","type":"text"},{"type":"hardBreak"},{"text":" ","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"align-start","width":1067,"widthType":"pixel"},"content":[{"type":"media","attrs":{"width":1067,"id":"8bdf09d5-d91c-47f6-8d11-69ab65b8fca9","collection":"contentId-46728239","type":"file","height":321}}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"To enable the collection of mediation statistics for the REST API, click ","type":"text"},{"text":"Enable Statistics","type":"text","marks":[{"type":"strong"}]},{"text":".","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"To enable mediation tracing for the REST API, click ","type":"text"},{"text":"Enable Tracing","type":"text","marks":[{"type":"strong"}]},{"text":".","type":"text"}]}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Follow the steps below to enable statistics for the endpoints:","type":"text"}]},{"type":"orderedList","attrs":{"order":1},"content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"On the ","type":"text"},{"text":"Main","type":"text","marks":[{"type":"strong"}]},{"text":" tab of the management console, go to ","type":"text"},{"text":"Manage -> Service Bus","type":"text","marks":[{"type":"strong"}]},{"text":", and click ","type":"text"},{"text":"Endpoints","type":"text","marks":[{"type":"strong"}]},{"text":". The ","type":"text"},{"text":"Manage Endpoints","type":"text","marks":[{"type":"strong"}]},{"text":" screen appears, and you will see several endpoints listed.","type":"text"},{"type":"hardBreak"},{"text":" ","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"align-start","width":1040,"widthType":"pixel"},"content":[{"type":"media","attrs":{"width":1040,"id":"1226a5cc-be99-4e44-8235-bca677da5167","collection":"contentId-46728239","type":"file","height":461}}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"To enable the collection of mediation statistics for the endpoints, click ","type":"text"},{"text":"Enable Statistics ","type":"text","marks":[{"type":"strong"}]},{"text":"for each endpoint.","type":"text"}]}]}]}]}]},{"type":"paragraph","content":[{"text":"You have now created mediation artifacts in the Enterprise Integrator and enabled statistics. Let's send a request to the Enterprise Integrator.","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"type":"inlineExtension","attrs":{"extensionType":"com.atlassian.confluence.macro.core","extensionKey":"anchor","parameters":{"macroParams":{"":{"value":"runScenario"},"legacyAnchorId":{"value":"QuickStartGuide-runScenario"}},"macroMetadata":{"macroId":{"value":"f997ea3a-c101-41c7-8b97-b1121aad86c9"},"schemaVersion":{"value":"1"},"title":"Anchor"}}}},{"text":"Sending a request to the Enterprise Integrator","type":"text"}]},{"type":"orderedList","attrs":{"order":1},"content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Create a JSON file named ","type":"text"},{"text":"reserve_appointment.json","type":"text","marks":[{"type":"code"}]},{"text":" with the following request:","type":"text"}]},{"type":"codeBlock","content":[{"text":"{\n\"reserveRequest\": {\n\"patientDetails\": {\n\"name\": \"Mark Smith\",\n\"dob\": \"1990-03-19\",\n\"ssn\": \"ASJK-asnda-AAA\",\n\"address\": \"100 MAIN ST, SEATTLE WA 98104, USA\",\n\"phone\": \"0770596754\",\n\"email\": \"marksm@mymail.com\"},\n\"doctor\": \"thomas collins\",\n\"hospital\": \"grand oak community hospital\",\n\"category\": \"surgery\",\n\"cardNo\": \"7844481124110331\"\n}\n}","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"In a new terminal, navigate to the location where you saved the ","type":"text"},{"text":"reserve_appointment.json","type":"text","marks":[{"type":"code"}]},{"text":" file and execute the following command:","type":"text"}]},{"type":"codeBlock","content":[{"text":"curl -v -X POST \"http://localhost:8280/hospitalservice/reserve\" --header \"Content-Type: application/json\" -d @reserve_appointment.json -k -v","type":"text"}]},{"type":"paragraph","content":[{"text":"This sends an appointment request to the REST API, which is the configuration inside the Enterprise Integrator that receives and processes the request. Once all the message flows take place as described in the sample introduction, you will see a response similar to the following on the console:","type":"text"}]},{"type":"codeBlock","attrs":{"language":"xml"},"content":[{"text":"{\n \"appointmentNumber\": 1,\n \"Doctor\": {\n \"fee\": 7000,\n \"name\": \"thomas collins\",\n \"availability\": \"9.00 a.m - 11.00 a.m\",\n \"hospital\": \"grand oak community hospital\",\n \"category\": \"surgery\"\n },\n \"Payment\": {\n \"patient\": \"Mark Smith\",\n \"actualFee\": 7000,\n \"discount\": 0,\n \"discounted\": 7000,\n \"paymentID\": \"c5edddf3-d7d7-4756-8a03-5e8e31f2e716\",\n \"status\": \"Settled\"\n }\n} ","type":"text"}]}]}]},{"type":"paragraph","content":[{"text":"When you receive the response for the request that you sent, you can view the mediation statistics related to the processing that happens within WSO2 EI via WSO2 EI Analytics.","type":"text"}]},{"type":"paragraph","content":[{"text":"Now let's have a look at how you can view the mediation statistics on the ","type":"text"},{"text":"Analytics Dashboard","type":"text","marks":[{"type":"strong"}]},{"text":" of WSO2 EI Analytics.","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Analyzing the mediation statistics","type":"text"}]},{"type":"orderedList","attrs":{"order":1},"content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"In a new browser window or tab, open ","type":"text"},{"text":"https://localhost:9444/carbon/","type":"text","marks":[{"type":"link","attrs":{"href":"https://localhost:9444/carbon/"}}]},{"text":" and log into the Analytics management console using ","type":"text"},{"text":"admin","type":"text","marks":[{"type":"code"}]},{"text":" as the username as well as the password.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"On the ","type":"text"},{"text":"Main","type":"text","marks":[{"type":"strong"}]},{"text":" tab, click ","type":"text"},{"text":"Analytics Dashboard","type":"text","marks":[{"type":"strong"}]},{"text":" and log in using ","type":"text"},{"text":"admin","type":"text","marks":[{"type":"code"}]},{"text":" as the username as well as the password. You will then see the following:","type":"text"},{"type":"hardBreak"},{"text":" ","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"align-start","width":328,"widthType":"pixel"},"content":[{"type":"media","attrs":{"width":328,"id":"6b0954bc-208d-4719-a0e9-6e50d47d8561","collection":"contentId-46728239","type":"file","height":126}}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Click ","type":"text"},{"text":"View","type":"text","marks":[{"type":"strong"}]},{"text":" to open the EI Analytics Dashboard. You will see an ","type":"text"},{"text":"OVERVIEW","type":"text","marks":[{"type":"strong"}]},{"text":" page similar to the following:","type":"text"}]},{"type":"panel","attrs":{"panelType":"info"},"content":[{"type":"paragraph","content":[{"text":"Note","type":"text","marks":[{"type":"strong"}]}]},{"type":"paragraph","content":[{"text":"The statistics you see will be for the number of requests that you have sent. If you follow the steps in the ","type":"text"},{"text":"Sending a request to the EI","type":"text","marks":[{"type":"link","attrs":{"href":"#QuickStartGuide-runScenario"}}]},{"text":" section, and send just one request, you will see the statistics for just that request.","type":"text"}]}]},{"type":"mediaSingle","attrs":{"layout":"align-start","width":1280,"widthType":"pixel"},"content":[{"type":"media","attrs":{"width":1280,"id":"d66545f5-f5f2-4164-b2f0-a590f7e0eb18","collection":"contentId-46728239","type":"file","height":534}}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"To view statistics for a specific date range, select the required date range from the top right menu bar. If you want to view statistics for a specific date, click ","type":"text"},{"text":"Custom","type":"text","marks":[{"type":"strong"}]},{"text":" in the menu bar and enter the required date. For more information on analyzing the statistics displayed on this page, see ","type":"text"},{"text":"Analyzing EI Statistics Overview","type":"text","marks":[{"type":"link","attrs":{"href":"https://wso2docs.atlassian.net/wiki/spaces/EI600/pages/46728035"}}]},{"text":".","type":"text"}]}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"To view statistics for the REST API, click ","type":"text"},{"text":"API","type":"text","marks":[{"type":"strong"}]},{"text":" on the left navigator and search for ","type":"text"},{"text":"HospitalServiceApi","type":"text","marks":[{"type":"code"}]},{"text":" . For more information on analyzing statistics displayed on this page, see ","type":"text"},{"text":"Analytics Statistics for REST APIs","type":"text","marks":[{"type":"link","attrs":{"href":"https://wso2docs.atlassian.net/wiki/spaces/EI600/pages/46728023"}}]},{"text":".","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"To view statistics for an endpoint, click ","type":"text"},{"text":"ENDPOINT ","type":"text","marks":[{"type":"strong"}]},{"text":"on the left navigator and search for the required endpoint. You can view statistics for the following endpoints on this page:","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"reserveAppointmentEp","type":"text","marks":[{"type":"code"}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"discountEligibility","type":"text","marks":[{"type":"code"}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"channellingFee","type":"text","marks":[{"type":"code"}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"settlePayment","type":"text","marks":[{"type":"code"}]}]}]}]},{"type":"paragraph","content":[{"text":" For more information on analyzing statistics displayed on this page, see ","type":"text"},{"text":"Analyzing Statistics for Endpoints","type":"text","marks":[{"type":"link","attrs":{"href":"https://wso2docs.atlassian.net/wiki/spaces/EI600/pages/46728031"}}]},{"text":".","type":"text"}]}]}]},{"type":"bodiedExtension","attrs":{"extensionType":"com.atlassian.confluence.macro.core","extensionKey":"excerpt","parameters":{"macroParams":{"hidden":{"value":"true"},"atlassian-macro-output-type":{"value":"INLINE"}},"macroMetadata":{"macroId":{"value":"bfbd99a4-4de1-4bd6-b10a-7966b1262110"},"schemaVersion":{"value":"1"},"title":"Excerpt"}}},"content":[{"type":"paragraph","content":[{"text":"Where to go next","type":"text"}]},{"type":"paragraph","content":[{"text":"You have now explored the basics of application integration using WSO2 EI and are ready to get started creating your own EI artifacts. Next, you can have a look at the lessons in the ","type":"text"},{"text":"Integration Tutorials","type":"text","marks":[{"type":"link","attrs":{"href":"https://wso2docs.atlassian.net/wiki/spaces/EI600/pages/46728241"}}]},{"text":" section, to understand more about some of the most common usage scenarios of WSO2 EI, how to use WSO2 EI Tooling to create your artifacts, and how to use WSO2 EI Analytics to publish statistics related to the processing carried out in WSO2 EI to the Analytics Dashboard.","type":"text"}]},{"type":"paragraph","content":[{"text":"For information on the various integration patterns you can implement, see ","type":"text"},{"text":"Enterprise Integration Patterns","type":"text","marks":[{"type":"link","attrs":{"href":"https://docs.wso2.com/display/EIP/Enterprise+Integration+Patterns+with+WSO2+Enterprise+Integrator"}}]},{"text":".","type":"text"}]}]}]}],"version":1},"cxhtml":"trueApplication Integration

Let's take a look at a basic application integration use case of WSO2 EI using a sample scenario.

Introducing the sample

This is a healthcare system in which a user reserves a medical appointment by providing his/her personal details, preferred hospital, doctor's name, credit card information etc.

The Enterprise Integrator processes the user's request and returns an appointment confirmation or a refusal. The following diagram shows how the Enterprise Integrator handles all the service calls and payload manipulations involved in a reservation:

Note the following regarding the diagram:

When a patient makes a request to reserve an appointment, the request is sent to a REST API that is configured in the Enterprise Integrator. The REST API processes the incoming request and forwards it to the hospital service, which does the appointment reservation.
The REST API processes the appointment reservation response and sends a service call to the hospital service to get the doctor's channeling fee and receives the response.
The REST API processes the channeling fee response and sends a service call to the hospital service t o get the user's eligibility for a discount.
When the responses for these service calls are returned, the REST API calculates the actual fee for the appointment and creates a new request with the payment details to be sent to the healthcare service.The healthcare service processes the payment settlement and returns the response to the REST API.
The REST API takes the payment settlement response and generates the response to be sent to the user.

Let's go through the main features of WSO2 EI using this healthcare service as an example.

Deploying the sample to create mediation artifacts

Instead of creating the artifacts that are required to run this sample scenario from scratch, let's deploy them using a Composite Application Archive (CAR) file. The CAR file consists of mediation artifacts such as the REST API, the endpoints (backend services the requests are sent to), and the sequences (list of mediators) that allow the Enterprise Integrator to process the requests.

Tip: For information on how to create all the required Enterprise Integrator artifacts in a composite application project, see the following tutorial: .

Before you begin,

Install Oracle Java SE Development Kit (JDK) version 1.8.* and set the JAVA_HOME environment variable.
Download the WSO2 EI ZIP file from here, and then extract the ZIP file.
The path to this folder will be referred to as <EI_HOME> throughout this quick start guide.
Download WSO2QuickStartGuideCapp_1.0.0.car from here and save it in a preferred location in your computer.
If you are running on Windows, download the snappy-java_1.1.1.7.jar from here and copy the JAR file to <EI_HOME>\\lib directory.

Let's get started!

Follow the steps below to deploy the healthcare sample:

Set the following properties in the <EI_HOME>/conf/synapse.properties file to true so that the Enterprise Integrator can publish mediation statistics:
xml
Open a command line terminal and start the Analytics runtime that is shipped with your EI distribution by running one of the following startup scripts from the <EI_HOME>/wso2/analytics/bin directory:
- On Linux/Mac OS: sh wso2server.sh
- On Windows: wso2server.bat
Open a new command line terminal and start WSO2 EI by running one of the following startup scripts from the <EI_HOME>/bin directory( Be sure you have successfully started the Analytics server before taking this step .):
- On Linux/Mac OS: sh integrator.sh
- On Windows: integrator.bat
Open the Enterprise Integrator management console using https://localhost:9443/carbon/ and log in using admin as the username as well as the password.
Deploy WSO2QuickStartGuideCapp_1.0.0.car in the Enterprise Integrator as follows:
Tip: The CAR file was created using tooling. Find more information on Enterprise Integrator tooling from .
1. On the Main tab of the management console, go to Manage -> Carbon Applications and click Add.
2. Click Choose File, select the WSO2QuickStartGuideCapp_1.0.0.car file you downloaded in the Before you begin... section above, and click Upload.
  Note
  After you upload a CAR file, you can confirm that it was successfully deployed by taking the following step:
  - On the Main tab of the management console, go to Manage -> Carbon Applications and click List. The Carbon Applications List screen appears. If successfully deployed, the CAR file will be listed here.
Follow the steps below to enable statistics and tracing for the REST API:
1. On the Main tab of the management console, go to Manage -> Service Bus and click APIs. The Deployed APIs screen appears, and you will see the HospitalServiceApi listed as follows:
2. To enable the collection of mediation statistics for the REST API, click Enable Statistics.
3. To enable mediation tracing for the REST API, click Enable Tracing.
Follow the steps below to enable statistics for the endpoints:
1. On the Main tab of the management console, go to Manage -> Service Bus, and click Endpoints. The Manage Endpoints screen appears, and you will see several endpoints listed.
2. To enable the collection of mediation statistics for the endpoints, click Enable Statistics for each endpoint.

You have now created mediation artifacts in the Enterprise Integrator and enabled statistics. Let's send a request to the Enterprise Integrator.

runScenarioSending a request to the Enterprise Integrator

Create a JSON file named reserve_appointment.json with the following request:
In a new terminal, navigate to the location where you saved the reserve_appointment.json file and execute the following command:
This sends an appointment request to the REST API, which is the configuration inside the Enterprise Integrator that receives and processes the request. Once all the message flows take place as described in the sample introduction, you will see a response similar to the following on the console:
xml

When you receive the response for the request that you sent, you can view the mediation statistics related to the processing that happens within WSO2 EI via WSO2 EI Analytics.

Now let's have a look at how you can view the mediation statistics on the Analytics Dashboard of WSO2 EI Analytics.

Analyzing the mediation statistics

In a new browser window or tab, open https://localhost:9444/carbon/ and log into the Analytics management console using admin as the username as well as the password.
On the Main tab, click Analytics Dashboard and log in using admin as the username as well as the password. You will then see the following:
Click View to open the EI Analytics Dashboard. You will see an OVERVIEW page similar to the following:
Note
The statistics you see will be for the number of requests that you have sent. If you follow the steps in the section, and send just one request, you will see the statistics for just that request.
- To view statistics for a specific date range, select the required date range from the top right menu bar. If you want to view statistics for a specific date, click Custom in the menu bar and enter the required date. For more information on analyzing the statistics displayed on this page, see .
To view statistics for the REST API, click API on the left navigator and search for HospitalServiceApi . For more information on analyzing statistics displayed on this page, see .
To view statistics for an endpoint, click ENDPOINT on the left navigator and search for the required endpoint. You can view statistics for the following endpoints on this page:
- reserveAppointmentEp
- discountEligibility
- channellingFee
- settlePayment
For more information on analyzing statistics displayed on this page, see .

trueINLINE

Where to go next

You have now explored the basics of application integration using WSO2 EI and are ready to get started creating your own EI artifacts. Next, you can have a look at the lessons in the section, to understand more about some of the most common usage scenarios of WSO2 EI, how to use WSO2 EI Tooling to create your artifacts, and how to use WSO2 EI Analytics to publish statistics related to the processing carried out in WSO2 EI to the Analytics Dashboard.

For information on the various integration patterns you can implement, see Enterprise Integration Patterns.

"}}},{"type":"extension","attrs":{"extensionType":"com.atlassian.confluence.migration","extensionKey":"legacy-content","text":"","parameters":{"nestedContent":{"type":"doc","content":[{"type":"bodiedExtension","attrs":{"extensionType":"com.atlassian.confluence.macro.core","extensionKey":"localtab","parameters":{"macroParams":{"title":{"value":"Business Process Management"}},"macroMetadata":{"macroId":{"value":"82b5e697-ff24-4411-8e26-793f54b01410"},"schemaVersion":{"value":"1"},"placeholder":[{"type":"icon","data":{"url":"https://us.navitabs-static-assets.aws.bitvoodoo.cloud/static/4.0.5/images/macro-icon.png"}}],"title":"Tab (Deprecated)"}}},"content":[{"type":"paragraph","content":[{"text":"Let's take a look at how to model a business process using either the BPMN 2.0 standard or the WS-BPEL 2.0 standard.","type":"text"}]},{"type":"panel","attrs":{"panelType":"success"},"content":[{"type":"paragraph","content":[{"text":"Before you begin","type":"text","marks":[{"type":"strong"}]},{"text":",","type":"text"}]},{"type":"orderedList","attrs":{"order":1},"content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Install Oracle Java SE Development Kit (JDK) version 1.8.* and set the JAVA_HOME environment variable.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Download the WSO2 EI ZIP file from ","type":"text"},{"text":"here","type":"text","marks":[{"type":"link","attrs":{"href":"http://wso2.com/integration/"}}]},{"text":", and then extract the ZIP file. ","type":"text"},{"type":"hardBreak"},{"text":"The path to this folder will be referred to as ","type":"text"},{"text":"","type":"text","marks":[{"type":"code"}]},{"text":" throughout this quick start guide.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Download and ","type":"text"},{"text":"setup EI Tooling","type":"text","marks":[{"type":"link","attrs":{"href":"https://wso2docs.atlassian.net/wiki/spaces/EI600/pages/46728185"}}]},{"text":". ","type":"text"}]}]}]}]},{"type":"paragraph","content":[{"type":"hardBreak"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Setting up EI Business Process","type":"text"}]},{"type":"orderedList","attrs":{"order":1},"content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Open a command prompt (or a shell in Linux) and go to the ","type":"text"},{"text":"\\wso2\\business-process\\bin","type":"text","marks":[{"type":"code"}]},{"text":" directory.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Execute one of the following:","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"On Linux/Mac OS: ","type":"text"},{"text":"sh wso2server.sh","type":"text","marks":[{"type":"code"}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"On Windows: ","type":"text"},{"text":"wso2server.bat","type":"text","marks":[{"type":"code"}]}]}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"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 \"","type":"text"},{"text":"WSO2 Carbon started in n seconds.","type":"text","marks":[{"type":"em"}]},{"text":"\"","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Download and setup EI Tooling. ","type":"text"}]}]}]},{"type":"paragraph","content":[{"text":"Go to the required tab for step by step instructions to model a business process.","type":"text"}]},{"type":"bodiedExtension","attrs":{"extensionType":"com.atlassian.confluence.macro.core","extensionKey":"localtabgroup","parameters":{"macroParams":{},"macroMetadata":{"macroId":{"value":"5649e9fd-5ae1-429d-80a1-dfef41aa77fb"},"schemaVersion":{"value":"1"},"placeholder":[{"type":"icon","data":{"url":"https://us.navitabs-static-assets.aws.bitvoodoo.cloud/static/4.0.5/images/macro-icon.png"}}],"title":"Tab Group"}}},"content":[{"type":"bodiedExtension","attrs":{"extensionType":"com.atlassian.confluence.macro.core","extensionKey":"localtab","parameters":{"macroParams":{"title":{"value":"Modeling a BPMN process"}},"macroMetadata":{"macroId":{"value":"51610574-34cc-470e-b159-503f23a417bc"},"schemaVersion":{"value":"1"},"placeholder":[{"type":"icon","data":{"url":"https://us.navitabs-static-assets.aws.bitvoodoo.cloud/static/4.0.5/images/macro-icon.png"}}],"title":"Tab (Deprecated)"}}},"content":[{"type":"paragraph","content":[{"text":"Follow the steps below to model a BPMN process.","type":"text"}]},{"type":"orderedList","attrs":{"order":1},"content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Open Eclipse.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Under the ","type":"text"},{"text":"Help","type":"text","marks":[{"type":"strong"}]},{"text":" menu, click ","type":"text"},{"text":"Install New Software","type":"text","marks":[{"type":"strong"}]},{"text":". In the resulting panel, click the ","type":"text"},{"text":"Add","type":"text","marks":[{"type":"strong"}]},{"text":" button to add a repository and fill in the following fields:","type":"text"},{"type":"hardBreak"},{"text":" ","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"align-start","width":416,"widthType":"pixel"},"content":[{"type":"media","attrs":{"width":416,"id":"0002772b-b49d-4a2a-bb91-6fededf74ab1","collection":"contentId-32211362","type":"file","height":149}}]},{"type":"paragraph","content":[{"type":"hardBreak"},{"text":"Fill in the following repository details for BPMN.","type":"text"},{"type":"hardBreak"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Name","type":"text","marks":[{"type":"strong"}]},{"text":": Activiti BPMN 2.0 designer","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Location","type":"text","marks":[{"type":"strong"}]},{"text":": ","type":"text"},{"text":"http://activiti.org/designer/update/","type":"text","marks":[{"type":"link","attrs":{"href":"http://activiti.org/designer/update/"}}]}]}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Click ","type":"text"},{"text":"OK","type":"text","marks":[{"type":"strong"}]},{"text":" to add the plugin. Once this is done, click ","type":"text"},{"text":"Finish","type":"text","marks":[{"type":"strong"}]},{"text":" and restart Eclipse.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Once Eclipse restarts, navigate to ","type":"text"},{"text":"File","type":"text","marks":[{"type":"strong"}]},{"text":" > ","type":"text"},{"text":"New","type":"text","marks":[{"type":"strong"}]},{"text":" > ","type":"text"},{"text":"Other","type":"text","marks":[{"type":"strong"}]},{"text":". From the window that appears select ","type":"text"},{"text":"Activiti","type":"text","marks":[{"type":"strong"}]},{"text":" > ","type":"text"},{"text":"Activiti Project","type":"text","marks":[{"type":"strong"}]},{"text":" and click ","type":"text"},{"text":"Next","type":"text","marks":[{"type":"strong"}]},{"text":". ","type":"text"},{"type":"hardBreak"},{"text":" ","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"align-start","width":318,"widthType":"pixel"},"content":[{"type":"media","attrs":{"width":318,"id":"990a131c-5921-46e0-92a3-c945472e5139","collection":"contentId-32211362","type":"file","height":256}}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Provide a suitable ","type":"text"},{"text":"Project Name","type":"text","marks":[{"type":"strong"}]},{"text":" and click ","type":"text"},{"text":"Finish","type":"text","marks":[{"type":"strong"}]},{"text":". ","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Right-click on your project and navigate to ","type":"text"},{"text":"New","type":"text","marks":[{"type":"strong"}]},{"text":" > ","type":"text"},{"text":"Other","type":"text","marks":[{"type":"strong"}]},{"text":".","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"From the window that appears, select ","type":"text"},{"text":"Activiti","type":"text","marks":[{"type":"strong"}]},{"text":" > ","type":"text"},{"text":"Activiti Diagram","type":"text","marks":[{"type":"strong"}]},{"text":".","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Select the project in the viewer and enter a ","type":"text"},{"text":"File name.","type":"text","marks":[{"type":"strong"}]},{"type":"hardBreak"},{"text":" ","type":"text","marks":[{"type":"strong"}]},{"type":"inlineExtension","attrs":{"extensionType":"com.atlassian.confluence.migration","extensionKey":"inline-media-image","parameters":{"width":"","id":"a55cce68-25d1-432f-b687-5857c6cd628f","collection":"contentId-32211362","height":""}}},{"text":" ","type":"text","marks":[{"type":"strong"}]}]},{"type":"panel","attrs":{"panelType":"success"},"content":[{"type":"paragraph","content":[{"text":"Tip","type":"text","marks":[{"type":"strong"}]},{"text":": 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 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”.","type":"text"}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Click ","type":"text"},{"text":"Finish","type":"text","marks":[{"type":"strong"}]},{"text":". You are presented with a canvas as shown below to model your BPMN package.","type":"text"},{"type":"hardBreak"},{"text":" ","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"align-start","width":601,"widthType":"pixel"},"content":[{"type":"media","attrs":{"width":601,"id":"e0184b87-947d-4aeb-97c2-48f5cf2cec65","collection":"contentId-32211362","type":"file","height":344}}]},{"type":"paragraph","content":[{"type":"hardBreak"},{"text":"The palette is positioned on the right side of the screen. You can drag and drop models from the palette onto the canvas and do yourmodelling.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"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.","type":"text"},{"type":"hardBreak"},{"text":" ","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"align-start","width":395,"widthType":"pixel"},"content":[{"type":"media","attrs":{"width":395,"id":"7bca7c6c-715f-41a4-88ac-0b6e6b38e8e0","collection":"contentId-32211362","type":"file","height":136}}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Link up the flow according to the business logic. ","type":"text"}]},{"type":"panel","attrs":{"panelType":"success"},"content":[{"type":"paragraph","content":[{"text":"Tip","type":"text","marks":[{"type":"strong"}]},{"text":": According to the business logic in this example, the Start Event should trigger the ","type":"text"},{"text":"Fill Order Form","type":"text","marks":[{"type":"strong"}]},{"text":" User Task. So connect the Start Event to the Fill Order Form User Task.","type":"text"}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"In the ","type":"text"},{"text":"Connection","type":"text","marks":[{"type":"strong"}]},{"text":" tab, select ","type":"text"},{"text":"Sequence Flow","type":"text","marks":[{"type":"strong"}]},{"text":". Connect the Start Event to the ","type":"text"},{"text":"Fill Order Form","type":"text","marks":[{"type":"strong"}]},{"text":" User Task.","type":"text"}]},{"type":"panel","attrs":{"panelType":"success"},"content":[{"type":"paragraph","content":[{"text":"Tip","type":"text","marks":[{"type":"strong"}]},{"text":": 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 ","type":"text"},{"text":"Fill Order Form","type":"text","marks":[{"type":"strong"}]},{"text":" User Task and you will be able to see few tooltips hovering around the ","type":"text"},{"text":"Fill Order Form","type":"text","marks":[{"type":"strong"}]},{"text":" User Task on the canvas. The diamond shape with a cross in the middle implies an Exclusive Gateway.","type":"text"}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Select the ","type":"text"},{"text":"Fill Order Form","type":"text","marks":[{"type":"strong"}]},{"text":" User Task by clicking on it and click on the Exclusive Gateway tooltip on the right of the tool.","type":"text"},{"type":"hardBreak"},{"text":" ","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"align-start","width":503,"widthType":"pixel"},"content":[{"type":"media","attrs":{"width":503,"id":"707714e7-d6f7-4483-8a86-f4501691cab4","collection":"contentId-32211362","type":"file","height":218}}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Once you click the Exclusive Gateway, a bigger diamond with a cross in the middle should appear on the canvas next to the ","type":"text"},{"text":"Fill Order Form","type":"text","marks":[{"type":"strong"}]},{"text":" User Task. The ","type":"text"},{"text":"Fill Order Form","type":"text","marks":[{"type":"strong"}]},{"text":" User Task will point to it. ","type":"text"},{"type":"hardBreak"},{"text":" ","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"align-start","width":503,"widthType":"pixel"},"content":[{"type":"media","attrs":{"width":503,"id":"5718929c-9362-430e-84fe-41f42a030b7b","collection":"contentId-32211362","type":"file","height":178}}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"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.","type":"text"},{"type":"hardBreak"},{"text":" ","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"align-start","width":514,"widthType":"pixel"},"content":[{"type":"media","attrs":{"width":514,"id":"17f6e006-9a75-4966-8d6f-f575b1e36361","collection":"contentId-32211362","type":"file","height":179}}]},{"type":"paragraph","content":[{"type":"hardBreak"},{"text":"After the diagram has been constructed, you must configure the properties of each element tofulfil the business logic.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Click on the Start Event element and set the following properties in the general tab.","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Id","type":"text","marks":[{"type":"strong"}]},{"text":": fillOrderDetails","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Name","type":"text","marks":[{"type":"strong"}]},{"text":": Enter Order Details","type":"text"}]}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"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 ","type":"text"},{"text":"Form","type":"text","marks":[{"type":"strong"}]},{"text":" tab in the properties of the Start Event.","type":"text"},{"type":"hardBreak"},{"text":" ","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"align-start","width":621,"widthType":"pixel"},"content":[{"type":"media","attrs":{"width":621,"id":"2446a8fe-a6b2-4aed-89b6-f6b1a59e22f4","collection":"contentId-32211362","type":"file","height":162}}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Click on the ","type":"text"},{"text":"New","type":"text","marks":[{"type":"strong"}]},{"text":" button and use the new window as shown below to create a productID field.","type":"text"},{"type":"hardBreak"},{"text":" ","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"align-start","width":434,"widthType":"pixel"},"content":[{"type":"media","attrs":{"width":434,"id":"9fa2bb8a-839a-452c-9911-97d6b893c8ab","collection":"contentId-32211362","type":"file","height":431}}]},{"type":"paragraph","content":[{"type":"hardBreak"},{"text":"Ensure that you enter the following details.","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Id","type":"text","marks":[{"type":"strong"}]},{"text":": productID","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Name","type":"text","marks":[{"type":"strong"}]},{"text":": Product Id","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Type","type":"text","marks":[{"type":"strong"}]},{"text":": string","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Variable","type":"text","marks":[{"type":"strong"}]},{"text":": productID","type":"text"}]}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Click ","type":"text"},{"text":"OK","type":"text","marks":[{"type":"strong"}]},{"text":". Once you have filled the form, the table in the form tab should look similar to the following.","type":"text"},{"type":"hardBreak"},{"text":" ","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"align-start","width":623,"widthType":"pixel"},"content":[{"type":"media","attrs":{"width":623,"id":"d562ee0a-70e4-4303-a980-5b4ee9ca4f7e","collection":"contentId-32211362","type":"file","height":128}}]},{"type":"paragraph","content":[{"type":"hardBreak"},{"text":"Now that the configurations for the start event have been set, you can configure the ","type":"text"},{"text":"Fill Order Form","type":"text","marks":[{"type":"strong"}]},{"text":" User Task, which is a claimable task by the goods division, where an employee of the goods division will be able to claim and complete the form. ","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Click on the ","type":"text"},{"text":"Fill Order Form","type":"text","marks":[{"type":"strong"}]},{"text":" User Task. In the ","type":"text"},{"text":"Properties","type":"text","marks":[{"type":"strong"}]},{"text":" tab, assign an Id and Name, similarly to how you assigned a Id and Name to the start event. You can use the following values.","type":"text"},{"type":"hardBreak"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":" ","type":"text","marks":[{"type":"textColor","attrs":{"color":"#000000"}}]},{"text":"Id","type":"text","marks":[{"type":"strong"},{"type":"textColor","attrs":{"color":"#000000"}}]},{"text":": fillOrderForm","type":"text","marks":[{"type":"textColor","attrs":{"color":"#000000"}}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":" ","type":"text","marks":[{"type":"textColor","attrs":{"color":"#000000"}}]},{"text":"Name","type":"text","marks":[{"type":"strong"},{"type":"textColor","attrs":{"color":"#000000"}}]},{"text":": Fill Order Form","type":"text","marks":[{"type":"textColor","attrs":{"color":"#000000"}}]}]}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Click on the ","type":"text"},{"text":"Main Config","type":"text","marks":[{"type":"strong"}]},{"text":" tab in the ","type":"text"},{"text":"Properties","type":"text","marks":[{"type":"strong"}]},{"text":" pane. Since there is no specific user who the task is to be assigned and anyone from the goods division can claim the task and execute it, set the ","type":"text"},{"text":"Candidate Group","type":"text","marks":[{"type":"strong"}]},{"text":" to goodsDivision. This is will allow any employee under the goods division to claim and complete the task.","type":"text"},{"type":"hardBreak"},{"text":" ","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"align-start","width":622,"widthType":"pixel"},"content":[{"type":"media","attrs":{"width":622,"id":"0a6d7287-c513-4b82-bd80-318ab1fdae86","collection":"contentId-32211362","type":"file","height":157}}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Create the form that the employee needs to fill. To do this, click on the ","type":"text"},{"text":"Form","type":"text","marks":[{"type":"strong"}]},{"text":" tab in the ","type":"text"},{"text":"Properties","type":"text","marks":[{"type":"strong"}]},{"text":" pane. Add the following fields in a similar manner to how you added form attributes for the start event.","type":"text"}]},{"type":"table","content":[{"type":"tableRow","content":[{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"paragraph","content":[{"type":"hardBreak"}]}]},{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"paragraph","content":[{"text":"productID","type":"text"}]}]},{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"paragraph","content":[{"text":"quantity","type":"text"}]}]},{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"paragraph","content":[{"text":"unitPrice","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"paragraph","content":[{"text":"Id","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"paragraph","content":[{"text":"productID","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"paragraph","content":[{"text":"quantity","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"paragraph","content":[{"text":"unitPrice","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"paragraph","content":[{"text":"Name","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"paragraph","content":[{"text":"Product ID","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"paragraph","content":[{"text":"Quantity","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"paragraph","content":[{"text":"Unit Price","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"paragraph","content":[{"text":"Type","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"paragraph","content":[{"text":"string","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"paragraph","content":[{"text":"long","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"paragraph","content":[{"text":"double","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"paragraph","content":[{"text":"Variable","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"paragraph","content":[{"text":"productID","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"paragraph","content":[{"text":"quantity","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"paragraph","content":[{"text":"unitPrice","type":"text"}]}]}]}]},{"type":"paragraph","content":[{"text":"Once the above fields are added to the form, the table in your ","type":"text"},{"text":"Form","type":"text","marks":[{"type":"strong"}]},{"text":" tab should look similar to the following.","type":"text"},{"type":"hardBreak"},{"text":" ","type":"text"},{"type":"inlineExtension","attrs":{"extensionType":"com.atlassian.confluence.migration","extensionKey":"inline-media-image","parameters":{"width":"623","id":"06aede77-d075-40f6-b8cb-ce18acc28fa6","collection":"contentId-32211362","height":""}}}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Now that you have configured your ","type":"text"},{"text":"Fill Order Form","type":"text","marks":[{"type":"strong"}]},{"text":" User Task, you can identify the two flows. There can be a default flow and a conditional flow.","type":"text"}]},{"type":"orderedList","attrs":{"order":1},"content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"To assign the default flow, set an appropriate ID for the flow, which is the ","type":"text"},{"text":"Sequence Flow","type":"text","marks":[{"type":"strong"}]},{"text":" element from the exclusive gateway to mail task. Click on this flow.","type":"text"},{"type":"hardBreak"},{"text":" ","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"align-start","width":353,"widthType":"pixel"},"content":[{"type":"media","attrs":{"width":353,"id":"a39376bf-6d13-4776-9273-04d4d3db67e5","collection":"contentId-32211362","type":"file","height":125}}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Set the Id value as shown below.","type":"text"},{"type":"hardBreak"},{"text":" ","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"align-start","width":623,"widthType":"pixel"},"content":[{"type":"media","attrs":{"width":623,"id":"abddf18a-49ee-443f-8e9b-6e234dd8234e","collection":"contentId-32211362","type":"file","height":122}}]}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Similarly, assign an ID to the ","type":"text"},{"text":"Sequence Flow","type":"text","marks":[{"type":"strong"}]},{"text":" from the exclusive gateway to the ","type":"text"},{"text":"Approve Order","type":"text","marks":[{"type":"strong"}]},{"text":" User Task.","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Id","type":"text","marks":[{"type":"strong"}]},{"text":": approveOrder","type":"text"}]}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"To set orderProduct as the default flow, do the following.","type":"text"}]},{"type":"orderedList","attrs":{"order":1},"content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Click on the exclusive gateway. ","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Click the ","type":"text"},{"text":"General","type":"text","marks":[{"type":"strong"}]},{"text":" tab in the ","type":"text"},{"text":"Properties","type":"text","marks":[{"type":"strong"}]},{"text":" pane and select orderProduct in the dropdown to assign it.","type":"text"},{"type":"hardBreak"},{"text":" ","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"align-start","width":621,"widthType":"pixel"},"content":[{"type":"media","attrs":{"width":621,"id":"0e6e4ba4-03a5-4e7c-93ed-7a3f45d68e14","collection":"contentId-32211362","type":"file","height":161}}]}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"To assign the ","type":"text"},{"text":"Conditional flow","type":"text","marks":[{"type":"strong"}]},{"text":", click on the approveOrder ","type":"text"},{"text":"Sequence Flow","type":"text","marks":[{"type":"strong"}]},{"text":" element, navigate to the ","type":"text"},{"text":"Main Config","type":"text","marks":[{"type":"strong"}]},{"text":" tab. In the condition field, define the condition as ${(quantity*unitPrice) > 100000}. This is for calculating the total cost and checking if it exceeds 100,000. If it does, it will take the conditional flow.","type":"text"},{"type":"hardBreak"},{"text":" ","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"align-start","width":623,"widthType":"pixel"},"content":[{"type":"media","attrs":{"width":623,"id":"a7ac6bdb-262a-4d73-bbe4-614d5fc78523","collection":"contentId-32211362","type":"file","height":97}}]},{"type":"paragraph","content":[{"type":"hardBreak"},{"text":"You have now configured the conditional flow. If the total cost exceeds 100,000, the flow is directed to the ","type":"text"},{"text":"Approve Order","type":"text","marks":[{"type":"strong"}]},{"text":" User Task.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"To configure the ","type":"text"},{"text":"Approve Order","type":"text","marks":[{"type":"strong"}]},{"text":" User Task, do the following. ","type":"text"}]},{"type":"orderedList","attrs":{"order":1},"content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Click on the ","type":"text"},{"text":"Approve Order","type":"text","marks":[{"type":"strong"}]},{"text":" User Task. ","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"In the ","type":"text"},{"text":"General","type":"text","marks":[{"type":"strong"}]},{"text":" tab, assign an appropriate ID and Name. ","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"In the ","type":"text"},{"text":"Main Config","type":"text","marks":[{"type":"strong"}]},{"text":" tab, you must set the ","type":"text"},{"text":"Candidate Group","type":"text","marks":[{"type":"strong"}]},{"text":" as the “orderApproval” group, as according to the scenario, anyone from the order approval group can claim the task and complete the task. ","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"To allow the approver to view the order details, you must create a form to display the Product ID, Quantity and Unit Price. To do this, navigate to the ","type":"text"},{"text":"Form","type":"text","marks":[{"type":"strong"}]},{"text":" tab in the ","type":"text"},{"text":"Properties","type":"text","marks":[{"type":"strong"}]},{"text":" pane and create the fields as show in the diagram below.","type":"text"}]},{"type":"panel","attrs":{"panelType":"warning"},"content":[{"type":"paragraph","content":[{"text":"Note","type":"text","marks":[{"type":"strong"}]},{"text":": The fields are only readable.","type":"text"}]}]},{"type":"mediaSingle","attrs":{"layout":"align-start","width":623,"widthType":"pixel"},"content":[{"type":"media","attrs":{"width":1280,"id":"729b53d6-7e9a-4e49-854d-556442d4f607","collection":"contentId-32211362","type":"file","height":256}}]},{"type":"paragraph","content":[{"type":"hardBreak"}]}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Now you have configured the properties for the ","type":"text"},{"text":"Approve Order","type":"text","marks":[{"type":"strong"}]},{"text":" User Task. To accommodate a scenario for the orderApproval group rejecting an order, you must add an end event to this User Task. Therefore this process can terminate at ","type":"text"},{"text":"Approve Order","type":"text","marks":[{"type":"strong"}]},{"text":" User Task.","type":"text"},{"type":"hardBreak"},{"text":" ","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"align-start","width":512,"widthType":"pixel"},"content":[{"type":"media","attrs":{"width":512,"id":"8397a79b-cf44-4223-adfb-97edb15ae8c7","collection":"contentId-32211362","type":"file","height":166}}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"To configure the Mail Task, do the following. ","type":"text"}]},{"type":"orderedList","attrs":{"order":1},"content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Click on the ","type":"text"},{"text":"Order Product","type":"text","marks":[{"type":"strong"}]},{"text":" Mail Task. In the ","type":"text"},{"text":"Properties","type":"text","marks":[{"type":"strong"}]},{"text":" pane, select the ","type":"text"},{"text":"General","type":"text","marks":[{"type":"strong"}]},{"text":" tab.","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Id","type":"text","marks":[{"type":"strong"}]},{"text":": mtOrderProduct","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Name","type":"text","marks":[{"type":"strong"}]},{"text":": Order Product","type":"text"}]}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Select the ","type":"text"},{"text":"Main Config","type":"text","marks":[{"type":"strong"}]},{"text":" tab, and fill the respective fields (i.e., To, From, Subject). ","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"In the non-HTML field, enter “Order ${quantity} of ${productID} at the rate of ${unitPrice}”. The variable will be used to create the mail body.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Follow the instructions on the ","type":"text"},{"text":"Working with the Email Task","type":"text","marks":[{"type":"link","attrs":{"href":"https://wso2docs.atlassian.net/wiki/spaces/BPS360/pages/32212226/Working+with+the+Email+Task#WorkingwiththeEmailTask-SampleEmailServerConfiguration"}}]},{"text":" page to configure the server for the Mail Task. ","type":"text"}]}]}]},{"type":"paragraph","content":[{"text":"The model is now complete as the necessary logic has been applied.","type":"text","marks":[{"type":"textColor","attrs":{"color":"#222222"}}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"To create the Business Archive File (.bar), do the following.","type":"text"}]},{"type":"orderedList","attrs":{"order":1},"content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"On the ","type":"text"},{"text":"Explorer","type":"text","marks":[{"type":"strong"}]},{"text":", found in the upper left of your screen, navigate to ","type":"text"},{"text":"Package Explorer","type":"text","marks":[{"type":"strong"}]},{"text":". ","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Right click on the package and select “Create deployment artifacts”.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Navigate to the location of the source. You will find the .bar file inside the deployment folder.","type":"text"}]}]}]}]}]},{"type":"paragraph","content":[{"type":"hardBreak"}]}]},{"type":"bodiedExtension","attrs":{"extensionType":"com.atlassian.confluence.macro.core","extensionKey":"localtab","parameters":{"macroParams":{"title":{"value":"Modelling a BPEL process"}},"macroMetadata":{"macroId":{"value":"a0d6e920-6149-4acd-9b69-cef9359936b7"},"schemaVersion":{"value":"1"},"placeholder":[{"type":"icon","data":{"url":"https://us.navitabs-static-assets.aws.bitvoodoo.cloud/static/4.0.5/images/macro-icon.png"}}],"title":"Tab (Deprecated)"}}},"content":[{"type":"paragraph","content":[{"text":"Follow the steps below to model a BPEL process.Then you can deploy and test it via the BPS management console.","type":"text"}]},{"type":"orderedList","attrs":{"order":1},"content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Open Eclipse and select","type":"text"},{"text":" File > New > Other.","type":"text","marks":[{"type":"strong"}]},{"text":" ","type":"text"},{"text":" ","type":"text","marks":[{"type":"strong"}]},{"type":"hardBreak"},{"text":" ","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"From the window that appears, select ","type":"text"},{"text":"Composite Application Project","type":"text","marks":[{"type":"strong"}]},{"text":" and click ","type":"text"},{"text":"Next.","type":"text","marks":[{"type":"strong"}]},{"text":" ","type":"text"},{"text":" ","type":"text","marks":[{"type":"strong"}]},{"type":"hardBreak"},{"text":" ","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Provide a suitable name for the project. For the purpose of this example, name it as \"WS_NumberAdderCarbon\". Click ","type":"text"},{"text":"Finish","type":"text","marks":[{"type":"strong"}]},{"text":" once done.","type":"text"},{"type":"hardBreak"},{"text":"The composite application project is created and you can see it on ","type":"text"},{"text":"Project Explorer","type":"text","marks":[{"type":"strong"}]},{"text":" pane on the left of your Developer Studio screen.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Right-click on the project which is onthe ","type":"text"},{"text":"Project Explorer","type":"text","marks":[{"type":"strong"}]},{"text":" pane and choose","type":"text"},{"text":" New ","type":"text","marks":[{"type":"strong"}]},{"text":" ","type":"text"},{"text":"> BPEL WorkFlow","type":"text","marks":[{"type":"strong"}]},{"text":". If it does not appear there, click ","type":"text"},{"text":"Other ","type":"text","marks":[{"type":"strong"}]},{"text":"and search for BPEL WorkFlow on the search bar. ","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"On the ","type":"text"},{"text":"Create New BPEL WorkFlow","type":"text","marks":[{"type":"strong"}]},{"text":" wizard, select ","type":"text"},{"text":"Create New BPEL workflow","type":"text","marks":[{"type":"strong"}]},{"text":" and click ","type":"text"},{"text":"Next","type":"text","marks":[{"type":"strong"}]},{"text":" to continue.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Provide suitable names, a namespace and select the matching template for your BPEL process and project. More information on the different templates can be found ","type":"text"},{"text":"here","type":"text","marks":[{"type":"link","attrs":{"href":"https://docs.wso2.com/display/BPS350/Synchronous+and+Asynchronous+Service+Invocations"}}]},{"text":". ","type":"text"},{"type":"hardBreak"},{"text":"For this example, the following values can be used: ","type":"text"},{"type":"hardBreak"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Project Name : ","type":"text","marks":[{"type":"strong"}]},{"text":"BPELNumberAdder","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Process Name","type":"text","marks":[{"type":"strong"}]},{"text":" : AdderProcess","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Namespace","type":"text","marks":[{"type":"strong"}]},{"text":" : ","type":"text"},{"text":" ","type":"text","marks":[{"type":"strong"}]},{"text":"http://NumberAdder.co","type":"text","marks":[{"type":"link","attrs":{"href":"http://numberadder.com/"}},{"type":"strong"}]},{"text":" ","type":"text","marks":[{"type":"strong"}]},{"text":" ","type":"text"},{"text":" ","type":"text","marks":[{"type":"strong"}]},{"text":"m","type":"text","marks":[{"type":"link","attrs":{"href":"http://numberadder.com/"}},{"type":"strong"}]},{"text":" ","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Template","type":"text","marks":[{"type":"strong"}]},{"text":" : Synchronous BPEL Process","type":"text"}]}]}]},{"type":"mediaSingle","attrs":{"layout":"align-start","width":626,"widthType":"pixel"},"content":[{"type":"media","attrs":{"width":626,"id":"d1942b01-6678-4928-9121-b7ffa79139fe","collection":"contentId-32211334","type":"file","height":595}}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Click ","type":"text"},{"text":"Finish","type":"text","marks":[{"type":"strong"}]},{"text":" to close the wizard.The ","type":"text"},{"text":"Project Explorer","type":"text","marks":[{"type":"strong"}]},{"text":" window and the ","type":"text"},{"text":"AdderProcess.bpel","type":"text","marks":[{"type":"strong"}]},{"text":" file will look like the following.","type":"text"},{"type":"hardBreak"},{"text":" ","type":"text"},{"type":"inlineExtension","attrs":{"extensionType":"com.atlassian.confluence.migration","extensionKey":"inline-media-image","parameters":{"width":"","id":"397f8e5d-0660-418b-bfae-9567bca95f53","collection":"contentId-32211334","height":""}}}]},{"type":"panel","attrs":{"panelType":"warning"},"content":[{"type":"paragraph","content":[{"text":"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.","type":"text"}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Open ","type":"text"},{"text":"AdderProcessArtifacts.wsdl","type":"text","marks":[{"type":"code"}]},{"text":" file in BPELNumberAdder Project and click on the blue arrow next to ","type":"text"},{"text":"Adder Process Request","type":"text","marks":[{"type":"strong"}]},{"text":". It will open another tab called ","type":"text"},{"text":"InlineSchemaofAdderProcessArtifacts.wsdl.","type":"text","marks":[{"type":"code"}]},{"text":" ","type":"text"},{"type":"hardBreak"},{"text":" ","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"align-start","width":750,"widthType":"pixel"},"content":[{"type":"media","attrs":{"width":764,"id":"755b400e-09ac-4b1c-82b8-d6da2c9c2dd2","collection":"contentId-32211334","type":"file","height":105}}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Rename the default variable named as \"input\" as ","type":"text"},{"text":"x ","type":"text","marks":[{"type":"strong"}]},{"text":"and change the type from \"string\" to ","type":"text"},{"text":"int. ","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Add another element by right-clicking on ","type":"text"},{"text":"AdderProcessRequestType>Add an element","type":"text","marks":[{"type":"strong"}]},{"text":". Name it ","type":"text"},{"text":"y","type":"text","marks":[{"type":"strong"}]},{"text":" and set the type as ","type":"text"},{"text":"int","type":"text","marks":[{"type":"strong"}]},{"text":". Now it should look like the follwing image.","type":"text"},{"type":"hardBreak"},{"text":" ","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"align-start","width":499,"widthType":"pixel"},"content":[{"type":"media","attrs":{"width":499,"id":"44e81dce-5c42-4a26-b655-2503e67de6b5","collection":"contentId-32211334","type":"file","height":83}}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Now lets design the simple business logic. Open the ","type":"text"},{"text":"AdderProcess.bpe","type":"text","marks":[{"type":"code"}]},{"text":"l","type":"text","marks":[{"type":"code"}]},{"text":"\n ","type":"text","marks":[{"type":"code"}]},{"text":" file. You need to add business logic in the place of where ","type":"text"},{"text":"FIX_ME-Add_Business_Logic_Here","type":"text","marks":[{"type":"strong"}]},{"text":" ","type":"text"},{"text":" ","type":"text","marks":[{"type":"code"}]},{"text":"activity resides. Delete the ","type":"text"},{"text":"FIX_ME-Add_Business_Logic_Here","type":"text","marks":[{"type":"strong"}]},{"text":" element. You will have the following process.","type":"text"}]},{"type":"panel","attrs":{"panelType":"info"},"content":[{"type":"paragraph","content":[{"text":"To delete, right-click on the element and choose delete.","type":"text"}]}]},{"type":"mediaSingle","attrs":{"layout":"align-start","width":162,"widthType":"pixel"},"content":[{"type":"media","attrs":{"width":162,"id":"d0e430a5-c8d2-42af-be5f-1d83b84454e2","collection":"contentId-32211334","type":"file","height":194}}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Add an ","type":"text"},{"text":"Assign","type":"text","marks":[{"type":"strong"}]},{"text":" activity in between ","type":"text"},{"text":"receiveInput","type":"text","marks":[{"type":"code"}]},{"text":" and ","type":"text"},{"text":"callbackClient","type":"text","marks":[{"type":"code"}]},{"text":" activities. To add ","type":"text"},{"text":"Assign","type":"text","marks":[{"type":"strong"}]},{"text":" activity drag it from the ","type":"text"},{"text":"Action","type":"text","marks":[{"type":"strong"}]},{"text":" section of the","type":"text"},{"text":" Action Palette","type":"text","marks":[{"type":"strong"}]},{"text":".","type":"text"}]},{"type":"panel","attrs":{"panelType":"info"},"content":[{"type":"paragraph","content":[{"text":"Another way to add activity element to the editor isright-clickonelementand use add-before option.","type":"text"}]}]},{"type":"mediaSingle","attrs":{"layout":"align-start","width":180,"widthType":"pixel"},"content":[{"type":"media","attrs":{"width":180,"id":"2e868771-dd89-45a8-a6e4-1738c37513a8","collection":"contentId-32211334","type":"file","height":250}}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Click on the ","type":"text"},{"text":"Assign ","type":"text","marks":[{"type":"strong"}]},{"text":"element and then click on ","type":"text"},{"text":"Details ","type":"text","marks":[{"type":"strong"}]},{"text":"tab in the ","type":"text"},{"text":"Properties","type":"text","marks":[{"type":"strong"}]},{"text":" window. ","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Click on ","type":"text"},{"text":"New","type":"text","marks":[{"type":"strong"}]},{"text":" which will lead you to the following view in the ","type":"text"},{"text":"Properties","type":"text","marks":[{"type":"strong"}]},{"text":" window.","type":"text"},{"type":"hardBreak"},{"text":" ","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"align-start","width":1005,"widthType":"pixel"},"content":[{"type":"media","attrs":{"width":1005,"id":"50b016c6-9b3f-41db-94c4-19aa0e105907","collection":"contentId-32211334","type":"file","height":269}}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"We will use an Xpath expression to compute the addition of two variables and assign the result to the output variable. To do that select ","type":"text"},{"text":"Expression","type":"text","marks":[{"type":"strong"}]},{"text":" from the ","type":"text"},{"text":"From ","type":"text","marks":[{"type":"strong"}]},{"text":"drop down list and select ","type":"text"},{"text":"Variable","type":"text","marks":[{"type":"strong"}]},{"text":" from the ","type":"text"},{"text":"To","type":"text","marks":[{"type":"strong"}]},{"text":" drop down list.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Include the following expression in the box below \"","type":"text"},{"text":"Edit the associated Xpath Expression\"","type":"text","marks":[{"type":"strong"}]},{"text":".","type":"text"}]},{"type":"codeBlock","content":[{"text":"$input.payload/tns:x + $input.payload/tns:y ","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"While you configure the variables, the a message will appear asking to initialize the variables. Click ","type":"text"},{"text":"Yes","type":"text","marks":[{"type":"strong"}]},{"text":". It will automatically generate an XML string for variable initialization. The ","type":"text"},{"text":"Properties","type":"text","marks":[{"type":"strong"}]},{"text":" window of ","type":"text"},{"text":"Assign","type":"text","marks":[{"type":"strong"}]},{"text":" activity should look like the following once you have completed the steps.","type":"text"},{"type":"hardBreak"},{"text":" ","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"align-start","width":1102,"widthType":"pixel"},"content":[{"type":"media","attrs":{"width":1102,"id":"070078a0-ba98-4a01-ad49-071fed3ea932","collection":"contentId-32211334","type":"file","height":280}}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Now you need to define inbound and out bound interfaces. Open the ","type":"text"},{"text":"deploy.xml","type":"text","marks":[{"type":"code"}]},{"text":" file which is in the BPEL project. Choose ","type":"text"},{"text":"AdderProcessPort","type":"text","marks":[{"type":"strong"}]},{"text":" as the ","type":"text"},{"text":"Inbound Address Port","type":"text","marks":[{"type":"strong"}]},{"text":" from the given list. The rest of the parameters will be automatically filled in once you select it. You do not need to specify ports outbound interfaces as we do not have external invocations in this particular business process.","type":"text"},{"type":"hardBreak"},{"text":" ","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"align-start","width":965,"widthType":"pixel"},"content":[{"type":"media","attrs":{"width":965,"id":"14cb55cc-f581-4675-a257-8d6b439619cb","collection":"contentId-32211334","type":"file","height":680}}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Include the BPEL process as a dependency of the Composite Application (WS_NumberAdderCarbon). To include it, open ","type":"text"},{"text":"pom.xml","type":"text","marks":[{"type":"code"}]},{"text":" of Composite application project and select the ","type":"text"},{"text":"BPELNumberAdder","type":"text","marks":[{"type":"strong"}]},{"text":" checkbox as a dependency. ","type":"text"},{"type":"hardBreak"},{"text":" ","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"align-start","width":866,"widthType":"pixel"},"content":[{"type":"media","attrs":{"width":866,"id":"066ba548-8e53-402a-8d98-86fbfc3118f5","collection":"contentId-32211334","type":"file","height":253}}]}]}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Deploying and testing the BPEL process","type":"text"}]},{"type":"paragraph","content":[{"text":"AftermodellingtheBPEL process, it can be deployed in the WSO2 BPS.","type":"text"}]},{"type":"orderedList","attrs":{"order":1},"content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"In Developer Studio, right-click on the ","type":"text"},{"text":"Servers ","type":"text","marks":[{"type":"strong"}]},{"text":"window and select ","type":"text"},{"text":"New>Server","type":"text","marks":[{"type":"strong"}]},{"text":". If it is not visible, select ","type":"text"},{"text":"Window>Show View>Servers","type":"text","marks":[{"type":"strong"}]},{"text":".","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"The ","type":"text"},{"text":"New Server","type":"text","marks":[{"type":"strong"}]},{"text":" window appears. From the list, expand the ","type":"text"},{"text":"WSO2","type":"text","marks":[{"type":"strong"}]},{"text":" folder and select ","type":"text"},{"text":"WSO2 Carbon 4.4 based server","type":"text","marks":[{"type":"strong"}]},{"text":" as shown below. Carbon 4.4 based server is selected here since BPS 3.5.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 ","type":"text"},{"text":"Next","type":"text","marks":[{"type":"strong"}]},{"text":".","type":"text"},{"type":"hardBreak"},{"text":" ","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"align-start","width":530,"widthType":"pixel"},"content":[{"type":"media","attrs":{"width":530,"id":"3b530f36-1a3e-48a3-8625-6a0b6058b7ff","collection":"contentId-32211334","type":"file","height":574}}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Set the ","type":"text"},{"text":"CARBON_HOME","type":"text","marks":[{"type":"strong"}]},{"text":" by clicking the ","type":"text"},{"text":"Browse","type":"text","marks":[{"type":"strong"}]},{"text":" button and selecting ","type":"text"},{"text":"WSO2 Business Process Server_Home","type":"text","marks":[{"type":"code"}]},{"text":" directory. Click ","type":"text"},{"text":"Finish","type":"text","marks":[{"type":"strong"}]},{"text":" once done or ","type":"text"},{"text":"Next","type":"text","marks":[{"type":"strong"}]},{"text":" if more settings of the server need to be configured such as the 'service port', 'web console port' etc.","type":"text"},{"type":"hardBreak"},{"text":" ","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"align-start","width":529,"widthType":"pixel"},"content":[{"type":"media","attrs":{"width":529,"id":"5fe995f2-30a1-4437-a105-c989894b56f6","collection":"contentId-32211334","type":"file","height":573}}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Once done, WSO2 BPS is added to Servers List as shown below.","type":"text"},{"type":"hardBreak"},{"text":" ","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"align-start","width":393,"widthType":"pixel"},"content":[{"type":"media","attrs":{"width":393,"id":"3b785d33-1f39-41ce-acc0-0eea4a5d4416","collection":"contentId-32211334","type":"file","height":208}}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"The next step is to deploy the composite application in WSO2 BPS. Go to WSO2 ","type":"text"},{"text":"BPS Server>Add and Remove","type":"text","marks":[{"type":"strong"}]},{"text":" and select the WS_NumberAdderCarbon project. The server will be automatically started.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"If the server does not get started automatically, right-click on the server and select ","type":"text"},{"text":"Start","type":"text","marks":[{"type":"strong"}]},{"text":". In the console window, note the server process's log. ","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"The WSO2 BPS login page will open automatically in the default web browser. Loginusing ","type":"text"},{"text":"admin","type":"text","marks":[{"type":"strong"}]},{"text":" as username and ","type":"text"},{"text":"admin","type":"text","marks":[{"type":"strong"}]},{"text":" as password.","type":"text"},{"text":" ","type":"text","marks":[{"type":"textColor","attrs":{"color":"#000000"}}]},{"type":"hardBreak"},{"text":" ","type":"text","marks":[{"type":"textColor","attrs":{"color":"#000000"}}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Select ","type":"text"},{"text":"Processes >BPEL>List","type":"text","marks":[{"type":"strong"}]},{"text":" from the ","type":"text"},{"text":"Main","type":"text","marks":[{"type":"strong"}]},{"text":" menu. The ","type":"text"},{"text":"Deployed Processes","type":"text","marks":[{"type":"strong"}]},{"text":" window opens with the ","type":"text"},{"text":"AdderProcess","type":"text","marks":[{"type":"strong"}]},{"text":" deployed.","type":"text"}]},{"type":"panel","attrs":{"panelType":"info"},"content":[{"type":"paragraph","content":[{"text":"The \"Process ID\" is generated in the format ","type":"text"},{"text":"{\"Process NameSpace\"} ProcessName-VersionNo","type":"text","marks":[{"type":"code"}]},{"text":".","type":"text"}]}]},{"type":"mediaSingle","attrs":{"layout":"align-start","width":750,"widthType":"pixel"},"content":[{"type":"media","attrs":{"width":1022,"id":"2aa5b811-8292-4056-aa39-23ea12cd55af","collection":"contentId-32211334","type":"file","height":128}}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Click the ","type":"text"},{"text":"Process ID","type":"text","marks":[{"type":"strong"}]},{"text":".","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"The ","type":"text"},{"text":"Process Information","type":"text","marks":[{"type":"strong"}]},{"text":" window appears with the details of the process. Click on the ","type":"text"},{"text":"Try It","type":"text","marks":[{"type":"strong"}]},{"text":" link. ","type":"text"},{"type":"hardBreak"},{"text":" ","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"align-start","width":750,"widthType":"pixel"},"content":[{"type":"media","attrs":{"width":989,"id":"7c3f194d-11b8-4378-bd0d-871476c91540","collection":"contentId-32211334","type":"file","height":521}}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"A browser window opens to enter the required input parameters. Enter the values and press ","type":"text"},{"text":"Send","type":"text","marks":[{"type":"strong"}]},{"text":" to calculate the result. ","type":"text"},{"type":"hardBreak"},{"text":" ","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"align-start","width":750,"widthType":"pixel"},"content":[{"type":"media","attrs":{"width":1079,"id":"ea2fa3e2-1551-4afb-8e24-34206a226c70","collection":"contentId-32211334","type":"file","height":625}}]}]}]},{"type":"panel","attrs":{"panelType":"info"},"content":[{"type":"paragraph","content":[{"text":" Alternatively, you can use the SOAP UI to test a business process. The SOAP UI application shows the request/response soap messages and is particularly helpful in error handling.","type":"text"}]}]}]}]}]}],"version":1},"cxhtml":"Business Process Management

Let's take a look at how to model a business process using either the BPMN 2.0 standard or the WS-BPEL 2.0 standard.

Before you begin,

Install Oracle Java SE Development Kit (JDK) version 1.8.* and set the JAVA_HOME environment variable.
Download the WSO2 EI ZIP file from here, and then extract the ZIP file.
The path to this folder will be referred to as <EI_HOME> throughout this quick start guide.
Download and .

Setting up EI Business Process

Open a command prompt (or a shell in Linux) and go to the <EI_HOME>\\wso2\\business-process\\bin directory.
Execute one of the following:
- On Linux/Mac OS: sh wso2server.sh
- On Windows: wso2server.bat
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."
Download and setup EI Tooling.

Go to the required tab for step by step instructions to model a business process.

Modeling a BPMN process

Follow the steps below to model a BPMN process.

Open Eclipse.
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:

Fill in the following repository details for BPMN.
- Name: Activiti BPMN 2.0 designer
- Location: http://activiti.org/designer/update/
Click OK to add the plugin. Once this is done, click Finish and restart Eclipse.
Once Eclipse restarts, navigate to File > New > Other. From the window that appears select Activiti > Activiti Project and click Next.
Provide a suitable Project Name and click Finish.
Right-click on your project and navigate to New > Other.
From the window that appears, select Activiti > Activiti Diagram.
Select the project in the viewer and enter a File name.

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 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”.
Click Finish. You are presented with a canvas as shown below to model your BPMN package.

The palette is positioned on the right side of the screen. You can drag and drop models from the palette onto the canvas and do yourmodelling.
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.
Link up the flow according to the business logic.
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.
In the Connection tab, select Sequence Flow. Connect the Start Event to the Fill Order Form User Task.
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.
Select the Fill Order Form User Task by clicking on it and click on the Exclusive Gateway tooltip on the right of the tool.
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.
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.

After the diagram has been constructed, you must configure the properties of each element tofulfil the business logic.
Click on the Start Event element and set the following properties in the general tab.
- Id: fillOrderDetails
- Name: Enter Order Details
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.
Click on the New button and use the new window as shown below to create a productID field.

Ensure that you enter the following details.
- Id: productID
- Name: Product Id
- Type: string
- Variable: productID
Click OK. Once you have filled the form, the table in the form tab should look similar to the following.

Now that the configurations for the start event have been set, you can configure the Fill Order Form User Task, which is a claimable task by the goods division, where an employee of the goods division will be able to claim and complete the form.
Click on the Fill Order Form User Task. In the Properties tab, assign an Id and Name, similarly to how you assigned a Id and Name to the start event. You can use the following values.
- Id: fillOrderForm
- Name: Fill Order Form
Click on the Main Config tab in the Properties pane. Since there is no specific user who the task is to be assigned and anyone from the goods division can claim the task and execute it, set the Candidate Group to goodsDivision. This is will allow any employee under the goods division to claim and complete the task.
Create the form that the employee needs to fill. To do this, click on the Form tab in the Properties pane. Add the following fields in a similar manner to how you added form attributes for the start event.

productID quantity unitPrice
Id productID quantity unitPrice
Name Product ID Quantity Unit Price
Type string long double
Variable productID quantity unitPrice
Once the above fields are added to the form, the table in your Form tab should look similar to the following.
Now that you have configured your Fill Order Form User Task, you can identify the two flows. There can be a default flow and a conditional flow.
1. To assign the default flow, set an appropriate ID for the flow, which is the Sequence Flow element from the exclusive gateway to mail task. Click on this flow.
2. Set the Id value as shown below.
Similarly, assign an ID to the Sequence Flow from the exclusive gateway to the Approve Order User Task.
- Id: approveOrder
To set orderProduct as the default flow, do the following.
1. Click on the exclusive gateway.
2. Click the General tab in the Properties pane and select orderProduct in the dropdown to assign it.
To assign the Conditional flow, click on the approveOrder Sequence Flow element, navigate to the Main Config tab. In the condition field, define the condition as ${(quantity*unitPrice) > 100000}. This is for calculating the total cost and checking if it exceeds 100,000. If it does, it will take the conditional flow.

You have now configured the conditional flow. If the total cost exceeds 100,000, the flow is directed to the Approve Order User Task.
To configure the Approve Order User Task, do the following.
1. Click on the Approve Order User Task.
2. In the General tab, assign an appropriate ID and Name.
3. In the Main Config tab, you must set the Candidate Group as the “orderApproval” group, as according to the scenario, anyone from the order approval group can claim the task and complete the task.
4. To allow the approver to view the order details, you must create a form to display the Product ID, Quantity and Unit Price. To do this, navigate to the Form tab in the Properties pane and create the fields as show in the diagram below.
  Note: The fields are only readable.
Now you have configured the properties for the Approve Order User Task. To accommodate a scenario for the orderApproval group rejecting an order, you must add an end event to this User Task. Therefore this process can terminate at Approve Order User Task.
To configure the Mail Task, do the following.
1. Click on the Order Product Mail Task. In the Properties pane, select the General tab.
  - Id: mtOrderProduct
  - Name: Order Product
2. Select the Main Config tab, and fill the respective fields (i.e., To, From, Subject).
3. In the non-HTML field, enter “Order ${quantity} of ${productID} at the rate of ${unitPrice}”. The variable will be used to create the mail body.
4. Follow the instructions on the page to configure the server for the Mail Task.
The model is now complete as the necessary logic has been applied.
To create the Business Archive File (.bar), do the following.
1. On the Explorer, found in the upper left of your screen, navigate to Package Explorer.
2. Right click on the package and select “Create deployment artifacts”.
3. Navigate to the location of the source. You will find the .bar file inside the deployment folder.

	productID	quantity	unitPrice
Id	productID	quantity	unitPrice
Name	Product ID	Quantity	Unit Price
Type	string	long	double
Variable	productID	quantity	unitPrice

Modelling a BPEL process

Follow the steps below to model a BPEL process.Then you can deploy and test it via the BPS management console.

Open Eclipse and select File > New > Other.
From the window that appears, select Composite Application Project and click Next.
Provide a suitable name for the project. For the purpose of this example, name it as "WS_NumberAdderCarbon". Click Finish once done.
The composite application project is created and you can see it on Project Explorer pane on the left of your Developer Studio screen.
Right-click on the project which is onthe Project Explorer pane and choose New > BPEL WorkFlow. If it does not appear there, click Other and search for BPEL WorkFlow on the search bar.
On the Create New BPEL WorkFlow wizard, select Create New BPEL workflow and click Next to continue.
Provide suitable names, a namespace and select the matching template for your BPEL process and project. More information on the different templates can be found here.
For this example, the following values can be used:
- Project Name : BPELNumberAdder
- Process Name : AdderProcess
- Namespace : http://NumberAdder.co m
- Template : Synchronous BPEL Process
Click Finish to close the wizard.The Project Explorer window and the AdderProcess.bpel file will look like the following.

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.
Open AdderProcessArtifacts.wsdl file in BPELNumberAdder Project and click on the blue arrow next to Adder Process Request. It will open another tab called InlineSchemaofAdderProcessArtifacts.wsdl.
Rename the default variable named as "input" as x and change the type from "string" to int.
Add another element by right-clicking on AdderProcessRequestType>Add an element. Name it y and set the type as int. Now it should look like the follwing image.
Now lets design the simple business logic. Open the AdderProcess.bpel\n 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.
To delete, right-click on the element and choose delete.
Add an Assign activity in between receiveInput and callbackClient activities. To add Assign activity drag it from the Action section of the Action Palette.
Another way to add activity element to the editor isright-clickonelementand use add-before option.
Click on the Assign element and then click on Details tab in the Properties window.
Click on New which will lead you to the following view in the Properties window.
We will use an Xpath expression to compute the addition of two variables and assign the result to the output variable. To do that select Expression from the From drop down list and select Variable from the To drop down list.
Include the following expression in the box below "Edit the associated Xpath Expression".
While you configure the variables, the a message will appear asking to initialize the variables. Click Yes. It will automatically generate an XML string for variable initialization. The Properties window of Assign activity should look like the following once you have completed the steps.
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 in once you select it. You do not need to specify ports outbound interfaces as we do not have external invocations in this particular business process.
Include the BPEL process as a dependency of the Composite Application (WS_NumberAdderCarbon). To include it, open pom.xml of Composite application project and select the BPELNumberAdder checkbox as a dependency.

Deploying and testing the BPEL process

AftermodellingtheBPEL process, it can be deployed in the WSO2 BPS.

In Developer Studio, right-click on the Servers window and select New>Server. If it is not visible, select Window>Show View>Servers.
The New Server window appears. From the list, expand the WSO2 folder and select WSO2 Carbon 4.4 based server as shown below. Carbon 4.4 based server is selected here since BPS 3.5.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.
Set the CARBON_HOME by clicking the Browse button and selecting WSO2 Business Process Server_Home directory. 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.
Once done, WSO2 BPS is added to Servers List as shown below.
The next step is to deploy the composite application in WSO2 BPS. Go to WSO2 BPS Server>Add and Remove and select the WS_NumberAdderCarbon project. The server will be automatically started.
If the server does not get started automatically, right-click on the server and select Start. In the console window, note the server process's log.
The WSO2 BPS login page will open automatically in the default web browser. Loginusing admin as username and admin as password.
Select Processes >BPEL>List from the Main menu. The Deployed Processes window opens with the AdderProcess deployed.
The "Process ID" is generated in the format {"Process NameSpace"} ProcessName-VersionNo.
Click the Process ID.
The Process Information window appears with the details of the process. Click on the Try It link.
A browser window opens to enter the required input parameters. Enter the values and press Send to calculate the result.

Alternatively, you can use the SOAP UI to test a business process. The SOAP UI application shows the request/response soap messages and is particularly helpful in error handling.

Let's take a look at how to create and invoke a data service using WSO2 EI. See the following topics for details:

Before you begin,

Install Oracle Java SE Development Kit (JDK) version 1.8.* and set the JAVA_HOME environment variable.
Download the WSO2 EI ZIP file from here, and then extract the ZIP file.
The path to this folder will be referred to as <EI_HOME> throughout this quick start guide.

Let's get started!

mysql databaseCreating a sample database with data

Create a sample MySQL database and add some data. For the purpose of this demonstration, we will create a simple database with one table.

Download and install MySQL.
Open a terminal and execute the following command to start your MySQL database:
Access the MySQL prompt by giving the user name and password. By default the user name is 'root' and the password is blank.
Create the sample database named employeedb using the following command:
Open the employeedb database you just created using the following command:
Create one table in the database using the following command:
This command will create the following table in the database:
Insert employee data into the employee table as follows:
1. The first employee:
2. The second employee:
3. The third employee:
You can see the data that you have added to the employee table of the employeedb database by executing the following command:
The result will be as follow:

You now have a MySQL database with employee data.

Starting WSO2 EI

Open a command line terminal and start WSO2 EI by running one of the following startup scripts from the <EI_HOME>/bin directory:
- On Linux/Mac OS: sh integrator.sh
- On Windows: integrator.bat
Open the Enterprise Integrator management console using https://localhost:8243/carbon/ and log in using admin as the username as well as the password.

Creating your first data service

We are now ready to start creating the first data service. We can use the created employeedb database to expose the data through our data service.

Step 1: Creating the data service

On the Management Console, go to the Main tab and click Services -> Add -> Data Service -> Create. This opens the Create Data Service wizard.
In the Data Service Name field, enter 'MyFirstDS' as the name. Leave the default settings of all other options.
Click Next. This will take you to the page for adding datasources.

Step 2: Adding new datasources

Click Add New Datasource. You can now specify the datasource details.
1. In the Datasource ID field, enter 'MyDS'.
2. In the Datasource Type field, select RDBMS from the list of values.
You will now be prompted to enter details of your RDBMS:
Enter the following details of your MySQL database in the relevant fields as shown above:
- Database Engine: MySql
- Driver Class: com.mysql.jdbc.Driver
- URL: jdbc:mysql://localhost:3306/employeedb
- User Name: root
- Password: (Leave this blank)
Click Save to save the datasource.
Click Next. This will take you to a new page for adding queries to your service.

Step 3: Creating a query for your datasource

Now we will create a query to obtain all the employee details saved in the database.
1. Enter a name for the query in the Query ID field. We will use 'QueryAll'.
2. All datasources created for the data service will be listed for the Datasource field. Select MyDS from this list.
3. Specify the SQL statement in the SQL field. We will use a SELECT statement to query for all the employee details in the database as shown below.
4. output mappingWe must now specify output mappings to determine how the information in the database should be displayed in the query output. We will be needing three columns (ID, Name and Address) to display the employee details. Therefore, we need to create three output mapping entries for these fields. Click Generate Response to automatically create output mappings as shown below.
Click Next. This will take you to a new page for connecting operations to each of your queries.

Step 4: Creating an operation to invoke a query

Enter a name for the operation in the Operation Name field. We will use 'getEmployees'.
All the queries defined for the data service will be listed for the Query ID field. Select 'QueryAll'.
Save the operation.
Click Finish to complete the data service creation. The 'MyFirstDS' data service is now listed as a deployed data service.

Invoking the data service

In this section, we will look at two different ways of invoking our data service without writing a single line of code. First, we will invoke our data service using the Tryit utility, which is integrated with the Management Console of WSO2 EI. We will then invoke the service using a simple HTTP GET request.

Using the TryIt tool

In the Deployed Services page, you will now see 'MyFirstDS' listed as a data service. You can access the Deployed Services page by clicking Services -> List in the Main tab.
Click the Try this service link for the data service. The service will be opened from the TryIt tool as shown below.

All the operations defined for the data service will be listed in the left navigator. As shown above, the 'MyFirstDS' data service has one operation (getEmployees).
Click getEmployees to invoke the operation.
Click Send to execute the getEmployees operation and the result will be printed as shown below.

Note that the employee ID and name will be returned as XML elements and the address will be wrapped as an attribute. This is due to the that was defined for each column: We have configured ID and Name as element type mappings and the address as an attribute type mapping. You can edit these mappings and observe the associated changes in the response very easily using the Tryit tool.

Sending an HTTP GET request

Now we will invoke the same data service using the HTTP GET request. Get the URL of the data service from the service dashboard:

Go to Services -> List to open the Deployed Services page.
Click the data service (MyFirstDS) to open the service dashboard. See that the URL of the 'MyFirstDS' data service is listed under Endpoints: https://10.100.5.65:8243/services/MyFirstDS/
You can execute the getEmployees operation using the above URL. Simply copy this URL followed by the operation name as follows:
https://10.100.5.65:8243/services/MyFirstDS/getEmployees
The result will be the same as with the TryIt tool:

"}}}]}],"version":1}

Quick Start Guide