Warning: number_format() expects parameter 1 to be float, string given in /data/web/virtuals/7298/virtual/www/wp-includes/functions.php on line 412

Working with Translation Files (XLIFF)

by Sep 13, 2021AL Language

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

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

How to let users choose field(s) properly

How to let users choose field(s) properly

When some complex functionality is developed, it is sometimes necessary to let users choose a specific field. This can be required for field permissions, mapping imported values or any similar process. Earlier, the usual way was to create a link on the Field table...

read more
Returning complex types in AL Language

Returning complex types in AL Language

In Microsoft Dynamics 365 Business Central 2021 w1 (released in May 2021), a profound change was introduced to ways how we can design our applications Until this version, the only way to return complex data types (like records, codeunits, Lists etc.) was using the var...

read more
Import various file types with Interfaces

Import various file types with Interfaces

A few weeks ago, I described a solution for importing an Excel file to the Business Central using Excel Buffer in AL Language (see here). In today's article, we will look at how to build a more complex solution that can be used for file imports without the needs to...

read more
How to import Excel files using Excel Buffer

How to import Excel files using Excel Buffer

Last week, I saw a question about importing data from Excel file to Business Central using AL Language. A few years ago, the only solution was to use DotNet integration. However, with the Business Central, there is a much quicker and better approach. All functions for...

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