Coding tips (for partners)

How to create an own language version of the VJS

The VJS offers manually created proper translations in English and German. Partners wanting to create a translation in another language can proceed as described in this instruction.

As a basis for creating your own language translations of the VJS, we provide the English xlf files. These files can be found in our NETRONIC Partner Community on Microsoft Teams, under Files -> Demo Versions and Runtime Packages -> For Dynamics 365 Business Central. There, you need to select the desired VJS and BC versions:

VJS - how to create own language version

How to proceed:

  • Translate our xlf file of the NETRONIC VJS.
  • Write an extension using our NETRONIC VJS xlf file, which you install on top of the  NETRONIC VJS.
    1. Create an extension inside the VSCode using the “AL:Go!” command.
    2. Delete the al files in the project, because translation extensions do not contain any al files.
    3. Create a directory “Translations” in the root of the extension and save the translated xlf file of  the NETRONIC VJS to this folder.
  • You must reference the extension to be translated using the dependencies section in the app.json file. As example, we have created an Italian version.
    1. "dependencies": [{"appId": "9a08bc1f-7ac9-4671-b212-9076b2869e80
      ","name": "Visual Jobs Scheduler","publisher": "NETRONIC Software GmbH","version": "x.x.x.x"}]
    2. "idRanges": [{"from": 60000 ,"to" 60100 }]    Please replace this range with the range of your tenant customization  
    3. "features": ["TranslationFile"]
    4. "supportedLocales": ["en-US","it-IT"]
  • Compile and install the extension to Dynamics 365 Business Central and the VJS  appears with Italian menus, labels, etc.:

create own language version in VJS