Nuclos language files: properties, ResourceBundle, Jaspersoft Studio, $R{}, Bundle.properties, form, subforms, locale.

globe with meridians Language: Deutsch · English

hammer and wrench Creating language files

Multilingual reports/forms – create a ResourceBundle in Jaspersoft Studio and embed it via $R{}.

Auf dieser Seite

What is a language file?

A properties file (.properties) is a simple text file that JasperReports uses via the ResourceBundle mechanism. The easiest way to create one is in Jaspersoft Studio.

Create a ResourceBundle in Jaspersoft Studio

  1. Right-click a project → New → Other.
  2. Choose Messages Editor → Resource Bundle, Next.
  3. Set the folder and base name, add the desired languages, Finish.
  4. One .properties file per language is created (base name + country code).
  5. Add keys via right-click → Append… and enter values per language.

ResourceBundle main view with languages.

Embedding in the form template

In the form, translatable spots are defined as text fields with a key:

anfrage.thema = Anfrage      # in Bundle_de.properties
$R{anfrage.thema}            # in the form

In the form property, enter the base name without .properties (e.g. Bundle). The Java ResourceBundle mechanism automatically picks Bundle_de, Bundle_en etc. based on the locale. This setting must also be set for all subforms!

The form is loaded via Configuration → Report → Form or Report. For another language, clone the record and assign the other language. Further locales can be added at any time.

Related pages

globe with meridians Localization

Overview.

Öffnen →

printer Creating forms with Jaspersoft Studio

Forms.

Öffnen →