WSO2 Business Process Server v3.0.1 Documentation

##### Overview

- Home
- Release Note
- WS-BPEL Compliance
- License

##### Downloads

- Releases

##### Installation Guide

- Installing WSO2 BPS

##### Quick Start Guide

- Modeling the process
- Deploying the process
- Testing the process

##### User Guide

- Deploying BPEL Processes
- Deploying Human Tasks
- Managing BPEL processes
- Managing BPEL process instances
- QoS for BPEL processes
- Securing BPEL processes
- Invoking secured partner services
- Versioning
- Management API

##### Human Task Guide

- Human Tasks Quick Start Guide
- Deploying HumanTasks
- Managing Tasks
- Developing a Human Task Artifact
- Human Task Management and Configuration
- Human Task Concepts

##### Administrator Guide

- External data sources Configuration
- Registry Configuration
- Events
- Unified Endpoints
- BPEL Extensions
- Transaction Factory Configuration
- Message Exchange Interceptors
- OpenJPA specific properties
- JMS Transport Configuration
- Process Instance Cleanup Tasks
- Process Hydration and Dehydration
- Enabling Peer-to-Peer(P2P) Communication
- Setting up a BPS Cluster

##### Best Practices

- Process Deployment Best Practices

##### Concepts

- Process Versioning
- Process instance events
- Partner links

##### WS-BPEL Extensions

- Activity Failure and Recovery
- Extension Activities and Extensible Assign Operations
- XPath Extensions
- Iterable ForEach
- Flexible Assigns
- BPEL4People Extension

##### Samples

- HelloWorld
- If-Else
- ForEach
- While
- Repeat Until
- Flow and Links
- Pick
- Synchronous and Asynchronous Service Invocations
- Fault Handling
- Split
- XslTransform
- Compensation Handler
- Event Handler

##### Resources

- FAQ
- External Articles
- Library
- Source Code

##### Community

- Forum
- Mailing Lists

##### Project Information

- Issue Tracking

# Managing a Human Task Instance - TODO

### Table of Content

- Task Listing
- Task Details View
- Task Privileges
- Task Life Cycle
- Task Event History

## Task Listing

Once you log in the the WSO2 BPS the list of tasks could be viewed by clicking on the Task List link on the manage menu.

The task list page would show you the available tasks.

The following basic filtering options are present in the task list page.

- My Tasks

  The list of tasks currently assigned to you and are in progress

- Claimable

  The claimable tasks are the list of tasks which the user can claim and reserve. Any tasks would become claimable for a particular user if he has the role of Potential Owners of the task definition.

- Admin Tasks

  A list of tasks which the current logged in user have the administration rights. The user can perform the administration actions like reassignment on these tasks.

- Notifications

  A list of notifications which are accessible to the current logged in user.

- All Tasks

  A list of all tasks that the logged in user can view. This would also include all the tasks which are already completed.

## Task Details View

The task details could be viewed when you click on the particular task id on the task list page. The task view would depend on the current status of the task and the particular user's privileges on that task.

## Task Privileges

The actions a particular user can perform on a task would depend on the privileges granted to that user and the current status of the task. These privileges will be based on the logical people group the user belongs to. For an example only the Actual Owner of the task would be able to release a task already assigned to him.

## Task Life Cycle

The following transition diagram shows how the task propagates from each stated based on the action performed.

The following table lists some important task actions along with the authorised logical people groups and the pre and post state transition of the task.

Action | Description | Authorised Roles | Pre-State(s) | Post-State
--- | --- | --- | --- | ---
Claim | Claim responsibility for a task, i.e. set the task to status Reserved | Potential Owners | Ready | Reserved
Start | Start the execution of the task | Actual Owner Potential Owners | Ready Reserved | InProgress
Stop | Cancel/stop the processing of the task. The task returns to the Reserved state. | Actual Owner | InProgress | Reserved
Suspend | Suspend the task | Task Stakeholders Business Administrator | Ready Reserved InProgress | Suspended
Resume | Resume a suspended task. | Task Stakeholders Business Administrator | Ready Reserved InProgress | Suspended
Skip | Skips the task | Task Initiator Task Stakeholders Business Administrator | Suspended | Ready Reserved InProgress
Release | Release the task, i.e. set the task back to status Ready. | Actual Owner | InProgress Reserved | Ready
Fail | Execution of the task fails. | Actual Owner | InProgress | Failed
Add Comment | Add a comment to a task. | Task Stakeholders Potential Owners Actual Owner Business Administrator | (any state) | (no state transition)

#### Basic Flow of a Task

- Claiming a Task

  When a task is created it would be in Ready state. Ready state means that the task is ready to be claimed by a user in the Potential Owner logical people group. A user having the Potential Owner role can claim the task by clicking on the Claim button in the task details page. When a user claims the task the, it would go to the Reserved state which means that the task is now owned by the user who claimed the particular task.

- Starting a Task

  A task could be started by either of the following logical people groups. First group being the Actual Owner group which has already claimed the task. Otherwise Potential Owners can directly start a task which would automatically be claimed to the user starting the task. Once a task is started you would see the input form rendered to capture the task output. The output form would depend on the output form uploaded with the task definition. Refer the image below for a sample output form rendering.

- Completing a Task

  The task completion happens with the task owner performs the completion action provided with the output rendering form.

  Once the task is completed, the particular task would be moved out from the My Tasks list of the particular user.

- Other Actions Refer the list of actions in Task Actions Table

## Task Event History

Users can view the events occurred on a particular task by clicking on the History tab of the task details page. The task history details would contain information about the action, user who performed that operation, time stamp of the event and any state transitions due to the event. Refer the below image for a sample list of events.