Run the sample

Client application

To run this sample, use the Business Process Choreographer Explorer, or the client application delivered with this sample.

Business Process Choreographer Explorer (BPC Explorer)

To start BPC Explorer in the integrated test environment of your WebSphere Integration Developer, follow these steps:

  1. In WebSphere Integration Developer, switch to the Servers view.
  2. In the table, right-click WebSphere Process Server v6.1.
  3. From the pop-up menu, select Launch > Business Process Choreographer Explorer.

To start the BPC Explorer on WebSphere Process Server, follow these steps:

  1. In a Web browser, open the URL http://yourhost:yourport/bpc.

    2. Note: Replace yourhost with your server's internet address and replace yourport with the port of your server's HTTP transport, for example http://localhost:9080/bpc.

The BPC Explorer opens:

Client application delivered with the sample

In the Download section of this sample, you can find the client application ToDoTaskClient as both a WID project interchange file and as an Enterprise Archive (EAR File). You can deploy either version to your server:

  • To deploy the project interchange file, import it into WID, right-click WebSphere Process Server v6.1, then select Add and Remove Projects and add the ToDoTaskClientEAR to the server.
  • To deploy the EAR file, open the administrative console and use Applications > Install New Application, accepting all the defaults. Then make sure that this application is started.

To run the client application in your Web browser, follow these steps:

  1. In a Web browser, open URL http://yourhost:yourport/ToDoTaskClient.

    2. Note: Replace yourhost with your server's internet address and replace yourport with the port of your server's HTTP transport, for example http://localhost:9080/ToDoTaskClient.

  2. If security is enabled, you will be requested to log into the client Web application. Enter the userid and password.

    3. The home view of the client application is displayed:

Start the to-do task with a business process

To start the request process, follow these steps:

  1. Switch to the BPC Explorer.
  2. In the Process Templates section, click My Process Templates.

    3. The My Process Templates view is displayed:

  3. Select RequestProcess, then click Start Instance.

    4. The Process Input Message view opens:

  4. Optionally, enter a Process Name.
  5. In the question field, enter a value of type string.
  6. Click Submit.

Start the to-do task with the client application

To create a new to-do task, follow these steps:

  1. Switch to the client application.
  2. In the home view, click Create. The create page is loaded.
  3. Optionally, enter a Task identifier.
  4. In the Input data field, enter a value of type string.

  5. Click Create.

    6. A confirmation message is displayed:

  6. To return to the home view, click Home.
  7. To create another to-do task, click New.
  8. To display the task list view, click List.
  9. Click List to see the task you just created:

Work with the human task

To work with human tasks, follow these steps:

  1. Switch to the BPC Explorer.
  2. In the Task Instances section, click My To-dos.

    3. The My To-dos view opens:

    The task you created is in the ready state. RequestTask is the Task Display name, specified when you created the Task model.

  3. Select RequestTask and click Work on. The Task Message view is displayed.
  4. In the answer field, enter a value of type string.

  5. Click Complete.

To view the status of completed human tasks in BPC Explorer, follow these steps:

  1. In the Task Instances section, click All Tasks.

    2. The All Tasks view is displayed:

    As you can see, your task is now in the finished state.

  2. Click on RequestTask to view more details.

  3. Click on the Task Input Message tab to view the input message.
  4. Click on the Task Output Message tab to view the output message.

Track the task status with your client application

To track the status of your human task, follow these steps:

  1. Switch to the client application.
  2. In the home view, click View.

    3. The task list view is displayed:

    Notice the task is now in the finished state and the output message is available.

  3. To return to the home view, click Home.
  4. To create another to-do task, click New.
  5. To delete all tasks, click Delete all.
  6. To delete all tasks that are in the finished state, click Delete finished.
  7. To refresh the task list view, click Refresh table.

To track the status of human tasks in general, follow these steps:

  1. Switch to the client application.
  2. Create a new task and submit.
  3. In BPC Explorer, claim the task. Before you complete the task, return to the client.
  4. In the home view, click View.
  5. You should now see the task status as claimed.
  6. Return to BPC Explorer and complete the task.
  7. Return to the client and Refresh table. The task status is now finished.

Process output

Output message

Since the request process is a long-running business process, the process output message is not displayed immediately after the process input message has been submitted. To display the process output message, follow these steps:

  1. In BPC Explorer, switch to the My Process Templates view.
  2. Select RequestProcess, then click Instances.

    3. The Process Instance for Process Templates view is displayed:

  3. Click on the process instance.

    4. The Process Instance view is displayed:

  4. Click the Process Output Message tab.

    5. The process output message is displayed:

Clean up process instances

Instances of the request process are not cleaned up automatically after completion. To delete process instances, follow these steps:

  1. In BPC Explorer, switch to the My Process Templates view.
  2. Select RequestProcess, then click Instances.

    3. The Process Instances for Process Templates view is displayed:

  3. Select all process instances with a state of Finished or Failed.
  4. Click Delete.

Clean up task instances

BPC Explorer

Instances of the human task are not cleaned up automatically after completion. To delete task instances, follow these steps:

  1. Switch to BPC Explorer.
  2. In the Task Instances section, click Administered By Me.

    3. The Task Instances Administered By Me view is displayed:

  3. Select all task instances with a state of Finished or Failed.
  4. Click Delete.

Client application

To delete task instances with the client application, follow these steps:

  1. Switch to the client application.
  2. In the home view, click View.

    3. The task list view is displayed:

  3. To delete all tasks that are in the finished state, click Delete finished.
  4. To delete all tasks, click Delete all.

    5. A confirmation message is displayed:

  5. To return to the task list view, click OK.