Progressing a Work Item
A number of service operations are provided that allow you to progress a work item through a business process.
Each of these operations is applicable only to work items in a particular state or states—for example, you cannot perform an openWorkItem on a work item that is already Opened. These operations will also change the state of the affected work item—to take openWorkItem as an example again, a successful openWorkItem call changes the state of the work item from Allocated or Pended to Opened. See Work Item States and Accessing Hidden Work Items for information about the possible states of work items and the possible changes between states.
The following operations are used for progressing work items:
- openWorkItem
- closeWorkItem
- completeWorkItem
- cancelWorkItem
- skipWorkItem
- saveOpenWorkItem
- pendWorkItem
- rescheduleWorkItem
- setWorkItemPriority
To identify which work item is affected, the requests for these operations require the unique ID of the work item as input. You can obtain the work item ID by several methods, for example from the response to a previous getWorkListItems or getAllocatedWorkListItems operation.