Localization

Introduction

There are three distinct categories of languages to consider:

  1. The languages of the forms you create.
  2. The languages of the Form Builder user interface.
  3. The languages of the Form Runner user interface.

This means that a form author could use Form Builder in the French language, create a form in Mandarin Chinese, and run it with the Form Runner's English user interface.

For more on how to localize your forms in Form Builder, see Form Localization in Form Builder. For more on how to localize the Form Builder or Form Runner user interface, see Localizing Orbeon Forms. In what follows, we'll discuss how Form Runner picks which language to use at runtime, and what languages are supported by Form Builder and Form Runner out-of-the-box.

Language selection at runtime

Determination of the form's language

The following applies to Form Runner pages which deal with a given form definition, such as the Summary page and Detail page. It doesn't apply to the Form Runner Home page, which deals with multiple form definitions.

To determine what language to use, Form Runner determines a list of available languages for the form, as well as a requested language. From these, it determines the language to actually use.

The list of available languages for the current form is selected as follows:

  • It starts with the list of languages defined in the form definition. There is always at least one such language present.
  • If the oxf.fr.available-languages.*.* property specifies at least one language, then only those languages which are both in the form definition and specified by the property are retained.

NOTE: The result can be an empty selection.

The requested language is determined following this order of priority:

  1. The language just selected by the user in the Form Runner language selector.
  2. The current Liferay language if Form Runner is used via the Liferay proxy portlet and the "Send Liferay language" option is selected.
  3. The value of the fr-language request parameter if specified.
  4. The value of the fr-language servlet session attribute if present.
  5. The value of the oxf.fr.default-language.*.* property if present.
  6. English (en) if everything else fails.

Then the actual form language is selected:

  • If the requested language is one of the available languages, then it is selected.
  • Otherwise, if the default language specified with oxf.fr.default-language.*.* is one of the available languages, then it is selected.
  • Otherwise the first language available in the form definition is selected.

NOTE: This means that one language is always picked, even if it is not an "available" language.

Once a language is selected, it is stored as the fr-language session attribute so that it is remembered when the user navigates pages. This behavior can be turned off if the fr-remember-language=false is passed as request parameter.

Determination of the Form Runner user interface language

Summary page and Detail page

The form's language is first selected as described above. Then the actual Form Runner user interface language is selected:

  • If the form's language is one of the available Form Runner UI languages, then it is selected.
  • Otherwise, if the default language specified with oxf.fr.default-language.*.* is one of the available Form Runner UI languages, then it is selected.
  • Otherwise English is selected.

NOTE: This means that the Form Runner user interface can be the same as the language of the form, or be different. For example, if your form definition is in Mandarin Chinese, but Form Runner doesn't support that language for its UI yet, the Form Runner UI will be in English.

Home page

The list of available languages is selected as follows:

  • It starts with the list of Form Runner user interface languages. There is always at least one such language present.
  • If the oxf.fr.available-languages property (without wildcards) specifies at least one language, then only those languages which are both Form Runner user interface languages and specified by the property are retained.

NOTE: The result can be an empty selection.

The requested language is determined following this order of priority:

  1. The language just selected by the user in the Form Runner language selector.
  2. The current Liferay language if Form Runner is used via the Liferay proxy portlet and the "Send Liferay language" option is selected.
  3. The value of the fr-language request parameter if specified.
  4. The value of the fr-language servlet session attribute if present.
  5. The value of the oxf.fr.default-language property if present.
  6. English (en) if everything else fails.

Then the actual Form Runner user interface language is selected:

  • If the requested language is one of the available languages, then it is selected.
  • Otherwise, if the default language specified with oxf.fr.default-language is one of the available languages, then it is selected.
  • Otherwise English is selected.

Once a language is selected, it is stored as the fr-language session attribute so that it is remembered when the user navigates pages. This behavior can be turned off if the fr-remember-language=false is passed as request parameter.

Form Builder and Form Runner user interface

  • F: full support
  • P: partial support
  • N: no support

See also Localizing Orbeon Forms for information about how to localize Form Builder and Form runner in additional languages. Your contributions are welcome!

As of Orbeon Forms 2016.1 and 2016.2

Language Calendar Numberer XBL components Form Runner Form Builder
English F F F F F
French F F F F F
Swedish F F F 1 F1 F1
Portuguese F F F 1 F1 F1
Italian F F F 1 F1 F1
German F F F 1 F1 F1
Spanish F F F 1 P P
Finnish F F P F1 F1
Dutch F F F 1 F1 N
Norwegian F F P P P
Russian F F P P P
Polish N F N N N
  1. A few resources are missing.

As of Orbeon Forms 4.10

Language Calendar Numberer XBL components Form Runner Form Builder
English F F F F F
French F F F F F
Swedish F F F F F
Portuguese F F F 1 F1 F1
Italian F F F 1 F1 F1
German F F F 1 F1 F1
Spanish F F F 1 P P
Finnish F F P F1 F1
Dutch F F F 1 F1 N
Norwegian F F P P P
Russian F F P P P
Polish N F N N N
  1. A few resources are missing.

As of Orbeon Forms 4.9

Language Calendar Numberer XBL components Form Runner Form Builder
English F F F F F
French F F F F F
Swedish F F F F F
Portuguese F F F F1 F1
Italian F F F F1 F1
German F F F F1 F1
Spanish F F F P P
Finnish F F P F1 F1
Dutch F F F F N
Norwegian F F P P P
Russian F F P P P
Polish N F N N N
  1. A few resources are missing.

As of Orbeon Forms 4.6.2, 4.7 and 4.8

Language Calendar Numberer XBL components Form Runner Form Builder
English F F F F F
French F F F F F
Portuguese F F F F1 F1
Italian F F F F1 F1
German F F F F1 F1
Swedish F F F F1 F1
Spanish F F F P P
Finnish F F P F1 F1
Dutch F F F F N
Norwegian F F P P P
Russian F F P P P
Polish N F N N N
  1. In 4.8, a few resources related to the new "singleton form" feature are missing.

NOTE: In 4.6.0, Spanish, Italian and German have a few missing localized resources. In 4.6.2 PE, Italian and German resources are complete again. We hope to have Spanish resources fully updated for 4.9. Please let us know if you would like to help!

As of Orbeon Forms 4.5

Language Calendar Numberer XBL components Form Runner Form Builder
English F F F F F
French F F F F F
Spanish F F F F F
Swedish F F F F N
Italian F F F P P
German F F F P P
Finnish F F P P P
Norwegian F F P P P
Russian F F P P P
Polish N F N N N

As of Orbeon Forms 4.3

Language Calendar Numberer XBL components Form Runner Form Builder
English F F F F F
French F F F F F
Italian F F F F F
German F F F F F
Spanish F F P P P
Finnish F F P P P
Norwegian F F P P P
Russian F F P P P

As of Orbeon Forms 4.2

Language Calendar Numberer XBL components Form Runner Form Builder
English F F F F F
French F F F F F
Spanish F F P P P
Norwegian F F P P P
Russian F F P P P

Known limitations

Form Builder (Orbeon Forms PE only) lets you create forms in multiple languages. Most world languages are available, with some limitations described below.

  1. PDF output: There are some known issues with ligatures in some Indian languages such as Hindi or Tamil.
  2. Right-to-left languages are not officially supported.

We are glad to get help to address these two limitations.

See also

results matching ""

    No results matching ""