How to configure regional settings for Alloy Navigator

On this page

Regional settings decide which language people see and how dates, times, numbers, money, and durations appear. In Alloy Navigator they are not one setting: each application takes its language and formats from its own place. An administrator sets the installation's display language and its currency and duration formats, the languages of each Self Service Portal instance, the report locale, the time zone of the API, and the Windows regional settings of the account that runs the Automation Server. Technicians then adjust how dates and times appear for themselves in the Web App.

Before you begin

  • To open the Admin Center, your account needs the Basic Administrative Access permission. You open the Admin Center from the Advanced group at the bottom of the Web App main menu. See Work in the Admin Center.
  • Inside the Admin Center, each page needs its own permission or Administrative Access: General > Language & Region needs Regional Settings, General > Report Settings needs Report Settings, a portal instance's pages need Self Service Portal Configuration, and an API instance's pages need API Configuration. See What each administrative permission opens.
  • The Settings App checks Basic Administrative Access at sign-in. Its General > Regional Settings and General > Report Settings nodes need the Regional Settings and Report Settings rights, or Administrative Access. See Work in the Settings App.
  • To change the Windows regional settings that the Automation Server uses, you need to sign in to the computer that runs the Automation Server.

Set the display language and the currency and duration formats

The display language and the currency and duration formats apply to the whole installation. There is no per-user currency format.

In the Admin Center:

  1. Open General > Language & Region.
  2. Under Language, choose the Display language: English - United States or Spanish. The section is marked Preview.
  3. Under Currency format, set the Currency symbol, the Positive currency format and Negative currency format, and No. of digits after decimal, a whole number from 0 to 4. Reset fills the four fields with currency settings taken from the regional settings that the Admin Center's server process runs with at that moment.
  4. Under Duration format, enter Time duration format and When duration is less than 1 hour. The page does not check what you enter. For the tokens that the templates use, see Duration formats.
  5. Click Save and Restart. Save and Restart and Cancel appear once you change a value.

If you changed the display language, a dialog shows Applying New Language and then Import Completed, and a restart follows. If you did not change the display language, the first Web App instance restarts.

IMPORTANT: Save and Restart starts the language import or the restart in the same click as the save, without waiting for the save to finish, so the import or the restart runs even if the save fails. Before you rely on the language import or the restart, check that the save completed.

The display language changes the Web App's interface texts for every technician, the labels of object fields, and the Admin Center's own language. Statuses, actions, forms, views, and other configured names keep the names they were configured with. Saving Language & Region also sets the default language of every Self Service Portal instance to the display language and adds that language to the instance's languages.

The Settings App edits the same currency and duration formats on its General > Regional Settings node, which has no display language. There, click Save on the toolbar, and then restart Internet Information Services (IIS) on the web server to apply the new formats to the web and mobile apps: Save in the Settings App restarts nothing. See Set the currency and duration formats.

Choose the languages of each portal instance

Each Self Service Portal instance offers its own set of languages. In the Admin Center:

  1. In the main menu, open Apps and Portals > Self Service Portal, choose the instance, and open Languages.
  2. Under Additional languages, check the languages that the portal's users may choose.
  3. Choose the Default language. It offers only the checked languages.
  4. Save the page. The change takes effect within a few minutes, without a restart.

When the installation's display language is stored, the portal uses that language as its default instead of the instance's Default language. To add a language the instance does not have yet, or to change a portal text, see Manage portal languages.

Each portal user then chooses a language on their own Profile page, and can have dates, times, and numbers follow the first language of their browser while the portal text stays in the chosen language. See Your Profile.

Set the default report locale

Reports show dates, numbers, and currency in the default report locale, unless a report sets its own language. The locale also decides the first day of the week for "this week" and the other week-based date ranges. If no report locale is set, the Database Management tool fills it in with the system locale of the computer it runs on.

In the Settings App, open General > Report Settings and choose the locale in Locale: in the Default report locale group. The Admin Center's General > Report Settings page holds the same value in its Default Locale list. See Report Settings.

Set the time zone of the API

The API converts the date and time values it sends and receives against the time zone of its instance, so every API client sees one consistent time zone.

In the Admin Center:

  1. In the main menu, open Apps and Portals > API and choose the instance. When only one instance exists, the menu goes straight to that instance's tabs.
  2. Open the Timezone tab.
  3. In Timezone, choose the time zone. The list shows the time zones of the computer that hosts the Admin Center.
  4. Save the tab. The change takes effect in a few minutes.

Choose the time zone that the stored values were written in: the API agrees with the database only for that zone. If no time zone is set, the API uses the time zone of the computer it runs on. See API Settings.

When SQL Server and IIS are hosted on separate computers, configure the database server and the web server to operate in the same time zone. Otherwise, dates and times can be processed inaccurately, and system functionality can be disrupted. No installer check compares the time zones. See System Requirements.

Set the Windows formats of the Automation Server

Workflow notifications and other templates write money with the installation's currency symbol, digits, and formats, but take the decimal and grouping separators from the Windows regional settings of the account that runs the process. For the Automation Server, that is its startup account, which the Automation Server Manager shows under Startup account. With a multicurrency license, the amount is written without the symbol in a fixed format. The Automation Server formats dates, times, and numbers with the Windows regional settings of its startup account, and the connector and job programs with those of the account that runs them.

To make these values match the formats that people see elsewhere, on the computer that runs the Automation Server:

  1. In the Windows Region settings in Control Panel, set the formats on the Formats tab. The Formats tab holds the settings of the account you are signed in with.
  2. Open the Administrative tab and click Copy settings. In the Welcome screen and new user accounts settings, select both check boxes to copy your current settings to the existing and new system accounts.
  3. Click OK and Apply.
  4. Restart the computer.

When the Automation Server's startup account is a Windows domain account, the copied settings may not take effect. In that case, stop the Automation Server in the Automation Server Manager, sign in to the computer with the startup account, set the formats on the Formats tab directly, and start the Automation Server again. See Start, stop, or restart the service.

A value that SQL Server has already turned into text, for example with CONVERT in a SQL macro, is inserted into a notification unchanged.

Adjust dates and times in the Web App

The Web App formats dates, times, and numbers in lists for the first preferred language of each technician's browser. The decimal and thousand separators in number fields and number filters also follow the browser's language; no Alloy Navigator setting changes them. Each technician can adjust how dates and times appear in lists.

In the Web App:

  1. In the header, open the profile menu and choose Settings.
  2. Under Date format options, turn 2-digit year and Abbreviate month on or off.
  3. Under Time format options, turn Display seconds and 24-hour format on or off.
  4. Click Save.

Until a technician changes one of these options, the four options take their starting values from the browser's locale. If the browser's locale already uses 24-hour time, 24-hour format is shown selected and cannot be changed. See Personal Settings.

What people see in each application

The currency format is set once for the installation, and each application applies it in its own way:

Where Dates, times, and numbers Currency
Web App The browser's first preferred language, adjusted by the technician's own date and time options All four values. Decimal and grouping separators follow the browser's language.
Self Service Portal The language the user picked, else the first of the browser's languages that the instance offers, else the portal's default language; or the browser's first language when the user selected automatic formatting The symbol and the digits after the decimal only; the symbol's placement and the minus sign follow the formatting language
Alloy Navigator app and Alloy Self-Service app The device's locale All four values, unless a money field on a record's page sets its own. The decimal separator is a period, with no grouping separator.
API Date-time values with the offset of the API instance's time zone Not applied to values
Settings App, Automation Server, Import Wizard, connector and job programs The Windows regional settings of the account that runs the program All four values. The decimal separator comes from Windows.
Notifications and other workflow templates - The installation's symbol, digits, and formats, with the separators of the account that runs the process
Reports The default report locale, or the report's own language Not applied; currency is shown in the report locale

For the full rules, including multicurrency amounts, see Language and format scopes.

What you have now

The installation has its display language and its currency and duration formats, each portal instance offers the languages you chose, reports use the report locale, the API uses one time zone, and the Automation Server writes notifications with the separators you chose. Technicians see dates and times in the Web App the way their browser and their own options set them.