Skip to content
D
Documentation

Dashboard settings

reference
7 min readUpdated

Use Dashboard settings to review role dashboards, maintain their tabs and widgets, and review forecast rules.

Dashboard settings at a glance

Dashboard settings are the configuration records used to organise role dashboards and forecast rules. A role dashboard is the saved dashboard configuration that you maintain through its tabs, widgets, imports, reports, and view actions.

The Dashboard settings screen is available with the Dashboard settings configuration subscription. The list uses Role, Tabs, Widgets, Users, and Last modified. A dashboard setting record supports tabs, widgets, imports, saved changes, and forecast rules.

If you need to…Go to
Check the subscription, access, and record conditions firstBefore you begin
Open the list, forecast rules, or a role dashboardFind and open a dashboard setting
Read the list columns and maintenance actionsUnderstand the dashboard settings list
Review or save forecast calculation choicesOpen the forecast rules
Diagnose a missing action or import choiceWhen a dashboard setting is unavailable
Work with a new dashboard settingNew dashboard setting
Maintain an existing dashboard settingEdit dashboard setting
Understand dashboard display and widgetsDashboard or Dashboard widget catalog

Before you begin

Dashboard settings work depends on the Dashboard settings configuration subscription, your editing state, and whether the dashboard record has been saved.

Before you beginWhat it changes
The Dashboard settings configuration subscription is includedThe configuration list and Forecast settings are available.
The screen is in edit modeDashboard editing actions are available.
A dashboard record has an IDLast Modifications is available for the saved record.
Another role dashboard has been selectedThe import tab-selection controls are available.

The subscription is required for this screen. If it is unavailable, the configuration screen is replaced by a surface with Back. Editing actions require edit mode. The Last Modifications tab requires RoleDashboard.Id, so the dashboard record must exist before that tab is available. Import tab-selection controls appear only after you select another role dashboard.

Find and open a dashboard setting

The Dashboard settings list is the starting point for reviewing a role dashboard or opening its configuration record. Forecast settings opens a separate forecast-rules popup.

Prerequisites

  • The Dashboard settings configuration subscription is available.
  • You can access the configuration area.

Steps

  1. In the configuration area, select Dashboard settings.

  2. Choose one destination.

    If you need to…Select or open
    Review forecast rulesForecast settings
    Open an existing role dashboard from its rowThe dashboard-setting row
    Open an existing role dashboard for editingEdit
    Open a new dashboard settingOpen the new dashboard-setting page from the Dashboard settings list
  3. If you selected a dashboard row or Edit, open the selected dashboard setting's detail page.

The Dashboard settings list with its role-dashboard columns and Forecast settings action

Result: The list, the forecast-rules popup, the saved dashboard-setting record, or the new dashboard-setting detail surface is open.

Understand the dashboard settings list

The Dashboard settings list is the directory of role-dashboard configuration records. Use its columns to identify a record, then use the opened record's maintenance actions to change its dashboard structure.

List columns
Role
Tabs
Widgets
Users
Last modified

Select a row to open the selected dashboard setting, or select its Edit action to open the same record on its detail page. The detail surface provides these maintenance actions:

SurfaceAvailable actions
Dashboard detail toolbarWidget, Blank Tab, Import From, Principals Report, Eagle View, Save, and Save and Close
Tab menuBlank Tab, Import From, Principals Report, and Eagle View
Import popupAnother role dashboards, Select tab(s), and All (Replace existing tabs)
Saved recordLast Modifications

Widget opens widget preparation for an active user-dashboard tab with widgets. Blank Tab opens the blank-tab flow. Import From opens the import popup. Principals Report and Eagle View add or remove their dashboard tabs. Save keeps the page open after saving, and Save and Close leaves the page after saving.

Select Blank Tab to open the new-tab dialog. The dialog has the required New Tab field and an OK button.

The import popup first provides Another role dashboards. After you select another role dashboard, Select tab(s) and the all-tabs choice become available when source tabs are present.

The import popup with the source-dashboard and tab-selection controls

When the record has an ID, select Last Modifications to review its saved modification history. The detail surface can also provide Rename tab, Delete tab, and Remove widget from tab for an active editable tab. Widget-specific choices and report columns depend on the active tab and widget area.

When a dashboard-setting request succeeds, the message is Your request was completed successfully. If an imported special tab is already present, the message is You already have this tab in this dashboard. A request error uses An error occurred while processing your request.

Open the forecast rules

Forecast settings are the booking-rule choices used to configure how the forecast is calculated and how booking periods are represented.

Prerequisites

  • The Dashboard settings configuration subscription allows Forecast settings.
  • The Dashboard settings list is open.

Steps

  1. Select Forecast settings.

  2. Complete the forecast choices.

    Field or choiceSelect or enter
    Forecast calculation typeFirm offers only or Firm offers and received inquiries
    Forecast calculation methodThe order-chance multiplication method or the at-or-above percentage method
    RatingA required percentage when you use the order-chance method
    Tolerated deviation between forecasted and achieved monthly bookingA value from 0 through 100
    Listing of the average monthly bookingOf the last 3 years or Of the last 5 years
    Average Period For Goods Delivery Till Receiving The Commission PaymentA value of at least 0
    Average Period For Goods Delivery Till Receiving The Clients PaymentA value of at least 0
    Commission and client payment periodsSelect them when your company configures them as required
  3. Select the action that matches your choice.

    If you need to…Select
    Save the forecast-rule choicesSave
    Leave the popup without savingCancel
    Confirm the shared popup actionOK

The popup also supports the shared confirmation actions. A required value can show This Field Is Required. Choose the order-chance method before entering its required percentage in Rating; Rating is available for that choice.

The forecast settings surface with its calculation and booking-period fields

Result: The forecast settings popup remains available for the selected save or cancel action, with the entered calculation choices and booking-period values displayed.

When a dashboard setting is unavailable

Dashboard-setting surfaces change when the subscription, editing state, saved-record state, or import source does not meet the screen's conditions.

What you seeWhat it meansWhat to do
The configuration screen is replaced by a surface with BackThe Dashboard settings subscription is not included.Select Back.
Widget, Blank Tab, Import From, Principals Report, Eagle View, Save, or Save and Close is unavailableThe screen is not in edit mode.Continue in edit mode.
Last Modifications is unavailableThe dashboard record has no RoleDashboard.Id yet.Save or open the saved dashboard record before reviewing modifications.
Select tab(s) or All (Replace existing tabs) is unavailableAnother role dashboard has not been selected, or the source has no tabs available for import.Select another role dashboard with tabs to import.
A widget-specific area is unavailableIts own subscription or widget guard does not permit it.Continue with the dashboard area that is available.
You already have this tab in this dashboard appearsThe imported special tab is already on the dashboard.Close the message and continue with the existing tab.
This Field Is Required appearsA required forecast value is empty.Enter the required value before saving.
An error occurred while processing your request appearsThe request returned the common processing error.Review the values and request conditions, then retry the action.

Continue to dashboard maintenance

After opening a role dashboard, continue with Widget, Blank Tab, Import From, Principals Report, or Eagle View according to the maintenance task. On a saved record, Last Modifications is the onward review surface for dashboard changes.

For widget meanings and day-to-day dashboard use, continue to Dashboard and Dashboard widget catalog. The focused pages for creating or maintaining the configuration record are New dashboard setting and Edit dashboard setting.

Was this page helpful?

Need help using the product?

Dashboard settings — PAMS Fresh Generation