BeyondERP.Newsletter
Menu

Setup page · Retail and Commerce

Language text

A setup page where you add language text entries (a language ID, a text ID and the replacement text) that override the default labels, messages, error messages and receipt strings shown by the POS.

Used by
Retail operations manager, Retail service, Information technology manager
Business process
Manage sales channels
Menu item
RetailLanguageText
Main table
RetailLanguageText
Data entity
RetailLanguageTextEntity
Setup steps
1 on this page
Show what matters for
PAGE GUIDEWhat the page does and how to use it8 sections. Choose a role to highlight what matters to you.
Everyone

1What it is and why

What it isA setup page where you add language text entries (a language ID, a text ID and the replacement text) that override the default labels, messages, error messages and receipt strings shown by the POS.
What you do hereUse this page to change POS user interface labels and POS messages, or Commerce runtime error messages and receipt strings, for a given language without changing code. You can also add new custom messages for extensions here.
ExampleFor example, you can change the label of the Operator ID field on the POS sign-in page to Employee ID for US English by adding an entry with language ID en-us, text ID 502 and text Employee ID.
Language text page in Dynamics 365
The page in Dynamics 365. page title tab to open what to set or check
Functional consultant · Solution architect

2Where it fits

Business processDevelop sales policies › Manage sales channels
Menu pathRetail and Commerce › Channel setup › POS setup › POS profiles › Language text
Used next byDistribution schedule Microsoft Learn
Related pagesCustom fields Microsoft Learn
End user · Functional consultant

3How to do it

About the examples: Examples and screenshots in this guide use BEAT, a demo company in a Dynamics 365 test environment. Use your own company's codes and values instead of copying them.

Setup steps on this page

Set up Language text

Use this page to change POS user interface labels and POS messages, or Commerce runtime error messages and receipt strings, for a given language without changing code. You can also add new custom messages for extensions here.

Steps from Microsoft

  1. Go to Retail and Commerce > Channel setup > POS setup > POS profiles > Language text.
  2. On the POS tab, in the POS language text grid, select Add.
  3. Enter the language ID, the text ID of the string to override, and the new text.
  4. On the Action Pane, select Save.
  5. Go to Retail and Commerce > Retail and Commerce IT > Distribution schedule.
  6. Select the Registers (1090) job and select Run now.
  7. Wait for the string cache to refresh (up to one hour, or restart Retail Server), then sign out of and back in to Store Commerce.

Source: Microsoft Learn

Fields on the page

FieldWhat it means
Language IDThe language and culture code (for example en-us) that the override applies to.Microsoft Learn
Text IDThe identifier of the POS string (a number such as 502) or of the runtime message or receipt string (a resource name); new custom message IDs must start with Microsoft_Dynamics_Commerce_.Microsoft Learn
TextThe replacement text that the POS or receipt shows for that text ID in that language.Microsoft Learn

Test checklist

  1. Add en-us, Text ID 502, Text Employee ID on the POS tab.
  2. Run the Registers (1090) job and wait for the string cache to refresh.
  3. Sign out and back in to Store Commerce.
  4. Check the sign-in field label reads Employee ID.

Source: Microsoft Learn

Functional consultant

4Setup decisions

Setup stepRecommended value and whyDecision, common mistake and test
Set up Language textOverride standard POS strings by language ID and text ID; give new custom messages a text ID starting with Microsoft_Dynamics_Commerce_Learn requires the Microsoft_Dynamics_Commerce_ prefix for new messages, and overrides need the exact text ID of the string.Running job 1090 and checking at once. The localized string cache can take up to an hour; users then need to sign out and in, or Retail Server must be restarted.
Solution architect

5Design impact

Can it be undoneReversible: Delete or change the entry and run job 1090; the default string returns after the cache refreshes and users sign in again. Microsoft Learn
If you change it laterChanges only reach the POS after the Registers (1090) job runs and the localized string cache refreshes; users must then sign out and back in to see the new labels. Microsoft Learn
Technical architect

6Technical

Menu itemRetailLanguageText Checked in Dynamics 365
FormRetailLanguageText Checked in Dynamics 365
TableRetailLanguageTextShown as “TRANSLATIONS” in Record infoChecked in Dynamics 365
Data entitiesRetailLanguageTextEntityRetail translations Microsoft data model
Who can open itPrivilegesMaintain Retail language text RetailLanguageTextMaintainDutiesMaintain retail register reference data RetailTerminalReferenceDataMaintain
3 security rolesRetail operations manager RetailOperationsManagerRetail service RetailServiceInformation technology manager SysServerITManager
Checked in Dynamics 365
Roles to set it up and use itTo set it up or change itRetail service RetailServiceRetail operations manager RetailOperationsManagerInformation technology manager SysServerITManagerGive people one of these roles. On this system, 3 roles can open this page.Checked in Dynamics 365
Developer

7Developer

Open it by URLhttps://<your-environment>/?mi=RetailLanguageText
Integrate withRetailLanguageTextEntity data entity Microsoft data model
Data migrationRetailLanguageTextEntity (Retail translations): loaded for each company.Microsoft Learn
Table definitionRetailLanguageText columns and relations Microsoft data model
Everyone

8Sources