Multi-Language Forms 

Use

You want forms to be displayed in the language of the logged on user. The system supports language-dependent resource files for this purpose.

 

Features

The descriptions below only applies to language-dependent texts in the forms themselves. It does not apply to entered content.

Default Resource File

When you generate a project, the system creates the following default resource file:

<Preferences location>/<project name>/<project name>.xml

This resource file contains the text that you enter in the Caption property of label controls and other controls.

For example, the system has generated the following default resource file for the Demo News project:

/etc/xmlforms/SAP_DemoNews/SAP_DemoNews.xml

The system uses the default resource file if no language-dependent resource file is available in the language of the logged on user.

 

Language-Dependent Resource Files

You can use the default resource files as a template for language-dependent resource files. Note the following naming conventions for language-dependent resource files:

<Preferences location>/<project name>/<project name>_<language key>.xml

For example, an item file for Italian could have the following ID:

/etc/xmlforms/SAP_DemoNews/SAP_DemoNews_it.xml

You have to create the language-dependent resource files manually (see Activities).

 

Updating Language-Dependent Resource Files

If you have created and translated language-dependent resource files and then change the forms in the XML Forms Builder (for example, by creating new label controls), you will need to update the language-dependent resource files.

You can make a setting in the XML Forms Builder so that the system updates the language-dependent resource files when you generate the project (Options ® Project ® Update Language-Dependent Resource Files).

·        If you activate this option, the system regenerates existing language-dependent resource files.

Texts whose keys were already available in the resource file remain unchanged – your translations are not lost.

New texts are written to the language-dependent resource files in the original language.

You can translate the new texts in the language-dependent resource files after generating the project.

 

·        If you deactivate this option, the system only regenerates the default resource file, and leaves any language-dependent resource files unchanged.

If you have created new controls in the XML Forms Builder, users logged on in languages other than the default language are not able to see the new texts – not even in the original language.

 

Activities

Proceed as follows to create language-dependent resource files for a project:

...

       1.      In the top-level navigation area, choose Content Administration ® KM Content.

       2.      Navigate to the project folder.

For example: /etc/xmlforms/MyProject

       3.      Create a copy of the file <project name>.xml in this folder for each required language. Use the naming conventions described above.

       4.      Open the project-specific resource files and translate the text within the text tags.

Example:

<TEXT AKEY="lbl_1016189257907" LENGTH="0" TYPE="XFLD">Create or Edit a News Item</TEXT>

In this line you would only translate the text "Create or Edit a News Item".