Step 3: Seed and Export Text to a Translation File

Previous
Previous
Next
Next

The second step is to seed the translation table and then export the translation text to a translation file.

Topics:

Seeding Translatable Text

To translate an application, you must seed the translation. Seeding the translation copies all translatable text into the Translation Text repository. After you have seeded the application and specified the language in the Translation Text repository, you can then generate and export an XLIFF file for translation.

The seeding process keeps your primary language application synchronized with the Translation Text repository. You should run the seed process any time your primary language application changes.

To seed translatable text:

  1. Navigate to the Translate Application page. See "Step 1: Navigate to the Translate Application Page".

  2. On the Translate Application page, select Seed and export the translation text of your application into a translation file.

  3. From Language Mapping, select the appropriate primary and target application ID map.

  4. Click Seed Translatable Text.

    The XLIFF Export page appears.


    Note:

    XML Localization Interchange File Format (XLIFF) is an XML-based format for exchanging localization data. For information about the XLIFF or to view the XLIFF specification, see:
    http://www.xliff.org
    
    

Exporting Text to a Translation File

After you have seeded translatable text, a status box displays at the top of the XLIFF Export page indicating the total number of attributes that may require translation, including the number of:

You can use this information to determine if you need to export translatable text for an entire application or just a specific page.

The XLIFF Export page is divided into two sections. Use the upper section of the page to export translatable text for an entire application (that is, all pages, lists of values, messages, and so on). Use the lower section to export translatable text for a specific page.

To export translatable text for an entire application:

  1. Seed the translatable text. See "Seeding Translatable Text".

  2. Under Step 2, Export XLIFF:

    1. From Application, select the appropriate primary and target application ID map.

    2. Specify whether or not to include XLIFF target elements.

    3. Under Export, specify what translation text is included in your XLIFF file.

    4. Click Export XLIFF for Application.

  3. Follow the on-screen instructions.

To export translatable text for a specific page:

  1. Seed the translatable text as described in "Seeding Translatable Text".

  2. Under Export XLIFF for specific Page:

    1. From Application, select the appropriate primary and target application ID map.

    2. Specify whether or not to include XLIFF target elements.

    3. Under Export, specify what translation text is included in your XLIFF file.

    4. Click Export XLIFF for Page.

  3. Follow the on-screen instructions.

About Include XLIFF Target Elements

When Oracle Application Express generates an XLIFF document, each document contains multiple translation units. Each translation unit consists of a source element and a target element. The XLIFF document can be generated with both the source and target elements for each translation unit. You have the option of generating a file containing only source elements. The updated translations will be applied from the target elements of the translation units.

About Export

Use the options under Export to specify what translation text is included in your XLIFF file. Select All translatable elements to include all translation text for an application. In contrast, select Only those elements requiring translation to include only new elements that have not yet been translated. Only those elements requiring translation produces an XLIFF file containing new or modified translation units. Also, if translation units were intentionally not previously translated (that is, the source of the translation element equals the target of the translation element), those translation units will also be included in the file.