Run the sample

Prerequisites

Before you can run the sample application, you have to install and start the order management process. Refer to the Download section for details.

Also ensure that security is enabled for WebSphere Process Server. Please refer to the WebSphere information center for more details.

Client application

To run the client application, perform the following steps:

  1. In a web browser, open URL http://yourhost:yourport/CustomClient70.

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

    The welcome page is displayed:

  2. On the welcome page, there are two links. To start the order management process, click Start order management process. To work with the tasks associated with the order management process, click List my tasks.
  3. If the Login page is displayed, enter Name and Password, then click Login.

    4. Depending on the link you have clicked, either the process template list or the task list is displayed.

  4. To navigate through the client pages, use the links in the navigation header.

Starting the order management process

To start an instance of the order management process, perform the following steps:

  1. In the navigation header, click Process Templates.

    2. The Process templates page is displayed. The only process template you should see is OrderManagementProcess.

  2. In the list, click OrderManagementProcess.

    3. The process start form is displayed.

  3. In the Department field, enter a string.
  4. In the Order Number field, enter a string. This string must be unique.
  5. In the Supplier number field, enter a string.
  6. In the Total amount field, enter a numeric value.
  7. In the Order text field, enter a string.
  8. Click Start.

    9. The Process Instances page is displayed:

Working with process instances

Listing process instances

To list the process instances, perform the following steps:

  1. In the navigation header, click Process Status.

    2. The Process Instances page is displayed:

    You will notice that process instances with a state of 'finished', 'failed', or 'terminated' are highlighted.

Filtering process instances

You can filter the process instances by order no. and department.

To apply a filter, perform the following steps:

  1. Enter a string in the Order No. field and/or the Department field.
  2. Click Refresh.

    3. A filtered process instance list is displayed:

To disable the filter, perform the following steps:

  1. Clear the Order No. and Department fields.
  2. Click Refresh.

Displaying process instance details

To display process instance details, perform the following steps:

  1. Switch to the Process Instances page.
  2. In the list, click the name of the process instance.

    3. The Process Instance Details page is displayed:

Deleting process instances

To delete process instances, perform the following steps:

  1. Switch to the Process Instance page.
  2. In the list, mark the process instances to delete.

    3. Note: only process instances in the states 'finished', 'failed', or 'terminated' can be deleted.

  3. Click Delete.

Working with tasks

Listing task instances

To list the task instances, perform the following steps:

  1. In the navigation header, click My Tasks.

    2. The My Task Instances page is displayed:

    Filters can be applied as described in the filtering process instances section.

Working with task instances

To display the task instance details, perform the following steps:

  1. Switch to the My Task Instances page.
  2. In the task list, click the name of the task.

    3. The task details page is displayed:

    This page looks different depending on the kind and the state of the task.

To return to the task instance list, perform the following steps:

  1. In the command-bar, click Back.

    2. The My Task Instances page is displayed.

To work on a task instance, perform the following steps:

  1. Switch to the My Task Instances page.
  2. In the task list, click the name of the task. The task details page is displayed.
  3. On the command-bar click Claim.

    4. Note: this command is only valid for tasks in the state 'ready'.

    The output message is displayed for editing. In this sample, custom JSPs are used to render the output message:

    This page looks different depending on the kind and state of the task.

To save the task output message, perform the following steps:

  1. On the command-bar click Save.

    2. Note: this command is only valid for tasks in the state 'claimed'.

    You can now go back to the My Task Instances page and continue to work wit the task later.

To finish a task, perform the following steps:

  1. On the command-bar click Finish.

    2. Note: this command is only valid for tasks in the state 'claimed'.

    The My Task Instances page is displayed.

To release a task, perform the following steps:

  1. On the command-bar click Release.

    2. Note: this command is only valid for tasks in the state 'claimed'.

    The My Task Instances page is displayed.

Decide task

  1. To accept the order, click the radio-button I accept this order.
  2. To accept the order, click the radio-button I decline this order.
  3. If the order contains errors, click the radio-button This order contains errors.
  4. Optionally, if you want to work with this task later, click the radio-button Follow up with this order, then enter a numeric value into the minutes field.
  5. Optionally, enter a string in the Add a comment text area.

Approve task

  1. To approve the order, click the radio-button I approve this order.
  2. To accept the order, click the radio-button I decline this order.
  3. If the order contains errors, click the radio-button This order contains errors.
  4. Optionally, if you want to work with this task later, click the radio-button Follow up with this order, then enter a numeric value into the minutes field.
  5. Optionally, enter a string in the Add a comment text area.

Update order task

  1. To discard the order, click the radio-button Discard order due to errors.
  2. To correct the order data, click the radio-button Errors can be corrected, then update the following fields:

    3. In the Supplier number field, enter a string.
    In the Size of order field, enter a numeric value.
    In the Order text field, enter a string.

  3. Optionally, enter a string in the Add a comment text area.

Logout

To logout from your application, perform the following steps:

  1. In the navigation header, click Logout.
  2. The Login page is displayed:

  3. To re-login to the application, enter Name and Password, then click Login.