22.4.3 Creating a Text Message-Based Translation

Learn how to create a Text Message-Based application translation.

Tip:

If you make any changes to the primary application, such as refreshing the theme, modifying the page title, adding a new page item or modifying an existing one, you will need run the Convert To Text Wiazrd again to capture any new translatable text as text messages.

Related Topics

Parent topic: Understanding the Translation Process

22.4.3.1 Step 1: Enable Application Translation

Configure Globalization attributes and enable the Application Translation switch.

Follow the procedure described in Before You Begin: Configure Globalization Attributes. For Translate Method, select Text Message-Based.

Parent topic: Creating a Text Message-Based Translation

22.4.3.2 Step 2: Convert to Text Messages

Convert all translatable text in the application to text messages using the Convert to Text Wizard.

The Convert Text Messages process converts and updates text throughout your application into Text Messages, enabling streamlined updates across the app and simplifying translations through XLIFF or CSV export/import. You can develop your application in your primary language, use this process to regularly sync text messages.

Any exceptions found are stored at the session level. After logging out and and back in, run Convert to Text Messages again in order to see the exceptions.

Note:

The Convert to Text Messages process does not convert template directives, numeric text, component text marked as not translated, or subscribed text objects.

To convert all translatable text using Convert to Text Wizard:

  1. Navigate to the Translate Application page:
    1. On the Workspace home page, click the App Builder icon.
    2. Select an application.
    3. Click Shared Components.
    4. Under Globalization, click Application Translations.

      The Translate page appears.

  2. Click Convert Text Messages.

    The Convert to Text Messages Wizard appears.

    Any exceptions found are stored at the session level. After logging out and and back in Convert to Text Messages must be run again in order to see the exceptions. Note: This

    Note:

    The Convert to Text Messages Wizard will not convert template directives, numeric text, component text marked as not translated, or subscribed text objects.
  3. Click Convert Text Messages again.

    The Convert to Text Messages Wizard confirmation page appears.

  4. Click Close to exit the wizard.

Parent topic: Creating a Text Message-Based Translation

22.4.3.3 Step 3: Define Application Languages

Choose a translation language.

Once a language is added, the text messages from the primary language are synchronized to the target translation language.

To choose a translation language:

  1. Navigate to the Translate Application page:
    1. On the Workspace home page, click the App Builder icon.
    2. Select an application.
    3. Click Shared Components.
    4. Under Globalization, click Application Translations.

      The Translate page appears.

  2. To add a language:
    1. Click Add Language.

      Adding a language will synchronize text messages from the application primary language to the language selected.

    2. Language - Select a language.
    3. Click Add Languages.
  3. In the Application Languages region, click Add Languages.

    The Language Mappings page appears.

  4. Click Create.
  5. On Create/Edit Language Application Mapping:
    • Translation Application - Enter a unique integer value that identifies an application. The application ID must be unique on your instance of Oracle APEX.
    • Language - Select the language to be translated.
    • Document Direction - Set document direction. Options: Left-To-Right or Right-To-Left.
    • Image Directory - Enter the directory where images are obtained. Unless you are using static files from the images directory which are translated, leave this field blank. This is the default and most common option.
  6. Click Create.

Parent topic: Creating a Text Message-Based Translation

22.4.3.4 Step 3: Translate Text Messages

Export text messages into a translation file in a chosen language or all defined languages.

To export text messages into a translation file in a chosen language:

  1. Navigate to the Translate Application page:
    1. On the Workspace home page, click the App Builder icon.
    2. Select an application.
    3. Click Shared Components.
    4. Under Globalization, click Application Translations.

      The Translate page appears.

  2. On the Translate page, click Export Text Messages.
    (Optional) <Enter additional information about the step.>
  3. On Export Text Messages:
    1. Language - Choose the language to download text messages for. Choosing All - Zipped file downloads a ZIP archive containing text messages for all languages.
    2. Format – Chose the format for the export file (XLIFF or CSV).
    3. Click Export.

Parent topic: Creating a Text Message-Based Translation

22.4.3.5 Step 5: Upload Translation File

Learn how to upload a translated file.

To upload a translated document, XLIFF, CSV or ZIP:

  1. Navigate to the Translate Application page:
    1. On the Workspace home page, click the App Builder icon.
    2. Select an application.
    3. Click Shared Components.
    4. Under Globalization, click Application Translations.

      The Translate page appears.

  2. Click Import Text Messages.

    The Import Text Messages page appears.

  3. 3. On the Upload page:
    1. Locate the file to be uploaded.
    2. Click Import.

    Text Messages from the document are updated.

Parent topic: Creating a Text Message-Based Translation