建立用於匯入的資料對應
發行︰ 2017年1月
適用於： Dynamics 365 (online)、Dynamics 365 (on-premises)、Dynamics CRM 2016、Dynamics CRM Online
若要將資料匯入 Microsoft Dynamics 365，您必須提供適當的資料對應。
您可以在 SDK 的下列位置找到資料對應範例：SDK\Resources\DataImportMaps\。下載 Microsoft Dynamics CRM SDK 套件。
使用資料對應，將來源檔案中包含的資料對應至 Microsoft Dynamics 365 實體屬性。 您必須將來源檔案中的每一欄對應到適當的屬性。 資料匯入作業期間，不會匯入未對應欄中的資料。
資料對應是由匯入對應 (資料對應) 實體所表示。 使用 CreateRequest 訊息，您可以建立新的對應，使用 IOrganizationService.Update 方法可更新現有的對應。 對應有唯一名稱，包含在 ImportMap.Name 屬性中。 使用 ImportMap.Source 屬性，您可以為建立此資料對應的匯入來源指定名稱。
本主題內容
欄、清單值與查詢對應
負責人對應
附註與附件
匯入和匯出資料對應
欄、清單值與查詢對應
若要將來源檔案中的欄、清單值與查詢值對應至 Microsoft Dynamics 365 屬性，使用下列對應：
欄對應
將來源檔案中的欄對應至 Microsoft Dynamics 365 實體屬性。 針對欄對應，使用欄對應 (ColumnMapping) 實體。 您可以在來源和目標屬性之間使用 1:1 (一對一) 或 1:N (一對多) 關聯。 例如，您可以將客戶地址資訊對應至訂單中的帳單地址與寄送地址。
清單值對應
將來源檔案中的清單值對應至 OptionSetValue 類型的 Microsoft Dynamics 365 屬性。 對於清單值對應，使用挑選清單對應 (PicklistMapping) 實體。
如果來源檔案欄中指定的值是清單值，例如 OptionSetValue、Status、State 與 Boolean，除了欄對應，您還必須提供清單值對應。 例如，將來源檔案的「bill」和「ship」清單值對應至 OptionSetValue 類型的 bill 和 ship 值。
查詢對應
將來源檔案中的查詢值對應至 EntityReference 類型的 Microsoft Dynamics 365 屬性。 針對查詢對應，使用查詢對應 (LookupMapping) 實體。
若來源資料檔案中指定的值參照實體，則必須為此值提供查詢對應。 使用 LookupMapping.LookupSourceCode 屬性指定要在來源檔案中或在 Microsoft Dynamics 365 中搜尋參照的實體。 如果您使用早期繫結類型，可以使用 LookupSourceType 列舉來設定查詢值。 若要在來源檔案中搜尋，請使用 LookupSourceType.Source 值。 若要在 Microsoft Dynamics 365 中搜尋，請使用 LookupSourceType.System 值。 對於 LookupSourceCode 值的清單，請參閱此實體的挑選清單值。若要檢視組織的實體中繼資料，請安裝瀏覽組織的中繼資料中敘述的中繼資料瀏覽器解決方案。 您也可以下載 SDK 後開啟其頂層資料夾內所附名為 EntityMetadata.xlsx 的 Excel 檔案，從中檢視未經自訂組織的中繼資料。您可以提供多個查詢對應。 非同步轉換非同步會處理所有可用的對應。 它會尋找參照記錄和使用記錄唯一識別碼來更新剖析表。 如需詳細資訊，請參閱執行資料匯入。
負責人對應
使用負責人對應，將來源檔案指定的使用者對應至 Microsoft Dynamics 365 使用者。 對於記錄資訊，請使用 Microsoft Dynamics 365 使用者登入名稱。 針對負責人對應，使用負責人對應 (OwnerMapping) 實體。
附註與附件
附註與附件對應的處理與其他實體不同。 附註與附件是會用來附加其他資訊至 Microsoft Dynamics 365 記錄。 附註儲存為文字，而附件儲存為 Microsoft Dynamics 365 資料庫中的檔案。
若要在 Microsoft Dynamics 365 中建立附註的，將註解 (附註) 實體中的 Annotation.IsDocument 屬性設定為 false。 若要建立附件，將 IsDocument 設定為 true。
使用下列設定來對應附註與附件：
將 ColumnMapping.SourceAttributeName 屬性設定為「true」或「false」。 「true」值表示附件。 「false」值表示附註。
將 ColumnMapping.TargetAttributeName 屬性設定為 IsDocument。
如果您使用早期繫結類型，將 ColumnMapping.ProcessCode 屬性設定為 ImportProcessCode 列舉的 ImportProcessCode.Internal 值。 對於 ProcessCode 值的清單，請參閱此實體的挑選清單值。
如果來源資料表示附註，將附註文字對應至 Annotation.NoteText 屬性。 如果您使用 Salesforce 檔案，這些檔案通常儲存在磁碟上 (使用唯一識別碼)。 若要匯入附件，您必須將來源檔案包含的檔案識別碼對應至 Annotation.DocumentBody 屬性。DocumentBody 屬性儲存附件的內容。
匯入非同步工作會檢查來源屬性名稱設定為「true」和「false」的對應，探索附註與附件。 如果找到附件對應，會在磁碟中尋找指定的資料並上傳檔案內容做為附件至 Microsoft Dynamics 365。 如果找不到檔案，傳回錯誤。
如果您沒有提供註解 (附註) 實體的對應，匯入工作會產生附註的預設對應。
注意
可上傳的檔案大小上限是由 Organization.MaxUploadFileSize 屬性所決定。 此屬性是在 Dynamics 365 應用程式中 [系統設定] 的 [電子郵件] 索引標籤上進行設定。 此設定限制可附加至電子郵件訊息、附註和 Web 資源的檔案大小。 預設設定是 5 MB。不過，附件大小不得超過最大 HTTP 要求大小 (預設是 16MB)。 若要讓變更生效，重新設定 Internet Information Services (IIS)。 做法是按一下 [開始]、按一下 [執行]、輸入 iisreset，然後按一下 [確定]。
匯入和匯出資料對應
您可以現有的資料對應匯出至 XML 檔案以及將 XML 資料對應匯入至 Microsoft Dynamics 365。 若要從 Microsoft Dynamics 365 匯出資料對應，使用 ExportMappingsImportMapRequest 訊息。 若要匯入 XML 資料對應以及在 Microsoft Dynamics 365 中建立資料對應，請使用 ImportMappingsImportMapRequest 訊息。
另請參閱
Microsoft Dynamics 365
© 2017 Microsoft. 著作權所有，並保留一切權利。 著作權