# My Desk workspace

Use My Desk to narrow your daily work, choose a list or work view, and hand a linked
record to the page that owns it.

## Before you start

My Desk is a personal, filterable daily workspace. It brings together lists, graphs,
tasks, activities, and calendar appointments; it is not a sales-job record. Its scope
can include a client, vendor, project, sales-responsible person, contact, and team.
A scope is the client, vendor, project, sales-responsible person, contact, or team that
limits the work shown in the workspace.
When you open a linked record, My Desk shows that record for inspection and hands edits
to the record's owning page.

The standard workspace is titled **My Desk**. Principal users see **Principal Desk** and
choose a client for the workspace.
A principal user is a user who works from **Principal Desk** and chooses a client scope.

| If you need to… | Go to |
| --- | --- |
| Narrow the records in your workspace | [Focus work and choose a list group](#focus-work-and-choose-a-list-group) |
| Choose a list, graph, task, activity, or calendar view | [Choose a work mode](#choose-a-work-mode) |
| Add a task or activity | [Add a task or activity from My Desk](#add-a-task-or-activity-from-my-desk) |
| Complete or delete a task | [Act on a task row](#act-on-a-task-row) |
| Continue work on a linked record | [Open and hand off a linked record](#open-and-hand-off-a-linked-record) |
| Understand principal-user or subscription differences | [Handle principal-user and subscription variations](#handle-principal-user-and-subscription-variations) |
| Find the meaning of an opened-panel message | [Messages from linked panels](#messages-from-linked-panels) |
| Work with standalone tasks | My Desk tasks |
| Record standalone activities | My Desk activities |
| Work with dashboard graphs | [Dashboard overview](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/dashboard-overview) |
| Create a task | [Create a task](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/create-task) |
| Create an activity | [Create an activity](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/create-activity) |
| Continue a sales job, invoice, principal invoice, L/G, account, project, contact, user, or team | Its owning record page |

## Prerequisites

My Desk requires the My Desk module subscription. If the module is not included in
your plan, the workspace content is replaced by a subscription page with **Upgrade
needed**, the message `The feature you are trying to use is not included in your current
plan. Please upgrade your plan.`, and **Upgrade now** and **Back** actions.

Principal users use **Principal Desk** with a searchable client field. Their personal
**Tasks**, **Activities**, and **Calendar** tabs are disabled. **Calendar** also requires
the Calendar subscription.

> **Note:** My Desk is a hand-off workspace. Use the owning page when you need the full
> record form or the form's messages.

## Focus work and choose a list group

Use the lists area to review current or archived work within the scope you select.

**Prerequisites**

- You have access to the My Desk workspace.
- You know which client, vendor, project, sales-responsible person, contact, or team
  should define your work scope.

**Steps**

1. Select **Filter** to reveal the filter block.
2. Select the scope chips that match the work you want to review: **Client**, **Vendor**,
   **Project**, **Sales Responsible**, **Contact**, or **Team**.
3. On a selected scope chip, select its remove control to remove that scope from the
   workspace.
4. Beside the scope chips, select the remove-all control to clear every selected scope and
   return to an unscoped workspace.
5. Select the **Lists** tab.
6. Select **Current** to review current work.
7. Select **Archived** to review archived work.

   ![Current work groups and their list contents](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/4d569dab76496e847e886d7a49b5ba0a.png)

The selected scope filters the list data, and the selected list group is saved for the
workspace. Loading placeholders appear while the list data is loading.

**Result:** The Lists view shows the selected **Current** or **Archived** group for your
chosen scope, or its loading placeholders while that data is being retrieved.

With the list group selected, continue to [Choose a work mode](#choose-a-work-mode).

## Prerequisites

The same filter context is passed to the list, graph, task, activity, and calendar work
components. Principal-user status and feature subscriptions determine which tabs can be
selected. The selected main tab is saved when a saved choice is available.

Do not treat a disabled tab as missing data. It indicates a user-context or subscription
condition.

## Choose a work mode

Each work mode answers a different daily question: **Graphs** gives a non-editable
dashboard view, **Tasks** gives the task list, **Activities** gives the activity list,
and **Calendar** gives appointment work in a calendar. A graph data point or calendar
appointment can take you to related work.

**Prerequisites**

- My Desk is available.
- The required feature subscription is included for the work mode you need.
- You are not a principal user when selecting **Tasks**, **Activities**, or **Calendar**.

**Steps**

1. Select the mode that matches your work:

   | If you need to… | Select | What opens |
   | --- | --- | --- |
   | Review dashboard measures | **Graphs** | A non-editable dashboard container |
   | Review or add tasks | **Tasks** | The task list |
   | Review or add activities | **Activities** | The activity list |
   | Review appointments by date | **Calendar** | The calendar |

   Selecting **Tasks**, **Activities**, or **Calendar** is unavailable for principal users.
2. If you select **Graphs**, review the dashboard surface.

   ![Graphs with dashboard measures and linked work areas](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/aa5993093fe8b93e4eccf25f2c4d6a8c.png)

   Select a graph data point when you need to continue into the related work.
3. If you select **Tasks**, review the task list.

   ![Task work mode with its list columns](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/143dd75b9e004888d114161bd83a2f89.png)

4. If you select **Activities**, review the activity list.

   ![Activity work mode and its activity list](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/2f2c14676b9d02c9355c17aae1e46e69.png)

5. If you select **Calendar**, review the calendar.
6. In Calendar, use the control in the table that matches your next action:

   | If you need to… | Use |
   | --- | --- |
   | Choose calendar data | `Filter data` |
   | Apply the calendar filter | **Submit** |
   | Return to today's date | **Today** |
   | Change to a timeline view | **Timeline** |

   **Timeline** is unavailable in Month view.
7. Select a calendar appointment to open its related work.

The calendar can show **Day** and **Month** views, with `Sun`, `Mon`, `Tue`,
`Wed`, `Thu`, `Fri`, and `Sat` columns. In Month view, **Timeline** is
unavailable.

**Result:** The selected work mode is displayed. The standard-user workspace shows
**Graphs**, **Tasks**, **Activities**, and **Calendar** when those features are available;
principal users see the three personal tabs disabled.

When you need to create a task or activity, continue to
[Add a task or activity from My Desk](#add-a-task-or-activity-from-my-desk).

## Prerequisites

The **Tasks** and **Activities** tabs are subscription-gated. Principal users cannot use
those tabs. When either tab is active for an eligible user, the add icon in its tab header
opens the corresponding creation entry point. In the **Activities** tab, find the add icon in
the tab header; it opens the activity type menu. The detailed forms belong to
[Create a task](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/create-task) and [Create an activity](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/create-activity), not to the My Desk
workspace.

## Add a task or activity from My Desk

My Desk provides the shared entry point; the owning form supplies the fields and save
rules.

**Prerequisites**

- The **Tasks** or **Activities** tab is available and active.
- You know whether you are creating a task, a Visit, a Meeting, or a Call.

**Steps**

Use this table to choose the activity entry point before following the numbered steps:

| If you need to create | When this applies | Action |
| --- | --- | --- |
| A standalone task | If **Tasks** is active | In the **Tasks** tab header, select the add icon to open the Task popup. |
| Open the activity menu | If **Activities** is active | In the **Activities** tab header, select the add icon. |
| Choose an activity type | If the activity menu is open | Select **Visit**, **Meeting**, or **Call**. |

1. If **Tasks** is active, select the add icon in the **Tasks** tab header to
   open the Task popup.
2. If **Activities** is active, select the add icon in the **Activities** tab header to open the
   activity type menu.
3. If **Activities** is active, select **Visit**, **Meeting**, or **Call** from the activity
   type menu.

   ![Activity type menu with Visit, Meeting, and Call](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/2f2c14676b9d02c9355c17aae1e46e69.png)

4. Complete the form on its owning page.
5. Select **Save** in the form.
6. If you do not want to save, select the control at the right side of the popup header to
   close the popup without saving.

**Save** validates the form and refreshes the relevant My Desk list after a successful save.
Use [Create a task](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/create-task) for task fields and [Create an activity](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/create-activity)
for activity fields.

**Result:** The selected task or activity form is open, or the relevant list is refreshed
after a successful save.

After the form opens, continue with [Add a task](#add-a-task) or
[Add an activity](#add-an-activity).

### Add a task

The task popup embeds the new-task form. Use it when you need a standalone task visible in
the My Desk task list.

**Prerequisites**

- The Task popup is open from the active **Tasks** tab.
- You have the task priority, purpose, start date, and due date.

**Steps**

1. In the task form, complete the required **Priority** field.
2. Complete the required **Task Purpose** field.
3. Complete the required **Start Date** field.
4. Complete the required **Due Date** field.
5. Keep **Due Date** on or after **Start Date**.
6. Review the dates: a new task starts with today's date and tomorrow's date as the date
   defaults.
7. Select **Save**.

The task form validates the required fields and date order. A successful save refreshes the
task list.

**Result:** The saved task is available in the My Desk task list.

Continue with [Act on a task row](#act-on-a-task-row) when you need to open, complete,
un-complete, or delete a task.

### Prerequisites

Open the menu at the right end of a task row to see its available actions. Only the task owner can
change task completion. Completing or deleting a task requires confirmation.

Use the action that matches the required result:

| If you need to | Use the row menu action |
| --- | --- |
| Open the task page | **Open** |
| Change the completion state | **Complete** or **Consider As Not Completed** |
| Remove the task | **Delete** |

### Act on a task row

Use the menu at the right end of a task row to open the task, change its completion state,
or delete it.

**Prerequisites**

- A task row is visible in the task list.
- You own the task when you need to change its completion state.

**Steps**

1. Open the menu at the right end of the task row.
2. If you need the task page, select **Open** to hand the task to its owning task page.
3. If you need to mark the task complete, select **Complete**.
4. If the completion confirmation appears, select **Yes** to confirm or **No** to cancel.
5. If you need to remove the completion state, select **Consider As Not Completed**.
6. If the un-completion confirmation appears, select **Yes** to confirm or **No** to cancel.
7. If you need to remove the task, select **Delete**.
8. If the deletion confirmation appears, select **Yes** to delete the task, or **No** to
   cancel.

Completion refreshes the grid. If deletion is refused because the task is related to saved
data, the message is `This record is related to saved data and cannot be deleted`.

**Result:** The task opens, changes completion and refreshes the grid, is deleted with its
success result, or remains unchanged after **No** or a refusal.

### My Desk task messages

The task row owns these messages:

| When you select | Message |
| --- | --- |
| **Complete** | `Are you sure that you want to mark this task as completed?` |
| **Consider As Not Completed** | `Are you sure that you want to un-complete this task?` |
| **Delete** | `Are you sure you want to delete this task?` |
| After a successful deletion | `Task deleted successfully` |

**Result:** The task opens, changes completion and refreshes the grid, is deleted with its
success result, or remains unchanged after **No** or a refusal.

Continue with [Add an activity](#add-an-activity) when the next item is an activity rather
than a task.

### Add an activity

An activity records a Visit, Meeting, or Call and then hands its details to the activity
page that owns the form.

**Prerequisites**

- The **Activities** tab is available and active.
- You know whether the activity is a Visit, Meeting, or Call.

**Steps**

1. If **Activities** is active, select the add icon in the **Activities** tab header to open the
   activity type menu.
2. Select **Visit**, **Meeting**, or **Call** from the activity type menu.
3. Complete the type-specific activity fields.
4. For a Visit, complete the required date or title fields shown by the Visit form.
5. For a Meeting, complete **Meeting Purpose**, **Priority**, **Location**, **Tags**,
   **Participant**, **Start Date**, **End Date**, **Prepared By**, and **Signature** as
   applicable; **Start Date** and **End Date** carry required markers.
6. For a Call, complete the fields shown by the Call form.
7. Select **Save** or **Save and Close** in the activity form.

The activity save finalizes the activity and displays its success or error result. An
activity request can show `Your request was completed successfully`, `Forbidden characters
detected. Please remove them and try again.`, or `Action not allowed`. A creation form can
also show `This action is only allowed if you belong to that branch`, `One topic and at
least one note is required`, or `There is no topic to print`.

**Result:** The selected activity form is saved and its result is displayed, or the form
remains open with its message.

Continue with [Open and hand off a linked record](#open-and-hand-off-a-linked-record) when
you need to inspect related work from a list or graph.

## Prerequisites

A linked record must come from a My Desk list or a supported graph widget. My Desk opens
the record in a dynamically titled tab and keeps it in view mode. A standard user can open
the record's normal page when the record supplies a normal link.

## Open and hand off a linked record

Use the opened-record view to inspect supported sales jobs, invoices, principal invoices,
L/Gs, clients or principals, projects, contacts, users, and teams. Continue to the owning
page when you need the record's normal form.

**Prerequisites**

- A supported linked record is visible in a list or graph.
- The record supplies a normal link when you need to edit it.

**Steps**

1. Select the linked record in the list or graph.
2. Select the dynamically titled opened-record tab to inspect the record in My Desk view
   mode.
3. For a standard user, select the control at the right end of the opened-record tab in the
   tab bar to open the record's normal page.
4. For a principal user, read the opened record in view mode; no editing control is available.
5. At the right end of the opened-record tab in the tab bar, select the control that closes the
   tab and returns you to **Lists**.

The standard-user notice says `To make changes, click the pen icon on the tab bar.` The
principal-user notice says `View Mode Only`.

**Result:** The record is either open in My Desk view mode, open on its owning page, or
closed with **Lists** restored and the opened-record tab reset.

Continue with [Handle principal-user and subscription variations](#handle-principal-user-and-subscription-variations)
when the workspace title, tab state, or subscription message differs from the standard view.

## Prerequisites

Your user type and subscriptions determine which My Desk surfaces are present or actionable.
Standard users see the personal workspace branches. Principal users see the Principal Desk
branch, disabled personal tabs, and a different opened-record view-mode path. My Desk and
Calendar are subscription-gated.

## Handle principal-user and subscription variations

Use the workspace title, tab state, and subscription message to identify the branch you are
in before selecting a work mode.

| What you see | What it means | What you can use |
| --- | --- | --- |
| **My Desk** | Standard-user workspace | Personal lists, filters, and eligible work tabs |
| **Principal Desk** and a searchable client field | Principal-user workspace | Client-scoped principal work |
| Disabled **Tasks**, **Activities**, or **Calendar** | Principal-user restriction | **Graphs** remains available |
| **Upgrade needed** | My Desk or a selected feature is not in the plan | **Upgrade now** or **Back** |

**Steps**

1. Read the workspace title to distinguish **My Desk** from **Principal Desk**.
2. If you are on **Principal Desk**, select a client in the searchable client field to
   set the principal workspace scope.
3. Select **Graphs** when the personal work tabs are disabled.
4. If **Calendar** is unavailable because its subscription is absent, select **Upgrade now**
   or **Back** on the subscription surface.

The standard workspace shows **Graphs** when it is available. On Principal Desk, **Tasks**,
**Activities**, and **Calendar** are disabled. The My Desk subscription-unavailable surface
replaces normal workspace content when the module is not included.

**Result:** The workspace shows the work modes permitted by your user context and
subscriptions.

Continue with [When workspace behaviour does not match](#when-workspace-behaviour-does-not-match)
if a tab, filter, loading state, or calendar view does not match the expected workspace.

### Prerequisites

The same visible differences can result from four states: a disabled tab, a subscription
surface, list-loading placeholders, or a work mode that does not support the requested view.

## When workspace behaviour does not match

Use the symptom and next action below to distinguish a workspace condition from a missing
record.

| What you see | What it means | What to do |
| --- | --- | --- |
| **Tasks**, **Activities**, or **Calendar** is visible but disabled | Principal-user restriction | Use **Graphs** or the principal workspace route |
| **Upgrade needed** and its subscription message | The required subscription is unavailable | Select **Upgrade now** or **Back** |
| Loading skeleton groups | List data is still loading | — |
| The standard **Filter** area is absent on Principal Desk | Principal Desk uses the client field instead | Select a client in that field |
| **Timeline** is unavailable in **Month** view | The calendar does not offer Timeline in Month view | Select **Day** or a non-Month view |
| Goods receipt dates do not appear in the visible Calendar filter | The visible filter does not expose Goods receipt dates | Use the calendar data choices that are visible |

The permitted column-request error path has no reader-visible error or fallback message.

### Messages from linked panels

Opened record panels are owned by their respective record pages. My Desk keeps them in view
mode and directs changes to the owning page. Task and activity form messages belong to
[Create a task](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/create-task) and [Create an activity](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/create-activity).

When an opened record shows the standard-user notice, read `To make changes, click the pen
icon on the tab bar.` At the right end of the opened-record tab in the tab bar, select the
control that opens the record's normal page. When it
shows `View Mode Only`, use the principal-user view without editing it in My Desk.

The subscription surface uses these exact messages and actions:

- **Upgrade needed**
- `The feature you are trying to use is not included in your current plan. Please upgrade your plan.`
- **Upgrade now**
- **Back**

### Messages owned by other pages

The following messages can appear after My Desk hands work to an owning page. Use the named
page for the fields, validation, save, and error response associated with that message.

| Owning page | When to use it | Message |
| --- | --- | --- |
| Create a task or Create an activity | A required embedded field is empty | `This field is required  ` |
| Create a task or Create an activity | A numeric value is outside the allowed range | `Invalid input. The value must be greater than 0 and cannot exceed 999,999.00` |
| Create a task or Create an activity | A numeric value is negative | `Invalid input. Please enter a non-negative value` |
| My Desk tasks | A related task cannot be deleted | `This record is related to saved data and cannot be deleted` |
| My Desk activities | An activity request succeeds | `Your request was completed successfully` |
| My Desk activities | An activity contains forbidden characters | `Forbidden characters detected. Please remove them and try again.` |
| My Desk activities | An activity action is refused | `Action not allowed` |
| Purchasing inquiry | A receiving date is required | `Required Receiving Date` |
| Products | A receiving-after value is required | `Required Receiving After` |
| Purchasing inquiry | An offer type is required | `Required Offer Type` |
| Purchasing inquiry | A bid due date is required | `Required Bid Due Date` |
| Accounts | An account name already exists | `An account with this name already exists` |
| Accounts | A request cannot be processed | `An error occurred while processing your request` |
| Accounts | A vendor has not been saved | `Error: Vendor not saved yet` |
| Accounts | A client has not been saved | `Error: Client not saved yet` |
| Accounts | A required account field is empty | `This Field Is Required` |
| Contacts | A contact with the same name already exists | ` You already have a contact with this name` |
| Libraries | A library name contains an unsupported character | `Just '_'‘-''.' And '&' Characters Accepted` |
| Teams | Storage has reached its limit | `You’ve reached the maximum storage limit` |
| Principal invoices | Invoice validation fails | `Check validation` |
| Create an activity | The activity branch rule is not met | `This action is only allowed if you belong to that branch` |
| Create an activity | A topic or note is missing | `One topic and at least one note is required` |
| Create an activity | There is no topic to print | `There is no topic to print` |
| Sales job record | Custom fields save successfully | `Custom fields saved successfully` |
| Sales job record | A job is updated | `Job updated successfully` |
| Sales job record | A job is deleted | `Job deleted successfully` |
| Sales job record | A job is regretted | `Job regretted successfully` |
| Sales job record | A job is cancelled | `Job cancelled successfully` |
| Sales job record | A job is missed | `Job missed successfully` |
| Sales job record | A job is reactivated | `Job reactivated successfully` |
| Sales job record | A job becomes an offer | `Converted to offer successfully` |
| Sales job record | A job becomes an inquiry | `Converted to inquiry successfully` |
| Sales job record | A job becomes regretted | `Converted To Regretted` |
| Sales job record | A job becomes cancelled | `Converted to cancelled` |
| Sales job record | A job becomes lost | `Converted to lost` |
| Sales job record | Custom-field saving fails | `Error saving custom fields` |
| Sales job record | A due invoice prevents undelivery | `Cannot be un-delivered — a due invoice already exists` |
| Sales job record | An offer is not in draft status | `All offers must be in draft status to revert to inquiry` |
| Sales job record | The server returns a variable error | `Error {{errorMsg}}` |
| Sales job record | A project name already exists | `A project with this name already exists` |
| Sales job record | A mandatory field is missing | `Check mandatory field(s)` |
| Sales job record | An opened inquiry is not saved | `Please save opened inquiry first` |
| Sales job record | An inquiry is not in draft stage | `All inquiries must be in draft stage to revert to potential` |
| Sales job record | An item has zero quantity | `One or more items has ZERO quantity` |
| Sales job record | An item has no unit | `One or more items has no unit` |
| Offers | An action is missing for a milestone | `Please enter action for each milstone  ` |
| Offers | An opened cost sheet is not saved | `Please save opened cost sheet first` |
| Offers | A discount exceeds the negotiation margin | `There is a maximum discount that exceeds the negotiation margin.` |
| Offers | The gross-profit margin is unacceptable | `The gross profit margin is unacceptable, and the release prices have been stopped.` |
| Orders | A sales order is archived | `Sales order is archived` |
| Orders | Booked quantity exceeds the required BOM quantity | `Booked quantity for this job is greater than the required BOM quantity` |
| Orders | A product is locked after package creation | `You cannot edit or delete the product after the purchase package is created` |
| Orders | A product in purchasing cannot be deleted | `Cannot be deleted. Product is in purchasing` |
| Orders | A product is locked after purchase-order creation | `You cannot edit the product after the PO is created` |
| Products | A product is already in a BOM | `This product is already included in BOM` |
| Products | The first variant cannot be deleted | `The first variant cannot be deleted` |
| Products | The CRM connection fails | `An error occurred while connecting to your CRM system.` |
| Products | No product is selected | `Please select one product` |
| MRQ | A package has no item | ` Package must have at least one item` |
| MRQ | A product is missing from the package | `You cannot save without adding at least one product` |
| MRQ | A product has no quantity | `One of products has no quantity` |
| Purchasing | All remaining items are selected | `No remaining items. All items have been selected` |
| Purchasing | No email is entered | `Please enter at least one email` |
| Purchasing | An inquiry has no item | `Inquiry must have at least one item` |
| Purchasing | An offer has no item | `Offer must have at least one item` |
| Purchasing | An order has no item | `Order must have at least one item` |
| Purchasing | A ready or delivered item is selected for deletion | `Items labeled as ‘Ready for Shipment’ or ‘Delivered’ cannot be deleted` |
| Purchasing | No item is selected for an RFQ | `Please select one or more items to create a RFQ.` |
| Job profitability | Permission is missing | `You don’t have permission` |
| Orders | Accounts cannot be loaded | `Error loading accounts` |
| Reference lists | A serial already exists for the manufacturer | `Serial you have entered already exist and belong to same manufacturer` |
| Reference lists | A serial is invalid | `There is error in serial you have entered` |
| Reference lists | No serial is entered | `Minimum: At least one serial` |
| L/G lifecycle | An extension is needed | `Please Add Extension to activate the LG` |
| L/G lifecycle | An L/G has extensions or deductions | `LG has one or more extensions or deductions and cannot be reverted to the requested stage` |
| L/G lifecycle | An L/G still needs confirmation | `LG still needs confirmation` |
| L/G lifecycle | The selected date is not after expiry | `Please choose a date after the current expiry date` |
| L/G lifecycle | A pending increase exists | ` There is a pending increase you can edit` |
