# Frequent currencies

Frequent currencies is the company currency-entry configuration. Use it to review,
add, change, delete, or export the currency entries available to company and product
workflows.

Before a branch uses a newly supported currency, add that currency to Frequent Currencies.

## Before you start

| If you need to… | Go to |
|---|---|
| Open the list and check its columns | [Find Frequent currencies](#find-frequent-currencies) |
| Understand the fields | [Understand the currency list and form](#understand-the-currency-list-and-form) |
| Add or change an entry | [Add or edit a currency](#add-or-edit-a-currency) |
| Delete or export entries | [Delete or export currency data](#delete-or-export-currency-data) |
| Maintain company flags | [Flags](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/configuration-company-flags) |
| Maintain product categories | [Product categories](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/configuration-company-product-categories) |
| Use currency data in product work | [Products](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/products) |

The subscription feature controls whether the grid and **New** control appear. When
the feature is included, the grid and **New** are available; otherwise, the upgrade
surface appears. Editing requires edit permission, and deleting requires delete
permission. The delete action is available only when more than one item exists.

Confirm that the delete action is available before planning a removal.

## Find Frequent currencies

Open the list before reviewing or maintaining currency entries.

**Prerequisites**

- The subscription feature is included when you need the grid and **New** control.

**Steps**

1. Open **Configuration**.
2. Open **Company**.
3. Select **Frequent Currencies**.
4. Confirm that the visible list controls include **New**, **Refresh**, and **Settings**
   when those controls are available on your surface.

**Result:** The Frequent currencies list is open with its available list controls visible.

![The Frequent currencies entry point and list toolbar](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/d62fcea4ee990a96f2cee4f5f30f96c5.png)

## Understand the currency list and form

The list is the review surface for company currency entries. Selecting **New** opens
the new currency dialog, which asks for a currency code and name. The list also
shows the symbol.

The currency picker uses the currency lookup as its source. Each option contains a
currency code, name, and symbol, and the picker displays the code followed by the
currency name. Selecting a code also sets the record name.

The form shows **Code** and **Name**. **Symbol** is visible in the list but is not an
editable form field. A configured field appears in the form only when it is enabled
for forms.

The list shows **Code**, **Name**, and **Symbol**, with nine currency rows. The new
currency dialog shows **Code**, **Name**, and **OK**. **Code** and **Name** carry
required markers. A loading indicator can remain while list values are already
present, so use the visible headers and values when reviewing the list.

![The New Currency dialog with Code and Name fields](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/5932c52f491f93f7114b398757d62a06.png)

### List columns and entry fields

| Field | Reader guidance | Required | Visible in list | Visible in form |
|---|---|---:|---:|---:|
| **Code** | The lookup choice can supply the text shown in the next field. | Yes | Yes | Yes |
| **Name** | Review the supplied text, then edit it before submitting. | Yes | Yes | Yes |
| **Symbol** | Read it in the list; the form does not offer it. | No | Yes | No |

The currency picker offers every row returned by the currency lookup. Each option
carries its code, name, and symbol data.

The entry form also includes **Add more**. Select **Add more** to add another entry row
to the form before submitting.

### Actions on the screen

| Action | Where to use it | What it does |
|---|---|---|
| **New** | List | Opens a new-record popup when new entries are allowed. |
| Edit control | Row | Opens the selected row when edit permission is available. A row click also opens the edit popup. |
| **Delete** | Row menu | Deletes a list item when delete permission is available and more than one item exists. |
| **Export** | Shared list toolbar | Opens the export options flow. |
| **OK** | Shared popup | Submits the selected item when validation succeeds. |
| **Cancel** | Shared popup | Closes the open popup without submitting it. |

> **Note:** **Symbol** is a list value, not an editable field in the currency form.

## Add or edit a currency

Use this procedure to add a company currency entry or correct an existing one.

**Prerequisites**

- The subscription feature is included and **New** is available for a new entry.
- You have edit permission for an existing entry.
- You know the currency code and the name that the company should use.

**Steps**

1. Select the option that matches the change.

   | If you want to… | Select… |
   |---|---|
   | Add a new entry | **New** |
   | Edit an existing entry | The row edit control or the row |

2. In **Code**, select the currency code from the picker.
3. In **Name**, enter the currency name when it is not already set from **Code**.
4. Select **OK**.
5. Read the message shown after the save attempt.

| If you are… | The completion message is… |
|---|---|
| Creating an entry | `Data saved Successfully` |
| Updating an entry | `Data updated Successfully` |

To leave without submitting the entry, select **Cancel** in the open popup.

**Result:** The displayed message identifies the submitted operation, or **Cancel**
closes the dialog without submitting the entry.

The required checks are `Code is required`, `Name is required`, and `Select a Curriency`.
Use the last message when the currency picker has not received a selection.

## Delete or export currency data

Use deletion only when you intend to remove an entry. Use export when you need to
start the list's export-options flow.

### Delete an entry

**Prerequisites**

- You have confirmed that the row is the one to remove.
- Delete permission is available and the list contains more than one item.

**Steps**

1. Open the row's delete menu.
2. Select **Delete**.
3. Read `Are you sure you want to delete this item?`.
4. Select **Cancel** or **Delete** in the confirmation dialog.
5. Read the message shown after the delete attempt.

The delete messages are `Data Deleted Successfully`, `Failed to Delete`, and `Must have
at least one item`.

**Result:** After confirmation, the displayed message states whether the entry was
deleted or refused.

### Export currency data

Start this procedure when you need the list's export options.

**Prerequisites**

- The Frequent currencies list is open.
- **Export** is available in the shared list toolbar.

**Steps**

1. Select **Export**.
2. Review the export options.
3. Select **Cancel** to leave the export options.
4. Select **Export** to continue the export flow.

**Result:** The export options flow is open.

## When currency maintenance goes wrong

Use the message or surface you can see to choose the next action.

| What you see | What it means | What to do |
|---|---|---|
| `Code is required` | **Code** has no value. | Select a value in **Code**. |
| `Code is required` | The value is present. | Select **OK**. |
| `Name is required` | **Name** has no value. | Enter a value in **Name**. |
| `Name is required` | The value is present. | Select **OK**. |
| `Select a Curriency` | The currency picker has no selected currency. | Select a currency in **Code**. |
| `Select a Curriency` | A currency is selected. | Select **OK**. |
| `Forbidden characters detected. Please remove them and try again.` | The entry contains a forbidden character. | Remove the forbidden character and submit the entry again. |
| `Failed to Delete` | The delete operation failed. | Keep the entry and review the screen or request assistance. |
| `Must have at least one item` | The list cannot be left without an item. | Keep at least one entry in the list. |
| The upgrade surface appears instead of the grid | The subscription feature is not included. | Open the upgrade surface. |
| A loading indicator remains while values are visible | The list is still reporting loading. | Read the visible headers and values before editing. |

For every save, update, or delete attempt, read the displayed result message before
treating the operation as complete.

## Out of scope

The related saved-data workflow is outside this page. If deletion shows
`Related to Saved data, Can't be deleted`, keep the entry and use that related workflow.

| Message | Why it is outside this page |
|---|---|
| `Related to Saved data, Can't be deleted` | The related saved-data workflow owns the next action. |

## Continue with currency configuration

After reviewing or maintaining the entries, continue with the company configuration
area that matches the next piece of work.

| Next need | Page |
|---|---|
| Maintain company flags | [Flags](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/configuration-company-flags) |
| Maintain product categories | [Product categories](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/configuration-company-product-categories) |
| Use configured currency data in product and sales work | [Products](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/products) |

The next step after this page is the related company setting or the product workflow
that uses the currency data.
