...
For developers, it is important to determine the
...
Node Name of the current Work Item, Task Name, Task ID, and assigned transitions for
...
Work Item in Docupace Start
...
. And also to verify if the Work Item is opened from a Docupace Start widget or not.
Initial problem was that when opening an existing work item with the Docupace Start widget, it loads the data from the work item and fields were not editable.
...
...
When creating a new work item with the Docupace Start, all values are editable.
...
Figure 21: Created Work Item
In specific cases, the work item should not be edited.
Example. When opening a work item from the queue which is in the workflow task “Pending Advisor Review”, it is set as editable. But when opening it from the queue task “FA Final Review” in the workflow, then fields are locked down. It is done by detecting the opened task in the widget code or on the widget page configuration.
...
...
How to know the node name of the current Work Item, Task ID, and assigned transitions for this Work Item in the Docupace Start?
Normally, if the work item is assigned to a user, transitions are displayed on the work item's Task screen opened from Monitor and the user is able to execute the transitions (see Figure 2).
...
Figure 42: Work Item’s transitions
...
The Work Item list with Task names
To execute the transitions, in the work item's Task screen click on the menu bar buttons (see Figure 3).
...
Figure 3: Work Item’s transition buttons
To execute the transactions with the Docupace Start, they should be triggered. To do this, Then the developer needs to know the task Task ID (not the Work Item), and the tasks connected to this work item. To get them, open the Work Item with the DSP, and get these values from JavaScript.
When Docupace Start creates a new Work Item or loads an existing Work Item, it populates:
...
id – task Id
workflowName (e.g. "ePACS")
taskName (e.g. "Pending Advisor Review")
nodeName (e.g. "Advisor Review")
assignedTo
url (e.g. "https://www.preprod.docupaceinc.com/rbcwm_dev/rest/v1/workflows/ePACS/mytasks/2462544 ")
transitions[] – Transitions available for this task
name (e.g. "Reject")
displayName (e.g. "Withdraw")
uri (e.g. "https://www.preprod.docupaceinc.com/rbcwm_dev/rest/v1/workflows/ePACS/mytasks/2462544/transitions/Reject ")
This is added to For example, there are added the following parts of Connect/DSP which deals deal with opening a Work Item or creating a Work Item.
/launchInterface?interfaceKey=CLIENTDSP&spTransactionGUID= |
...
Finds the oldest Work Item in this Starting Point |
...
transaction and opens it |
...
. |
/launchInterface?interfaceKey=CLIENTDSP&workItemId= |
...
Opens specific Work Item. |
page with pageType="loadNextWorkitem" |
...
Special page which loads next |
...
Work Item in this |
...
Starting Point transaction. |
page with pageType="createOrUpdateWorkItem" |
...
Page creates a new Work Item or updates an existing one. |
page with pageType="createWorkItem" |
...
Page creates a new Work Item. |
Docupace Start provides a method which would load all tasks of the current work item: $scope.api.taskService.getWorkItemTasks()
...