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.

Label-placeholders

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 >>

See also

Learn About User-Defined Labels >>
How to Design Multilingual Reports >>
How to Add Custom Labels in Docentric Report Setup >>

IN THIS ARTICLE