# Create a task

## What a task is

A task is a record of follow-up work that you need to track. Record a task when
you have work to do later and need a dated item with an owner, an assignee, a
status, or related follow-up. Create and handle these records in the Tasks flow:
use the new-task form to create one, then open the saved task for its tabs and
status actions.

| If you need to… | Go to |
|---|---|
| Enter follow-up work for the first time | [Enter task details](#enter-task-details) |
| Commit a new task | [Save the task](#save-the-task) |
| Open a task that already exists | [Find a task](#find-a-task) |
| Use tabs, status actions, or activity options on a saved task | [Handle saved-task options](#handle-saved-task-options) |
| Continue in the wider task workspace | [Continue after saving](#continue-after-saving) |
| Work with the task and activity lists together | [Tasks and activities](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/tasks-and-activities) |
| Change an activity's status | [Activity status](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/activity-status) |
| Create a Visit, Meeting, or Call | [Create an activity](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/create-activity) |
| Work from the personal task workspace | [My Desk tasks](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/my-desk-tasks) |
| Work from the personal activity workspace | [My Desk activities](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/my-desk-activities) |
| Work with tasks embedded in a sales job | [Sales-job comments and tasks](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/sales-job-comments-and-tasks) |

The task list and new-task form are separate surfaces. Open the task list to
find existing work, open the new-task form to record work, or open a saved task
to continue working with it.

![The task form with its fields and save actions](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/a12f6a4952cfcb9e993b1a675ff1f957.png)

## Before you start

You need a signed-in account and a subscription that includes the task form.
The form is available only when the task data is present and the subscription
condition allows it. Leaving the new-task screen is protected while you are
entering a task.

Collect the task purpose, description if one is needed, start date, due date,
priority choice, and assignee choice before you begin. Priority choices come
from the priorities available to your account. Assignee choices come from the
users available for the relevant branch. The labels and initial values for
**Priority** and **Assign To** depend on those returned choices.

The form provides **Owner**, **Assignee**, and **Tags** as display information.
**Reminder** belongs to a saved task rather than a new unsaved task. On the
task form, **Start Date** and **Due Date** carry required markers. The
other visible fields do not carry required markers on this form, although the
form's validation rules still define **Priority** and **Task Purpose** as
required when you save.

## Find a task

Choose the entry point that matches the work you need to do.

| If you need to… | Open |
|---|---|
| Record work that does not yet have a task record | The new-task form |
| Reopen saved work or choose a task row for a later action | The task list |

### Open a new task

**Prerequisites**

- You are signed in.
- The task form is available for your subscription.

**Steps**

1. Open the new-task form.
2. Confirm that **Task Purpose**, **Priority**, **Description**, **Start Date**,
   **Due Date**, **Task Progress**, and **Assign To** are visible.

   ![The new-task form with its visible fields](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/19e9b452b3ad706562e085a46a333f39.png)

**Result:** The new-task form is open and ready for task details. The form shows
the **Save** and **Save and Close** actions.

### Locate an existing task

**Prerequisites**

- You are signed in.
- You know enough about the task to recognise its row.

**Steps**

1. Open the task list.
2. Select the view that matches the work you need to find.

   | If you need to see… | Select |
   |---|---|
   | Every available task | **All** |
   | Tasks assigned to you | **My Tasks** |
   | Completed tasks | **View completed tasks** |

3. Match the row using the visible columns **Title**, **Owner**, **Start date**,
   **Due date**, **Status**, and **Importance**.
4. Open the task row you need.

   ![The task list with its filters and visible columns](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/734e469dca731d0a178c8957e1da75a5.png)

**Result:** The selected saved task is open.

For a new task, continue with [Enter task details](#enter-task-details). For a
saved task, continue with [Handle saved-task options](#handle-saved-task-options).

## Enter task details

Enter the information that identifies the follow-up work and places it on the
right dates. The available choices for **Priority** and **Assign To** come from
your account and branch data, so use the choices that appear in your form.

### Complete the task form

**Prerequisites**

- The new-task form is open.
- You have the task purpose and its start and due dates.

**Steps**

1. In **Task Purpose**, enter the work you need to follow up.
2. In **Priority**, select an available priority.
3. In **Description**, enter supporting details when they are needed.
4. In **Start Date**, enter the date on which the task starts.
5. In **Due Date**, enter the date by which the task is due.
6. In **Task Progress**, review the progress shown for the task.
7. In **Assign To**, select the available assignee when the task must be given
   to another available user.
8. Review the **Owner**, **Assignee**, and **Tags** information shown on the
   form.

**Result:** The task form contains the available task information and is ready
for [saving](#save-the-task).

## Save the task

Saving commits the task after the form validates it. The save controls are
available for a new task when the current account is the owner; they are also
available for an accepted, owned saved task.

**Prerequisites**

- The task form is open.
- The current account is allowed to save the task.

**Steps**

1. Enter all values required by the form.
2. Select **Save** when you want to save the task and remain on the task.
3. Select **Save and Close** when you want to save the task and close the form.

   | Choice | Use it when you need to… |
   |---|---|
   | **Save** | Continue working with the saved task |
   | **Save and Close** | Leave the task form after saving |

4. If validation displays a message, correct the named field and select the
   save control again.

**Result:** A successful save displays `Data saved Successfully`. A new task
 saved from the new-task form opens in the saved task view. If the save
cannot complete, the form displays `Error Saving Registration`.

## Handle saved-task options

A saved task is the version that has a task ID and can expose task tabs and
status actions. The options depend on the task's status, ownership, parent-task
relationship, branch, and whether the task is complete.

### Use the saved-task controls

**Prerequisites**

- A saved task is open.
- You know whether the task is yours and whether it is complete, overdue, or due
  to start.

**Steps**

1. Select the status action that matches the task's current condition.

   | If the task… | Select |
   |---|---|
   | Is assigned to you and has not already been accepted | **Accept** |
   | Is assigned to you and you do not accept it | **Decline** |
   | Is overdue or due to start and the work is complete | **Consider As Complete** |
   | Is completed and needs to return to an incomplete state | **Consider As Not Completed** |

2. Select the saved-task tab that matches the work you need.

   | If you need to work with… | Select |
   |---|---|
   | Child tasks on a saved root task | **Sub-tasks** |
   | Related activities | **Activities** |
   | Comments | **Comments** |
   | Attached files | **Attachment** |
   | Change history | **Last Modifications** |

3. In **Activities**, select **Meeting**, **Visit**, or **Call** when the task is
   in the same branch and is not completed.

   ![The saved-task action area and task tabs](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/19e9b452b3ad706562e085a46a333f39.png)

**Result:** The selected status, saved-task tab, or activity option is open when
its ownership, status, parent-task, and branch conditions allow it. Accepting a
task displays `You accepted the assigned task`. Declining it displays `You
declined the assigned task`.

## Fix task-entry problems

Use the message on screen to identify whether the form needs a value, the task
owner must take the action, or the list action is blocked.

| What you see | What it means | What to do |
|---|---|---|
| `Priority is required` | The form has no accepted priority value. | Select a value in **Priority**, then save again. |
| `Title is required` | The task purpose is empty. | Enter the task purpose in **Task Purpose**, then save again. |
| `Start Date is required` | The start date is empty. | Enter **Start Date**, then save again. |
| `Due Date is required` | The due date is empty. | Enter **Due Date**, then save again. |
| `Only task owner can take that action` | The current account cannot perform that status action. | Have the task owner perform the action. |
| `An error occurred while processing your request` | Accept or decline did not complete. | Check the task assignment and select the action again when appropriate. |
| `Error Saving Registration` | The save error path was reached. | Review the task values and select **Save** or **Save and Close** again. |
| `This record is related to saved data and cannot be deleted` | The related task cannot be deleted from the list. | Keep the related record and use its owning workflow instead. |
| `Error while deleting task` | The delete operation did not complete. | Do not rely on deletion; reopen the row and review its available actions. |
| `You declined the assigned task` | The assigned task was declined. | Review the assignment before continuing. |
| `Task deleted successfully` | The task was deleted. | Return to the task list and locate the remaining work. |
| `Forbidden characters detected. Please remove them and try again.` | An activity contains forbidden characters. | Remove the characters and try the activity entry again. |
| `Action not allowed` | The requested activity action is unavailable. | Continue from the activity page that owns the action. |
| `This action is only allowed if you belong to that branch` | The activity action requires branch membership. | Use an account that belongs to the task's branch. |
| `One topic and at least one note is required` | The activity needs a topic and a note. | Enter one topic and at least one note on the activity page. |
| `There is no topic to print` | The activity has no topic available for printing. | Add a topic before printing the activity. |
| `You already have a contact with this name` | The contact name already exists. | Use the existing contact or enter a different name on the contact page. |
| `Just '_'‘-''.' And '&' Characters Accepted` | The file or library name contains unsupported characters. | Use only the accepted characters in the file or library page. |
| `Your request was completed successfully` | A file or library request completed. | Continue from the file or library page. |

The task list shows **All**, **My Tasks**, and **View completed tasks**. It does
not show a following filter tab or a filter text field. The
task form does not provide a usable **Follow** control, and its header does not
provide **Attachments**, **Sub-tasks**, or **Activity** controls; use the saved-task
tabs instead.

The task-list grid is drawn from the selected list layout.

| Visible task-list column |
|---|
| **Title** |
| **Owner** |
| **Start date** |
| **Due date** |
| **Status** |
| **Importance** |

**Export** is not shown on the task list, so use the
controls that are actually shown on your list rather than relying on a hidden
Export action.

The available priority and assignee choices, editable defaults, and some
saved-task states depend on returned account, branch, and task data. Server-side
authorization and server-side validation are handled outside the task form's
visible rules.

## Continue after saving

After saving, continue from the saved task according to the work you need to do:
use its conditional tabs for task-related work, or move to the registered page
that owns the wider activity, workspace, or embedded-record operation.

**Prerequisites**

- You have saved a task or opened an existing task.

**Steps**

1. In the saved-task tab row, select **Sub-tasks**, **Activities**, **Comments**,
   **Attachment**, or **Last Modifications**.

   | If you need to… | Select or open |
   |---|---|
   | Work with child tasks on a root task | **Sub-tasks** |
   | Work with related activities | **Activities** |
   | Review comments, attachments, or change history | **Comments**, **Attachment**, or **Last Modifications** |
   | Create a Visit, Meeting, or Call in the same branch before the task is complete | **Meeting**, **Visit**, or **Call** |
   | Follow activity status transitions | [Activity status](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/activity-status) |
   | Create a Visit, Meeting, or Call | [Create an activity](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/create-activity) |
   | Work from the personal task workspace | [My Desk tasks](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/my-desk-tasks) |
   | Work from the personal activity workspace | [My Desk activities](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/my-desk-activities) |
   | Work with tasks embedded in a sales job | [Sales-job comments and tasks](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/sales-job-comments-and-tasks) |

**Result:** You are on the saved-task tab or registered follow-up page that owns
the next piece of work.
