Working with REST Tasks
BPMN REST tasks allow you to invoke REST endpoints within your BPMN processes. You can achieve this by adding a REST Task and handling the REST invocation part in a process implementation. This tutorial simulates a scenario, in which you access a REST endpoint of a Health Care Service via a REST Task to retrieve information of a patient appointment, and approve it based on the date as an administrator.
Before you begin,
- Install Oracle Java SE Development Kit (JDK) version 1.8.* and set the
JAVA_HOME
environment variable. - Download the product installer from here, and run the installer.
Let's call the installation location of your product the <EI_HOME> directory.If you installed the product using the installer, this is located in a place specific to your OS as shown below:
OS Home directory Mac OS /Library/WSO2/EnterpriseIntegrator/6.5.0
Windows C:\Program Files\WSO2\EnterpriseIntegrator\6.5.0\
Ubuntu /usr/lib/wso2/EnterpriseIntegrator/6.5.0
CentOS /usr/lib64/EnterpriseIntegrator/6.5.0
Select and download the relevant WSO2 Integration Studio ZIP file depending on your operating system from here, and then extract the ZIP file.
- For more detailed installation instructions, see Installing WSO2 Integration Studio.
- For information on any error messages you get, see the troubleshooting tips given under Troubleshooting WSO2 Integration Studio.
Deploying the backend service
Download the MSF4J service from Git Hub and copy the JAR file to the <EI_HOME>/wso2/msf4j/deployment/microservices
directory. The back-end service is now deployed in the MSF4J profile of WSO2 EI.
Sending the request to the backend service
Follow the steps below to send the request to the backend service. This creates the appointment of the patient.
Start the MSF4J profile.
Send a request to the Backend service by entering the below details using a REST Client (e.g., Postman).
In the Payload, set the
appointment_date
to a date, which is minimum one day after today's date. For example, in the below payload, it is assumes that today's date is2018-08-14
so that2018-08-16
is set as theappointment_date
.HTTP Method Request URL Payload POST http://localhost:9090/grandoaks/categories/surgery/reserve {
"patient": {
"name": "John Doe",
"dob": "1940-03-19",
"ssn": "234-23-525",
"address": "California",
"phone": "8770586755",
"email": "johndoe@gmail.com"
},
"doctor": "thomas collins",
"hospital": "grand oak community hospital",
"appointment_date": "2018-08-16"
}
Creating the BPMN artifacts
Follow the steps below to create the BPMN artifacts including the REST Task,
- Create a new BPMN project named RestTaskBPMN. For instructions, see Creating a BPMN Project.
- Create a BPMN Diagram named RestTask.bpmn. For instructions, see Creating the BPMN Diagram.
- Click anywhere on the canvas, go to the Properties tab, and fill in the following details:
Id :restTask
Name :REST Task Process
Namespace:http://wso2.org/bpmn/restTask
To implement the order approval process, drag and drop a Start Event element, a REST Task element, a User Task element and an End Event element to the canvas.
You view the Create connection option when you hover the mouse pointer on an artifact. Click on the arrow, drag it and drop it on the artifact to which you want to connect it.
Configuring the Start Event
Select the Properties tab of the Start Event, click Form, click New, update the following and click OK.
Id | Name | Type | Required | Readable | Writable |
---|---|---|---|---|---|
patientName | Name of the Patient | string | True | True | True |
appointmentNo | Appointment Number | long | True | True | True |
You view both fields added to the form as shown below.
Configuring the REST Task
- Select the Properties tab of the REST Task, click General and enter the Name as Get Appointment.
In the Properties tab of the REST Task, click Main config and update the following:
Service URL http://localhost:9090/healthcare/appointments/validity/${appointmentNo}
HTTP method GET Output Variable Mappings noOfDays:$.status
Important!
Be sure to use only one parameter (Output Variable Mappings parameter or the Output Variable Name parameter) to specify the variable mappings.
Configuring the User Task
- Select the Properties tab of the User Task, click General and enter the Name as Confirm Appointment.
- Click Properties, click Main config and give
admin
as the Assignee. In the Properties tab click Form, click New and add the following.
Id Name Type Readable Writable Required approveCancellation
Do You Approve the
Appointment Cancellation Request?enum True False True Click New next to Form values and add the following:
Id Name approve Approve reject Reject In the Properties tab click Form, click New and add the following.
Id Name Type Variable Readable Writable Required noOfDays
Number of Days long noOfDays True False True You view the fields added to the Form of the User Task as shown below.
Press Ctrl+S to save all your artifacts.
Deploying the artifacts
- For instructions on creating the deployable artifacts, see Creating the deployable archive.
- For instructions on deploying them, see Deploying BPMN artifacts.
Testing the output
- Log in to the BPMN-explorer at https://localhost:9445/bpmn-explorer using
admin
for both the username and password. - Click PROCESSES in the top menu, and click the Start option of the REST Task Process.
Enter a value for the Name of the Patient and Appointment Number and click Start. This creates a Claimable Task.
You need to enter the Appointment Number you received in the response of the service invocation above.
- Click TASKS in the top menu, and then click Claimable Tasks.
Click on the new Claimable Task.
You should not approve the appointment if the Number of days is less than one.
You view the Appointment Number you entered before and the Number of Days retrieved as 1, which means you can approve it since it is one day ahead from today.- Click Complete Task, to approve the appointment.
- Click TASKS → COMPLETED TASKS to view the completed task.