Coding tips (for partners)

How to create an own language version of the VPS

The VPS 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 VPS, 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 VPS and BC versions:

 

VPS-where to find language files

 

How to proceed:

  • Translate our xlf file of the NETRONIC VPS.
  • Write an extension using our NETRONIC VPS xlf file, which you install on top of the NETRONIC VPS.
    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 VPS 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": "5716C909-A743-461e-AC12-D99759152986","name": "Visual Production 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 VPS  appears with Italian menus, labels, etc.:

create own language version in VPS