執行資料匯入
發行︰ 2017年1月
適用於： Dynamics 365 (online)、Dynamics 365 (on-premises)、Dynamics CRM 2016、Dynamics CRM Online
資料匯入會直接在 Microsoft Dynamics 365 伺服器中執行。 如要執行資料匯入，請設定背景非同步工作來進行隨後作業，順序為：
剖析匯入檔案中的來源資料。
使用資料對應，轉換剖析資料。
上載轉換的資料至 Microsoft Dynamics 365。
所有擁有適當使用權限的 Microsoft Dynamics 365 使用者都可以執行資料匯入。
本主題內容
剖析來源資料
轉換剖析資料
上傳轉換資料至目標伺服器
紀錄失敗
匯入稽核資料
剖析來源資料
剖析來源資料包括剖析所有與特定匯入 (資料匯入) 的匯入檔案。
剖析的資料儲存在為所有瑞入的檔案建立的暫存剖析表格中。 剖析表名稱儲存在 ImportFile.ParsedTableName 屬性中。 來源檔案欄位標頭指定於 ImportFile.HeaderRow 屬性中。 如果來源檔案不包含欄標題的第一列，此屬性指定系統產生的預設欄標題。
使用 ParseImportRequest 訊息，將剖析資料存在剖析表。 使用 GetDistinctValuesImportFileRequest 訊息和 RetrieveParsedDataImportFileRequest 訊息在剖析工作表中擷取資料。
下表列出您可以用來解析匯入檔案和取得剖析表格並擷取剖析資料的訊息。
訊息 |
描述 |
|---|---|
送出解析任何匯入檔案使用指定的匯入 (資料匯入) 的非同步工作。 在此請求的 ImportId 屬性中傳送關聯匯入 (資料匯入) ID。 在背景執行且執行資料解析的非同步工作 ID 會在訊息回覆的 AsyncOperationId 屬性中回傳。 |
|
為包含清單值的來源檔案的欄回傳明確的值。 在此請求的 ImportFileId 屬性中傳送關聯匯入檔案 ID。 此明確值是在訊息回覆的 Values 屬性中，以字串陣列的形式回傳。 只有在使用 ParseImportRequest 訊息建立剖析表後才使用此訊息。 重要 不要在使用 ImportRecordsImportRequest 訊息之後使用此訊息。 您無法在結束執行的 ImportRecordsImportRequest 訊息送出匯入工作後存取剖析工作表。 |
|
從剖析表中擷取資料。 在此請求的 ImportFileId 屬性中傳送關聯匯入檔案 ID。 此剖析資料是在訊息回覆的 Values 屬性中，以字串二維陣列的形式回傳。 資料會如同來源檔案的欄順序回傳 只有在使用 ParseImportRequest 訊息建立剖析表後才使用此訊息。 重要 不要在使用 ImportRecordsImportRequest 訊息之後使用此訊息。 您無法在結束執行的 ImportRecordsMessage 訊息送出匯入工作後存取剖析工作表。 |
轉換剖析資料
在轉換時，您可藉由套用所有可用的資料對應和與特定匯入 (資料匯入) 至相關資料轉換來變更剖析資料。
使用 TransformImportRequest 訊息來送出一項非同步工作，轉換剖析的資料。 在此請求的 Import.ImportId 屬性中傳送關聯匯入 (資料匯入) 唯一識別碼。 在背景執行且執行轉換的非同步工作唯一識別碼會在訊息回覆的 AsyncOperationId 屬性中回傳。
上傳轉換資料至目標伺服器
在成功完成轉換後，資料準備上傳至 Microsoft Dynamics 365 伺服器。
使用 ImportRecordsImportRequest 訊息來送出一項非同步工作，上傳轉換資料至 Microsoft Dynamics 365。 關聯匯入 (資料匯入) 的唯一識別碼必須在此請求的 ImportId 屬性中指定。 在背景執行且上傳資料至 Microsoft Dynamics 365 的非同步工作的唯一識別碼會在訊息回覆的 AsyncOperationId 屬性中回傳。 將會匯入所有與指定的匯入 (資料匯入) 匯入檔案。
每個匯入工作的都有唯一個序號，儲存在建立紀錄的 ImportSequenceNumber 屬性中。Organization.CurrentImportSequenceNumber 屬性包含上一份在系統中執行的匯入工作的一組唯一的序號。 您可以使用下列唯一序號來追蹤屬於一項匯入工作記錄。
紀錄失敗
紀錄匯入失敗會在剖析、轉換或是上傳資料時發生。 失敗的原因以及關於其他匯入失敗的紀錄的詳細資訊會在匯入紀錄 (ImportLog) 實體中記下。
如要找出有多少紀錄匯入失敗，請擷取紀錄的 ImportFile.FailureCount 屬性。 若要確認匯入期間，有哪些紀錄匯入失敗，請擷取 ImportData.HasError 屬性。 如果 HasError 屬性為 true，發生了部分的失敗，如果是 false，則順利地匯入。
匯入稽核資料
Microsoft Dynamics 365 實體有四個預設屬性可用來追蹤記錄建立時和上次修改的日期與時間，以及建立和上次修改記錄的使用者。
createdon 屬性指定記錄建立的日期和時間。 若要在 createdon 屬性中匯入資料，請將包含此資料的資料欄位對應至 overriddencreatedon 屬性。 在匯入期間，紀錄的 createdon 屬性已與對應到 overriddencreatedon 屬性的值更新且 overriddencreatedon 屬性已設定為資料匯入的日期和時間。 如果資源值沒有對應到 overriddencreatedon 屬性，則 createdon 屬性會設定為資料匯入的日期和時間，且 overriddencreatedon 屬性不會設定為任何值。
注意
如要在匯入期間覆寫 createdon 屬性值，您需要 prvOverrideCreatedOnCreatedBy 權限。 請注意權限名稱指的是您可以在匯入期間覆寫 createdby 屬性。 不過，目前尚不支援此功能。
您無法將資料匯入 modifiedon、createdby和 modifiedby 屬性。 如果您需要儲存跟上次建立修改資料的人員與修改資料的時間，您可以在 Microsoft Dynamics 365 中建立自訂屬性，然後將您的來源欄對應至新的自訂屬性。
另請參閱
匯入資料
設定資料匯入
部落格文章：如何以程式設計方式匯入附件
資料匯入實體
Microsoft Dynamics 365
© 2017 Microsoft. 著作權所有，並保留一切權利。 著作權