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.
| Table of Contents | ||
|---|---|---|
|
| Tip | ||||||||||
|---|---|---|---|---|---|---|---|---|---|---|
Before you begin, Install Oracle Java SE Development Kit (JDK) version 1.8.* and set theJAVA_HOME environment variable.
|
Deploying the backend service
...
|
Starting the back-end service
Download and start the back-end service:
- Download the JAR file of the back-end service.
Open a terminal and navigate to the location where your saved the back-end service.
Execute the following command to start the service:
Code Block java -jar Hospital-Service-JDK11-2.0.0.jar
The Healthcare service is now active and you can start sending requests to the service.
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.
...
| borderColor | #542989 |
|---|---|
| bgColor | #ffffff |
| borderWidth | 1 |
...
| Localtab | ||
|---|---|---|
| ||
Open a terminal and execute the following command:
|
...
| title | On Windows |
|---|
...
.
Send a request to the Backend service by entering the below details using a REST Client (e.g., Postman).
Tip In the Payload, set the
appointment_dateto 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-14so that2018-08-16is 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"}Anchor request request 
...
- Log in to the BPMN-explorer at https://localhost:9445/bpmn-explorer using
adminfor 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.
Tip 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 .
Tip 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.
