openWorkItem

This method opens the specified work item.

This method has two signatures: one to open a single work item, and one to open multiple work items.

Note: Pageflow definitions can include branching that would require the simultaneous handling of multiple user tasks, each requiring the display of a form (this same scenario could also occur in embedded sub-processes set up for chained execution).

Workspace cannot currently display multiple forms resulting from these parallel pageflows. If one is encountered in a WCC application (including the Workspace application), a warning message is displayed. In some situations, none of the forms can be displayed and execution of the pageflow (or chaining in the sub-process) cannot proceed. If a parallel pageflow is encountered inside of a business service, it may be able to arbitrarily display one of the forms, but an exception may occur later when the form is submitted.

Syntax

openWorkItem(id,
             version,
             parent);

openWorkItem(workItems,
             parent);

Parameters

  • id - (integer) A work item ID, identifying the work item to open.
  • version - (integer) Specifies the version number of the work item you want to open. The version number indicates how many times the work item has changed state. The version number starts at 0 when the work item is created, and is incremented by one each time it changes state.
  • parent - (Object) (optional) Identifies the General Interface component where the work item form is to be loaded. If omitted, it is loaded in a dialog.
  • workItems - (Array<Objects>) These identify the work items to be opened. Each Object in the array must have the following properties, identifying an existing work item (see above for definitions):
    • workItemId (integer)
    • workItemVersion (integer)

Returns

none