Tasks

Under the Tasks tab, configurations can be done for the view of a task list.

This is further divided into two more tabs:

• Columns

• Search fields

Unread task indicator

The task list shows a bullet next to tasks that have not been opened yet. As soon as the task detail modal is opened, the dot disappears. It is also cleared automatically when the task is completed.

Access control

Access to the tasks can be configured through access control. More information about access control can be found in the access control documentation.

Resources and actions

Resource type	Action	Effect
com.ritense.valtimo.operaton.domain.OperatonTask	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.operaton.domain.OperatonIdentityLink

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.operaton.domain.OperatonTask",
    "action": "view",
    "conditions": [
        {
            "type": "container",
            "resourceType": "com.ritense.valtimo.operaton.domain.OperatonIdentityLink",
            "conditions": [
                {
                    "type": "field",
                    "field": "groupId",
                    "operator": "==",
                    "value": "ROLE_USER"
                }
            ]
        }
    ]
}

Permission to view and complete tasks assigned to the user's teams

This example uses the ${currentUserTeams} expression, which resolves to the team keys of the current user. When a BPMN user task has a candidate group that matches a team key, this condition grants access to members of that team.

{
    "resourceType": "com.ritense.valtimo.operaton.domain.OperatonTask",
    "actions": ["view_list", "view", "complete"],
    "roleKey": "ROLE_USER",
    "conditions": [
        {
            "type": "container",
            "resourceType": "com.ritense.valtimo.operaton.domain.OperatonIdentityLink",
            "conditions": [
                {
                    "type": "field",
                    "field": "groupId",
                    "operator": "in",
                    "value": "${currentUserTeams}"
                }
            ]
        }
    ]
}

Permission to claim a task if unassigned

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