自定义标签以支持多种语言

 

发布日期： 2017年1月

适用于： Dynamics 365 (online),Dynamics 365 (on-premises),Dynamics CRM 2016,Dynamics CRM Online

当您在 Microsoft Dynamics 365 中创建自定义项时，可以使用标签支持多种语言。

本主题内容

使用标签

使用标签的消息

基本语言中的自定义标签

翻译自定义实体和属性文本

管理组织的语言

使用标签

标签是在客户端应用程序中向用户显示的本地化字符串。 通过使用支持语言包的 Label 类，可将其实现。 可采用多种语言存储向用户显示的字符串（例如实体显示名称或选项集中的选项）。 用户可以选择要在 Microsoft Dynamics 365 的窗体和视图中显示的语言。

下表列出了使用Label 类的所有元数据。

元数据属性	说明
AttributeMetadata。Description	属性的说明。
AttributeMetadata。DisplayName	属性的显示名称。
EntityMetadata。Description	属性的说明。
EntityMetadata。DisplayCollectionName	实体的复数显示名称。
EntityMetadata。DisplayName	实体的显示名称。
Label	用于实体关系中实体的标签。
OptionMetadata。Label	用于选择列表中的选项，状态或状态属性的标签。

Label 类可为每种已安装的语言存储一个字符串。 此数组为 LocalizedLabels 属性。 为基本语言存储的标签必须始终存在。 其他语言的标签可以为 null。 如果用户想要以某种语言显示用户界面，但标签不包含该语言的字符串，将使用基本语言的标签。

您可以使用 UserLocalizedLabel 属性检索用户选择的语言的标签。

使用标签的消息

以下列表列出了可与本地化标签一起使用来支持多种语言的消息。 导入翻译时，您可以使用导入解决方案时的方法来根据导入作业生成报告。 有关详细信息，请参阅安装或升级解决方案。

消息	说明
ExportTranslationRequest	将特定解决方案的所有翻译导出到压缩文件。
ImportTranslationRequest	导入压缩文件中的所有翻译。
RetrieveFormattedImportJobResultsRequest	将 ImportJob 的结果检索为旨在使用 Microsoft Office Excel 打开的 XML 文档。
RetrieveLocLabelsRequest	检索指定属性的本地化标签。
SetLocLabelsRequest	设置指定属性的本地化标签。

基本语言中的自定义标签

自定义工具提供了编辑实体显示名称的方法，您可以通过编程自定义这些属性。 还可以编辑实体消息。 但不是每条消息都是公开的。 找到并自定义应用程序中所使用文本的另一种方法是导出翻译，编辑基本语言的值并再次导入翻译。 尽管这并不是此项功能的预期用途，但仍是用来标识和自定义应用程序中所使用文本的受支持方法。 有关详细信息，请参阅修改实体的消息。

翻译自定义实体和属性文本

因为只可以通过使用基本语言在应用程序中执行自定义项，所以当要为这些自定义项提供本地化标签时，必须导出标签的文本，以便可以将标签翻译成为组织启用的任何其他语言。

导出自定义文本进行翻译

可以在 Web 应用程序中或使用 ExportTranslationRequest 消息导出翻译。

导出的文本会保存为包含 CrmTranslations.xml 的压缩文件，该压缩文件可使用 Microsoft Office Excel 打开。 可将此文件发送给语言专家、翻译机构或本地化公司。

有关详细信息，请参阅 Office 2003 XML 参考架构。

导入翻译后的文本

在导出自定义实体或属性文本并翻译后，您可以使用 ImportTranslationRequest 消息在 Web 应用程序中导入翻译完的文本字符串。 导入的文件必须是包含 CrmTranslations.xml 和 [Content_Types].xml 文件的压缩文件，与导出时相同。

导入已完成的翻译后，会向使用自定义文本目标翻译语言的用户显示该文本。

备注

Microsoft Dynamics 365 无法导入长度超过 500 个字符的已翻译文本。 如果翻译文件中的任何一项的长度超过 500 个字符，则导入过程将失败。 如果导入过程失败，请检查文件中导致失败的行并减少该行的字符数，然后重新尝试导入。

因为只支持使用基本语言进行自定义，所以您只能在基本语言设置为语言首选项的 Microsoft Dynamics 365 中进行自定义。 若要验证已翻译的文本是否已显示，必须更改 Microsoft Dynamics 365 用户界面的语言首选项。 若要执行其他自定义工作，必须将语言首选项重新更改为基本语言。

管理组织的语言

Microsoft Dynamics 365（在线或本地） 使您可以在服务器上安装多个语言包，并且允许用户选择要使用的语言包。 有关如何安装语言包的详细信息，请参阅 安装指南，TechNet：安装并启用语言包。 本节包含用于管理您的组织所安装语言的相关消息的信息。

下表列出了可用于语言包的消息。 这些消息可与 Execute 方法一起使用。

消息	说明
DeprovisionLanguageRequest	包含取消设置语言所需要的数据
ProvisionLanguageRequest	包含设置新语言所需要的数据。
RetrieveAvailableLanguagesRequest	检索可用语言列表。
RetrieveDeprovisionedLanguagesRequest	检索服务器上安装的已禁用语言包的列表。
RetrieveInstalledLanguagePacksRequest	包含检索服务器上安装的语言包列表所需要的数据。
RetrieveInstalledLanguagePackVersionRequest	包含检索已安装的语言包版本所需要的数据。
RetrieveProvisionedLanguagesRequest	检索服务器上安装的已启用语言包的列表。
RetrieveProvisionedLanguagePackVersionRequest	检索安装在服务器上的语言包的版本。

另请参阅

使用含有 Dynamics 365 元数据的组织服务
自定义 Microsoft Dynamics 365 应用程序
修改实体的消息

Microsoft Dynamics 365

© 2017 Microsoft。 保留所有权利。 版权