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
ExportCompressedTranslationsXml Export all translations to an XML file, which is compressed into a zipped format.
ExportTranslationsXml Export all translations to an XML file.
ImportCompressedTranslationsXmlWithProgress Import all translations from a zipped XML file with progress logging.
ImportTranslationsXmlWithProgress Import all translations from an XML file with progress logging.
RetrieveAvailableLanguages Retrieves the list of available languages.
RetrieveDeprovisionedLanguages Retrieves the list of language packs installed on the server that have been disabled.
RetrieveInstalledLanguagePacks Retrieves the list of language packs installed on the server.
RetrieveLocLabels Retrieves the localized labels for the specified attribute.
RetrieveProvisionedLanguages Retrieves the list of language packs installed on the server that have been enabled.
SetLocLabels Sets 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\&DisplayLang=e.

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.