Claims Approval Task Sample

Note: The port offset in the carbon.xml file must be set to 0 in order to run this sample.

Introduction

The ClaimsApprovalTask sample has a BPEL process that accepts claims approval requests. If the claim approval amount is greater than 1000, the process requires human interaction for the claim approval.

Creating the Required Role and User

Before you run the sample, you must create a user and role.

To create the role:

In the BPS management console, go to Configure -> Users and Roles -> Roles, and then click Add New Role.
Enter regionalClerksRole for the role name and click Next.
Select All Permissions to give all permissions to the role created and click Finish (the user will be added later).

To create the user:

Go to Configure -> Users and Roles -> Users, and then click Add New User.
Enter regionalClerkUser for the user name and enter any password, and then click Next.
Select regionalClerksRole and click Finish.

Now you are ready to deploy the sample.

Deploying the Sample

You will now deploy the ClaimsApprovalTask sample by adding the tasks and process associated with the sample.

To add the tasks:

Go to Main -> Human Tasks -> Add.
Browse to and select ClaimsApprovalTask.zip, which is located in <BPS_HOME>/repository/samples/humantask, and click Upload.
Click OK in the confirmation message and then refresh the page.

The ApproveClaim and ClaimApprovalReminder task definitions appear in the deployed task configurations list.

You can click a task definition to view it. The ApproveClaim task definition looks like this:

To add the process:

Go to Main -> Processes -> Add.
Browse to and select ClaimsApprovalProcess.zip, which is located in <BPS_HOME>/repository/samples/bpel, and click Upload.
Click OK in the confirmation message, wait a few moments, and then refresh the page.

The ClaimsApprovalProcess process is now deployed and appears in the Deployed Processes list.

Running the Sample

You will now run the sample by taking the following steps:

Go to Main -> Processes -> List.
In the Process ID column, click the process ID for ClaimsApprovalProcess: {http://www.wso2.org/humantask/claimsapprovalprocess.bpel}ClaimsApprovalProcess-1
The Process Information screen appears, displaying information about this process.
In the WSDL Details section of the process information screen, select claimsApprovalPartnerLink from the Partner-Links list, and then click Try It.
A new browser window appears where you can replace the placeholder values with the values you want to send.

Replace the sample with the following values:

<body>
   <p:ClaimApprovalProcessInput xmlns:p="http://www.wso2.org/humantask/claimsapprovalprocessservice.wsdl">
      <xsd:custID xmlns:xsd="http://www.wso2.org/humantask/claimsapprovalprocessservice.wsdl">customerId</xsd:custID>
      <xsd:custFName xmlns:xsd="http://www.wso2.org/humantask/claimsapprovalprocessservice.wsdl">customerFName</xsd:custFName>
      <xsd:custLName xmlns:xsd="http://www.wso2.org/humantask/claimsapprovalprocessservice.wsdl">CustomerName</xsd:custLName>
      <xsd:amount xmlns:xsd="http://www.wso2.org/humantask/claimsapprovalprocessservice.wsdl">5000</xsd:amount>
      <xsd:region xmlns:xsd="http://www.wso2.org/humantask/claimsapprovalprocessservice.wsdl">reagon</xsd:region>
      <xsd:priority xmlns:xsd="http://www.wso2.org/humantask/claimsapprovalprocessservice.wsdl">1</xsd:priority>
   </p:ClaimApprovalProcessInput>
</body>

You can now view this process instance in the management console.

Go to Main -> Business Processes -> Instances.
Notice that the ClaimsApprovalProcess-1 instance has been created and is active.
Click the instance ID to view the activity flow. The flow of the process depends on the value we specified for the amount property. If the amount is less than 1000, the BPEL process handles the approval, so the process terminates without initiating the human task. If the amount is over 5000, as we specified above, the ClaimsApprovalTask is initiated, and the process waits until it receives approval from the human task activity. To view this task, you must log in as the user who is assigned this task.
Click Sign-out, and then log in as regionalClerkUser.
Go to Main -> Human Tasks -> List (be sure to click the link lower down in the left navigation pane, not the one in the Manage group).

The task appears in the My Tasks list.
In the Task ID column, click the link for the task.
Click Start to start the task.

8. To approve the request, click Approve in the Response section, and then click Complete.

9. Go to Main -> Business Processes -> Instances. You can see that the instance, which was previously waiting for approval, has now completed successfully.