User-Defined Labels

Unlike the built-in D365FO labels, User-defined labels are created and translated at runtime. They can be used either with Docentric templates or in report print settings such as Email body, subject and output filename for both Docentric and SSRS reports.

To open User-Defined Label setup navigate to the Docentric AX workspace and click the User-defined labels menu item. Alternatively, you can access to User-defined labels via Organization administration > Docentric AX > Report labels > User-defined labels.

Before you start with label translations

To start translating User-defined labels, you will first need to set up Label languages, to which User-defined labels will be translated. Learn how to set up Label languages >>

User-defined label setup

There are 4 different views (i.e. forms) of User-defined labels:

User-defined label list

This form is an entry point for User-defined labels. It is especially important for operations that can be performed for multi-selected records at once. For example, adding to a report, adding blank translations for missing languages, deletion, etc. can be performed in bulk only on this form.


View by label

User-defined label details or View by label shows label translations grouped by label. This form is convenient when you are translating label by label to multiple languages.

View by language

View by language shows label translation groped by language. This form is suitable for translating various labels for a particular language.



Navigating between View by label and View by language

We tried to create as good as possible user-experience when working with labels and their translations; that’s why we made Label and Language IDs clickable. When you click a Label ID in View by language, you will be navigated to the View by label form, where you will be able to see all translations for the clicked label. The same applies to the View by label form, by clicking a language you will jump to View by language and be able to see all labels translated (or not-translated) in the clicked language.


View label translations on flat

View all shows label translations without grouping by label or language – this is a flat view. We introduced this view to enable quick filtering by label or by language and updating translations.


Fallback translations

Fallback translation is a text that will be used if no translation for this label and runtime language exists. In the first phase, we recommend to leave the Fallback translation field empty in order to see the warning messages for missing translations.

Update translations in Excel

If you find more convenient to translate labels in Excel, you can do it by using 2 different Excel formats defined by 2 different data entities.


Moving between environments

To support export/import scenarios, i.e. moving between environments, we created several data entities that you can use with the Data management framework. Learn more >>

How to use User-defined labels with Docentric templates

You will create User-defined labels usually to make your report multilingual. Once you create a User-defined label, you can assign it to multiple reports registered in Docentric report setup. You can do this from User-defined label setup or in Docentric report setup. These labels will become so-called Custom labels and after the report DDSP is generated, you will see them in Docentric designer. Learn more >>

How to use User-defined labels with report print settings

Besides being used on Docentric report templates, User-defined labels can also be used in report print settings such as Email body, subject or output filename. More precisely, anywhere in print settings where you can use placeholders, you can now use User-defined labels as well. Learn more >>


Anyone with the Docentric AX Report Labels User role can maintain Label languages, which means that he or she does not need to have the Docentric AX Administrator role assigned.

See also

User-Defined Labels and Multilingual Reports >>
User-Defined Labels and Print Destination Settings >>
Import/Export User-Defined Labels >>
How to Design Multilingual Reports >>