Install a translation file for the XC Business Tools

Abstract

How to install a language translation file for the Commerce Business tools that lets you display the business tools in a language other than English.

Sitecore XC Business Tools lets users select which language to display the graphical user interface (GUI) in. By default, the XC Business Tools GUI displays in English. To display the XC Business Tools in other languages, you must import the translation files into Sitecore.

Note

With each release, Sitecore provides XC Business Tools translation files (in XML format) for Danish, German, and Japanese. You can download these translation files from the Sitecore Download site. For any other language support, you must provide your own translation file.

The following procedure assumes that you have already saved the language file on your web server.

To install a Business Tools translation file into Sitecore:

  1. Store the language file you want to import in the following location C:\inetpub\wwwroot\<YourSitecoreServer>. This is where the file must be stored so that you can access it in subsequent steps.

  2. On the Sitecore Launchpad, click Control Panel and in the Localization section, click Import languages.

  3. In the Import Languages dialog box, click Browse. The Open Language File dialog box opens.

  4. Click Browse, select the language file to import (for example, da-DK.xml ), and then click Open.

    XC_Dev_Ops_Open_Language_File.png

    Note

    If you cannot find the required language file in the Open Language File dialog box, make sure that it is stored in C:\inetpub\wwwroot\<YourSitecoreServer>.

  5. In the Import Languages dialog box, click Next, and click Next again to confirm the language to import.

  6. In the Database drop-down list, click Core, and then click Import. A dialog box notifies you when the import operation is complete.

    Note

    Items in the translation file with the database set to "master" override the database selection you make in the Import Language dialog box.

  7. To verify that the translation file is available in Sitecore, on Sitecore Launchpad, click Content Editor, go to Sitecore/Commerce/Commerce Control Panel/Commerce Engine Settings/Commerce Terms/Systems Messages, and click any system message item.

  8. On the ribbon, on the Versions tab, in the Language group, click the language you imported. In the Content area, in the Value field, you can see the translated string, as shown in the following example:

    DevOps_Language_Versions.png
  9. Open Internet Information Manager (IIS) and restart the IIS service.

  10. To make the new language available from the XC Business Tools interface, flush the Redis cache . Open Windows Powershell, and execute the following command: C:\Program Files\Redis&gt; .\redis-cli.exe flushall.

Now, when you launch Sitecore XC Business Tools and select the language you want to display the GUI in, the interface displays the selected language.