# Reports settings

Reports settings is the administrator's list for preparing role reports and reviewing the
invoice-delay values used by forecast settings.

## Reports settings

A report setting is a role-based report configuration. Use the list to open a role's setting,
review its tabs and widgets, and maintain the report layout retrieved for that user. **Forecast
settings** records each branch's expected delay for purchase, sales, and commission invoices,
together with its unit.

Open **Reports settings** from the configuration area when you need the administrator list rather
than the [Reports hub](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/reports-hub), where a user consumes the prepared role reports.

| If you need to… | Go to |
|---|---|
| Check access and prepare information | [Before you start](#before-you-start) |
| Open the administrator list | [Open Reports settings](#open-reports-settings) |
| Identify a setting and choose its maintenance path | [Read the Reports settings list](#read-the-reports-settings-list) |
| Review branch invoice delays | [Review forecast settings](#review-forecast-settings) |
| Inspect an existing record | [Open a report setting for maintenance](#open-a-report-setting-for-maintenance) |
| Understand conditional surfaces and request messages | [Handle availability and request outcomes](#handle-availability-and-request-outcomes) |
| Create or maintain a setting | [New report setting](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/configuration-reports-settings-new) or [Edit report setting](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/configuration-reports-settings-edit-record) |

## Before you start

You need signed-in access to the configuration area. **Forecast settings** is available only when
your subscription includes that surface.

Have the delay values and units ready for each branch:

| Information to have ready | Why it matters |
|---|---|
| Purchase-invoice delay | Enter it in **for purchase invoices**. |
| Sales-invoice delay | Enter it in **for sales invoices**. |
| Commission-invoice delay | Enter it in **for commission invoices**. |
| Unit for each delay | Choose **Days**, **Weeks**, or **Months**. |

The three delay fields are optional number fields formatted as `#,##0.00`.

> **Note:** Review each value together with its unit so the forecast uses the intended time scale.

When the information is ready, open the list.

## Open Reports settings

The Reports settings list is the administrator configuration page for role report settings. It is
separate from the Reports hub.

**Prerequisites**

- You are signed in.
- You can access the configuration area.

**Steps**

1. Open the configuration area.
2. Open **Reports settings** from the configuration area.
3. Confirm that the Reports settings list page is displayed.

![The Reports settings page opened at its list landing surface](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/56a44c43f8b89f6b6b58332a6d31849d.png)

**Result:** The signed-in Reports settings list is on screen. Use its columns to identify a row.

## Read the Reports settings list

The Reports settings list is the directory of role report configurations. Use its five columns to
identify the role setting, then choose a maintenance path.

| Column | Use it to… |
|---|---|
| **Role** | Identify the role whose report setting you need. |
| **Tabs** | Compare the number of report tabs in the setting. |
| **Widgets** | Compare the number of widgets in the setting. |
| **Users** | Identify the users assigned to the setting. |
| **Last modified** | Find the latest modification shown for the setting. |

**Prerequisites**

- The Reports settings list is open.

**Steps**

1. Read the **Role**, **Tabs**, **Widgets**, **Users**, and **Last modified** columns for the row.
2. Choose the path that matches your task.

   | If you need to… | Select or open |
   |---|---|
   | Review branch invoice delays | **Forecast settings** |
   | Refresh the list | **Refresh** |
   | Change the visible table layout | **Table Layout** |
   | Open list settings | **Settings** |

![The list grid with Role, Tabs, Widgets, Users, and Last modified](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/8074fd1283604d0af1a2dec6722dd97e.png)

**Result:** The row is identified and the next path is selected. To review invoice delays, continue
to [Review forecast settings](#review-forecast-settings). To maintain the row, continue to
[Open a report setting for maintenance](#open-a-report-setting-for-maintenance).

## Review forecast settings

Review the branch values and their units before maintenance.

**Prerequisites**

- The Reports settings list is open.
- Your subscription includes **Forecast settings**.
- You have the purchase, sales, and commission invoice delay values for the branch.

**Steps**

1. Select **Forecast settings**.
2. Open the branch accordion for the branch you need to review.
3. Review the three optional delay fields and their units.

   | Field | Unit choices |
   |---|---|
   | **for purchase invoices** | **Days**, **Weeks**, or **Months** |
   | **for sales invoices** | **Days**, **Weeks**, or **Months** |
   | **for commission invoices** | **Days**, **Weeks**, or **Months** |

4. Select **OK** when the forecast-settings surface presents that confirmation action.

![Forecast settings with the branch invoice-delay fields and unit options](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/44faaaff5ae403872e12a53d4ea262b4.png)

Each delay field uses the `#,##0.00` number format and is optional. The branch fields appear when
the branch panel is open.

**Result:** The selected branch's invoice-delay fields and available units are on screen. Return to
the list to choose another row or open an existing report setting.

## Open a report setting for maintenance

An existing report setting is the saved role report configuration that you inspect through its
report tabs and widgets.

**Prerequisites**

- The Reports settings list is open.
- You have identified the existing report-setting row to inspect.

**Steps**

1. Open the selected report-setting row.
2. Confirm that the report-setting editor is displayed.
3. Review **Editable prev. months** and **Time Frame** on the editor.
4. Review the report tabs shown in the editor.
5. Select **Widget** to inspect widget choices for the active tab.
6. Select **Tab**.

7. Choose the tab action that matches your task.

   | If you need to… | Select |
   |---|---|
   | Create a tab without importing one | **Blank Tab** |
   | Import tabs from another role dashboard | **Import From** |
   | Review the saved record's history | **Last Modifications** |

8. If you select **Blank Tab**, use the required **New Tab** field in the add-tab surface.
9. If you select **Import From**, review **Another role dashboards**.
10. If the source dashboard has tabs, select **Select tab(s)**.

![The existing report-setting editor with its report tabs and maintenance controls](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/62fb7b86ea7e175c8229b9922650d7a3.png)

**Result:** The existing report-setting editor is open, with its tab, widget, blank-tab, import, and
history paths identifiable. **Save** and **Save and Close** are available in Edit mode when you
are ready to commit a maintenance action. Continue to [New report setting](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/configuration-reports-settings-new)
or [Edit report setting](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/configuration-reports-settings-edit-record) for the next task.

## Handle availability and request outcomes

Report-setting surfaces change with subscription, edit state, the active tab, and whether the
record has been saved. Use the condition that matches what is on screen.

| Condition or message | What it means or what to do |
|---|---|
| The subscription includes the surface | **Forecast settings** is available from the list. |
| The active visible tab has widgets | The widget library search and widget list are available. |
| Edit mode is active | **Widget**, **Tab**, **Blank Tab**, **Import From**, **Save**, and **Save and Close** are available. |
| The record has been saved | **Last Modifications** is available. |
| A source dashboard has tabs | **Select tab(s)** and its tab-selection controls are available in the import surface. |
| **Principals Report** or **Eagle View** does not appear | That option is unavailable. |
| `Your request was completed successfully` | The product's success message is displayed for a completed request. |
| `An error occurred while processing your request` | Review the intended action before retrying. |
| `You already have this tab in this dashboard` | The tab is already present in the dashboard. Continue with the existing tab or choose another import choice. |

Saving may not display a success message, so check the visible result before moving on. The three
delay fields remain optional number fields with the `#,##0.00` format.

## Continue with report settings

Choose the page that matches the next task:

| If you need to… | Continue to |
|---|---|
| Choose another saved role report setting | The Reports settings list on this page |
| Create a new report setting | [New report setting](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/configuration-reports-settings-new) |
| Maintain an existing report setting | [Edit report setting](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/configuration-reports-settings-edit-record) |
| Use an administrator-prepared role dashboard or report | [Reports hub](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/reports-hub) |
