You are viewing the documentation for Blueriq 13. Documentation for other versions is available in our documentation directory.
The DCM_TaskList was previously named AQ_TaskList. In our ongoing effort for DCM 2.0, we renamed this container and moved it from the AquimaLibrary to the DCM library.
The DCM_TaskList Container Type is meant for use with the DCM Lists component. To use it, a DCM Lists Service [editor] should be running and the Runtime should be configured to locate it.
The DCM_TaskList container can be used to create a tabular overview of the tasks for a single case. Tasks will be displayed in a table that consists of columns which can contain ‘task data’ (task details), ‘actions’ (buttons and events) and 'custom fields'.
The Studio screen for a DCM_TaskList is the same as the screen for Container type: AQ_WorkList. Some features, however, are ignored:
- The 'Group by case' attribute (the task list only shows tasks for one case)
- 'Data' columns (this data is the same for all tasks)
- The 'Mask' property for Task List columns
- Presentation Style when locked
How to use
A Task List can be placed in a container or directly on a page. The interaction between the task list container and relating service calls is modeled in a flow.
Because the list displays tasks for a case, the case ID needs to be specified for the container. This is achieved by adding a Task data column for the case ID, which is not visible and has a filter on it. The filter should result in a case ID at runtime.
If the case ID column does not exist or somehow the filter does not result in a valid case ID, the container will show an exception and will not be rendered.
Runtime behavior
The DCM_TaskList is only supported by the Material Theme. Sorting, paging and filtering are done on the client side, as all tasks are sent to the client. Additionally, the task list will connect to the runtime to retrieve events and update the list accordingly, in real time. If you experience problems with the real time updates, see Using a reverse proxy server.
Since Blueriq 13.3, started tasks are no longer shown by default. This behavior is now configurable for each Task List by checking the 'Show started tasks' checkbox in Studio.