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 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 and Country-Specific Resource Files

You can use the default resource files as templates for language-dependent and country-specific resource files. Use the following naming conventions:

<preferences_location>/<project_name>/<project_name>__<language_key>.xml

<preferences_location>/<project_name>/<project_name>__<language_key>__<country_code>.xml

Examples:

Resource file for Italian:

/etc/xmlforms/SAP_DemoNews/SAP_DemoNews__it.xml

 

Resource files for English (United States) and English (United Kingdom):

etc/xmlforms/SAP_DemoNews/SAP_DemoNews__en__us.xml

etc/xmlforms/SAP_DemoNews/SAP_DemoNews__en__gb.xml

 

Updating Language-Dependent Resource Files

If you 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 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 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.      Choose Content Administration ® KM Content from the top-level navigation bar.

       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".

If the translation is not visible in the forms, you should delete some of the caches:

Choose System Administration ® Monitoring ® Knowledge Management ® Cache Monitor.

Delete the following caches:

■       ca_pipeline

■       ca_xmlforms_renderlistitems

■       ca_xmlforms_showforms