Processing a Work Item
A number of functions are provided that are used to process a work item.
Each of these functions 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 functions 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 functions 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 function