reallocateWorkItems

This request takes allocated work items and changes the allocation to another resource, optionally cancelling changes made by the original resource.

Syntax

com.tibco.wcc.base.Requests.reallocateWorkItems(requestId,
                                                arrayWorkItems,
                                                txtResourceGuid,
                                                chkRevertData);

Parameters

  • requestId - (String) Uniquely identifies the request. For more information, see Submitting Server Requests.
  • arrayWorkItems - (Array[Object]) The work items to be re-allocated.
    [
      {
         workItemId: workItemId,
         workItemVersion: workItemVersion,
      }
    ]

    where:

    • workItemId - (String) Unique ID for the work item.
    • workItemVersion - (String) (optional) The number of times the work item has changed state. The version number starts at 0 when the work item is created, and is incremented by 1 each time it changes state.
  • txtResourceGuid - (String) The GUID for the resource to which the work items are to be re-allocated.
  • chkRevertData - (Boolean) Specifies whether or not pending changes inside the work items, that were made by the original resource, will be preserved when the work items are re-allocated.

Returns

Returns an <ap:WorkItem> element for each work item that is re-allocated.

For example:

<ap:Requests>
  <ap:WorkItems Id="ApiSample.reallocateWorkItems">
    <ap:WorkItem>
           .
           .
           .
    </ap:WorkItem>
           .
           .
           .
  </ap:WorkItems>
</ap:Requests>

For details about the contents of the <ap:WorkItem> element, see listWorkItems.