Using CDL to Create Multilingual Reports

How to define multilingual text for manual labels in a CDL document using a 'resources' block and language selectors.

Texts defined by the dashboard designer

To define texts for manual labels (such as page or widget names) in different languages for each element in a CDL document, create a 'resources' block and include a section for each language with the relevant language code as the identifier. Within each language section, define a text for every label to be translated.

//language text definitions
resources {
  resource texts #en { // English translations
    gender: "Gender"
    page1: "English"
    // Additional keys with English texts ...
  }
  resource texts #fr { // French translations
    gender: "le genre"
    page1: "Français"
  }
     resource texts #de { // german translations
    gender: "Geschlecht"
    page1: "Deutsche"
  }
  // "resource texts" definitions for other languages ...
}

You can then reference these texts using __getText wherever a multilingual label is required, for example for the page lable in the image:

page #Page1 {
  label:__getText(page1)

Language Selectors

A language selector drop-down can be added to the header layout area to provide a pre-set list of available languages for the end user to choose from.

widget language {
      option value {
        label: "English" // use e.g. __getText(english) to provide localized menu text
        value: "en"
      }
      option value {
        label: "French"
        value: "fr"
      }
      option value {
        label: "German"
        value: "de"
      }
    }

This will add the component shown below:

Example of the language selector