# Pipeline and status widgets

## Pipeline and status widgets

A dashboard widget is a grouped chart or readout that lets you review sales and operational
results without opening each record. The dashboard brings together pipeline stages, offer and
order statuses, account counts, bids due around the current period, forecast comparisons,
backlog payment views, and visits.

| If you need to… | Go to |
|---|---|
| Reach the dashboard and orient yourself | [Dashboard overview](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/dashboard-overview) |
| Find or select a dashboard widget | Dashboard widget catalog |
| Review sales and backlog results | Sales and backlog widgets |
| Compare bookings, targets, forecasts, or visits | Management-report widgets |
| Read Principal report columns | Principal report |
| Continue with offer status work | [Offers](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/offers) |
| Continue with order status work | [Orders](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/orders) |

## Before you start

The dashboard shows the widget set selected for the current dashboard page. A widget appears
when the dashboard has selected widgets and a usable layout is available. Widget actions also
depend on the subscription feature check, so the choices shown to one company can differ from
those shown to another.

**Prerequisites**

- You can open the Home dashboard.
- Your dashboard page has at least one selected widget.
- Your company subscription includes the widget action you want to use.
- The dashboard has its display layout available.

The team and forecast choices depend on values the dashboard sets. The
fixed team choice is **All teams**; other team names come from the teams available to the
current dashboard. One forecast choice is **Value Of All Firm Inquiries And Offers Multiplied By
Its Order Chance**. Another choice applies a minimum order-chance threshold. The dashboard sets
the threshold rather than you entering it.

The report determines which columns are available when it runs.

> **Note:** A dashboard widget can be available as a chart or readout without presenting a
> labelled entry field. Use the heading and visible choices to identify the result you are
> reading.

## Find a widget on the dashboard

Home is the dashboard surface for the grouped widgets.

**Prerequisites**

- You are signed in.
- You know which dashboard page you want to review.

**Steps**

1. Open Home.
2. Open the dashboard page that contains the widget group.
3. Review the headings currently shown on the dashboard.
4. Select the widget whose heading or readout matches the result you need.

![Dashboard headings and grouped pipeline, account, forecast, and status readouts](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/d15bcedc0e5593f6b3ab04925f879aad.png)

The currently displayed group includes `Sales Pipeline`, `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`.

**Result:** The selected dashboard page is open, and you can identify the grouped widget by its
visible heading or readout. Continue by reading the grouped result.

## Understand the grouped results

A pipeline widget groups sales work by where it sits in the sales flow. A status widget groups
offers or orders by their current status. Account, bid, forecast, and visit widgets add the
customer, deadline, comparison, and activity views around that work.

| Group | What to look for |
|---|---|
| Sales pipeline | `Potentials`, `Inquiries`, `Budget offers`, `Firm offers`, and `Orders` |
| Accounts | `Clients` and account results connected to the sales pipeline or running offers |
| Offer status | `Firm Offers` and `Budget Offers`, grouped by their status views |
| Order status | Running-order results grouped by status |
| Bids | Bids due in the next period or due in the previous period |
| Forecast and target | Team, branch, principal, yearly target, and backlog-payment comparisons |
| Visits | Visits in the previous period or in the next period |

The scoped dashboard surfaces are `Sales pipeline`, `Accounts in sales pipeline`, `Accounts
running offers`, `Statuses of firm offers`, `Statuses of budget offers`, `Statuses of running
orders`, `Bids due in the next period`, `Bids due in the previous period`, `Sales pipeline in
the previous period`, `Visits in the previous period`, and `Visits in the next period`.
Each surface is selected by its chart type. The dashboard also uses separate conditions for
booking versus target versus forecast by month, booking versus target versus forecast by
variant, forecast versus target for the year, and forecast backlog payment.

The visible comparison headings explain the level of the result: teams, branches, or principals.
The readout `Backlog` belongs to the forecast backlog payment view. `Including Forecast` and
`Equivalent` are visible choices in forecast and comparison widgets, not pipeline stages. When
you need to change the view, open the relevant choice in the widget.

### Status widgets

Status widgets are subscription-gated. When the required subscription is unavailable, the widget
shows the subscription-upgrade surface instead of its chart.

| Widget | What it provides | Available controls or interaction |
|---|---|---|
| **Statuses of Jobs in Offer Stage (Firm Offers)** | **Jobs (Count)** and **Jobs (Value)** bar charts grouped by status. | **Show / hide label**, Excel export, and PNG download. |
| **Statuses of Jobs in Offer Stage (Budget Offers)** | Count and value bar charts grouped by status. | **Show / hide label**, Excel export, and PNG download. |
| **Statuses of Running Orders** | Count and value bar charts grouped by status. | **Show / hide label**, Excel export, and PNG download. |
| **Bank Guarantees** | A chart for each returned bank, showing facility work by category. | Select a non-remaining chart category to open its L/G record. Each chart also has **Show / hide label**, Excel export, and PNG download. |
| **Cash Cover Status** | One pie chart per returned bank and its total cash cover. | **Show / hide label**, Excel export, and PNG download. |
| **PM Current Status** | Project-management status amounts and counts. | Choose **By agreed margin**, **By budget**, or **By order price**. |

### Pipeline, account, bid, forecast, order, and visit widgets

| Group | What to read |
|---|---|
| Sales pipeline | **Sales Pipeline** is a stage chart with **Show / hide label**. **Accounts in Sales Pipeline** shows **Clients** and **Vendors** counts. **Sales Pipeline in Last 10 Days** provides recent stage work. |
| Sales invoices | **Sales Invoices** groups returned invoices by stage and provides **Show / hide label**. |
| Backlog | **Backlog** shows sales backlog, commission backlog, and average commission backlog percentage. It is read-only. |
| Backlog payment forecast | **Backlog Payment Forecast NTM** provides **Commission Invoices** and **Sales Invoices** choices, chart labels, Excel export, and PNG download. Selecting a chart item opens its invoice in a new browser tab. |
| Sales breakdown | **Sales** groups results by teams, vendors, clients, product types, market segments, account managers, or months. |

The subscription-upgrade surface can replace the Sales Pipeline, Accounts in Sales Pipeline, Sales
Pipeline in Last 10 Days, Sales Invoices, and Sales widgets when their features are unavailable.

**Prerequisites**

- A dashboard page with the status widget or grouped result you need is open.
- The relevant widget is available in your company's subscription.

**Steps**

1. Identify the widget by its visible title.
2. Read the chart, count, value, or status grouping that answers your question.
3. Use the widget's available control when you need a different view or an export.

**Result:** You have reviewed the selected dashboard result without changing dashboard
configuration.

## Choose a bid, forecast, or visit view

Use these steps when the widget offers a team, forecast, comparison, invoice, or
sorting choice. These choices change the view you are reading; they do not save a dashboard
configuration.

**Prerequisites**

- A dashboard page with the relevant widget is open.
- The widget displays the choice you want to review.

**Steps**

1. Open the team, forecast rule, comparison, invoice, or sorting choice in the relevant widget.
2. Select the option that matches the view you need.

   | If you need to… | Select |
   |---|---|
   | Review every team together | **All teams** |
   | Review one available team | An available team name |
   | Multiply all firm inquiries and offers by their order chance | **Value Of All Firm Inquiries And Offers Multiplied By Its Order Chance** |
   | Use the minimum order-chance threshold | The minimum order-chance threshold option |
   | Limit the booking view to your company | **Only My Company** |
   | Use the equivalent comparison | **Equivalent** |
   | Include forecast values | **Including Forecast** |
   | Review commission invoices in the backlog-payment view | **Commission Invoices** |
   | Review sales invoices in the backlog-payment view | **Sales Invoices** |
    | Sort a booking-versus-target result by booking | **Sort by Booking** |
    | Sort a booking-versus-target result by target | **Sort by Target** |
    | Sort a booking-versus-target result by achievement | **Sort by Achievement** |

![Forecast, comparison, and sorting choices on the dashboard](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/d15bcedc0e5593f6b3ab04925f879aad.png)

**Result:** The widget shows the selected team, forecast, comparison, invoice, or
sorting view. If the widget or result is missing, use the availability table.

## When a widget or result is not available

Availability has several causes. Check the visible dashboard conditions before treating a
different widget set as a data problem.

| What you see | What it means | What to do |
|---|---|---|
| A widget is not present | The dashboard has no selected widget for that chart type, or its display layout is unavailable. | Review the current dashboard page and its available widget choices. |
| A widget action is absent | The subscription feature check does not make that action available. | Ask the person responsible for your company subscription to review the feature. |
| A team choice contains only **All teams** | No additional team record is available in the current dashboard view. | Read the all-team result or ask for the relevant team setup. |
| A forecast rule shows a percentage you did not enter | The dashboard sets the percentage. | Use the displayed rule that matches the intended order-chance threshold. |
| You need to sort a result | The named sorting controls are available for the booking-versus-target view. | Select **Sort by Booking**, **Sort by Target**, or **Sort by Achievement**. |
| Five visible controls have no text label | The current dashboard includes unlabeled controls. | Use the three named sorting controls when sorting is the task. |
| **Principal report** columns differ | **Principal report** column choices are set when the report runs. | Review the columns available in the **Principal report**. |

## Out of scope

The parent dashboard page is **Dashboard** (Home). These messages are not status-widget results;
use the dashboard availability guidance when the dashboard itself does not load or refresh.

| Owning page | Message |
|---|---|
| **Dashboard** (Home) | `Your request was completed successfully` |
| **Dashboard** (Home) | `An error occurred while processing your request` |

## What to read next

Use [Dashboard overview](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/dashboard-overview) for the broader dashboard orientation. Use
Dashboard widget catalog for widget discovery and selection when that page is available. Use
Sales and backlog widgets for detailed sales and backlog results, Management-report widgets for
bid, forecast, and visit reporting, and Principal report for its column choices.

For record-level follow-up, continue with [Offers](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/offers) for offer status work or
[Orders](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/orders) for order status work.
