Support for Multiple Languages
[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.
|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
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 www.microsoft.com/downloads/details.aspx?FamilyID=fe118952-3547-420a-a412-00a2662442d9\&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.
- Using the Labels in the Metadata Web Service
- Collision Rules for Import and Export
- Customizing Entities
- Messages for Import, Export and Publish