Difference between revisions of "BIRT/FAQ/Internationalization"

From Eclipsepedia

< BIRT‎ | FAQ
Jump to: navigation, search
(Internationalization)
(Q: Can different bits of a report appear in different locales?)
 
(4 intermediate revisions by 4 users not shown)
Line 1: Line 1:
Back to [[BIRT/FAQ|BIRT FAQ Index]]
+
{{Backlink|BIRT/FAQ}}
 +
 
 
== Internationalization ==
 
== Internationalization ==
 
=== Q: Do BIRT reports support localization (L10N) and internationalization (I18N)? ===
 
=== Q: Do BIRT reports support localization (L10N) and internationalization (I18N)? ===
Line 20: Line 21:
 
=== Q: Can different bits of a report appear in different locales? ===
 
=== Q: Can different bits of a report appear in different locales? ===
  
For example, suppose BIRT is used in an ERP application. Invoices are printed in the locale of the customer. The user wants to see the invoice in the same locale as the customer. For example, if the user's locale is German, but customer's local is American, then the user would see the invoice in American format with English strings, decimal point "." instead of German "," etc.
+
Can portions of a report be in one locale while others are in another locale?
 
+
This can be done by using format properties in the properties editor. You can set the locale for formatted strings, numbers and dates.
This feature is not available in Release 1.0. It is something to consider for a future release.
+
You can also use script to get messages for a specific locale that is different than the locale you are using to run the report.
 +
//label oncreate script
 +
importPackage(Packages.java.util);
 +
var lc = new Locale("de_DE");
 +
this.text = reportContext.getMessage("text1", lc)
  
 
=== Q: Can the user specify the report locale when running the report? ===
 
=== Q: Can the user specify the report locale when running the report? ===
  
Reports are viewed using the BIRT web application. This application takes a __locale parameter within the URL for running a report. Simply set this parameter to the desired locale.
+
Reports are viewed using the BIRT web application. This application takes a <code>__locale</code> parameter within the URL for running a report. Simply set this parameter to the desired locale, by specifying both language and country codes, therefore: <code>__locale=fr_CA</code>.
 +
 
 +
Here's an example of using such parameter:
 +
 
 +
<code><nowiki>http://localhost:8900/WebViewerExampel/frameset?_-report=MyReport.rptdesign&__locale=fr_CA</nowiki></code>
 +
 
 +
Although there has been stated that only using the language code might work (<code>__locale=fr</code>), in current implementation one must specify both language and country codes.
  
 
=== Q: How can I localize strings in Javascript? ===
 
=== Q: How can I localize strings in Javascript? ===
Line 38: Line 49:
 
reportContext.getMessage("messageOrdersKey", reportContext.getLocale(), l10nParams);</VALUE-OF></pre>
 
reportContext.getMessage("messageOrdersKey", reportContext.getLocale(), l10nParams);</VALUE-OF></pre>
 
Read Sun Java documentation for [http://java.sun.com/j2se/1.4.2/docs/api/java/text/MessageFormat.html message format details].
 
Read Sun Java documentation for [http://java.sun.com/j2se/1.4.2/docs/api/java/text/MessageFormat.html message format details].
 +
 +
[[Category:BIRT]]
 +
[[Category:BIRT FAQ]]

Latest revision as of 17:41, 5 June 2012

< To: BIRT/FAQ

Contents

[edit] Internationalization

[edit] Q: Do BIRT reports support localization (L10N) and internationalization (I18N)?

Yes. Do the following:

  • Create a standard Java properties file within your report project.
  • Create properties for each resource you want to localize.
  • Set the Resources property of your report. Select the white space in the layout editor. Open the Property Editor. Switch to the General tab. Enter your property file name in the Resources field.
  • For each label, go the "Localization" tab in the Property Editor and choose the appropriate resource from the list for the Content key property.

When you run your report, BIRT will use the standard Java system for locating a property file that matches the user's locale. The resources for that file will appear in your labels. (If BIRT cannot find a resource file, or cannot find the requested key, then the default text for the label will appear. The default text is what you entered in BIRT's layout editor.)

BIRT Also provides language packs for many languages. The language packs are accessible from the downloads page.

[edit] Q: How to create translation for my language?

If your default property file is named "myreport.properties", copy it to file named "myreport_lang.properties" or "myreport_lang_country.properties", where lang and country are two letter ISO codes. For example for german translation use "myreport_de.properties", for US english use "myreport_en_US.properties". Then translate all texts behind equal signs (property file consists of couples key=text).

[edit] Q: Can different bits of a report appear in different locales?

Can portions of a report be in one locale while others are in another locale? This can be done by using format properties in the properties editor. You can set the locale for formatted strings, numbers and dates. You can also use script to get messages for a specific locale that is different than the locale you are using to run the report.

//label oncreate script
importPackage(Packages.java.util);
var lc = new Locale("de_DE");
this.text = reportContext.getMessage("text1", lc)

[edit] Q: Can the user specify the report locale when running the report?

Reports are viewed using the BIRT web application. This application takes a __locale parameter within the URL for running a report. Simply set this parameter to the desired locale, by specifying both language and country codes, therefore: __locale=fr_CA.

Here's an example of using such parameter:

http://localhost:8900/WebViewerExampel/frameset?_-report=MyReport.rptdesign&__locale=fr_CA

Although there has been stated that only using the language code might work (__locale=fr), in current implementation one must specify both language and country codes.

[edit] Q: How can I localize strings in Javascript?

Use reportContext.getMessage("companyNameKey", reportContext.getLocale()), where companyNameKey is a key from the resource bundle associated with the report. See javadoc for more information.

[edit] Q: Can I localize messages with dynamic content?

Yes, you can. But you should use javascript, as BIRT Designer does not support this feature. Imagine that you need to localize message: "There are <VALUE-OF>orders</VALUE-OF> orders." First define the key messageOrdersKey with this content: "There are {0} orders." Then edit your report item and type following:

<VALUE-OF>l10nParams = new Array(1); l10nParams[0] = orders;
reportContext.getMessage("messageOrdersKey", reportContext.getLocale(), l10nParams);</VALUE-OF>

Read Sun Java documentation for message format details.