# Personalizing your workspace

Use this page to choose the My Desk view that matches your work and, when your
account provides Dashboard editing, arrange the Dashboard content you need.

## Before you start

Workspace personalization means choosing a working view in **My Desk** and,
where it is available, arranging content on **Dashboard**. **My Desk** is at
`/my-desk`; **Dashboard** is at `/dashboard`.

| Workspace surface | Includes |
| --- | --- |
| **My Desk** | **Lists**, **Current**, **Archived**, **Graphs**, **Tasks**, **Activities**, and **Calendar**. |
| **Dashboard** | The dashboard library. |

| If you need to… | Go to |
| --- | --- |
| Choose the list or work view for the current task | [Set your work view](#set-your-work-view) |
| Understand the tabs and columns before choosing a view | [Recognize the workspace surfaces](#recognize-the-workspace-surfaces) |
| Add, remove, restore, or save Dashboard widgets | [Manage widgets](#manage-widgets) |
| Rename the active Dashboard tab | [Edit tabs](#edit-tabs) |
| Understand why a tab or control is unavailable | [Handle workspace availability branches](#handle-workspace-availability-branches) |
| Continue with task or activity work | [My Desk tasks](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/my-desk-tasks) or [My Desk activities](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/my-desk-activities) |
| Continue with Dashboard content | [Dashboard overview](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/dashboard-overview) or [Dashboard widget catalog](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/dashboard-widget-catalog) |

## Prerequisites

You must be signed in to reach My Desk or Dashboard. The controls you see also
depend on your role, subscription, active Dashboard tab, and whether Dashboard
is in edit mode.

| Condition | What it affects |
| --- | --- |
| You are a non-principal user | **Filter**, **Tasks**, **Activities**, and **Calendar** can be available on My Desk. |
| Your subscription includes the relevant feature | **Lists** and **Graphs** can appear; **Tasks**, **Activities**, and **Calendar** each also depend on their named feature. |
| A Dashboard tab is active and editable | Tab-menu actions apply to that active tab. |
| Dashboard is in edit mode | **Restore Standard Tabs**, **Add New Widget**, and **Save** can appear. |
| The active tab is an Eagle View tab | The Eagle View dashboard child can appear. |

> **Note:** Dashboard edit controls appear only when Dashboard is in edit mode.

## Open the workspace

Open the workspace surface that contains the view or Dashboard content you need.

### Prerequisites

- You are signed in.
- You know whether you need a My Desk work view or Dashboard content.

**Steps**

1. Select the workspace surface you need.

   | If you need to… | Select |
   | --- | --- |
   | Choose a My Desk work view | **My Desk** |
   | Work with Dashboard content | **Dashboard** |

**Result:** My Desk or Dashboard is open, and you can identify the active
workspace surface before changing its view.

## Recognize the workspace surfaces

My Desk is where you choose a work view. Dashboard is where you work with the
content on the active dashboard tab. The exact content in each area depends on
your account and the active tab.

| Surface | What to look for |
| --- | --- |
| My Desk | **Current**, **Archived**, **Graphs**, **Tasks**, **Activities**, and **Calendar**. |
| Tasks | **Title**, **Owner**, **Start date**, **Due date**, **Status**, and **Importance** columns. |
| Activities | **Title**, **Visitors**, **Activity purpose**, **Company**, **Start date**, **Status**, and **Importance** columns. |
| Calendar | **Sun**, **Mon**, **Tue**, **Wed**, **Thu**, **Fri**, and **Sat** weekday columns. |
| Dashboard | The active tab's dashboard grid and its account-dependent content. |
| Eagle View | A custom Dashboard child when the active tab is Eagle View. |

When Eagle View is active, its analysis choices include **Analyze**, **Clients**,
**Vendors**, **Projects**, and **Market Segments**. Other choices depend on the
loaded data.

My Desk can show Tasks, Activities, and Contacts layouts selected at run time.
Dashboard can show a run-time-selected widget list and principal-report columns.
Those contents are account-specific. Continue to [Set your work view](#set-your-work-view)
for My Desk, or to [Manage widgets](#manage-widgets) for Dashboard.

![My Desk Tasks with its visible columns](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/143dd75b9e004888d114161bd83a2f89.png)

![My Desk Activities with its visible columns](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/b4d94f329ff1bacc7f59e829b1b70855.png)

![My Desk Calendar with weekday columns](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/2403e2e69c7fc758f97d2fa7701dddea.png)

## Set your work view

Choose the My Desk view that matches the work you are about to do. Each choice
keeps you on `/my-desk`.

### Prerequisites

- My Desk is open.
- The required tab is available for your role and subscription.

**Steps**

1. Select one My Desk view.

   | If you need to… | Select |
   | --- | --- |
   | Work with the current view | **Current** |
   | Work with archived items | **Archived** |
   | Work with graph-based information | **Graphs** |
   | Work with tasks | **Tasks** |
   | Work with activities | **Activities** |
   | Work with calendar information | **Calendar** |

2. Confirm that the selected tab is active and that the address remains
   `/my-desk`.

**Result:** The selected My Desk view is on screen, and the address remains
`/my-desk`.

![My Desk Current selected](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/4d569dab76496e847e886d7a49b5ba0a.png)

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

![My Desk Graphs selected](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/aa5993093fe8b93e4eccf25f2c4d6a8c.png)

## Manage widgets

Use Dashboard widget management when Dashboard is in edit mode and the active tab
is editable. A widget is a piece of content placed on that tab.

### Prerequisites

- Dashboard is open.
- **Add New Widget**, **Save**, and **Restore Standard Tabs** are visible.
- The tab you want to change is active and editable.

**Steps**

1. Select **Add New Widget**.
2. In the `Select widget` dialog, select the widgets to add.
3. If you want every available widget, select **Select all**.
4. Select **OK**.
5. Open the active tab's widget menu.
6. If you want to remove a widget, select **Remove widget from tab**.
7. If you want to restore the standard tabs, select **Restore Standard Tabs**.
8. Select **Save**.

**Result:** The active Dashboard tab contains the selected widget arrangement after
you select **Save**. Widget changes are saved through Dashboard **Save**.

### Edit tabs

Use tab editing to change the name of the active editable Dashboard tab. Tab-menu
actions remain scoped to the active tab.

### Prerequisites

- Dashboard is open.
- The target tab is active and editable.
- The tab edit menu is available.

**Steps**

1. Open the menu for the active Dashboard tab.
2. Select **Rename tab** to open the tab-name editor.
3. Enter a name in the **New Tab** field.

**Result:** The active tab menu remains scoped to the active tab. The **New Tab**
field is required in both the add-tab and edit-tab dialogs. If you leave it empty,
the validation text is `This Field Is Required`.

The tab edit controls are conditional, so follow [When a workspace change does
not appear](#when-a-workspace-change-does-not-appear) if the menu is unavailable.

## Handle workspace availability branches

Workspace choices change when your role, subscription, feature access, or active
Dashboard tab changes. Use the following conditions to interpret the choices on
screen.

| Workspace choice or control | Available when |
| --- | --- |
| **Filter** | You are not a principal user. |
| **Lists** and **Graphs** | Your subscription is included for those views. |
| **Tasks** | `TasksModule` is available and you are not a principal user. |
| **Activities** | `ActivitiesModule` is available and you are not a principal user. |
| **Calendar** | `MyDeskCalendar` is available and you are not a principal user. |
| Eagle View | The active tab is an Eagle View tab. |

The global and single-branch view choices are not available choices. The My Desk
refresh control is also not an available control. Dashboard's edit-menu entry that
would enable editing is not an available menu entry. If a needed choice is absent,
check the role, subscription, feature access, and active tab before asking for
help.

## When a workspace change does not appear

Use this table when the surface on screen differs from the choice you expected.

| What you see | What to do |
| --- | --- |
| Dashboard edit controls are absent | Check whether Dashboard is in edit mode and whether the active tab is editable. If **Add New Widget**, **Save**, and **Restore Standard Tabs** are absent, continue with Dashboard configuration or [Getting help](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/getting-help). |
| The Dashboard widget list differs | Treat the visible list as account-dependent and continue with [Dashboard widget catalog](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/dashboard-widget-catalog). |
| Principal-report columns differ | Treat the visible columns as account-dependent and continue with [Dashboard overview](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/dashboard-overview). |
| My Desk filter rows or Lists/Contacts columns differ | Work from the rows and headers visible in your account, then continue with [My Desk workspace](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/my-desk-workspace). |
| You cannot identify the client selection list, task text filter, or widget search field | Use the surrounding surface and its visible controls; these controls use their position and contents rather than a visible field label. Continue with [Getting help](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/getting-help) if you cannot proceed. |
| A dialog or message appears while editing | Continue with the owning page or [Getting help](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/getting-help) rather than treating the message as a workspace-view change. |
| A tab-name field rejects an empty value | Enter a tab name in **New Tab**. The validation text is `This Field Is Required`. |

## Out of scope

This page covers choosing a workspace view and the conditional Dashboard
personalization controls. Use the owning pages for the detailed procedures below.

### Messages

This page includes only the Dashboard tab validation message. Messages owned by
My Desk task and activity work, or by other application areas, belong to their
owning pages and are outside this workspace-personalization scope.

| Need | Owning page |
| --- | --- |
| Work with My Desk tasks | [My Desk tasks](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/my-desk-tasks) |
| 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) |
| Understand detailed Dashboard widget content | [Dashboard overview](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/dashboard-overview) and [Dashboard widget catalog](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/dashboard-widget-catalog) |
| Configure default layouts or Dashboard settings | [Configuration default layouts](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/configuration-default-layouts) and [Configuration Dashboard settings](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/configuration-dashboard-settings) |
| Handle messages outside My Desk or Dashboard workspace scope | The page that owns that feature |

## Continue from your workspace

After you choose a view, continue with the page that owns the work on that
surface. This keeps workspace selection separate from the detailed task.

### Prerequisites

- You have selected a My Desk view or opened Dashboard.
- You know the next task you need to complete.

**Steps**

1. Select the destination that matches your next task.

   | If you are continuing with… | Open |
   | --- | --- |
   | The My Desk workspace map | [My Desk workspace](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/my-desk-workspace) |
   | A My Desk task | [My Desk tasks](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/my-desk-tasks) |
   | A My Desk activity | [My Desk activities](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/my-desk-activities) |
   | Dashboard purpose and overview | [Dashboard overview](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/dashboard-overview) |
   | The widget catalog | [Dashboard widget catalog](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/dashboard-widget-catalog) |
   | Dashboard configuration | [Configuration Dashboard settings](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/configuration-dashboard-settings) |
   | Help with a workspace problem | [Getting help](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/getting-help) |

**Result:** You are on the page that owns the next workspace, task, widget,
configuration, or help action.

## Related

Choose the related page by the surface and task you need. The available workspace
choices can differ by role or subscription.

- [Understanding the interface](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/understanding-the-interface) explains broader screen recognition.
- [Navigation basics](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/navigation-basics) explains wider route and work-area navigation.
- [My Desk workspace](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/my-desk-workspace) owns the complete My Desk workspace map.
- [My Desk tasks](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/my-desk-tasks) owns task work.
- [My Desk activities](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/my-desk-activities) owns activity work.
- [Dashboard overview](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/dashboard-overview) owns Dashboard purpose and overview.
- [Dashboard widget catalog](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/dashboard-widget-catalog) owns detailed widget coverage.
- [Configuration default layouts](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/configuration-default-layouts) owns administration of default layouts.
- [Configuration Dashboard settings](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/configuration-dashboard-settings) owns Dashboard configuration.
- [Getting help](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/getting-help) owns support routing.
