共用方式為

當地語系化產品屬性值

  • 發行項

 

發行︰ 2017年1月

適用於： Dynamics 365 (online)、Dynamics 365 (on-premises)、Dynamics CRM 2016、Dynamics CRM Online

產品名稱可能針對不同地區當地語系化。 在 Microsoft Dynamics 365 (線上和內部部署)，您可以為特定產品屬性提供當地語系化標籤，讓人們會看到符合他們的語言喜好設定的當地語系化名稱。 本主題說明開發人員如何與此功能互動。 如需使用此應用程式功能的逐步指示，請參閱說明及訓練：將產品名稱和屬性翻譯成多種語言。

本主題內容

支援當地語系化屬性值的屬性

擷取當地語系化屬性值

使用當地語系化值的查詢

建立或更新含有當地語系化屬性的記錄

翻譯可當地語系化的屬性

解除安裝語言

支援當地語系化屬性值的屬性

下列清單包含支援當地語系化值的屬性：

  • Product.Name

  • DynamicProperty.Name

  • DynamicPropertyOptionSetItem.DynamicPropertyOptionName

  • DynamicPropertyOptionSetItem.DynamicPropertyOptionDescription

StringAttributeMetadata 和 MemoAttributeMetadata 類別有唯讀 IsLocalizable 布林屬性，對於任何屬性 (先前表格中的四個屬性除外) 值為 false。

擷取當地語系化屬性值

您不需要進行特殊動作，擷取符合使用者的語言喜好設定的當地語系化值。 如果使用者的慣用語言有當地語系化值，便會傳回它。 如果當地語系化值不存在，會傳回組織的基礎語言值。 此行為維護回溯相容；您目前有使用產品名稱屬性的所有程式碼，會持續使用任何當地語系化值正常運作。 如果屬性值的當地語系化不完整，使用者可能看到混合語言值。

若要擷取特定當地語系化屬性的所有當地語系化標籤，請使用 RetrieveLocLabelsRequest 訊息。

使用當地語系化值的查詢

使用當地語系化屬性值與條件來查詢實體時，條件會先使用慣用語言評估，如果沒有該屬性的當地語系化值，則還原為基礎語言。 當地語系化屬性值的查詢結果將是慣用語言的值 (如果，即存在)。 否則，結果會使用基礎語言值。

建立或更新含有當地語系化屬性的記錄

含有當地語系化屬性的記錄是唯讀，除非慣用語言是組織的基礎語言。 只可以使用組織的基礎語言，建立具有當地語系化屬性值的記錄。 如果為當地語系化的屬性更新基礎語言值，不會變更該屬性之所有當地語系化值，除非清除基礎語言的值。 如果設定基礎語言值是 null 或空字串，也會清除該屬性的所有當地語系化值。

若要新增或更新任何特定當地語系化屬性的當地語系化標籤，使用 SetLocLabelsRequest 訊息或匯入翻譯值。 當地語系化屬性變更會顯示在記錄的稽核歷程記錄。 當地語系化值的語言識別碼 (LCID) 會顯示在稽核歷程記錄。

翻譯可當地語系化的屬性

以程式設計方式翻譯當地語系化的屬性程序類似用來翻譯當地語系化解決方案標籤的程序。其他資訊：翻譯自訂的實體與屬性文字

不同於翻譯中繼資料值，匯出與匯入當地語系化屬性值的使用者不必擁有系統管理員資訊安全角色。 銷售經理資訊安全角色擁有翻譯當地語系化屬性的必要權限。 翻譯當地語系化屬性值的人員只能匯出他們有檢視權限的記錄，以及更新他們有更新權限的記錄。

若要以程式設計方式翻譯當地語系化的屬性，必須先使用 ExportFieldTranslationRequest 匯出目前當地語系化標籤定義。ExportFieldTranslationResponse.ExportTranslationFile 屬性包含 crmFieldTranslations.zip 壓縮檔的 byte[]，其中包含的 [Content_types].xml 和 crmFieldTranslations.xml 檔案可以使用 Microsoft Office Excel 開啟。當地語系化標籤工作表中包含的欄具有組織的每個佈建語言 LCID 值。 基礎語言值的欄會填入，而每個佈建語言的欄會包含所有先前當地語系化的值。 這個檔案可由翻譯人員編輯，針對當地語系化的屬性提供當地語系化的標籤。

提示

若只要針對基礎語言名稱執行大量更新，也可以編輯基礎語言值。

在 crmFieldTranslations.xml 檔案編輯提供當地語系化標籤後，將它與 [Content_types].xml 檔案一起壓縮，並設定該檔案做為 ImportFieldTranslationRequest 的 TranslationFile 屬性。

修改匯出已翻譯屬性值時包含的值

匯出翻譯中包含的值是由可自訂檢視表控制 (與支援當地語系化屬性值的實體相關聯)。 只有產品實體會在自訂使用者介面中顯示此檢視表。 這些檢視表的名稱為 [匯出欄位翻譯]。 下表提供這些檢視表的 SavedQueryId。

實體

SavedQueryId

預設 FetchXml

product

9cfe2a9f-13c4-e311-8f2e-00155d9d2505

<fetch version="1.0" output-format="xml-platform" mapping="logical" distinct="false"> <entity name="product"> <attribute name="name" /> </entity></fetch>

dynamicproperty

4833cf48-1ac4-e311-8f2e-00155d9d2505

<fetch version="1.0" output-format="xml-platform" mapping="logical"> <entity name="dynamicproperty"> <attribute name="name" /> </entity></fetch>

dynamicpropertyoptionsetitem

d64cce30-1fc4-e311-8f2e-00155d9d2505

<fetch version="1.0" output-format="xml-platform" mapping="logical"> <entity name="dynamicpropertyoptionsetitem"> <attribute name="dynamicpropertyoptionname" /> <attribute name="dynamicpropertyoptiondescription" /> </entity></fetch>

您可以編輯這些檢視表 FetchXml 屬性，篩選不要包含的所有屬性值。 例如，您可能想要排除已封存的記錄或只包括在特定日期之後更新的記錄。

監視欄位翻譯匯入工作的進度

系統作業實體包含下列檢視表，可監視欄位翻譯匯入工作的進度：

  • 所有欄位翻譯匯入工作

  • 完成的欄位翻譯匯入工作

  • 進行中的欄位翻譯匯入工作

  • 我的欄位翻譯匯入工作

  • 未啟動的欄位翻譯匯入工作

匯入翻譯工作時，下列情況會導致錯誤：

訊息

描述

警告：您沒有匯入檔案指定的一個或多個資料列的寫入權限，工作表 {0}，資料列 {1}。

執行匯入的使用者可能沒有匯入檔案中一個或多個資料列的寫入權限。

其他列的處理會繼續。

警告：基礎語言翻譯字串為 null，工作表 {0}，資料列 {1}，資料行 {2}。

基礎語言值不可透過匯入翻譯清除。

其他列的處理會繼續

警告：資料列 {0} 中的儲存格數目不符合工作表 {1} 中資料列 1 的儲存格數目。

試算表中所有列必須有相同數目的儲存格。

其他列的處理會繼續。

警告：工作表 {0}，資料列 {1}，資料行 A 中找到無效的實體名稱。

系統中沒有有效的實體使用工作表的名稱。

其他列的處理會繼續。

警告：工作表 {0}，資料列 {1}，資料行 C 中找到無效的物件欄名稱。

系統中沒有有效的可自訂屬性使用工作表的名稱。

其他列的處理會繼續。

警告：工作表 {0}，資料列 {1}，資料行 B 中找到無效的物件識別碼。

組織中沒有此資料列中的項目的相符記錄。

其他列的處理會繼續。

錯誤：工作表 {0}中找不到資料列。

匯入工作表是空白。

錯誤：工作表 {0} 中的組織 ID 不符合目前組織 ID。

您只可以把翻譯匯入先前匯出的相同組織。

警告：工作表 {0}，資料行 {1} 中找到無效的語言碼。 | 詳細資料：{2}

資料行中的 LCID 不是有效的整數，或未安裝該語言的語言套件。

忽略資料行中的翻譯。

您可以在地區設定識別碼 (LCID) 表找到有效的地區設定識別碼值。

錯誤：工作表 {0}，資料行 {1} 中找到重複的語言碼。

每一資料行都必須有不同的語言碼。

錯誤：翻譯檔案無效。 壓縮檔的根目錄必須包含以下檔案：CrmFieldTranslations.xml、[Content_Types].xml

要匯入的壓縮 (zip) 檔案必須只包含錯誤描述的檔案。

錯誤：翻譯檔案無效或不符合所需的結構描述。

壓縮 (zip) 檔案中包含的 CrmFieldTranslations.xml file 必須是從系統匯出，並只編輯提供當地語系化值。 其他變更可能使檔案無效。

解除安裝語言

針對解除安裝語言提供的所有當地語系化標籤會保留在系統中，因此如果語言重新安裝，可就地安裝。

另請參閱

產品類別目錄實體
翻譯自訂的實體與屬性文字
說明及訓練：將產品名稱和屬性翻譯成多種語言

Microsoft Dynamics 365

© 2017 Microsoft. 著作權所有，並保留一切權利。 著作權