Manage site languages

 

Updated: November 1, 2016

Applies To: Dynamics Marketing

System_CAPS_importantImportant

Microsoft Dynamics Marketing is scheduled to be retired on May 15, 2018. After that date the service will no longer be available. Please plan accordingly. For details, see the blog post Microsoft Dynamics Marketing service will be discontinued, and learn what’s coming next.

Most of the text shown in the Microsoft Dynamics Marketing user interface is both customizable and translatable, with standard texts available for many major languages. New Dynamics Marketing instances are normally provided with the major language for your country/region or English installed by default, and you can download, install and enable additional languages as needed. If you need to support a language that is not yet available, you can export and translate an existing language file and then import the results.

This topic describes how to enable or disable installed languages, and how to download and install new language files. For details about how to customize individual labels for an existing and enabled language, see Customize user interface text.

System_CAPS_noteNote

For best site performance, you should only install and enable those languages that you actually use.

You must be an administrator to access the language settings. More information: Work with user accounts and staff contacts

All translatable texts shown in the Dynamics Marketing user interface (UI) are stored in layers of text resources that are separate from the site functionality. Users can therefore choose to view the site in any language for which a resource layer is available and still experience the same functionality as users working in other languages. Admins can also add, remove, enable, disable and customize each language by working with these resource layers through the UI itself. Each language has the following two layers:

  • Base language layer: contains the standard (default) texts for all of the features of the UI. This layer remains the same even if you customize a language using the Dynamics Marketing language settings.

  • Customization layer: contains overrides to the standard (base) texts. In a new installation the customization layer is mostly empty, but it does contain a few demo category values that you can decide to enable. As you work to customize your site labels and add new category values, this layer will grow.

You can download or upload either layer of any language as a human-readable XML file, which contains a header that identifies the language and culture to which the file applies, and also identifies the type of layer it is (base or customization). Each of these layers includes both labels (standard UI texts) and categories (which define folders and drop-down list values; More information: Create custom drop-down values and folders). You can import and export base and customization files for each language individually.

In Dynamics Marketing, the admin can choose the site language, which is assigned to all new users by default (More information: Configure site settings), and each user can choose their own preferred language as part of their personal preferences (More information: Configure your preferences).

To work with languages, go to Settings > Administration > Languages. This brings you to the Languages list page, which lists each language pack that is currently installed and provides many of the standard controls for searching, sorting, filtering, and viewing items in the list, plus other common features. For details about how to use these common controls, see Learn how to work and get around in Microsoft Dynamics Marketing.

The Active column on the Languages list page shows a check for each installed language that is also enabled. Active languages are available for admins to select as the default site language and also for individual users to select as their personal language. As with most areas of Dynamics Marketing, inactive languages are only shown when you choose to view inactive records using the Show/hide inactive toolbar button Show All/Active Only button/Hide Inactive/Deleted button.

To activate or inactivate an installed language, click on the relevant language name to open its maintenance page and then set the Active check box as needed. (This is also where you can customize any label and add, remove, and rename user-defined fields. More information: Customize user interface text, Configure user defined fields)

Base language files for many major languages are available in a language pack that you can get from the Microsoft download site. There are two reasons why you might download and apply a base language:

  • Add support for a new language on your site
    For best site performance, you should only install and enable those languages that your users actually need. Therefore, new Dynamics Marketing instances are normally provided with only the major language for your region or English installed. To add more languages, download the language pack and import each required language.

  • Add new labels for an existing language after a Dynamics Marketing update
    Most Dynamics Marketing updates introduce new features that include new UI controls and associated text labels, but these new texts won't appear on your site until you update the base language file to the latest version available. Because the base language and customizations are stored in two different files, you can update the base language and get all new texts without losing your customizations.

To download and unpack all the standard new and updated base language files available forDynamics Marketing:

  1. Download the language pack installer from the Microsoft Download site.

  2. Run the installer program.

  3. The installer program saves the language pack files here:
    C:\Program Files (x86)\Microsoft Dynamics Marketing\LanguagePack\

    The language pack folder contains a subfolder named for each language included in the package. Each of these folders contains an XML file with the base language data. See the following section for information about how to import one or more of these language files.

You will usually get a new language file by downloading the language pack from Microsoft (as described in the previous section), but you might also get a custom-translated or vertical-market file from a supplier. You import base-language files and customization files separately (the file type (base or custom), language, and other details are specified as part of the XML format of each file).

  1. Go to Settings > Administration > Languages

  2. Click the Import button Upload button.

  3. The Import user interface text dialog opens. Do the following:

    • If you're importing an update to an existing base language, select the Allow the standard user interface text to be overwritten check box. If you attempt to import a language that already exists without selecting this check box, your import will be rejected. If you're importing a customization file, you will always overwrite your customizations (but not the base language), so this check box has no effect.

    • Click the Choose File button to locate and select your language resource file.

    • Click Import to start the import.

  4. Your new language is automatically activated after a successful import.

System_CAPS_noteNote

You can't import individual text values that are more than 750 characters long. If any of the items in your import file are longer than this, the import process will fail. If this happens, review the line in the file that caused the failure, reduce the number of characters, and try to import again.

You can export both base and customization language files. You might do this if you need to translate your site into a language that's not included in the standard language pack, or to support specialist vocabulary for vertical markets. For example, to translate to a new language, you might export an existing base language file, send the file to an agency for translation, and then import the result.

To export a base-language or customization file:

  1. Go to Settings > Administration > Languages

  2. Select the check box for the language you want to export (you can only export one at a time).

  3. Click the Export button Download button.

  4. The Export user interface text dialog opens. Choose one of the following:

    • All standard text: exports the base file for the language you selected.

    •  Only changes: exports the customization file for the language you selected.

  5. Click Export to save the file.

If needed, you can remove all of the customizations that you have made to a given language. This deletes the customization file for that language, but leaves the base file in place, which means that the standard text will be shown for all labels and categories, and that all drop-down lists will revert to their standard set of options and labels.

To remove all customizations for a language:

  1. Go to Settings > Administration > Languages

  2. Select the check box for each language you want to revert (you can revert several at once).

  3. Click the Reset all customizations button Reply button.

  4. A warning dialog box is shown. Click OK to confirm the operation.

Show: