# Task

A task is a unit of work describing an action to be performed, by whom, and when. They are used to accurately track the progress of a request or intervention.

Tasks allow you to break down a ticket, change, or project into several traceable actions, ensuring better distribution of work and optimal follow-up.

## Main characteristics

* **Link to an object**: tasks are generally linked to a ticket, but can also be linked to an issue, a change, or a project.
* **Description**: free field to detail what needs to be done.
* **Assignment**: a task can be assigned to a technician, a group, or left unassigned.
* **Scheduling**: you can specify a planned start and end date/time.
* **Status**: allows you to track whether the task is pending, in progress or completed.
* **Time spent** (optional): allows you to record the time actually spent on the task.
* **Notifications**: allows to send notifications when new tasks are created or modified.

<figure><img src="https://3503800744-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FIiEHKRx5AeABNDLcRlWX%2Fuploads%2F8GMaasSv3HcctWzTij6N%2Fimage.png?alt=media&#x26;token=92987e38-0d57-4b63-96d9-5417b43a1301" alt=""><figcaption><p>View task</p></figcaption></figure>

## Description of each field

<table><thead><tr><th width="172" data-type="image">Icon</th><th>Explanation</th></tr></thead><tbody><tr><td><a href="https://3503800744-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FIiEHKRx5AeABNDLcRlWX%2Fuploads%2FUPJktWGoXjZNIXCbd4gb%2Ffollowup_template.svg?alt=media&#x26;token=c3e1ecf5-aacf-4cd0-8b7a-f89d0378a968">followup_template.svg</a></td><td>Use a template if one exists (see <a href="#task-template">task template</a> for more information)</td></tr><tr><td><a href="https://3503800744-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FIiEHKRx5AeABNDLcRlWX%2Fuploads%2FiPkaYhkmzHcBuxUgg9VS%2Fdate_task.svg?alt=media&#x26;token=3207dc4c-c15c-46fc-a681-0f110a6bb0bd">date_task.svg</a></td><td>Schedule the task (day/month/year and time)</td></tr><tr><td><a href="https://3503800744-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FIiEHKRx5AeABNDLcRlWX%2Fuploads%2FrryCih8s73P7UFn3OvA5%2Fcategory.svg?alt=media&#x26;token=14520d07-fa01-42bb-9b98-b8f4a9d2edec">category.svg</a></td><td>Add a <a href="#task-categories">task catgory</a></td></tr><tr><td><a href="https://3503800744-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FIiEHKRx5AeABNDLcRlWX%2Fuploads%2FmhsO9BV7XmIJA5SLnQBo%2Fstatus_task.svg?alt=media&#x26;token=35d6f419-1503-4d49-ba67-6f58f815e589">status_task.svg</a></td><td>Update the status (Information,  To do, Done)</td></tr><tr><td><a href="https://3503800744-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FIiEHKRx5AeABNDLcRlWX%2Fuploads%2FXQVeSHbJdk0ev8psgmYa%2Fprivate_followup.svg?alt=media&#x26;token=7cb936d5-fe3c-46ec-8dd2-64c58fd4d4c1">private_followup.svg</a></td><td>Change to public or <a data-footnote-ref href="#user-content-fn-1">private </a>task (You can specify in <strong><code>Setup</code></strong>> <strong><code>General</code></strong>> <strong><code>Default Values</code></strong> > <strong><code>Assistance</code></strong> whether tasks should be marked as private or public by default.</td></tr><tr><td><a href="https://3503800744-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FIiEHKRx5AeABNDLcRlWX%2Fuploads%2FSDVVETe8N1aRlhBMwJmr%2Fsave_add_knowledgebase.svg?alt=media&#x26;token=6ad49c39-ebb3-4a6f-bcdf-e182f192f523">save_add_knowledgebase.svg</a></td><td>Save and add to the knowledge base</td></tr><tr><td><a href="https://3503800744-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FIiEHKRx5AeABNDLcRlWX%2Fuploads%2FVfXzodA5PGahMlYBUjiy%2Fduration_task.svg?alt=media&#x26;token=11ff5ef1-14b6-4f59-ac22-9f11529f8c9b">duration_task.svg</a></td><td>Duration estimate</td></tr><tr><td><a href="https://3503800744-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FIiEHKRx5AeABNDLcRlWX%2Fuploads%2FQnIReOV0uWNByb2FFNMn%2Fuser.svg?alt=media&#x26;token=de02cbf8-3af8-494c-a430-0d7e4acefec8">user.svg</a></td><td>User assigned to the task</td></tr><tr><td><a href="https://3503800744-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FIiEHKRx5AeABNDLcRlWX%2Fuploads%2FBw23ONMp95N2xqG5pyqR%2Fgroup.svg?alt=media&#x26;token=3483a90c-4bdc-4686-b5c0-bea488373d37">group.svg</a></td><td>Group assigned to the task</td></tr><tr><td><a href="https://3503800744-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FIiEHKRx5AeABNDLcRlWX%2Fuploads%2FJ3lT6bkO31fkSTurKCQ6%2Fplan_task.svg?alt=media&#x26;token=b08f7d38-07dc-4319-b154-cf248871366d">plan_task.svg</a></td><td>Plan this task :<br>- Start Date<br>- Period<br>- Reminder</td></tr></tbody></table>

{% hint style="success" %}
The information entered in the ‘plan this task’ fields is linked to the calendar, as it is possible to create a task without scheduling it. This field is therefore optional. However, if a task is scheduled in ‘Schedule’, the values will be identical.
{% endhint %}

## Task template&#x20;

Templates simplify the process of creating a task (for recurring tasks, for example). When creating a task, simply select the appropriate template and the information will be filled in automatically.&#x20;

#### Create a template&#x20;

You can create a template by going to **`Setup`** > **`Dropdowns`** > **`Assistance`** > **`Task templates`** or by creating a task directly from a ticket, project or change.

<figure><img src="https://3503800744-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FIiEHKRx5AeABNDLcRlWX%2Fuploads%2FH6dhXGaHdanG5BdXCSlT%2Fimage.png?alt=media&#x26;token=b425ce93-d0a0-4e8d-90dd-f55692c90c8c" alt=""><figcaption><p>Add followup template</p></figcaption></figure>

<figure><img src="https://3503800744-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FIiEHKRx5AeABNDLcRlWX%2Fuploads%2FJ3YmnAJCBAFtzwc3d3nP%2Fcreation_task_template.png?alt=media&#x26;token=3b5382a2-3c03-4803-a893-2985d5f281bf" alt=""><figcaption><p>View followup template</p></figcaption></figure>

* **Name**: Will be appear in the list of templates
* **Comments**: Optionnal
* **Content**: You can use variables (click on available variable to see the list) and customise your content using the formatting bar
* **Task category**: Select the [task category](#task-categories) in thge dropdown list
* **Status**: add a status by default for your template (Information, To Do, Done)
* **Private**: Define whether this task is public or private[^1]
* **Duration**: Indicate the duration of the task (maximum 100 hours)
* **By**: The user assigned to the task. Select them from the dropdown list.
* **Group**: The group assigned to the task. Select them from the dropdown list.
* **Pending reason**: Indicate whether the ticket/change/project should be put on hold after the task is saved. See [pending reason](https://help.glpi-project.org/documentation/modules/assistance/tabs/pending-reason) for more information.

## Task categories

You can create task categories. These can then be exported for statistical purposes, for example.

#### Create a task category

You can create a category  by going to **`Setup`** > **`Dropdowns`** > **`Assistance`** > **`Task categories`** or by creating a task directly from a ticket, project or change.<br>

<figure><img src="https://3503800744-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FIiEHKRx5AeABNDLcRlWX%2Fuploads%2FxO7y6BldNCVMMffGnqrn%2Fimage.png?alt=media&#x26;token=eb9c4ea4-0177-4493-8814-a745f73dca33" alt=""><figcaption><p>Add category</p></figcaption></figure>

* Click on **`+ Add`**
* Enter the **name**
* Define whether this category is a subcategory of another category.
* Select **active yes**
* You can define whether this category should be added to the **knowledge base categories**

Once the category has been created, you can add a subcategory and add a translation.

[^1]: Only persons authorised to view private tasks (**`Administration`** > **`Profiles`** > *`My_profile`* > **`Assistance`** > **`Follow-ups/Tasks`**) will be able to view them.
