範例：使用變更追蹤，同步處理資料與外部系統

 

發行︰ 2016年11月

適用於： Dynamics CRM 2015

此範例程式碼顯示如何使用 RetrieveEntityChangesRequest 訊息，從實體擷取變更並與外部系統同步處理資料。 如需此範例示範功能的詳細資訊，請參閱 使用變更追蹤，同步處理資料與外部系統。

這個範例適用於 Microsoft Dynamics CRM Online 2015 更新 1。 這可從使用變更追蹤，同步處理資料與外部系統下載。

必要條件

1. 可存取 Microsoft Dynamics CRM Online 2015 更新 1 組織。

2. 下載 ChangeTrackingSample Visual Studio 專案。

3. 開啟 ChangeTrackingSample Visual Studio 專案並安裝 Microsoft.CrmSdk.CoreAssemblies 版本 7.1.0-preview NuGet 套件。 如需相關指示，請參閱安裝 NuGet 套件。

4. 在安裝 NuGet 套件後，請參閱 執行範例 以取得如何執行範例以及預期結果的指示。

本主題內容

此範例的作用

安裝 NuGet 套件

執行範例

此範例的作用

1. ChangeTrackingSample 類別 Run 方法呼叫 ImportChangeTrackingSolution 方法，後者先偵測 ChangeTrackingSample 受管理的解決方案是否已安裝。 如果沒有，則匯入 ChangeTrackingSample_1_0_0_0_managed.zip 檔案，安裝此受管理的解決方案。

   此受管理的解決方案包含此範例使用的自訂 sample_book 實體。 此實體具有 sample_bookcode 其他索引鍵，可以在該屬性中的值上建立唯一限制。

2. WaitForEntityAndKeysToBeActive 方法是必要的，因為此範例所需的其他索引鍵在安裝 ChangeTrackingSample 解決方案之後可能未就緒。 此方法輪詢實體的 sample_book 中繼資料，延遲範例的其餘部分執行，直到其他索引鍵就緒為止。

3. CreateRequiredRecords 方法在 sample_book 實體中產生 10 個記錄。

4. 第一次呼叫 RetrieveEntityChangesRequest 時，此訊息執行初始同步處理及擷取實體中的所有記錄 (和版本號碼)，以及快取擷取的記錄。

5. 在快取初始記錄之後，程式會詢問您是否要檢視 sample_book 實體記錄。 如果您回應「y」，程式會嘗試開啟 Internet Explorer，以顯示新建立的記錄的檢視表。

6. UpdateRecords 方法新增 10 個新記錄，更新現有記錄並刪除 sample_book 實體中的記錄。

7. 在更新記錄之後，程序會重設分頁資訊並具現化快取物件。

8. 再次呼叫 RetrieveEntityChangesRequest 時，只會擷取上次同步處理之後更新的記錄。

9. 在擷取變更之後，程式會詢問您是否要檢視 sample_book 實體記錄。 如果您回應「y」，程式會嘗試開啟 Internet Explorer，以顯示新建立的記錄的檢視表。

10. 最後，DeleteChangeTrackingSampleSolution 將提示您刪除 ChangeTrackingSample 受管理的解決方案。

    如果選取「y」，受管理的解決方案會被刪除，包括 sample_book 實體與該實體中的所有資料。 組織將失去已加入的任何資料。

    如果選取「n」，您可以檢查解決方案的詳細資料，包括範例建立的資料。 但是，您必須手動刪除受管理的解決方案，將組織還原至原始狀態。

安裝 NuGet 套件

使用下列步驟安裝此範例所需的組件：

1. 下載此範例並擷取檔案。

2. 使用 Visual Studio，瀏覽至 C# 資料夾並開啟 ChangeTrackingSample.sln 檔案。

3. 在 Visual Studio，以滑鼠右鍵按一下 ChangeTrackingSample 專案並選擇 [管理 NuGet 套件]。

4. 對於預覽版本，請務必選取搜尋準則的 [包含發行前版本] 而不是 [僅穩定版]。 然後搜尋 Microsoft Dynamics CRM 2015 SDK core assemblies。 請確定您選取 7.1.0-preview 版本。

5. 按一下 [安裝]。 您必須接受授權條款才能完成安裝此套件。

執行範例

1. 在 Visual Studio，已開啟解決方案而且已安裝必要 NuGet 套件時，按下 F5 鍵。

2. 若您之前未執行任何 Microsoft Dynamics CRM 受管理程式碼範例，您需要輸入資訊以執行程式碼，或輸入您之前設定的其中一個 CRM 伺服器的編號。

   提示	描述
   輸入 CRM 伺服器名稱和連接埠 [crm.dynamics.com]	輸入您的 Microsoft Dynamics CRM 伺服器名稱。 預設值是 Microsoft Dynamics CRM Online (crm.dynamics.com) 在北美洲。 範例： crm5.dynamics.com
   此組織是否於 Microsoft 線上服務中佈建 (y/n) [n]	如果這是 Microsoft 線上服務佈建組織，請輸入 y。 否則，請輸入 n。
   輸入 domain\username	輸入您的 Microsoft 帳戶。
   輸入密碼	請輸入您的密碼。 字元會在視窗中顯示為「*」。 您的密碼會安全地儲存在 Microsoft 認證管理員中並供往後使用。
   指定組織編號 (1-n) [1]	從組織清單中找到您所屬的組織，輸入對應的數字。 預設為 1，表示清單中的第一個組織。

3. 範例會執行 此範例的作用 中說明的伺服器作業，也會提示其他選項。

4. 當範例完成時，請按 ENTER 關閉主控台視窗。

另請參閱

使用變更追蹤，同步處理資料與外部系統

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