AL Translation Pack

This extension creates an XLF file for each language used in caption\tooltip\label comments. The caption\tooltip\label must always be entered in English and in the comments the values of the translations can be specified.

When a comment is entered, the extension creates a line that can be translated. Using the standard multilanguage formatting we can direct the extension to create the correct translations.

For example: Caption = 'Item No.', Comment = 'ITA="Nr. Articolo",ESP="Artículo No.",FRA="Numéro d'article"';

Features

To start the creation/update of the translation file you need to use the Update Translations (XLF) function. Every time you want to update the translation files (XLF) this function must be executed. The comment strings must be formatted correctly, for this reason a function has been implemented which corrects all the comment strings when the file is closed. If you want to fix the comment strings for all files of the project, you can use the Check Comment String (AL) function.

Once the translation file has been created/updated, you can choose the Auto Translations (XLF) function to add the translation to the XLF file where the comment has not been specified. Running this command will create translations for captions for which a translation has not been specified by adding the comment. At the same time a file will be created in the location .\.resource\Autranslate.json. This JSON file will contain all the translations that have been automatically suggested by the translator. By editing the translations in this file and updating the translations file using the Update Translations (XLF) command, the translation will be changed.

Also, if you want translations to be created for all AL files for which a translation has not been created, you can select the Create translation comment (AL) command.

In addition, the following snippets have been implemented:

• CaptionWithComment: Caption = 'CaptionString', Comment = 'TranslationLanguage="TranslationString"';
• LabelWithComment: LabelName: Label 'LabelString', Comment = 'TranslationLanguage="TranslationString"';
• TooltipWithComment: Tooltip = 'TooltipString', Comment = 'TranslationLanguage="TranslationString"';
• CommentForTranslation: , Comment = 'TranslationLanguage="TranslationString"';

Settings

This extension contributes the following variables to the settings:

• Default Language When the "Default Language" is specified, the Snippets are modified to replace TranslationLanguage with the specified code.

  So if the "Default Language" is set to ITA the Snippets are modified as follows:

  • CaptionWithComment: Caption = 'CaptionString', Comment = 'ITA="TranslationString"';
  • LabelWithComment: LabelName: Label 'LabelString', Comment = 'ITA="TranslationString"';
  • TooltipWithComment: Tooltip = 'TooltipString', Comment = 'ITA="TranslationString"';
  • CommentForTranslation: , Comment = 'ITA="TranslationString"';

• Update On Compile Project This flag allows to start the translation of the XLF file every time the project has been compiled.

• Auto Translate Language This option represents the languages that you want to be automatically translated by the Auto Translations (XLF) feature. These can be listed separated by a comma. For example: ITA,FRA,ESP

• Fix Comment String On Close File This flag allow the extension to fix the comment line when closing the file.

• Create the ``Translation Comment`` automatically This flag allow the extension to create automatically Translation Comment when a caption added.

Known Issues

When a double quote is used within the translation, it does not correctly recognize the string to be translated.

For example:

TestFieldErr: Label 'The "Item No." field must be completed.', Comment = 'ITA="Il campo "Nr. Articolo" deve essere valorizzato."';

In this case, using the string "Nr. Articolo" within the comment, this create problems in correctly finding the translation.