Where to locate the locales for languages

1 minute read time.

In light on the holiday season, I have a come up with a shorter than usual blog to discuss. I figured most of us would be in the holiday mindset and wouldn’t have the proper time to review a complex topic. I am like most of you, I am trying to cram in all the work I can before the holidays start.

Today we are going to take a brief look at Locales. Specifically, where to find them, how to see the details, and how to identify the difference between Factory Locales and non-factory (aka custom). To get to the locales you will need an admin or admca account. The Locales function is found under the administration module, which is why you need an admin type of account.

So, Locales are pretty much local preference packs for Sage X3. These are used to help add uniformed formatting to X3 for specific regions like USA  or France. They are also linked to specific languages so that the formatting matches the regional language.

 You can find the Locales function under Administration, Settings, Locales

As far as I know, there is no limit to the number of locales you can have. Here is a list of the Factory standard (or default) Locales.

If you select one, like en-US, you can see the formatting preferences.

The locales are directly tied to the language code you select with your login. Those can be found by selecting your account at the top bar and selecting a language

You can see the language in the left column and associated locale on the right column. The Locale button in the corner allows you to see all the locales at once via a popup.

Selecting a locale from the popup, like it-IT, for Italian, will select that locale and its associated language pack (Italian).

As you can see, it changed my GUI to Italian

And that’s pretty much it. Now you know where the Locales are stored and how to change them up (if you need to). 

Thanks for reading. 


Happy Holidays and Happy New Years!

  • Hi, thanks for the post above. 
    I've tried your steps to include the Vietnamese language. And it is appearing in Locales screen as one of the language. 

    However, when I go to the User Personal Settings to change the Language option to Vietnamese language, there is no translation being shown in all the other screens. It doesn't seem to work. 

    I tried to use other languages to troubleshoot and the other languages is working fine, except this Vietnamese language. 

    Please help. 

  • Hello , I didn't see Vietnamese language as a default language code. Is this something custom you are adding into the system?

    If it is, one of the things you can try is to run the Translatable text init (AINITEXTRA) [development, Utilities, Folders] function to make sure it has translations for that language code. You can also use the Text to translate (ATXTTRAD) [Translations, Software, Functions] function to check what has translations and what does not. The Process translation (APRTRAD) [Translations, Software, Functions] function allows you to search, import, export translations as well.

  • Hi  ,

    Following: greytrix.com/ blogs /sagex3 /2020 /04 /08 /adding-new-language-in-a-folder


    Folder used is TEST. 

    [TEST] GESADI2 = Local menu 201 - Vietnamese. Exit and update to all the local menu.
    [TEST] GESTLA = VIE - Conversion -> Vietnamese.

    Administration > Locales = Create the vi-VI code and following this document
    [TEST] GESADS = At TEST folder, Language - add VIE



    When I test it

    When I run addition language validation.


    [TEST] EXERQT = VALDICO: TEST, Additional language.


    I get this error instead.

    When I checked the Application folder's `X3_PUB\X3_ROOT\GEN\VIE\LIB`, it is empty.

    For reference, English have this:

    Is there a step I am missing here or configuration mistake done?

    I have already done: AINITEXTRA from ENG to VIE already.

  • For my reference, I found this: https://online-help.sagex3.com /erp/12/howtoguides/en-US/legislations/Add%20a%20non%20standard%20language/Content/How-to%20guides/Legislation/Add%20a%20non-standard%20language/T1%20Add%20a%20non-standard%20language.htm

  • Checked, I forgot to do ALANG function validation after "additional language" validation + "Complete" validation.

  • Additionally, there is a mismash of French, English (US), and Vietnamese which was updated recently.

    Running AINITEXTRA from ENG reference to VIE target already ran but the data is not overwritten.

  • ALANG is a required first-time run as it populates `C:\Sage\X3V12\folders\X3_PUB\X3_ROOT\GEN\VIE\LIB`

Comment Children
  • This comment was deleted.
  • AINITEXTRA must happen first before running VALDICO (Additional language).

    If AINITEXTRA is not run (because you are lazy to translate 12,000+ lines of text now and ENG language is fine for now) and no translation text imports were done, `menloc.js` will not be generated/updated and error will trigger by Sage X3.

    Next test to do is to check if ALANG must run first before the VALDICO (Additional language).

  • Also, do note that AINITEXTRA does not cover everything as there are stray fields that will still have French wordings or text coming out of left field such as below for GESITM (Common Data > Products):

    Where Products is Article and some fields not translated.

    And a lot of warning/error/help/additional buttons/messages as well with their internal numerical-equivalent being shown in-place of empty translation: