openWorkItem

Opens the work item form and starts the pageflow associated with the work item.

Note: There is an openWorkItem operation in three services:

ClientService (the one described here) - Use the openWorkItem operation in this service as an alternative to the one in the WorkPresentationService when opening a work item that starts a pageflow. When using this service, you do not need to explicitly start the pageflow. This service handles retrieving the appropriate form for the page activity, and ensures that the work item is completed when the pageflow is completed. Note that this service is available in REST only.
WorkPresentationService - Use this one if the user task was designed to either open a form or start a pageflow, which is typical for most client applications. The response from the openWorkItem operation in this service contains the pageflow details, which you use with the startPageFlow request in the PageFlowService to start the pageflow.
WorkItemManagementService - Use this one if the user task was designed to not open a form nor start a pageflow. This would typically be used only in special use-case client applications—see openWorkItem .

The request must specify the ID of the user opening the work item and the ID of the work item to be opened.
The response returns the complete details of the work item that is opened, as well as the pageflow that is started.

For additional information, see Introduction to Work Items.

API Descriptions