Translating Strings Using XML

Use the Export option in Application Administrator to first create an XML file that contains the default English strings. You can then import this file after strings are translated.

Important: Do not modify the structure of the XML file or the values for each category and section. Instead, provide translations as overrides.
Each string is composed of the following elements in the XML:
  • Key

    Container for each string, including values and tags for all locales.

  • Name

    The key name for each string.

  • Locale

    The locale for each key value.

  • Key Value

    If no override is applied, the text that is shown to users for the specified locale.

  • Override

    A way to customize a string and maintain the provided value. Overrides, if provided, are always shown to users.

  • Tag

    Customizable label for each key value.

The following example shows the XML for a key that has an override for the English value, a translated key value, and an override and tag for that translation.

<Key>
        <Name>Approvals</Name>
        <KeyValue>
          <Locale>en_US</Locale>
          <Value>Approvals</Value>
          <Override>Votes</Override>
        </KeyValue>
        <KeyValue>
          <Locale>fr</Locale>
          <Value>Approbations</Value>
          <Override>Agréments</Override>
        </KeyValue>
        <Tag>First Translation</Tag>
      </Key>

To translate strings using XML:

  1. In Application Administrator, click the Localization icon on the Administrator Portal.
  2. Select the Export tab.
  3. Select the category of strings to export.
  4. Select the locale you want to export.
  5. Click Export and save the file.
  6. Open the file of exported strings in an XML or text editor.
  7. Use search and replace to change the <Locale> value for each key.
  8. Add your translation to the override tag for each string.
    Important: For on-demand customers, you must use the <Override> element to override or translate an existing key. You cannot import new keys, and if you attempt an import and you specify a new value for a key, it will be ignored.
  9. In Application Administrator, select the Import tab, and then import the file.