Claims Approval Task Sample

Introduction

The ClaimsApprovalTask sample has a BPEL process that accepts claims approval requests. The Client is the user who requests for claim approval and sends a claim forward. If the claim approval amount is greater than 1000, the process requires human interaction for the claim approval. In this sample, a regional manager will be assigned a Claims Approval Task (human task) to interact with the system and approve or reject the claim. If the amount is less than 1000, no human interaction is required and the Claim Approval Process will continue.

Creating the Required Roles and Users

Before you run the sample, you must create two users with different roles.

To create the roles:

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

To create the users:

Go to Configure -> Users and Roles -> Users, and then click Add New User.
First, we will create a user who will have the regionalManagerRole role.
Enter regionalManagerUser for the user name and enter any password, and then click Next.
Select regionalManagerRole and click Finish.
Repeat these steps to create another user with username regionalClerkUser and assign the regionalClerksRole as the role.

You now have the two users and 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.
To approve the request, click Approve in the Response section, and then click Complete.
Go to Main -> Business Processes -> Instances. You can see that the instance, which was previously waiting for approval, has now completed successfully.