Including a manifest of translated text

Use the translated text files element (<translatedTextFiles>) to define the message manifest for a workflow. The message manifest contains one or more bundle definitions, each of which contains one or more language file definitions. A bundle is a logical grouping for a set of text elements used in the workflow.

To refer to these files, other text elements in the workflow definition can specify a bundle name and an identifier (or key) within the language files that contain the replacement text for that language. The Workflows task maps the bundle name and language into the file defined for that language and displays the text in the language that is in effect for the browser, if a language file is provided.

The Workflows task uses only the browser language to locate the translation file; the country is ignored. For example, en-US and en-UK are two versions of English: American, and British, respectively. The Workflows task uses only the value "en" to locate the language file.

The following example shows a message manifest:

<translatedTextFiles>
      <bundle name="StepMessages">
            <language name="en" path="steps/english.txt"/>
            <language name="fr" path="steps/french.txt"/>
      </bundle>
      <bundle name="VariableLabels">
            <language name="en" path="vars/english.txt"/>
            <language name="fr" path="vars/french.txt"/>
      </bundle>
</translatedTextFiles>

For an example of referencing a bundle in a translatable element, see the sample file workflow_sample_translation.xml, which is supplied with z/OSMF in the /samples subdirectory of the product file system.

Table 6 describes the elements that make up the message manifest.