Localization Value Import and Export

Intershop Commerce Management can import and export localization values from and to XLIFF files, as well as export localization values to properties files.

Uploading Localization Values for Import

Before files can be used for import, they have to be uploaded. To upload a file for import:
  1. Select the channel from the context selection box, then select Localization | Import & Export.
    This displays the Import & Export overview page.
  2. In the Import & Export Files row, click Upload.
    A list of files that have already been uploaded is displayed.
  3. In the Upload File field, specify the file path or click Choose File to locate the file.
  4. Click Upload to upload the file.
    The uploaded file is displayed in the list. It can now be imported.
Tip:
In order to save system resources, Intershop recommends to delete the uploaded import files after the import process has been completed.

Downloading Localization Value Export Files

Once files have been exported, they can be downloaded from the system. To download a file that has been exported:
  1. Select the channel from the context selection box, then select Localization | Import & Export.
    This displays the Import & Export overview page.
  2. In the Import & Export Files row, click Download.
    A list of files that have been exported is displayed.
  3. Click a file name to save the corresponding file.
    This displays the browser's download dialog, prompting you to save the file.
Tip:
After you have downloaded and saved export files, Intershop recommends to delete the export files in order to save system resources.

Exporting Localization Values (XLIFF)

To export localization values of the current channel into XLIFF:
  1. Select the channel from the context selection box, then select Localization | Import & Export.
    This displays the Import & Export overview page.
  2. In the Text Localization (XLIFF) row, click Export.
    The Select Application page is displayed.
  3. Select the application of which you intend to export the localization values, then click Next.
    The Select Locales page is displayed.
  4. Select the source language and the target locale(s), then click Next.
    For the target locale, mark the corresponding checkbox and specify, if required, a locale alias. The source language specifies the source language setting for the XLIFF file ("file" attribute "source-language" and "source" attribute "xml:lang").
  5. Configure the intended XLIFF settings.
    The following table lists the available parameters.
    Table 1. XLIFF export configuration
    Parameter Description
    Generate an export file for each locale If selected, generates an individual export file for each selected target locale.
    Export only untranslated items If selected, restricts the export to the "empty" texts.
    Export item descriptions If selected, includes the localization value descriptions (if available) in the export.
    Export Filename Specifies the file name of the export file (mandatory). Make sure to append the appropriate XLIFF file name extension supported by your CAT environment. Possible extensions can be xlf, xliff or xml.
    Character Set Specifies the character encoding for exported XLIFF file (default UTF-8).
    XLIFF version Specifies the XLIFF version (1.0|1.1|1.2). Make sure to select the appropriate value supported by your CAT environment.
    Export data type Specifies the value for the XLIFF "trans-unit" attribute "data type" (default html).
    Export approved Specifies the value for the XLIFF "trans-unit" attribute "approved" (default yes).
    Note From Specifies the value for the XLIFF "note" attribute "from" (optional).
    Target State Specifies the value for the XLIFF "target" attribute "state".
  6. Click Export.
    The export process is started immediately. The Import & Export Status is displayed on the overview page.
Note:
In order to support common translation environments, Intershop Commerce Management exports "generic XLIFF" as produced by XLIFF conversion tools like, for example, Okapi Rainbow. This means, the <target> element to be translated is "prefilled" with the <source> element's value.

Importing Localization Values

To import localization values in the current channel:
  1. Select the channel from the context selection box, then select Localization | Import & Export.
    This displays the Import & Export overview page.
  2. In the Text Localization (XLIFF) row, click Import.
    A list of files that can be imported is displayed.
  3. Select file to import, then click Next.
    The import file is now validated. When successful, the number of locales and text entries is displayed. In case of errors, error messages are generated. Click Next to continue.
  4. Select the target application and the import mode.
    The available import modes include INSERT | UPDATE | REPLACE | DELETE.
    Table 2. Localization value import modes
    Mode Description
    INSERT Inserts new entries.
    UPDATE Inserts new entries and updates existing entries.
    REPLACE Replaces existing entries.
    DELETE Deletes existing entries.
  5. Select the locales to be imported and specify the Intershop Commerce Management target locale.
  6. Click Import.
    The import process is started immediately. The Import & Export Status is displayed on the overview page.

Exporting Localization Values (.properties)

To export localization values of the current channel into *.properties (packed into a ZIP file):

  1. Select the channel from the context selection box, then select Localization | Import & Export.
    This displays the Import & Export overview page.
  2. In the Text Localization (.properties) row, click Export.
    The Select Application page is displayed.
  3. Select the application of which you intend to export the localization values, then click Next.
    The Select Locales page is displayed.
  4. Select the target locale(s), then click Next.
    Mark the corresponding checkbox.
  5. Configure the intended *.properties file details.
    The following table lists the available parameters.
    Table 3. Localization *.properties export configuration
    Parameter Description
    Export Filename Specifies the file name of the export file (mandatory). Make sure to append the appropriate file name extension supported by your CAT environment. The usual extension is properties.
    Generate an export file for each locale If selected, generates an individual export file for each selected target locale.
    Export only translated items, skip untranslated If selected, restricts the export to the already translated texts.
  6. Click Export.
    The export process is started immediately. The Import & Export Status is displayed on the overview page.