This documentation is archived and is not being maintained.

Support for Multiple Languages

banner art

[Applies to: Microsoft Dynamics CRM 4.0]

Find the latest SDK documentation: CRM 2015 SDK

Microsoft Dynamics CRM 4.0 enables you to install multiple language packs on a server and for the user to select a language pack. To install a language pack, you must use the installer for that language. For information about how to install language packs, see the Microsoft Dynamics CRM Installation Guide. This section contains information about the multilanguage support available in the SDK.

The following table lists the messages that you use to work with language packs. Use these messages with the Execute method.

Message Description
ExportCompressedTranslationsXmlExport all translations to an XML file, which is compressed into a zipped format.
ExportTranslationsXmlExport all translations to an XML file.
ImportCompressedTranslationsXmlWithProgressImport all translations from a zipped XML file with progress logging.
ImportTranslationsXmlWithProgressImport all translations from an XML file with progress logging.
RetrieveAvailableLanguagesRetrieves the list of available languages.
RetrieveDeprovisionedLanguagesRetrieves the list of language packs installed on the server that have been disabled.
RetrieveInstalledLanguagePacksRetrieves the list of language packs installed on the server.
RetrieveLocLabelsRetrieves the localized labels for the specified attribute.
RetrieveProvisionedLanguagesRetrieves the list of language packs installed on the server that have been enabled.
SetLocLabelsSets the localized labels for the specified attribute.

Translating Customized Entity and Attribute Text

If you have customized entity or attribute text, such as field labels or drop-down list values, you can give the users in your organization this customized text in languages other than the base language of your Microsoft Dynamics CRM implementation. You can export the text strings for all the customizations so that they can be translated into the languages you use in your organization.

Note    You can only perform customizations in the base language.

Exporting Customized Text for Translation

You can export the translations in the Web application or by using the ExportCompressedTranslationsXml message or the ExportTranslationsXml message.

Exported text is saved as a compressed or uncompressed XML file that is a Microsoft Office Excel workbook. You can send this file to a linguistic expert, translation agency, or localization firm.

For more information about the XML schema for the CrmTranslations.xml file, download the Office 2003 XML Reference Schemas at

Importing Translated Text

After you have exported customized entity or attribute text and had it translated, you can import the translated text strings in the Web application or by using the ImportCompressedTranslationsXmlWithProgress message or the ImportTranslationsXmlWithProgress message.

After you have imported the completed translations, customized text appears for users who work in the languages that you had the text translated into.

Note    Microsoft Dynamics CRM cannot import translated text that is over 500 characters long. If any of the items in your translation file are longer than 500 characters, the import process will fail. If the import process fails, review the line in the file that caused the failure, reduce the number of characters, and try to import again.

Because customization is supported only in the base language, you may be working in Microsoft Dynamics CRM with the base language set as your language preference. To verify that the translated text is appearing, you must change your language preference for the Microsoft Dynamics CRM user interface. To perform additional customization work, you must change back to the base language.

See Also


Other Resources

© 2010 Microsoft Corporation. All rights reserved.