diff --git a/docs/components/tasklist/img/tasklist-start-screen_light.png b/docs/components/tasklist/img/tasklist-start-screen_light.png index 5accbb26e4..a35b71f69d 100644 Binary files a/docs/components/tasklist/img/tasklist-start-screen_light.png and b/docs/components/tasklist/img/tasklist-start-screen_light.png differ diff --git a/docs/components/tasklist/userguide/img/tasklist-claim_light.png b/docs/components/tasklist/userguide/img/tasklist-claim_light.png index 8c0455a175..6894c0db7a 100644 Binary files a/docs/components/tasklist/userguide/img/tasklist-claim_light.png and b/docs/components/tasklist/userguide/img/tasklist-claim_light.png differ diff --git a/docs/components/tasklist/userguide/img/tasklist-claimed-by-me-empty_light.png b/docs/components/tasklist/userguide/img/tasklist-claimed-by-me-empty_light.png index d264a00891..416a85df49 100644 Binary files a/docs/components/tasklist/userguide/img/tasklist-claimed-by-me-empty_light.png and b/docs/components/tasklist/userguide/img/tasklist-claimed-by-me-empty_light.png differ diff --git a/docs/components/tasklist/userguide/img/tasklist-claimed-by-me-list_light.png b/docs/components/tasklist/userguide/img/tasklist-claimed-by-me-list_light.png index af80914c81..e721090291 100644 Binary files a/docs/components/tasklist/userguide/img/tasklist-claimed-by-me-list_light.png and b/docs/components/tasklist/userguide/img/tasklist-claimed-by-me-list_light.png differ diff --git a/docs/components/tasklist/userguide/img/tasklist-claimed-by-me_light.png b/docs/components/tasklist/userguide/img/tasklist-claimed-by-me_light.png index 73d6b32ff9..f3ab24e2fb 100644 Binary files a/docs/components/tasklist/userguide/img/tasklist-claimed-by-me_light.png and b/docs/components/tasklist/userguide/img/tasklist-claimed-by-me_light.png differ diff --git a/docs/components/tasklist/userguide/img/tasklist-complete-task_light.png b/docs/components/tasklist/userguide/img/tasklist-complete-task_light.png index 7214560349..4ed0bc3832 100644 Binary files a/docs/components/tasklist/userguide/img/tasklist-complete-task_light.png and b/docs/components/tasklist/userguide/img/tasklist-complete-task_light.png differ diff --git a/docs/components/tasklist/userguide/img/tasklist-task-completed_light.png b/docs/components/tasklist/userguide/img/tasklist-task-completed_light.png index 02011be964..fd6dffadda 100644 Binary files a/docs/components/tasklist/userguide/img/tasklist-task-completed_light.png and b/docs/components/tasklist/userguide/img/tasklist-task-completed_light.png differ diff --git a/docs/components/tasklist/userguide/img/tasklist-task-ordering.png b/docs/components/tasklist/userguide/img/tasklist-task-ordering.png index 2d58a00947..586762d137 100644 Binary files a/docs/components/tasklist/userguide/img/tasklist-task-ordering.png and b/docs/components/tasklist/userguide/img/tasklist-task-ordering.png differ diff --git a/docs/components/tasklist/userguide/img/tasklist-with-variables-claimed-by-me_light.png b/docs/components/tasklist/userguide/img/tasklist-with-variables-claimed-by-me_light.png new file mode 100644 index 0000000000..75602efeac Binary files /dev/null and b/docs/components/tasklist/userguide/img/tasklist-with-variables-claimed-by-me_light.png differ diff --git a/docs/components/tasklist/userguide/using-tasklist.md b/docs/components/tasklist/userguide/using-tasklist.md index 7dba6d644b..c72c529e20 100644 --- a/docs/components/tasklist/userguide/using-tasklist.md +++ b/docs/components/tasklist/userguide/using-tasklist.md @@ -6,11 +6,14 @@ description: "What you can do with Tasklist and an example use case." ## What can I do with Tasklist? -Tasklist shows you all user tasks that appeared in processes; those processes are running in Zeebe. +Tasklist shows you all user tasks that appeared in processes. Those processes are running in Zeebe. -User tasks need an interaction from the user. This can be updating, adding variables, filling out a [Camunda Form](../../../guides/utilizing-forms.md), or simply completion of the task. The user must first claim a task or unclaim an already claimed task. +User tasks need an interaction from the user. This can be updating, adding variables, filling out a [Camunda Form](../../../guides/utilizing-forms.md), or simply completion of the task. -If the user claimed a task, the task can be completed. Different task status filters help the user choose the desired task. +To work on a task the user must self-assign it first. Once assigned, the task can be completed. +The user can unassign the task if they do not intend to work on it. + +Different task statuses and filters help the user choose the desired task. :::note When a user is granted Tasklist access, the user has full access to the respective process instance data. @@ -18,22 +21,22 @@ When a user is granted Tasklist access, the user has full access to the respecti ## Example use case -If you've successfully logged in, you'll see a screen similar to the following: +When you've successfully logged in, you'll see a screen similar to the following: ![tasklist-start-screen](../img/tasklist-start-screen_light.png) -On the left side of the screen, you can see tasks. On the right side of the screen, you can see details of the currently selected task. - -Change the list of tasks by applying filters. You can also collapse and expand the task list. +On the left side of the screen, you can see the list of tasks. On the right side of the screen, you can see details of the currently selected task. -Click on the selection field in the left panel to choose which tasks you want to see: +You can filter tasks to see the following: -- All open +- All open tasks - Assigned to me - Unassigned - Completed -Click on the order icon ![order-icon](img/order-icon.png) to order the tasks. You can order them by the date of creation, the due date, or the follow-up date. +To apply filter, click on the selection field in the left panel and choose preferred option. + +Click on the order icon ![order-icon](img/order-icon.png) to order the tasks. You can arrange them by the date of creation, the due date, or the follow-up date. The follow-up date defines the latest time you should start working on a task, helping you to prioritize work. The due date provides a deadline for when the task should be finished: @@ -42,7 +45,7 @@ The due date provides a deadline for when the task should be finished: ### Assign tasks -When no tasks are assigned to you, the list appears empty +When no tasks are assigned to you, the list appears empty. ![tasklist-claimed-by-me-empty](img/tasklist-claimed-by-me-empty_light.png) @@ -58,16 +61,20 @@ Select the **Assigned to me** list to see the tasks that are assigned to you. Se ### Complete a task -When a task is assigned to you, you can complete the task by filling out the given form, and clicking on the **Complete Task** button. There are also cases where no form is available. In these cases, you have to add and/or update variables directly. +When a task is assigned to you, you can complete the task by filling out the given form, and clicking on the **Complete Task** button. ![tasklist-claimed-by-me](img/tasklist-claimed-by-me_light.png) -Always choose a list of tasks with a specified status. Then, select the task you want to work on. +There are also cases where no form is available. In these cases, you have to add and/or update variables directly. -Complete the task and check if it is shown in the **Completed** list. +![tasklist-with-variables-claimed-by-me](img/tasklist-with-variables-claimed-by-me_light.png) + +Always choose a list of tasks with a specified status. Then, select the task you want to work on. Change variables as needed and begin completion with the **Complete Task** button. +Completed tasks will be shown in the [**Completed** task list](#completed-tasks). + #### Add and update variables Update variables in the **Variables** section by adjusting their text field.