Skip to content
D
Documentation

Frequent currencies

reference
7 min readUpdated

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 columnsFind Frequent currencies
Understand the fieldsUnderstand the currency list and form
Add or change an entryAdd or edit a currency
Delete or export entriesDelete or export currency data
Maintain company flagsFlags
Maintain product categoriesProduct categories
Use currency data in product workProducts

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

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

List columns and entry fields

FieldReader guidanceRequiredVisible in listVisible in form
CodeThe lookup choice can supply the text shown in the next field.YesYesYes
NameReview the supplied text, then edit it before submitting.YesYesYes
SymbolRead it in the list; the form does not offer it.NoYesNo

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

ActionWhere to use itWhat it does
NewListOpens a new-record popup when new entries are allowed.
Edit controlRowOpens the selected row when edit permission is available. A row click also opens the edit popup.
DeleteRow menuDeletes a list item when delete permission is available and more than one item exists.
ExportShared list toolbarOpens the export options flow.
OKShared popupSubmits the selected item when validation succeeds.
CancelShared popupCloses 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 entryNew
    Edit an existing entryThe 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 entryData saved Successfully
Updating an entryData 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 seeWhat it meansWhat to do
Code is requiredCode has no value.Select a value in Code.
Code is requiredThe value is present.Select OK.
Name is requiredName has no value.Enter a value in Name.
Name is requiredThe value is present.Select OK.
Select a CurriencyThe currency picker has no selected currency.Select a currency in Code.
Select a CurriencyA 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 DeleteThe delete operation failed.Keep the entry and review the screen or request assistance.
Must have at least one itemThe list cannot be left without an item.Keep at least one entry in the list.
The upgrade surface appears instead of the gridThe subscription feature is not included.Open the upgrade surface.
A loading indicator remains while values are visibleThe 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.

MessageWhy it is outside this page
Related to Saved data, Can't be deletedThe 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 needPage
Maintain company flagsFlags
Maintain product categoriesProduct categories
Use configured currency data in product and sales workProducts

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

Was this page helpful?

Need help using the product?