Translations

IBM® TRIRIGA® supports the translation of all labels in the BIRT report. The starter report includes all the labels needed to translate the business object field labels in a report.

Field labels

A starter IBM TRIRIGA BIRT report is associated to a resource properties file with an extension of tririgalabels.properties. You can view this association in the report's Resources section in the Property Editor – Report tab.

This report resource points to a properties file that contains label keys for every business object field that was built into the report. The field label key uses the following format:
[FIELD]ModuleName__BusinessObjectName__FieldName
For example:
[FIELD]triPeople__triEmployee____triFirstNameTX
[FIELD]triPeople__triEmployee____triLastNameTX
In the starter report, each key is already associated to its corresponding data set output column in BIRT.

If you use the Data Explorer as a canvas, you can drag elements onto the canvas without having to reassociate the display keys for those elements. If you do not drag elements onto the canvas, you can still use all the labels in the properties file on any report element that supports localization. You do this by selecting a report element in the layout and navigating to its Localization properties in the Properties tab of the Property Editor – Label tab. At runtime, text that uses these [FIELD] keys is translated based on the current user's language.

If you need a custom field label in your report that is not available from the starter report properties file, you can add keys and labels to the file to support those other scenarios. As a result, the custom labels are added to the tririgalabels.properties file. When the report design and the label files are exported and uploaded to IBM TRIRIGA, the custom labels from the BIRT report can be exported for translation from the Globalization Manager.

Non-field labels

The IBM TRIRIGA BIRT integration also supports labels such as parameter input labels and report titles.

The only requirement for a key name is that it cannot begin with the special [FIELD] prefix.

If you need a custom non-field label in your report that is not available from the starter report properties file, you can add keys and labels to the file to support those other scenarios. As a result, the custom labels are added to the tririgalabels.properties file. When the report design and the label files are exported and uploaded to IBM TRIRIGA, the custom labels from the BIRT report can be exported for translation from the Globalization Manager.

Libraries

A BIRT report library can house reusable report elements, including labels. You need to create a properties file with an extension of tririgalabels.properties and refer to that properties file as a library resource. To view a supported properties file for a BIRT report library, select the library in the BIRT Navigator, and view the properties in the Property Editor – Library tab.

To read the library, each BIRT report must reference the library before you export and upload the report to IBM TRIRIGA.