Working with Translation Files (XLIFF)

by Jan 29, 2022AL Language

Home 9 Development 9 AL Language 9 Working with Translation Files (XLIFF)

How does the translation file work?

In Microsoft Dynamic 365 Business Central, displaying different languages is done using the XLIFF files extension (.xlf). The generated XLIFF files have strings that are specified in properties like Captions, Tooltips…

!!!Important!!!

———————

Old multilanguage properties (SomethingML like ToolTipML, CaptionML, …) are deprecated and are not supported by the Translation Files!

To enable translation files, the TranslationFile flag must be specified in the app.json

  “features”: 

      [ 
"TranslationFile"
]

To generate an XLIFF file, you should run the build command (Ctrl+Shift+B) in the Visual Studio Code. When you do this, the /Translation folder will pop, containing the .xlf files. The .xlf files will have all the labels, label properties, and reports of the labels you are using in the extension. Thus, by using the .xlf file, you will translate the data.

How to generate caption based on object names?

To generate the captions based on the object name, you must set the GenerateCaptions flag found in the app.json file. Once you do this, you will have to specify how you want to generate the caption.

You can choose to base it on the pages, tables, XMLports, reports, request pages, and table fields. If the object has the Caption properly set, the value used for table fields the OptionCaption is used for.

The system used to generate captions is

  "features": 
[
"TranslationFile",
"GenerateCaptions"
]

Create specific translation

The automatically created XLIFF file (created from build command) can be translated to your language manually or using any tool for reading/modifying translation files (or send it to your translation service as XLIFF is the most-known and most-used file format for translations).

Once you are done with the translation, you need to move the translated file to the same directory as the original translation file. Do not forget to rename the new file! That will help you avoid the possibility of the file getting overwritten the next time you build an extension.

AppSource

All applications you want to upload to AppSource must use Translation files!

Recent Articles from the category

NavigationAction for ErrorInfo data type

NavigationAction for ErrorInfo data type

One more article about ErrorInfo data type. Have you already read my previous posts about ErrorInfo and Collectible Errors? ErrorInfo data type & Collectible Errors | MSDyn365 Business Central - Ing. Tomáš Kapitán (kepty.cz) Collectible Errors?! | MSDyn365...

read more
Error actions for ErrorInfo data type

Error actions for ErrorInfo data type

It is already almost one and a half years since the ErrorInfo data type was introduced (we saw this data type for the first time in BC2021w2). If you do not know what it is and how to use this data type, check my previous posts: ErrorInfo data type & Collectible...

read more
Data types under the microscope: List

Data types under the microscope: List

The List data type in AL language represents an ordered collection of objects that can be accessed by their index. Unlike an Array data type, a List does not have a fixed size and does not need to have its dimension specified when it is declared. The List data type...

read more
Connect to Azure Function in BC 2022 wave 2 (v21)

Connect to Azure Function in BC 2022 wave 2 (v21)

The new version of the Microsoft Dynamics 365 Business Central brought a new system module "Azure Functions" that makes integration with Azure Functions much easier and straightforward. The typical scenario, why to use Azure Functions together with Business Central,...

read more
Collectible Errors?! Is it already in use?

Collectible Errors?! Is it already in use?

Collectible Errors?! Is it already in use? This is the second part of my new article series about Collectible Errors. Let's check out the first part here: Collectible Errors?! | Microsoft Dynamics 365 - Ing. Tomáš Kapitán (kepty.cz) or you might be interested in my...

read more
Collectible Errors?!

Collectible Errors?!

Collectible Errors?! It has been already almost a year since ErrorInfo datatype & CollectibleErrors were introduced (I already have an article about basic structure: ErrorInfo data type & Collectible Errors). This article was released for the first time in...

read more

Sign Up for News

Certifications

Highest certification
Microsoft Data Management and
also in D365 Business Central

Microsoft Certified: Dynamics 365 Business Central Functional Consultant Associate

See other certifications here