openWorkItem

Use this function to open a work item and to retrieve the associated data. The work item must be Allocated or Pended, and its state is changed to Opened. The function returns the body of the work item.

Note that this function is available in two different services:

  • WorkPresentationService - The openWorkItem function in this service should be used in the following situations:
    • If the user task is designed to display a form. This is typical for most client applications. (If the work item is designed to display a custom form, rather than a TIBCO Business Studio form, also see Custom Forms.)
    • If the user task is designed to start a pageflow. The response from the openWorkItem function contains the pageflow details, which you use with the startPageFlow function in the PageFlowService to start the pageflow.
  • WorkItemManagementService - The openWorkItem function in this service is used only if the user task does not open a form nor start a pageflow. This would be used only in special use-case client applications.