# Navigation basics

## Overview

**Home** is the dashboard landing area. **My Desk** is the work area for lists, graphs, tasks,
activities, and calendar views.

| If you need to… | Go to |
|---|---|
| Recognize the dashboard landing area | [Understand the visible work area](#understand-the-visible-work-area) |
| Open or adjust dashboard areas | [Dashboard controls and areas](#dashboard-controls-and-areas) |
| Choose a list, graph, task, activity, or calendar area | [My Desk controls and areas](#my-desk-controls-and-areas) |
| Select current, archived, or graph work | [Select a view and navigate](#select-a-view-and-navigate) |
| Understand workspace changes | [Personalizing your workspace](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/personalizing-your-workspace) |
| Get broader screen-recognition guidance | [Understanding the interface](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/understanding-the-interface) |
| Work in the complete My Desk workspace | [My Desk workspace](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/my-desk-workspace) |
| Work with My Desk activities | [My Desk activities](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/my-desk-activities) |

Open `/home` for **Home** or `/my-desk` for **My Desk**.

![The Home dashboard tabs and readouts after sign-in](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/0204f63edda4fb604281c56ffed4df6d.png)

## Before you start

You need a signed-in PAMS session. **Home** is protected by signed-in access. **My Desk** can
look different depending on whether you are a principal user and whether your subscription
includes the relevant features.

| Surface | What determines whether it appears |
|---|---|
| Home dashboard | A dashboard is available to your role. |
| Home dashboard library | At least one dashboard tab exists. |
| Home fallback | Your role has no dashboard. |
| My Desk standard view | You are not a principal user. |
| My Desk principal-user view | You are a principal user. |
| My Desk content | Your subscription includes the My Desk feature. |
| **Tasks** | The Tasks module is included and you are not a principal user. |
| **Activities** | The Activities module is included and you are not a principal user. |
| **Calendar** | The My Desk Calendar feature is included and you are not a principal user. |

The visible list content belongs to the signed-in account. Use the labels and entries on your
screen when choosing a work view.

## Choose and open a work area

Use **Home** for dashboard readouts. Use **My Desk** for list, graph, task, activity, or
calendar work.

### Prerequisites

- You are signed in to PAMS.

### Steps

1. Open the work area you need.

   | If you need to… | Open |
   |---|---|
   | View dashboard readouts | `/home` for **Home** |
   | Review list, graph, task, activity, or calendar work | `/my-desk` for **My Desk** |

2. Identify the active work area from the page content before selecting a tab.

**Result:** You are on **Home** at `/home` or on **My Desk** at `/my-desk`, ready to choose a work view.

The next choice depends on the area you opened: read [Dashboard controls and areas](#dashboard-controls-and-areas)
for **Home**, or [My Desk controls and areas](#my-desk-controls-and-areas) for **My Desk**.

## Understand the visible work area

**Home** can show dashboard tabs and readouts such as pipeline, booking, accounts, teams,
branches, and principals. **My Desk** starts with **Lists** and **Graphs** and can also show
**Tasks**, **Activities**, and **Calendar**.

Home can show these dashboard tabs or areas:

| Area | What to look for |
|---|---|
| **Dashboard** | The main dashboard landing area |
| **Principals Report** | A principals report dashboard tab |
| **Today** | A time-based dashboard area |
| **Next 10 days** | A forward-looking dashboard area |
| **Last 10 days** | A recent-period dashboard area |
| **Business development** | A business-development dashboard area |

Home readouts include **Sales Pipeline**, **Booking This Year**, **Accounts in Sales Pipeline**,
**Teams Booking vs. Target**, **Teams Running Offer**, **Branch Tendency to Target**,
**Principals Tendency to Target**, **Branch Booking vs. Target This Year**, **Principals
Booking vs. Target This Year**, **Branch Running Offers**, and **Principals Running Offers**.

![Home dashboard readouts and the main navigation areas](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/92c84c4d1016e6185b3a63a6d8c80ec6.png)

The next step is to select a dashboard tab or review the My Desk controls for the work area you
opened.

## Dashboard controls and areas

On **Home**, select dashboard tabs and inspect dashboard content. Dashboard editing is a separate
mode; its edit controls appear when edit mode is active.

| Control or area | Use |
|---|---|
| **Principals Report** | Select a dashboard tab of that type. |
| **Eagle View** | Select a dashboard tab of that type. |
| **Rename tab** | Open tab renaming while edit mode is active. |
| **Delete tab** | Open tab deletion while edit mode is active. |
| **Restore the Standard Tabs** | Open the restore confirmation menu while edit mode is active. |
| **Cancel** | Close the restore confirmation menu. |
| **Restore** | Restore the standard tabs. |
| **Widget** | Open the add-widget flow while edit mode is active. |
| **Save** | Save dashboard changes while edit mode is active. |
| **Select all** | Select all widgets in the widget chooser. |

The add-tab and rename-tab dialogs each require **New Tab**.

On **Home**, these are visible, non-required inputs:

- **Sort by Booking**.
- **Sort by Target**.
- **Sort by Achievement**.

### Add widgets to a dashboard tab

Use the widget chooser when you need to add a card or chart to the active dashboard tab.

**Prerequisites**

- You are in Home edit mode.

**Steps**

1. Select **Widget**.
2. Select the widgets to add.
3. Select **Select all** when you want every widget in the chooser.
4. Select **OK**.
5. Select **Save**.

**Result:** The selected widgets are added to the active dashboard tab and the dashboard changes
are saved.

![The widget chooser opened from the Home dashboard](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/92c84c4d1016e6185b3a63a6d8c80ec6.png)

When standard tabs are being restored, the confirmation text is:
`Are you sure you want to replace your tabs with standard tabs?`

Continue with [Personalizing your workspace](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/personalizing-your-workspace) for dashboard-tab
and widget changes. If you opened **My Desk**, continue with [My Desk controls and areas](#my-desk-controls-and-areas).

## My Desk controls and areas

**My Desk** keeps list, graph, task, activity, and calendar areas within the `/my-desk` route.

| Control | Destination or use |
|---|---|
| **Filter** | Open the filter-column menu. |
| **Lists** | Open list work. |
| **Graphs** | Open graph work. |
| **Tasks** | Open tasks when Tasks is available to your role. |
| **Activities** | Open activities when Activities is available to your role. |
| **Calendar** | Open the calendar when Calendar is available to your role. |
| **Visit** | Open the visit activity entry. |
| **Meeting** | Open the meeting activity entry. |
| **Call** | Open the call activity entry. |

Select **Current**, **Archived**, or **Graphs** to change the My Desk view while remaining at
`/my-desk`. These choices do not change a record or move a stage.

![My Desk with the Current work view selected](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/2c8ce586a7a179ff95e876d7282cd950.png)

Continue with [My Desk filter choices](#my-desk-filter-choices) to filter the selected area, or
with [Select a view and navigate](#select-a-view-and-navigate) to choose **Current**, **Archived**,
or **Graphs**.

## My Desk filter choices

Filtering starts from **Filter**, which opens the filter-column menu for the current My Desk area.

### Prerequisites

- You are on `/my-desk`.
- You have selected the My Desk area whose columns you want to filter.

### Steps

1. Select **Filter** in the My Desk toolbar.
2. Choose from the filter-column menu.

**Result:** The filter-column menu is open for the selected My Desk area.

The My Desk toolbar provides **Filter** as the available filter entry point. Layout, row-filter,
group-filter, import, and export settings are unavailable in this view.

Continue with [Select a view and navigate](#select-a-view-and-navigate) to choose the entries or
graphs you want to review.

## Select a view and navigate

**Current** is the My Desk list of current entries. **Archived** is the list of archived entries.
**Graphs** is the graph view.

### Prerequisites

- You are signed in.
- You are on `/my-desk`.

### Steps

1. Select a My Desk view.

   | View | Destination |
   |---|---|
   | **Current** | List entries |
   | **Archived** | Archived entries |
   | **Graphs** | Graph view |

2. Review the selected view.

   ![Current list entries in My Desk](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/2c8ce586a7a179ff95e876d7282cd950.png)

   Review archived entries next.

   ![Archived list entries in My Desk](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/d6db9951f7d04455483763db7d3b5716.png)

   Review graph work next.

   ![Graph work in My Desk](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/f2f5de4fabcfaf01d98bfc29a5ae29c1.png)

**Result:** You have selected **Current**, **Archived**, or **Graphs**, and remain on My Desk at `/my-desk`.

The visible controls can vary with your role, subscription, and layout. Read [Handle role,
subscription, and layout differences](#handle-role-subscription-and-layout-differences) before
troubleshooting a different view.

## Handle role, subscription, and layout differences

Navigation surfaces depend on role and subscription. A different set of tabs can mean that you
are a principal user, your role has no dashboard, or your subscription does not include a My Desk
feature.

| Difference | What you can expect |
|---|---|
| No Home dashboard | Home shows the no-dashboard message instead of the dashboard library. |
| Principal user | My Desk uses its principal-user view. |
| Standard user | My Desk uses the standard view when you are not a principal user. |
| No My Desk subscription feature | My Desk content that depends on that feature does not appear. |
| No Tasks module | **Tasks** does not appear. |
| No Activities module | **Activities** does not appear. |
| No My Desk Calendar feature | **Calendar** does not appear. |
| No Home dashboard tab | The dashboard library does not appear because it requires at least one dashboard tab. |

When Home has no dashboard, it displays `Your role has no dashboard` and
`Kindly, Contact your administrator to define a dashboard`.

Use these conditions to distinguish an expected role or subscription difference from a navigation
problem. Do not infer which account-specific records belong in a list from this page.

The next step is to compare the visible surface with these conditions.

## When navigation does not match

Start with the work area and feature conditions above. Some principal-report columns and My Desk
list areas depend on the layout available to your account. If My Desk shows page text but no
selectable controls, wait for the available work-area tabs to appear.

| What you see | What to do |
|---|---|
| Home has no dashboard | Treat it as the role's dashboard fallback. Home displays the no-dashboard message when the role has no dashboard. |
| A dashboard area or My Desk block differs | Check the role, principal-user status, subscription features, and selected work view. |
| A dashboard column or My Desk layout is incomplete | Wait for the account's available layout to finish loading. |
| A control is absent from My Desk | Check the available **Current**, **Archived**, and **Graphs** tabs, then confirm the role and feature availability. |
| A save or restore action reports success | The product message is `Your request was completed successfully`. |
| An action reports an error | The product message is `An error occurred while processing your request`. |
| Standard-tab restoration asks for confirmation | The product asks `Are you sure you want to replace your tabs with standard tabs?` before restoration. |

If the visible surface still does not match these conditions, use the focused page for that work
area or ask your PAMS administrator to confirm the role and subscription.

## Continue from the work area

After you choose a work area, continue with the page that owns the next task:

| Starting point | Continue with |
|---|---|
| Home dashboard orientation | [Personalizing your workspace](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/personalizing-your-workspace) for dashboard and workspace changes. |
| My Desk workspace orientation | [My Desk workspace](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/my-desk-workspace) for the complete workspace map. |
| My Desk activities | [My Desk activities](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/my-desk-activities) for activity work. |
| Reports | The Reports area for report-tab and widget navigation when Reports is available to your role. |

### Out of scope

These parsed messages belong to embedded panels owned by the named page, not to navigation
orientation.

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