# Edit report setting

Use this page to review and change an existing report setting, including its report tabs,
widgets, imported dashboard tabs, time frame, and editable previous-month value.

## Before you start

A report setting is a saved report library configuration. This editor changes the tabs and
widgets that the setting contains, while **Last Modifications** records the actions performed
on the saved setting.

Use **Save** or **Save and Close** only after checking the changes you intend to commit.

## Find a report setting

Use the report-settings list to find a saved report setting, then open its edit form to change it.

**Prerequisites**

- You have access to the configuration reports area.
- You have an existing saved report-setting record to open.

**Steps**

1. Open the report-settings list from the configuration area.
2. Select the existing report-setting record you need to change.
3. Open the saved report setting's edit page.
4. Confirm that the Edit report setting screen is open.

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

**Result:** The existing report-setting editor is open.

With the editor open, review its report-library areas and controls before changing a setting.

## Understand the report-setting screen

The report-setting screen is a report library: report tabs hold the active report content, and
widgets provide the report entries within the active tab.

The main surface shows **Editable prev. months** and **Time Frame** as readouts. The screen
also shows **Widget**, **Tab**, **Save**, and **Save and Close**.

| Area or control | What to look for or use it for |
|---|---|
| **Editable prev. months** | Review the current previous-month value. |
| **Time Frame** | Review the selected year or `last 12 months`. |
| **Widget** | Open widget selection for the active tab. |
| **Tab** | Open the add-tab menu. |
| **Save** | Save the dashboard configuration. |
| **Save and Close** | Save and request that the page be left. |
The report tabs are **Booking**, `Sales (invoicing)`, **Financial**, **Warehouse**,
and **Cash**. The report library also shows **Extend all**, **Cash Flow**, **Account Payable**,
**Net Profit**, and **Last Modifications**. **Last Modifications** is the saved-setting history
area.

### Fields and conditions

These fields and choices control which report period, dashboard tabs, and active-tab content
the saved setting uses.

| Field or choice | What it shows or does | When it appears or changes |
|---|---|---|
| **Editable prev. months** | Shows the current value and copies that value into the numeric popup before editing. | The value is shown on the editor; the numeric field is in the `PrevMonths` popup. |
| **Time Frame** | Shows the selected year or `last 12 months`. | The readout is on the editor; time-frame choices are in the time-frame popup. |
| **Another role dashboards** | Available choices are the dashboard names returned for this screen. Selecting a dashboard supplies its data and identifier for loading **Select tab(s)**; the current dashboard and dashboards without dashboard data are excluded. | The import-dashboard popup. |
| **Select tab(s)** | Provides the source tabs to select after a dashboard is selected. | After a dashboard is selected in **Another role dashboards**. |
| **All (Replace existing tabs)** | Replaces the current tabs with the selected dashboard's tabs when selected. | In the import-dashboard popup when the choice is available. |
| **number of editable Prev. months** | Accepts values from `1` through `11`. | In the `PrevMonths` popup. |
| **New Tab** | Names a new or renamed report tab and is required in the report-library add/edit popup. | In the add/edit tab popup. |
| **Search for widget** | Searches the widget choices for the active tab and can be cleared. | In the active-tab widget menu. |

The time-frame readout can represent a selected year or `last 12 months`; the selected value is
changed through its popup rather than by editing the readout itself. The previous-month readout
similarly opens the numeric popup with the current value already copied into it.

![The Time Frame readout and its time-frame choices](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/79b1a8fdc0d2fafc37001060adef8257.png)

When you select a dashboard in **Another role dashboards**, **Select tab(s)** is populated with
the tabs returned for that dashboard. Selecting **All (Replace existing tabs)** makes the source
dashboard's tabs replace the current tabs instead of adding only selected tabs.

The report-library add/edit popup requires **New Tab**. The active-tab widget menu provides
**Search for widget** as a clearable search field.

## Change and save report settings

Use this procedure to choose the edit path first, then commit the intended report-library
change with **Save** or **Save and Close**.

**Prerequisites**

- An existing report-setting editor is open.
- You know whether the change affects a widget, a tab, imported dashboard tabs, the time frame,
  or previous months.
- If you change a tab name, you have a value to enter in **New Tab**.

**Steps**

1. In the active report tab, select **Widget** to open widget selection.
2. Select a report entry from widget selection, using **Search for widget** to narrow the choices
   when needed.

   ![The Select widget dialog for the active report tab](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/d8e706df4a3b08755914f266d24e6b85.png)

3. Select **Tab** to open the add-tab menu.
4. Choose one tab action.

   | If you need to… | Select |
   |---|---|
   | Start a blank tab | **Blank Tab** |
   | Import tabs from another dashboard | **Import From** |
   | Rename the active tab | **Rename tab** |
   | Start the tab-deletion flow | **Delete tab** |

5. If you selected **Import From**, select a dashboard in **Another role dashboards**.

6. If the source dashboard is selected, choose entries in **Select tab(s)**.

7. If you want to replace the current tabs, select **All (Replace existing tabs)**.

![The Import dashboard popup with Another role dashboards and Select tab(s)](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/914cffa4e8820a62d07e304d0b625012.png)

8. If you selected **Blank Tab**, enter the tab name in **New Tab**.

9. If you selected **Blank Tab**, confirm the popup.

10. If you selected **Rename tab**, enter the new name in the tab-name editor.

11. Select **Save** to save the dashboard configuration, or select **Save and Close** to save
    and request page leave.

**Result:** The selected widget, tab, import choice, rename choice, or delete flow is on screen,
and the selected save action is available for the intended commit.

## Handle screen variations

The editor changes its visible surfaces according to whether it is editing a saved record, which
tabs exist, which tab is active, and which popup or dashboard choice is open.

| Condition | Surface or control affected |
|---|---|
| Edit mode is active | Header values and **Widget**, **Tab**, **Save**, **Save and Close**, and close controls are available. |
| The report setting has at least one report tab | **Widget** is enabled. |
| The selected dashboard has items | The imported-tab list appears. |
| The import-dashboard popup is open | **Another role dashboards**, **Select tab(s)**, and the import fields appear. |
| The previous-month popup is open | **number of editable Prev. months** appears. |
| A tab is active | That tab's report content appears. |
| The saved setting has a history area | **Last Modifications** appears. |

The add-tab entries `Sales Report` and **Eagle View** do not appear on this page because their
conditions are false. The widget action depends on an existing non-empty tab set. The imported
tab list depends on the selected dashboard having items, and the history area depends on the
saved setting having history.

## When saving or leaving goes wrong

Use the message or confirmation on screen to choose the bounded recovery action.

| What you see | What it means or what to do |
|---|---|
| `Your request was completed successfully` | The product's success message for the completed request. |
| `An error occurred while processing your request` | The product's error message for a processing failure; review the intended change before retrying. |
| `This Field Is Required` | A required field in the report-library add/edit popup is empty; enter the required tab name in **New Tab**. |
| `You already have this tab in this dashboard` | The selected tab already exists in the current dashboard; choose a different import choice. |
| `Are you sure you want to ultimately delete this tab and all it's content ?` | The tab-deletion confirmation is open; select **Cancel** to stop or **Delete** to confirm. |

After resolving a save or leave message, review the saved setting's history or choose the next
report-setting destination.

## Review the result and continue

**Last Modifications** is the saved setting's chronological history of user actions. It helps
you review what was recorded after the setting was changed.

**Prerequisites**

- The existing report-setting editor is open.
- The saved record has a **Last Modifications** area.

**Steps**

1. Select **Last Modifications**.
2. Review the chronological sequence of user actions.
3. Choose the next destination.

   | If you need to… | Open |
   |---|---|
   | Review another saved setting | The report-settings list |
   | Create a setting instead of editing one | [New report setting](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/configuration-reports-settings-new) |
   | Use the configured reports | The Reports hub |

**Result:** **Last Modifications** is available for reviewing the saved setting's action history,
and the selected next destination is open.
