# Manage tasks from My Desk

Use My Desk task work to review personal or all-user tasks, create new follow-up work,
complete tasks you own, and remove task rows when deletion is available.

## Manage tasks from My Desk

A standalone My Desk task is follow-up work managed from the **Tasks** tab rather than
from one sales job. Use the list to see your own work or the wider task list, add a task,
or act on a task row. Task work tied to one sales job continues on the sales job page.

| If you need to… | Go to |
|---|---|
| Open the task list from My Desk | [Open My Desk task work](#open-my-desk-task-work) |
| Recognize the task filters, columns, and form fields | [Understand the task screen](#understand-the-task-screen) |
| Switch between all tasks, your tasks, and completed work | [Filter and act on tasks](#filter-and-act-on-tasks) |
| Create, save, and complete a standalone task | [Create and complete a task](#create-and-complete-a-task) |
| Understand role, ownership, and feature variations | [Handle task branches](#handle-task-branches) |
| Correct a validation, save, or delete problem | [Resolve errors and continue](#resolve-errors-and-continue) |
| Work with tasks filtered to one 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) |
| Understand the shared My Desk subscription and role context | [My Desk workspace](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/my-desk-workspace) |

![The My Desk workspace with the Tasks surface available](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/aad0fe4d775a0a57df351d241efaad18.png)

## Before you start

My Desk task work is the standalone task list and form used for daily follow-up work.
Its availability and actions depend on the Tasks subscription, your user role, and the
task's owner and completion state.

| Before you start | What it determines |
|---|---|
| Your plan includes Tasks | The **Tasks** tab is available. |
| Your plan does not include Tasks | A subscription-unavailable surface replaces the workspace. |
| You are a principal user | **Tasks** is disabled. |
| You are not a principal user | You can select **Tasks** when the subscription is available. |
| You own the task | Completion, saving, and assignment controls can be available. |
| The task is completed | Its form controls are read-only or disabled. |

For the shared My Desk subscription and principal-user context, see [My Desk
workspace](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/my-desk-workspace).

## Open My Desk task work

Open this section for the standalone task list or the My Desk entry point for a new task.

### Prerequisites

- Your plan includes Tasks.
- You are not a principal user.

### Steps

1. Open My Desk.
2. Select **Tasks**.
3. In the **Tasks** tab header, select the plus icon.

The plus icon opens the task popup titled **Task**. A task with no ID is initialized as a
new task. Continue with [Understand the task screen](#understand-the-task-screen) to
identify its controls.

![The new Task form opened from My Desk](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/d7c1a2e9aa369072b0b07546c62cd792.png)

**Result:** The standalone task list is open, or the new **Task** form is open for a
task that has no ID.

## Understand the task screen

The task screen gives you two list scopes, a completed-work switch, a task grid, and a
form for task details. Continue with [Filter and act on tasks](#filter-and-act-on-tasks)
when you are ready to change the scope or select a row.

### Task-list controls and statuses

| Control or status | Use or meaning |
|---|---|
| **All** | Shows the full task list. |
| **My Tasks** | The personal task-list view. |
| **View completed tasks** | Reloads archived or completed work. |
| **Upcoming** | An All-task status for upcoming work. |
| **Due** | An All-task status for work due now. |
| **Overdue** | An All-task status for late work. |
| **Completed** | The status shown for completed work. |

The task grid shows **Title**, **Owner**, **Start date**, **Due date**, **Status**, and
**Importance** in your task list.

> **Note:** The task grid uses the selected list layout. Work from the headers visible in
> your task list when the layout differs.

![The All task-list view with its task columns and statuses](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/3fa1c70a0e738e22d00e5c7779f831c9.png)

### Task form fields and defaults

| Form surface | What to know |
|---|---|
| **Task** | The task form title. |
| **Task Purpose** | Required task-purpose field. |
| **Priority** | Required choice with `High`, `Medium`, and `Low` options. |
| **Owner** | Task ownership information. |
| **Tags** | Task tags surface. |
| **Description** | Supporting task details. |
| **Start Date** | Required date; a new task defaults to today. |
| **Due Date** | Required date; it cannot be earlier than **Start Date** and defaults to one day later for a new task. |
| **Task Progress** | Progress slider; a new task starts at `0`. |
| **Assign To** | Choose an available assignee. |
| **Reminder** | Appears after the task has an ID. |
| **Save** | Validates and saves without leaving the form. |
| **Save and Close** | Saves the task and leaves the form. |

The form controls become read-only or disabled when the task is completed. Assignment
and saving can be available for a task you own. Continue with [Create and complete a
task](#create-and-complete-a-task) to enter a new task.

## Filter and act on tasks

Change the task scope or act on a row in the standalone list when you need to review or
update task work.

### Switch the task view

### Prerequisites

- The standalone task list is open.
- You know whether you need all tasks, your tasks, or completed work.

### Steps

1. Select the view that matches the work you need.

   | If you need to see… | Select |
   |---|---|
   | All task-list work | **All** |
   | Your personal task-list work | **My Tasks** |
   | Archived or completed work | **View completed tasks** |

**Result:** The selected task view is displayed.

### Act on a task row

### Prerequisites

- The required task view is displayed.
- You know whether you own the task before selecting a completion action.

### Steps

1. Match the task row using **Title**, **Owner**, **Start date**, **Due date**, **Status**,
   or **Importance**.
2. On the task row, select its action button.
3. Select the action that matches your task:

   | If you need to… | Select | Then |
   |---|---|---|
   | Open the task | **Open** | Review the task form. |
   | Mark your task complete | **Complete** | Confirm `Are you sure that you want to mark this task as completed?`. |
   | Return your completed task to incomplete work | **Un complete** | Confirm `Are you sure that you want to un-complete this task?`. |
   | Remove the row when deletion is available | **Delete** | Select **Delete** or **Cancel** in the deletion confirmation. |

The deletion confirmation is `Are you sure you want to delete this task?`. Completing or
un-completing a task refreshes the grid. Deletion reports either `Task deleted
successfully` or `Error while deleting task`.

**Result:** The selected task opens, completion is confirmed, the task returns to
incomplete work, or the deletion dialog remains open after **Cancel**. Continue with
[Create and complete a task](#create-and-complete-a-task) to add or save task work.

## Create and complete a task

Create a standalone task when you have follow-up work that belongs in your daily task
workflow rather than under one sales job. The form requires **Task Purpose**, **Priority**,
**Start Date**, and **Due Date**.

### Enter and save a task

### Prerequisites

- The new **Task** form is open.
- You know the task purpose, priority, start date, and due date.
- You own the task when you need to save it or change its completion state.

### Steps

1. In **Task Purpose**, enter the task purpose.
2. In **Priority**, select `High`, `Medium`, or `Low`.
3. In **Start Date**, enter the task start date.
4. In **Due Date**, enter a date on or after the selected **Start Date**.
5. Review the **Owner** and **Tags** information shown by the form.
6. In **Description**, enter supporting task details when needed.
7. In **Task Progress**, review the progress value; a new task starts at `0`.
8. In **Assign To**, select an available assignee when assignment is needed.
9. Select the save action that matches what you need:

   | If you need to… | Select |
   |---|---|
   | Continue working in the saved task form | **Save** |
   | Leave the task form after saving | **Save and Close** |

The save message is `Data saved Successfully`. The form's completion controls are
available according to ownership and task status.

![The task form with the Save action](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/03be20999a4915a1933f937dba047ffb.png)

**Result:** The task is saved in the task workflow, and the form closes after **Save and
Close**. Continue with [Complete or return a saved task](#complete-or-return-a-saved-task)
when you need to change its completion state.

### Complete or return a saved task

Complete or return a saved task when its status and ownership allow a completion action.

### Prerequisites

- The task is saved.
- You own the task to complete it.

### Steps

1. Select the action that matches the saved task:

   | If | Select | Then |
   |---|---|---|
   | The task is yours and its status is Due or Overdue | **Consider As Complete** | Confirm `Are you sure that you want to mark this task as completed?`. |
   | The task is Completed and you need to return it to incomplete work | **Consider As Not Completed** | Confirm `Are you sure that you want to un-complete this task?`. |

**Result:** The saved task is marked complete or returned to incomplete work after the
matching confirmation.

## Handle task branches

The task surface changes with subscription, role, ownership, task status, and the task's
ID. Use the branch that matches what you see.

| What you see or condition | What to do |
|---|---|
| Tasks is unavailable under your subscription | Use the subscription surface that replaces the workspace. |
| You are a principal user | Treat **Tasks** as disabled; use the available principal-user workspace. |
| You are not a principal user and Tasks is subscribed | Select **Tasks**. |
| The task is completed | Review it with the form controls in their read-only or disabled state. |
| You own the task | Use the available saving, assignment, and completion actions. |
| The task has an ID | Look for **Reminder** on the saved task form. |

The task list does not show a **Following** filter, a search box, or a standalone toolbar
task menu. The **Following** condition is not active, the search container is not active,
and the toolbar task/activity menu is not active, so these controls do not appear in this
standalone task work.

## Resolve errors and continue

Use the exact message to correct a missing value or stop when the requested action is
blocked. After correcting the task, return to [Create and complete a task](#create-and-complete-a-task).

| Message | What to do |
|---|---|
| `Priority is required` | Select a value in **Priority**, then save again. |
| `Title is required` | Enter the task purpose in **Task Purpose**, then save again. |
| `Start Date is required` | Enter **Start Date**, then save again. |
| `Due Date is required` | Enter **Due Date**, then save again. |
| `Error Saving Registration` | Review the task values and select **Save** or **Save and Close** again. |
| `Error while deleting task` | Do not rely on deletion; review the row's available actions. |
| `This record is related to saved data and cannot be deleted` | Keep the related record and continue in its owning workflow. |
| `Task deleted successfully` | Return to the task list and locate the remaining work. |

### Out-of-scope messages from embedded components

These messages belong to embedded components whose owning pages handle the corresponding
work. Use the owning page or stage shown in the table rather than treating these as My
Desk task-list messages.

| Message | Owning page or stage |
|---|---|
| `Required Receiving Date` | Purchasing inquiry |
| `This field is required` | Purchasing details |
| `Invalid input. The value must be greater than 0 and cannot exceed 999,999.00` | Purchasing details |
| `Invalid input. Please enter a non-negative value` | Purchasing details |
| `Your request was completed successfully` | My Desk activities |
| `Forbidden characters detected. Please remove them and try again.` | My Desk activities |
| `Action not allowed` | My Desk activities |
| `An account with this name already exists` | Account details |
| `An error occurred while processing your request` | Account details |
| `Error: Vendor not saved yet` | Account details |
| `Error: Client not saved yet` | Account details |
| `This Field Is Required` | Account details |
| `You already have a contact with this name` | Contact details |
| `One topic and at least one note is required` | Activities |
| `Custom fields saved successfully` | Sales job |
| `Job updated successfully` | Sales job |
| `Job deleted successfully` | Sales job |
| `Job regretted successfully` | Sales job |
| `Job cancelled successfully` | Sales job |
| `Job missed successfully` | Sales job |
| `Job reactivated successfully` | Sales job |
| `Converted to offer successfully` | Sales job |
| `Converted to inquiry successfully` | Sales job |
| `Error saving custom fields` | Sales job |
| `Cannot be un-delivered — a due invoice already exists` | Sales job |
| `All offers must be in draft status to revert to inquiry` | Sales job |
| `Error {{errorMsg}}` | Sales job |
| `A project with this name already exists` | Sales job |
| `Please save opened inquiry first` | Sales job |
| `All inquiries must be in draft stage to revert to potential` | Sales job |
| `Please enter action for each milstone` | Sales job offer stage |
| `Please save opened cost sheet first` | Sales job offer stage |
| `Booked quantity for this job is greater than the required BOM quantity` | Bill of materials |
| `You cannot edit or delete the product after the purchase package is created` | Bill of materials |
| `Cannot be deleted. Product is in purchasing` | Bill of materials |
| `You cannot edit the product after the PO is created` | Bill of materials |
| `This product is already included in BOM` | Products |
| `The first variant cannot be deleted` | Product details |
| `An error occurred while connecting to your CRM system.` | Product details |
| `Please select one product` | Product details |
| `Required Receiving After` | Products |
| `Package must have at least one item` | MRQ |
| `You cannot save without adding at least one product` | MRQ |
| `Please enter at least one email` | Purchasing |
| `Inquiry must have at least one item` | Purchasing inquiry |
| `Offer must have at least one item` | Purchasing offer |
| `Order must have at least one item` | Purchasing order |
| `Items labeled as ‘Ready for Shipment’ or ‘Delivered’ cannot be deleted` | Purchasing |
| `Please select one or more items to create a RFQ.` | Purchasing |
| `Required Offer Type` | Purchasing inquiry |
| `Required Bid Due Date` | Purchasing inquiry |
| `Error loading accounts` | Delivery orders |
| `Serial you have entered already exist and belong to same manufacturer` | Reference details |
| `There is error in serial you have entered` | Reference details |
| `Minimum: At least one serial` | Reference details |
| `Please Add Extension to activate the LG` | L/G details |
| `LG has one or more extensions or deductions and cannot be reverted to the requested stage` | L/G details |
| `Please choose a date after the current expiry date` | L/G details |

## What happens next

After **Save**, the task remains in the task workflow without leaving the form. **Save
and Close** leaves the task form. Completion refreshes task work, and deletion reports
success or error. Use [Sales-job comments and tasks](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/sales-job-comments-and-tasks)
when the task work is filtered to a sales job; that work belongs to the sales job page,
not the standalone My Desk task workflow.
