11.3. Task Management

The following sections describe the features provided by the options available under the Tasks menu in Business Central.
Task Management in Business Central

Figure 11.4. Task Management

11.3.1. Tasks List

A User Task represents a piece of work the given user can claim and perform. User Tasks can be handled within the Task client perspective of the Business Central: the view displays the Task List for the given user. You can think about it as a to-do item. The User Task appears in your list either because the User Task element generated the User Task as part of Process execution or because someone has created the User Task directly in the Business Central console.
A User Task can be assigned to a particular actor, multiple actors, or to a group of actors. If assigned to multiple actors or a group of actors, it is visible in the Task Lists of all the actors and any of the possible actors can claim the task and execute it. The moment the Task is claimed by one actor, it disappears from the Task List of other actors.

Task client

User Tasks are displayed in the Tasks perspective, that are an implementation of a Task client, in the Business Central console: to display the Tasks perspective, click Tasks → Tasks List. You can filter out the Tasks based on their status using the following tabs:
Task Lists Tabs

Figure 11.5. Task Lists Tabs

  • Active tab: Displays all the active tasks that you can work on. This includes personal and group tasks.
  • Personal tab: Displays all your personal tasks.
  • Group tab: Displays all the group tasks that need to be claimed by you in order to start working on them.
  • All: Displays all the tasks. This also includes completed tasks but not the ones that belongs to a process that is already finished.
In addition to these, you can create custom filters to filter tasks based on the query parameters you define.
The Tasks List view is divided into two sections, Task List and Task Details. You can access to the Task Details by clicking on a task row. You can modify the details (such the Due Date, the Priority or the task description) associated with a task. The Task Detail section comprises the following tabs:
  • Work: Displays basic details about the task and the task owner. You can click the Claim button to claim the task. To undo the claim process, click the button again.
  • Details: Displays information such as task description, status, and due date.
  • Process Context: Displays related process instance and process definition.
  • Assigments: Displays the current owner of the task and allows you to delegate the task to another person or group.
  • Comments: Displays comments added by task user(s). It allows you to delete an existing comment and add a new comment.
  • Admin: Displays all the tasks for which you are the business administrator.

11.3.2. Creating a User Task

A user task can be created either by a User Task element executed as part of a process instance or directly in Business Central. To create a user task in the web environment, do the following:
  1. On the top menu of the Business Central, go to Tasks → Tasks List.
  2. On the Tasks List tab, click the New Task button and define the task parameters.
    This opens a New Task window with the following tabs:
    New Task window

    Figure 11.6. New Task Window

    • Basic tab
      • Task Name: The task display name.
    • Advanced tab
      • Due On: Add due date of the task.
      • Priority: Select task priority.
      • Add User button: Click to add more users. Note that a task cannot be created without a user or a group.
      • Add Group button: Click to add more groups.
      • User: Add the name of the person who executes the task.
      • Remove User button: Click to remove the existing user.
    • Form tab
      • Task form deploymentId: Select the deployment Id of the form from the list of available deployment Ids.
      • Task form name: Select the name of the associated task form from the list of available forms.
      If tasks are part of a Business Process, they have an associated form that collects data from you and propagates that to the business process for further usage. You can create forms for specific tasks using the Form Modeler. If there is no form provided for a task, a dynamic form is created based on the information that the task needs to handle. If you create a task as an ad-hoc task, which is not related with any process, there will be no such information to generate a form and only basic actions will be provided.
  3. Click the Create button.

11.3.3. Task Variables as Expressions

You can refer and use the task variables in task properties as soon as you create a task. For example, once your task has been created, you can define a task name that refers to a taskId. Task variables are resolved at both task creation time and notification time, unlike process variables, which are resolved only at task creation time. The ability of using task variables while creating tasks minimizes your Java code, such as calling JBoss BPM Suite APIs.
Task variables are available as task instances and you can get access to task information using the following expression: 
${task.id}
You can use this expression in data input of user task from within the process definition.
For example, the following expression can be used for accessing the processInstanceId variable: 
${task.taskData.processInstanceId}