✅Tasks

As part of a case process, some tasks need to be manually completed by a person. These tasks are called user tasks and often require some input of data or approval.

Valtimo only shows tasks to a user that have not been completed yet. They can be accessed via the case the task belongs to, or Tasks in the main menu.

The Tasks menu item brings the user to a task list view, which combines tasks from different cases. The available categories are:

My tasks: These are tasks that have been assigned to the current user.
Unassigned tasks: These tasks have not been assigned to any user.
All tasks This view shows all tasks regardless of assignment.

When clicking on a task from the list, it will open the form that the user can fill in to complete it. After completion, the task will no longer be visible to the user.

A user can filter the tasks by case via the top dropdown:

When no case is selected: tasks from all cases is shown. This view uses the task columns as configured in code. These columns cannot be changed via the UI.
When a case is selected: the tasks are filtered by that case, and the columns as configured for that case are shown. For more information on configuring task list columns for a case, click here

Columns

Task list columns can be configured to change the visible columns in the task list.

Go to the Admin menu
Go to the Tasks menu
Select the case to configure task list columns for

The configured task list columns will only be available for the selected case.

From here, it is possible to:

Add columns
Edit columns
Sort columns
Delete columns

Adding a column

A column can be added by clicking on the Add column button. This will open the following modal:

Title If this field is filled in, this title will display as the column header, overriding any available translations.
Key A unique key by which the column is identified. If the key is not unique, you will not be able to save the column.
Path A path which leads to the property you want to show. For the document's JSON schema, follow this example: doc:customer.firstName. For document properties, follow these examples: case:createdBy, or case:sequence, or case:assigneeFullName.

Note

When there are special characters in a property, the property must be enclosed in quotes. For example: case:"loan-accepted".

Display type This option decides how the data is eventually displayed in the table.
Sortable Whether the column will be sortable by the user
Default Sort If this field has a value, the table will be sorted by default on this property, in the direction specified. Only one column at a time can have this property. On creating a new column, if another column already has a default sort specified, this input field will be disabled.

Task list columns can be autodeployed by adding json files on the classpath. These files should end with .case-task-list.json to be eligible for autodeployment.

Every deployment file represents a changeset. These files are required to contain a changesetId that should be unique over all deployment files that use changesets. When starting up, changesets that have already been executed will be ignored. A checksum of the changeset is created when it is executed. Changesets that have already been deployed should not change. Changesets that have been changed since a previous time will result in an error and failure to start the application.

All changesets can be executed again, even when the content has changed, by setting the valtimo.changelog.case-task-list.clear-tables property to true. By default, this setting is disabled.

my-case.case-task-list.json

{
  "changesetId": "my-case.case-task-list",
  "case-definitions": [
    {
      "key": "my-case",
      "columns": [
        {
          "title": "First name",
          "key": "first-name",
          "path": "doc:first-name",
          "displayType": {
            "type": "text",
            "displayTypeParameters": {}
          },
          "sortable": false
        },
        {
          "title": "Last name",
          "key": "last-name",
          "path": "doc:last-name",
          "displayType": {
            "type": "text",
            "displayTypeParameters": {}
          },
          "sortable": true,
          "defaultSort": "ASC"
        }
      ]
    }
  ]
}

Available properties

The following properties can be shown in the task list:

Properties from the document, with the 'doc:' prefix. E.g.: doc:first-name
Properties from the task, with the task: prefix. The following properties are available:
- createTime
- name
- assignee
- dueDate

Starting Valtimo 12.6.0 the 'variable' property can be used in the task list. Using the variable property, process variables that exist in the process instance of the task can be shown. A variable property can be configured using the task:variable.firstName notation.

Search fields

Task filters enable users to search tasks that meet one or more of the configured criteria. These filters can be configured by an admin.

Configuring task search fields

Go to the Admin menu
Go to the Tasks menu
Select the case to configure serach fields for

The configured task search fields will only be available for the selected case.

On the Search fields tab, search fields can be added, edited or removed.

When adding or editing a search field, the available options are similar to the case search fields. More information on case search fields can be found here.

For task list filters the following path prefixes are available:

doc:
case:

Task search fields can be autodeployed by creating json files on the classpath following this pattern: classpath*:**/*.task-search-field.json. The name of the file does not matter, but it is advised to keep it in line with the object title.

You can find an example of the JSON below:

my-case.task-search-field.json

{
  "changesetId": "my-case.TaskListSearchColumns.1721390529320",
  "collection": [
    {
      "ownerId": "my-case",
      "searchFields": [
        {
          "key": "caseAssignee",
          "title": "Case assignee",
          "path": "case:assigneeFullName",
          "dataType": "TEXT",
          "fieldType": "SINGLE",
          "matchType": "LIKE"
        },
        {
          "key": "createdBy",
          "title": "Case created by",
          "path": "case:createdBy",
          "dataType": "TEXT",
          "fieldType": "SINGLE",
          "matchType": "LIKE"
        }
      ]
    }
  ]
}

More information on the available fields and values can be found here.

Using task search fields

Since task filters are configured on a case, they will only be available when the user selects a case from the dropdown. For 'All cases', the additional filters will not be available.

With these filters, a user can filter on data from the document or case the task relates to.

Just like the case search filters, these filters will behave differently depending on how the admin configured the fields.

Note

The current search criteria can be shared with another user by copying the url from the address bar. The same filter criteria will be applied, but results may vary depending on access control for the other user.

Import and export

The configurations for task list columns and task search fields are included in the case definition import and export by default.

Access control

Access to the processes can be configured through access control. More information about access control can be found here.

Resources and actions

Resource type

Action

Effect

com.ritense.valtimo.camunda.domain.CamundaTask

assign

Allows assigning users to a task.

assignable

Allows users to be assigned to a task.

claim

Allows claiming of a task.

complete

Allows completion of a task.

view

Allows viewing of a task.

view_list

Allows viewing of tasks.

com.ritense.valtimo.camunda.domain.CamundaIdentityLink

Task identity links have no actions currently. As a result, they can only be used as part of container conditions. See the example here on how to use this.

Examples

Permission to complete a task of one candidate group

{
    "resourceType": "com.ritense.valtimo.camunda.domain.CamundaTask",
    "action": "view",
    "conditions": [
        {
            "type": "container",
            "resourceType": "com.ritense.valtimo.camunda.domain.CamundaIdentityLink",
            "conditions": [
                {
                    "type": "field",
                    "field": "groupId",
                    "operator": "==",
                    "value": "ROLE_USER"
                }
            ]
        }
    ]
}

Permission to claim a task if unassigned

{
    "resourceType": "com.ritense.valtimo.camunda.domain.CamundaTask",
    "action": "claim",
    "conditions": [
        {
            "type": "field",
            "field": "assigneeId",
            "operator": "==",
            "value": null
        }
    ]
}

PreviousWhitelisting Spring beans for Camunda NextZGW

Last updated 2 days ago