# Understanding the interface

The signed-in Home and Dashboard surfaces help you recognize the page, choose a
dashboard view, and review the visible report and widget areas.

## What the Dashboard is for

The Dashboard is the signed-in Home surface for viewing dashboard tabs, report
controls, and available widget content.

| If you need to… | Go to |
|---|---|
| Recognize the Dashboard and its surrounding navigation | Open the Dashboard and orient yourself |
| Understand what must be in place before the surface appears | Before you open the Dashboard |
| Choose a time-range or dashboard view | Select a dashboard view |
| Understand the visible report and widget areas | Review the visible measures |
| Resolve a message or an unexpected surface | Troubleshooting |
| Learn the wider application navigation | Navigation basics |
| Change workspace and dashboard settings | Personalizing your workspace |
| Read the broader Dashboard overview and role variants | Dashboard |
| Find the complete widget catalog | Dashboard widget catalog |
| Route a problem to support | [Getting help](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/getting-help) |

A dashboard tab is a selectable view whose active content occupies the Dashboard
area. In the widget view, the grid contains the widgets selected for the active tab.
Prepared role dashboards provide radio choices for the available role dashboards.

## Before you open the Dashboard

The Home surface is available only in the signed-in state. Dashboard content
also depends on the dashboard setup and the subscription available to your
company.

| Setup condition | What appears |
|---|---|
| You are signed in | The Home surface appears. |
| A custom dashboard is selected | The custom dashboard area appears. |
| Dashboard tabs are available | The Dashboard library appears. |
| Your subscription includes the Dashboard | Dashboard tabs and their content appear. |
| A prepared role dashboard is available | A role dashboard choice appears. |

When prepared role dashboards are available, choose from the displayed radio choices
to review a role dashboard. The Dashboard library appears only when dashboard tabs
are available, and dashboard content appears when your subscription includes the
Dashboard.

The report columns are selected for the active setup. The columns for inquiries,
offers, orders, delivered items, lost items, and cancelled items therefore
depend on that setup. Widget-menu labels and numeric widget values also depend
on the setup available to your company.

> **Note:** The tabs, widget labels, values, and report columns can vary with
> your company setup.

## Open the Dashboard and orient yourself

The Dashboard is the Home surface where you move between application areas,
review the report area, and open dashboard content.

**Prerequisites**

- You are signed in to Pams.

**Steps**

1. Open the Dashboard surface.
2. Identify the navigation entries **Dashboard**, **Reports**, **My Desk**, **Sales**,
   **PM**, **Purchasing**, **Inventory**, **Financial**, **Job Profitability**, and
   **Data**.
3. Identify the **Principals Report** area, the time-range tabs **Today**, **Next 10
   days**, and **Last 10 days**, the required field **Report**, **Generate Report**,
   and **Download as PDF**.
4. Open the dashboard content area.

![Dashboard navigation, report controls, and time-range tabs](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/03ad57abeb62b68412c577fb891041b8.png)

**Result:** The Dashboard page is open with its navigation, report area, visible tabs,
**Report** field, **Generate Report**, **Download as PDF**, and dashboard content area
available for orientation. Use these surfaces to choose the view you need.

## Select a dashboard view

A dashboard view determines which content occupies the Dashboard area. Use this
procedure to move between the available time-range, report, and custom views.

**Prerequisites**

- You are signed in to Pams.
- The Dashboard is open and its available tabs are visible.

**Steps**

1. Select the dashboard tab that matches your task.

   | If you need to… | Select… |
   |---|---|
   | Review today’s dashboard content | **Today** |
    | Review the next ten days | **Next 10 days** |
    | Review the previous ten days | **Last 10 days** |
    | Review the principal report | **Sales Report** |
   | Review the custom dashboard | **Eagle View** |

2. Review the content shown for the selected tab.
3. When the widget-selection area is available, choose one option:

   | If you need to… | Select… |
   |---|---|
   | Find a widget | **Search for widget** |
   | Select every widget | **Select all** |

4. When edit mode is active, select one of these controls to manage the selected
   dashboard view:

| If you need to… | Select… |
|---|---|
| Restore the standard tabs | **Restore** |
| Add a widget | **Add New Widget** |
| Save dashboard changes | **Save** |
| Close the restore-standard-tabs sub-menu | **Cancel** |
| Open tab renaming | **Rename tab** |
| Open tab deletion | **Delete tab** |
| Remove the selected widget from the active tab | **Remove widget from tab** |

**Result:** The selected dashboard view is open, showing its time-range, principal
report, custom dashboard, or widget content. Continue by reviewing the measures on
that view.

## Review the visible measures

A selected widget is an item chosen for the active dashboard tab. The Dashboard
uses the selected-widget list to generate the widget grid, so the grid reflects
the list selected for that tab.

**Prerequisites**

- The Dashboard is open.
- You have selected a dashboard view.

**Steps**

1. Complete the required **Report** field in the report area.
2. Select **Generate Report**.
3. Confirm that **Content:** appears in the dashboard content area.
4. Review the visible measures on the active surface.

   | Review… | Locate… |
   |---|---|
   | The principal report | **Principals Report** |
   | Business development | **Business development** |
   | Forecast content | **Including Forecast Including Forecast** |
   | Booking, target, and achievement sorting | **Sort by Booking**, **Sort by Target**, and **Sort by Achievement** |
   | Tickets | **Tickets** |

5. Select **Download as PDF** when you need a PDF copy of the report.

The report columns and widget values follow the active dashboard setup. Review
the values and columns shown after selecting the relevant view.

**Result:** The selected dashboard measures and report content are visible, with the
available report controls ready for further use. If a surface or action is missing,
use the troubleshooting table.

## Troubleshooting

| What you see | What it means | What to do |
|---|---|---|
| `Your request was completed successfully` | The dashboard request completed successfully. | Continue with the page or view that opened. |
| `An error occurred while processing your request` | The dashboard request encountered an error. | Review the current dashboard setup and repeat the request when the relevant controls are available. |
| `Please choose one or more principals` | The report needs at least one principal selected. | Select one or more principals, then generate the report again. |
| The Dashboard surface is absent | The signed-in state, custom-dashboard choice, available tabs, or subscription affects whether the surface appears. | Confirm that you are signed in and check the dashboard setup available to your company. |
| **Search for widget**, **Rename tab**, or **Delete tab** is unavailable | These controls depend on the current dashboard setup or edit mode. | Use the control when it is available on the Dashboard. |

### Out of scope

| Message | Owning page |
|---|---|
| `Incorrect username or password` | Sign-in page |

Use [Getting help](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/getting-help) for support routing when the Dashboard
still does not match the setup available to your company.
