Managing a Business Process

Let's get started!

Configuring the Integration artifacts

1. Open the ESB Config project that you used when trying out the Using the Gmail Connector tutorial.
2. Open the PaymentRequestProcessingSequence.xml file that is inside the SampleServices > src > main > synapse-config > sequences directory.
3. Add an Enrich mediator next to the call mediator from the Mediators pallet to add the appointment cancellation link to the email that is being sent to the patient. 

4. Select the Enrich mediator, go to the Properties tab, and update the following:

   Field	Value
   Source Type	Select inline from the drop-down.
   Source XML	Click the browse button, add the code given below, and click OK. <cancellation_link>https://localhost:9445/bpmn-explorer/</cancellation_link> You need to add this link so that it appears in the appointment confirmation email. You can cancel the appointment by clicking on this link and starting the appointment cancellation business process.
   Target Action	Select child from the drop-down.
   Target XPath	Click the browse button, add //jsonObject, and click OK.

5. Save the changes you made to the  PaymentRequestProcessingSequence.xml file.
   

Creating the appointment cancellation process using BPMN

1. Open WSO2 Integration Studio.
2. Go to BP Project → BPMN.
   
3. Create a new project named AppointmentCancellation.
   
4. Click Finish.
5. Right click the project in the navigator and go to New → Other and select BPMN diagram.
   
6. Select the AppointmentCancellation/src/main/resources/diagrams directory as the parent folder, and enter AppointmentCancellation.bpmn for the File name.
   
7. Click Next, select the option to create an empty diagram as shown below, and click Finish.
   
8. Let's start drawing the BPMN process diagram for the appointment cancellation process. The AppointmentCancellation canvas. The Palette on the right side of the AppointmentCancellation canvas contains all the activity symbols that will be used for drawing the process as shown below.
   
   Let's get started. You can easily drag and drop the activities from the Palette the canvas, and then update the properties and configurations of each activity as explained below.
   1. Add a StartEvent from the Start Event palette.
      

   2. Select the Properties tab, click Form, click New, update the following and click OK.

      Id	patientName
      Name	Name of the Patient
      Type	string
      Required	True

      

   3. Repeat clicking New and adding the following to add the other form properties one by one.

      Id	Name	Type	Required
      appointmentNo	Appointment Number	long	True
      doctor	Name of the Doctor	string	True
      reason	Reason for cancellation	string	True
      email	Email Address	string	True

      

   4. Add a REST Task from the WSO2 Tasks palette.
      
      Select the Properties tab, click General and give the Name as Get Appointment, then click Main config and update the following:


      Service URL	http://localhost:9090/healthcare/appointments/validity/${appointmentNo}
      HTTP method	GET
      Output Variable Mappings	noOfDays:$.status

      
      

   5. Add an Exclusive Gateway from the Gateway palette.
      
   6. Add a User Task from the Task palette and name it Appointment Control Task.
      
   7. Click Properties, click Main config  and give admin as the Assignee.
       
      

   8. 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	True	True

      Click New next to Form values and add the following:

      Id	Name
      approve	Approve
      reject	Reject

      

   9. Repeat clicking New and adding the following to add the other form properties one by one.

      Id	Name	Type	Variable	Readable	Writable	Required
      AppNo	Appointment Number	long	appointmentNo	True	False	True
      cancellationReason	Reason For The Cancellation	string	reason	True	False	True
      doctorName	Name of the Doctor	string	doctor	True	False	True

      

   10. Add another Exclusive Gateway from the  Gateway  palette.
       
   11. Add a REST Task from the  WSO2 Tasks palette.
       
       

       Select the Properties tab and click Main config and update the following:


       Service URL	http://localhost:9090/healthcare/appointments/validity/${appointmentNo}
       HTTP method	DELETE
       Output Variable name	status

       

   12. Add a MailTask from the Task palette below the second Parallel Gateway and name it Reject cancellation Task.
       
       Select the Properties tab and click Main config and update the following:

       To	${email}
       From	Enter a valid SMTP email address.
       Subject	Appointment cancellation rejected
       Html	Appointment cancellation request with Appointment Number ${appointmentNo} has been rejected. Thank you. Administration Department

       

   13. Add another MailTask above the second Parallel Gateway and name it Approve Cancellation Task.
       
       
       Select the Properties tab and click Main config and update the following:

       To	${email}
       From	Enter a valid SMTP email address.
       Subject	Appointment cancellation successful
       Html	Appointment cancellation request with Appointment Number ${appointmentNo} has been approved. Thank you. Administration Department

       

   14. Link each activity by hovering over the element, selecting the arrow sign and dragging it to the connecting element as shown below.
       
9. Click on the arrow leading from the first Exclusive Gateway to the Approve Cancellation Task, and in the Main config section of the Properties tab add the ${noOfDays >2} condition.
   
10. Click on the arrow leading from the first Exclusive Gateway to the Reject Cancellation Task, and in the Main config section of the Properties tab add the ${noOfDays<2} condition.
    
11. Click on the arrow leading from the second Exclusive Gateway to the Rest Task, and in the Main config section of the Properties tab add the  ${approveCancellation == 'approve'}  condition.
    
12. Click on the arrow leading from the second Exclusive Gateway to the Reject Cancellation Task, and in the Main config section of the Properties tab add the  ${approveCancellation == 'reject'}  condition.
    
13. Click the arrow leading to the Appointment Control Task, open the General tab that is under properties and note the Id.
    Example:
    
14. Click the first exclusive gateway, open the General tab that is under properties, and select the ID you noted in the above steps as the value for Default flow.
    
    
15. Save all the changes you have made.
16. Click Window -> Show View -> Other in the top menu of WSO2 Integration Studio.
    
17. Type Package Explorer in the search bar, select it and click Open.
    
18. In the Package Explorer, right-click the AppointmentCancellation project and select Create deployment artifacts. 
    
    This will create a AppointmentCancellation.bar file in the deployment folder:
    

Deploying the BPMN process in the Business Process profile

You can now deploy the .bar file of the BPMN process using the management console of the business process profile in WSO2 EI.

1. Open a terminal and navigate to the <EI_HOME>/wso2/business-proces/bin directory.

2. Start the Business Process profile in WSO2 EI by executing one of the following commands:
3. Open the management console from  https://localhost:9445/carbon/.
4. Log in using admin as the username and password.
5. Go to Main -> Manage -> Add ->BPMN and upload the AppointmentCancellation.bar file by browsing in the workspace directory of your WSO2 Integration Studio instance as shown below. 
   

Starting the Message Broker profile

Let's start the Message Broker profile:

1. Open a terminal and navigate to the <EI_HOME>/wso2/broker/bin directory.

2. Start the Business Process profile in WSO2 EI by executing one of the following commands:

Deploying the ESB artifacts in the ESB profile

# register some connection factories
# connectionfactory.[jndiname] = [ConnectionURL]
connectionfactory.QueueConnectionFactory = amqp://admin:admin@clientID/carbon?brokerlist='tcp://localhost:5675'
connectionfactory.TopicConnectionFactory = amqp://admin:admin@clientID/carbon?brokerlist='tcp://localhost:5675'
# register some queues in JNDI using the form
# queue.[jndiName] = [physicalName]
queue.MyQueue = example.MyQueue
queue.PaymentRequestJMSMessageStore=PaymentRequestJMSMessageStore

Now, let's start the ESB profile in WSO2 EI and upload the ESB artifacts:

Assuming you have already added a server for the ESB profile in Eclipse, on the Servers tab, expand the WSO2 Carbon server, right-click SampleServicesCompositeApplication, and choose Redeploy. The Console window of the ESB profile will indicate that the CApp has been deployed successfully.

Starting the back-end service

To be able to send requests to the back-end service (which is an MSF4J service deployed in the MSF4J profile), you need to first start the MSF4J runtime:

1. Open a terminal and navigate to the <EI_HOME>/wso2/msf4j/bin directory.

2. Start the runtime by executing the MSF4J startup script as shown below.

The system is now ready to receive appointment reservation requests.

Sending requests to the ESB

To demonstrate how the BPMN process for appointment cancellation works, let's send three separate requests to the ESB profile of WSO2 EI. These requests will create three separate doctor's appointments on three separate dates. You will receive confirmation emails for all of the appointments.

1. Create a JSON file named request.json with a request payload as shown below. Note the following when you create the request payloads.

   Make sure you provide a valid email address so that you can test the email being sent to the 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",
   "cardNo": "7844481124110331",
   "appointment_date": "2025-04-02"
   }

2. Open a command line terminal and navigate to the location where you have stored the above request payloads.

3.  Execute the following command, which will send the request1.json payload as a request.

   curl -v -X POST --data @request.json http://localhost:8280/healthcare/categories/surgery/reserve --header "Content-Type:application/json"

   You will see the response as follows:

   {"message":"Payment request successfully submitted. Payment confirmation will be sent via email."}

   An email will be sent to the provided patient email address with the following details:

   Subject: Payment Status
    
   Message: 
   {"appointmentNo":1,"doctorName":"thomas collins","patient":"John
   Doe","actualFee":7000.0,"discount":20,"discounted":5600.0,"paymentID":"8c6e153e-4034-4d5a-b011-391553b15a8f","status":"Settled","cancellation_link":"https://localhost:9445/bpmn-explorer/"}

Canceling appointments using the BPMN explorer

Let's now look at how to cancel the doctor's appointments. If you successfully, completed the previous steps, you will now have three emails confirming three appointments. The cancellation link is provided in each mail. 

1. Click the cancellation link in one of the mails, which will take you to the BPMN explorer. 
   
2. Log in to the BPMN explorer using admin as the username and password.
3. Click Processes and see that an appointment cancellation process is listed as shown below.
   
4. Click Start to begin the cancellation process and the Start Process form will open as shown below.
   
5. Let's cancel the appointment that was confirmed.
   
   1. Enter the appointment details of the appointment that was emailed to you and click Start. Be sure to enter the correct appointment number and email address.
   2. Since the appointment is more than two days from the current date, the appointment cancellation will be approved automatically. 
   3. You will receive an email confirming that the appointment cancellation is approved.

Congratulations, you have successfully completed the tutorial! 

What's next?

Want to check out the statistics of the business processor? Try out the /wiki/spaces/EI650/pages/35554527 tutorial.