Multilingual Print Destination Settings
You can make report print settings multilingual by using User-defined labels. They can be used anywhere in print settings where you can use placeholders, e.g. Email body, subject or output filename.
In addition, you can also use labels in all fields in Docentric report setup, which can contain placeholders, e.g. Report caption and Email sender display name.
In order to be recognized as labels and processed by Docentric framework when printing reports, you should append the @ character to the end of any valid Label ID (for D365FO labels) or Global label ID (for Docentric User-defined labels). This way they will become so-called label-placeholders, ready for the use in report print settings.
Each label-placeholder consist of Label ID and the @ character appended at the end. For example:
>> Label ID: @SYS14204 (translated as ‘Invoice’ in English)
>> Label-placeholder: @SYS14204@
For User-defined labels, Global label ID is used in the same way:
>> Label ID: CustomerName
>> Global label ID: @DOC_LABEL:CustomerName
>> Label-placeholder: @DOC_LABEL:CustomerName@
Locate existing or create new labels in User-defined label setup
But let’s start from the beginning. If you want to make the email body and subject of your outgoing emails multilingual, you can try to locate D365FO labels suitable for your needs, which can be done only from within Visual Studio. As we already explained, besides D365FO labels you can also create your own labels from within D365FO using Docentric’s User-defined labels functionality.
In order to start, open User-defined labels from the Docentric AX workspace. Then find and select the needed labels or create and translate new ones. Next, click the Add to print settings button. A new dialog is open, showing the selected labels as label-placeholders, ready to be used in report print settings. Copy those you need to use in print settings.
Use labels in the Print destination settings form
Let’s say that we want to use labels in Email subject and body for the Customer invoice report. Open Print management setup and the Print destination settings form for Customer invoice. At the same time, you can keep User-defined labels open in another browser tab. Then copy and paste the wanted labels into Email subject and body.
Note that we also turn on the Open email before sending option, causing that the outgoing emails will be downloaded in the browser instead of sent out D365FO. This is convenient to check immediately the Email subject and body.
If we now print an invoice from Invoice journal using Print management, for a customer with the Language field set to de, we will get the output email with the used labels translated to German.
On the other hand, if we print another invoice from Invoice journal for a customer with the Language field set to en-us, we will get the output email with the used labels translated to English.
Use labels in Docentric report setup
Both D365FO and User-defined labels can also be used in Docentric report setup, in all those fields that can contain placeholders, e.g. Report caption and Email sender display name. In this manual, we will show you how to make the Report caption field multilingual.
Open Docentric report setup and locate SalesInvoice.Report, then update the Report caption field to contain a D365FO label. Note that we can use User-defined labels as well. We additionally set up Print management to save invoices to Print archive, where Report caption is used for the Description field. Let’s print the same reports again and see the results.
Note that Report caption can come handy in different scenarios. Learn about multiple use of Report caption >>
The Label placeholder list form
As explained in the Label-placeholders chapter above, when you use labels in print settings or Docentric report setup, you need to append one @ character to their Label ID. You can use the Label placeholder list form as a helper to easily pick the exact string and just copy-paste it where you need it.
The Label placeholders list form lists all available label-placeholders for User-defined labels.
Simply select one or more label-placeholders and you will get correctly formatted string at the bottom of the form. Just copy-paste it wherever you need it in the Print destination settings or in the Docentric report setup form.
The Label placeholder list form can be opened from the Report placeholders form, which you can access from these locations:
- Print destination settings form
- Docentric report setup form
- Docentric AX workspace
Additionally, the Label placeholders list form can be opened directly from the User-defined label form:
Discover System label ID using the Personalization form
To be able to create User-defined label based on D365FO System labels, users need to discover System label IDs first.
To support discovering System labels IDs, we added two controls to the Form Information form (i.e. the Personalization form): Control label ID and Field label ID.
While Control label ID contains the System label ID of the selected form control, Field label ID contains the System label ID of the data field bound to the selected control (if the control is bound to a data field).
To open the Form information dialog, select a control on a form, right-click it and select Form information. While Control label ID is placed in the Control details tab and is visible to all users, Field label ID is visible only to System administrators, because it is placed within the Administration tab.