# Sales and backlog widgets

## Sales and backlog widgets

Sales and backlog widgets are dashboard views that help you compare sales activity,
future work, bookings, teams, branches, and due dates without opening each underlying
record. A dashboard tab is one view within this workspace; use its widgets to answer a
specific reporting question.

| If you need to… | Go to |
|---|---|
| See the grouped widget catalog and the dashboard areas it covers | [Dashboard widget catalog](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/dashboard-widget-catalog) |
| Review pipeline and status-oriented dashboard views | [Pipeline and status widgets](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/pipeline-and-status-widgets) |
| Review management-report widget groups | [Management report widgets](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/management-report-widgets) |
| Find the dashboard and identify the active tab | Dashboard overview |
| Change broader dashboard administration settings | [Dashboard settings](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/configuration-dashboard-settings) |
| Personalize the wider workspace | Personalizing your workspace |

The widget families are:

| Family | Use it to read |
|---|---|
| Backlog widgets | Work that remains grouped by account manager, client, principal, product type, team, variant, market segment, or month |
| Booking widgets | Booking totals, comparisons, forecasts, and time-based booking views |
| Sales widgets | Sales pipeline, sales-by-year, invoice, and grouped sales activity |
| Teams widgets | Team targets, running offers, tendency, and bonus views |
| Branch widgets | Branch booking-versus-target and running-offer views |
| Due-date widgets | Bid, delivery, and task items for the next or previous ten-day ranges |

## Before you start

The Dashboard is the signed-in workspace where your account's tabs and widgets are
assembled for daily reporting.

**Prerequisites**

- Sign in to the application.
- Have the dashboard shell available to your account.
- Have at least one dashboard tab.
- Open a tab that contains one or more widgets when you need to read a widget.

The widget catalog appears when at least one dashboard tab exists. Graphs are also
subject to the account's active subscription, so the graph surface can differ between
accounts. Use the tabs and widgets that are present for your account.

## Find the dashboard widgets

**Prerequisites**

- Be signed in.
- Have a dashboard available.

**Steps**

1. Open **Dashboard** from the dashboard navigation.
2. Select the active dashboard tab.
3. Read the widget area shown for that tab.
4. Select the widget-catalog entry point when you need to choose another widget.

![Dashboard navigation, active tab, and widget area](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/0204f63edda4fb604281c56ffed4df6d.png)

**Result:** The active dashboard tab and its available widgets are on screen, with the
widget catalog available.

## Understand the widget catalog

The widget catalog is the list of dashboard views you can choose from. The widgets on
your active tab are the views currently placed in your dashboard.

The catalog presents translated widget names and groups them by reporting subject. The
available catalog content includes the following categories:

| Catalog category | Examples of the information presented |
|---|---|
| Order and offer status | Running-order status and firm- or budget-offer status |
| Principal and branch activity | Running offers and booking versus target this year |
| Sales and teams | Sales pipeline, accounts in the sales pipeline, and teams booking versus target |
| Backlog and booking | Backlog and booking summary for this year |
 | Due-date views | **Next 10 days** and **Last 10 days** |

Widget names are translated in their headers. The catalog list is grouped by widget
family so that you can start with the business question rather than a technical widget
type. Use the names that appear in your catalog.

![Grouped catalog categories and translated widget names](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/b89b84d07f53891bb571134bdb5d91df.png)

Choose a widget from the catalog list that appears on screen.

### Add a widget to the active tab

Use these steps to add a widget that is not on the active tab.

**Prerequisites**

- Be in dashboard edit mode.
- Have the widget catalog available.

**Steps**

1. Select **Widget**.
2. Select the widget you want to add.
3. Select **OK**.
4. Select **Save**.

**Result:** The selected widget is added to the active tab and the tab arrangement is
saved.

The picker can select more than one widget. It excludes widgets that are already on the
active tab and provides **Select all** and a keyword search field.

### Backlog widgets

Use these widgets to read outstanding sales and commission work. **Backlog** shows sales
and commission backlog totals and the average commission percentage.

| Widget or view | What it displays | Controls or choices |
|---|---|---|
| **Backlog** | Sales and commission backlog totals and average commission percentage | Read-only summary |
| **Backlog By Teams** | Backlog grouped by team | **Only Sales Jobs**, **Equivalent**, and label visibility |
| **Backlog By Vendors** | Backlog grouped by vendor | **Only Sales Jobs**, **Equivalent**, and label visibility |
| **Backlog By Clients** | Backlog grouped by client | **Only Sales Jobs**, **Equivalent**, and label visibility |
| **Backlog By Product Types** | Backlog grouped by product type | **Only Sales Jobs**, **Equivalent**, and label visibility |
| **Backlog By Market Segment** | Backlog grouped by market segment | **Only Sales Jobs**, **Equivalent**, and label visibility |
| **Backlog By Account Managers** | Backlog grouped by account manager | **Only Sales Jobs**, **Equivalent**, and label visibility |
| **Backlog By Months** | Backlog grouped by month | The same chart and control model as the other backlog breakdowns |
| **Backlog Payment Forecast NTM** | Positive invoice amounts by payment month, including invoices marked blind | **Commission Invoices**, **Sales Invoices**, and label visibility; select a chart item to open its invoice |
| **Backlog Over The Months** | Backlog by principal and month, separately for each branch | No active chart, export, drill-through, year, or period control is declared |
| **PM Backlog** | A monthly table with an initial balance, month totals, object totals, and a total row | **Initial Balance** is displayed; no active filter, export, drill-through, or edit control is declared |

The **Backlog** widget can group results by team, vendor, client, product type, market
segment, or account manager. When no saved selection exists, it starts with the team
dimension. **Only Sales Jobs** and **Equivalent** apply to the selected breakdown.

For the breakdown charts, the toolbox provides **Export as excel** and **Download as
image**. When a breakdown has more than 10 categories, a vertical chart slider is
available, except for **Backlog By Months**. **Backlog By Months** is hosted inside the
composite **Backlog** view rather than as a separate dashboard-tab widget.

### Booking widgets

Use booking widgets to compare achieved booking with targets and forecasts, or to review
booking over time.

| Widget or view | What it displays | Controls or choices |
|---|---|---|
| **Booking This Year** | Achieved booking, forecast, and blind forecast | Read the current-year comparison |
| **Booking Summary Today** | Target, achieved booking, achieved percentage of target, forecast, and blind forecast | Read the summary |
| **Booking Summary This Month** | Target, achieved booking, achieved percentage of target, forecast, and blind forecast | Read the summary |
| Booking versus target | Target and achieved booking, or achievement percentage, by supplier category | **Sort by Booking**, **Sort by Target**, **Sort by Achievement** |
| **Booking vs Target by Months** | Monthly booking performance by branch, including target and achieved or forecast values | **Sales Teams** choice and an enabled currency picker |

The booking views also include a booking-by-supplier comparison. Use **Sort by Booking**,
**Sort by Target**, or **Sort by Achievement** to change its order. The booking-by-months
view provides a searchable **Sales Teams** choice and an enabled currency picker.

### Sales widgets

Use sales widgets to read pipeline stages, account counts, invoices, annual totals, and
sales breakdowns.

| Widget or view | What it displays | Controls or choices |
|---|---|---|
| **Sales Pipeline** | Sales records grouped by pipeline stage | Select a chart record to open its sales record; **Show / hide label** |
| **Accounts in Sales Pipeline** | **Clients** and **Vendors** counts | Read the two counts |
| **Sales Pipeline in Last 10 Days** | Recent sales-pipeline records grouped by stage | Select a chart record to open its sales record; **Show / hide label** |
| **Sales Invoices** | Invoice records grouped by active stage | Select a chart record to open its invoice; **Show / hide label** |
| **Sales (Over Last Years)** | Annual sales totals | **Show / hide label** |
| **Sales** | Sales grouped by the selected dimension | Group by team, vendor, client, product type, market segment, account manager, or month; **Last 5 years**, **Last 3 years**, **Last year**, **Previous 12 months**, or **Current year**; **Only Sales Jobs** and **Equivalent** |

The **Sales** widget provides breakdowns by clients, vendors, teams, account managers,
market segments, product types, and months. Each breakdown uses a horizontal stacked bar
chart with a category for each returned heading and a series for each returned year.

Each standalone sales breakdown provides **Last 5 years**, **Last 3 years**, **Last year**,
**Previous 12 months**, and **Current year** period choices, together with **Equivalent**
and **Show / hide label**. It also provides **Only Sales Jobs**, except for the vendors
breakdown, where that control is not rendered.

## Use widget controls

Dashboard controls change the tab layout or the way a booking result is ordered. Edit
controls affect the selected tab, so use them only when you intend to change that tab's
composition.

**Prerequisites**

- Have the dashboard tab and its widgets on screen.
- Enter dashboard edit mode for tab or widget changes.

**Steps**

1. Select the control that matches the change you want to make.

   | If you want to… | Select |
   |---|---|
   | Order a booking result by booking | **Sort by Booking** |
   | Order a booking result by target | **Sort by Target** |
   | Order a booking result by achievement | **Sort by Achievement** |
   | Keep dashboard changes | **Save** |
   | Open the standard-tab restore action | **Restore Standard Tabs** |
   | Leave the restore action without restoring tabs | **Cancel** |
   | Restore the standard tabs | **Restore** |
   | Open tab management for a new tab | **New Tab** |
   | Change the selected tab's name | **Rename tab** |
   | Remove the selected tab | **Delete tab** |

The edit surface also provides **Remove widget from tab** from a widget toolbox. Widget
controls are available only in edit mode.

**Result:** The selected sort or tab-management action is in the dashboard surface, and
the active tab remains the place where its widgets are organized.

### Change the backlog grouping

Backlog widgets show remaining sales work grouped around the business dimension you are
investigating.

**Prerequisites**

- Have a backlog widget available in the catalog or active tab.
- Know whether you are investigating ownership, customer, product, team, market, or time.

**Steps**

1. Open the backlog widget family.
2. Choose the backlog grouping that matches your question.

| If you need to investigate… | Use this available backlog grouping |
|---|---|
| Account ownership | Account-manager grouping |
| A client | Client grouping |
| A principal | Principal grouping |
| Product type | Product-type grouping |
| A team | Team grouping |
| A product variant | Variant grouping |
| A market segment | Market-segment grouping |
| Monthly backlog | Month grouping |
| Expected payment from backlog | Payment forecast for backlog work |
| Backlog across the months | Monthly trend grouping |

3. Read the grouping that appears for the selected backlog view.

**Result:** The backlog information is organized by the selected account, client,
principal, product, team, variant, market-segment, payment-forecast, or month view.

### Change a chart comparison or offer view

Booking and sales comparison widgets put totals beside a target, forecast, or earlier
period, while offer widgets organize offer work by submission or status.

**Prerequisites**

- Have the booking, sales, or offer widget family available.
- Know whether you need a comparison, a time-series view, submitted offers, or offer status.

**Steps**

1. Open the widget family that matches your question.

| If you need to compare or review… | Use this available widget family |
|---|---|
| Booking against target | Booking comparison with target |
| Booking against forecast | Booking comparison with forecast |
| Booking across earlier years | Booking comparison across earlier years |
| Sales across earlier years | Sales comparison across earlier years |
| Orders against lost work | Order and lost-work comparison |
| Submitted offers | Submitted-offer widget family |
| Offer progress by status | Offer-status widget family |

2. Read the comparison or offer information shown by the selected widget.

**Result:** The dashboard shows the selected booking comparison, sales comparison, offer
view, or target or forecast variant where that widget is available.

### Sort booking results

The booking result exposes three labelled sort controls for changing the order used in
that result.

**Prerequisites**

- Have a booking result in view.

**Steps**

1. Choose the booking sort you need.

   | If you want to order by… | Select |
   |---|---|
   | Booking | **Sort by Booking** |
   | Target | **Sort by Target** |
   | Achievement | **Sort by Achievement** |

These sort controls have no required marker. Use the three labelled choices shown in the
table when you change the booking order.

**Result:** The booking result is ordered by the selected sort label.

### Read chart information

Chart information is the value, label, and legend text that lets you interpret the
selected widget without opening each underlying record.

**Prerequisites**

- Have a sales, backlog, booking, team, branch, or due-date widget in view.

**Steps**

1. Read the values and labels shown in the widget.

   | Read | Use it to interpret |
   |---|---|
   | Currency amounts | The monetary value |
   | Percentages | The percentage result |
   | Counts | The number of records or items |
   | Chart legends | The value described by each legend |
   | Offer-status labels | The offer status shown by the widget |

![Chart values with their legends, percentages, counts, and offer-status labels](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/92c84c4d1016e6185b3a63a6d8c80ec6.png)

The displayed values and record names belong to the dashboard data available to your
account. Use the labels and formats on the current widget rather than treating one
account's values as universal.

**Result:** The chart's currency amounts, percentages, counts, legends, and offer-status
labels are available for interpretation.

## Handle widget availability and branches

Widget availability is the set of account, tab, subscription, and edit conditions that
determines which dashboard surface you can use. Check these conditions when a widget
family or control does not appear.

| Condition | What you see |
|---|---|
| Active subscription permits graphs | The widget catalog can show graph widgets. |
| No permitted graph subscription | The graph surface is not available through that subscription guard. |
| At least one dashboard tab exists | The widget catalog can mount the tab surface. |
| The active tab has one or more widgets | The widget grid appears. |
| The dashboard is in edit mode | Edit styling and the widget toolbox action **Remove widget from tab** are available. |
| The dashboard is not in edit mode | Widget controls are unavailable. |
| A widget type is selected | Its matching widget surface is used. |
| An invoice filter is available or unavailable | Commission-invoice and sales-invoice views use the corresponding invoice surface. |
| Management-report editing is available | Management-report widgets receive the edit controls for that surface. |

Principal-report column choices depend on the account's available report configuration,
so use the columns shown in the current report.

![Runtime catalog surface with account-dependent widget availability](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/db53916433e4417a811f1f69b728bb5b.png)

## When a widget or action does not work

Use the message on screen to identify whether the issue concerns a duplicate widget,
request processing, tab limits, or a duplicate tab name.

| What you see | What it means | What to do |
|---|---|---|
| `You already have this widget in this tab` | The selected widget is already in the tab. | Choose another widget or work with the widget already on the tab. |
| `An error occurred while processing your request` | The request did not complete normally. | Review the dashboard state and repeat the action from the relevant dashboard surface. |
| `You’ve exceeded the number of tabs` | The dashboard tab limit was reached. | Keep the existing tabs or remove a tab before creating another. |
| `You already have a tab with the same name` | Another tab already uses that name. | Rename the new or edited tab with a different name. |

Use the widget toolbox for **Remove widget from tab** only when the edit surface is
available. Choose widgets from the catalog list that appears on screen.

![Runtime dashboard surface when a widget or tab action needs checking](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/c0412e66205334ca9d219c53758132ce.png)

## Out of scope

The dashboard request message `Your request was completed successfully` confirms that a
request completed. For tab administration, use **Dashboard settings**.

## Continue from the dashboard widgets

Continue according to the work you need to do:

| Next need | Continue with |
|---|---|
| Understand the whole dashboard surface | Dashboard overview |
| See the complete grouped widget map | [Dashboard widget catalog](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/dashboard-widget-catalog) |
| Read pipeline and status groups | [Pipeline and status widgets](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/pipeline-and-status-widgets) |
| Read management-report groups | [Management report widgets](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/management-report-widgets) |
| Personalize the workspace beyond dashboard widgets | Personalizing your workspace |
| Administer dashboard availability | [Dashboard settings](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/configuration-dashboard-settings) |
