範例：使用 Upsert 插入或更新記錄

 

發行︰ 2016年11月

適用於： Dynamics CRM 2015

此範例程式碼顯示如何使用 Upsert 訊息插入或更新記錄。 如需此範例示範功能的詳細資訊，請參閱 使用 Upsert 插入或更新記錄。

這個範例適用於 Microsoft Dynamics CRM Online 2015 更新 1。 這可從使用 Upsert 插入或更新記錄下載。

必要條件

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

2. 下載 UpsertSample Visual Studio 專案。

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

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

本主題內容

此範例的作用

安裝 NuGet 套件

執行範例

此範例的作用

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

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

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

3. 第一次呼叫 ProcessUpsert 方法時，它會處理 newsampleproduct.xml 檔案中的資料以代表新產品。UpsertRequest 會傳遞至 Execute 方法以建立 13 筆新記錄。

   UpsertResponse.RecordCreated 屬性會傳回 true，表示已建立新記錄。

   在 ProcessUpsert 方法完成之前，程式會詢問您是否要檢視範例產品實體記錄。 如果您回應「y」，程式會嘗試開啟 Internet Explorer，以顯示新建立的記錄的檢視表。

4. 第二次呼叫 ProcessUpsert 方法時，它會處理 updatedsampleproduct.xml 檔案中的資料，代表先前所建立產品的更新。Upsert 訊息用來更新 6 筆記錄。UpsertResponse.RecordCreated 屬性會傳回 false，表示記錄已更新。

   同樣地，ProcessUpsert 方法會詢問您是否要使用瀏覽器檢視記錄。 如果您已開啟檢視表，您可以重新整理檢視表以查看變更。

5. 最後，DeleteUpsertSampleSolution 將提示您刪除 Upsert Sample 受管理的解決方案。

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

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

安裝 NuGet 套件

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

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

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

3. 在 Visual Studio，以滑鼠右鍵按一下 UpsertSample 專案並選擇 [管理 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 關閉主控台視窗。

另請參閱

使用 Upsert 插入或更新記錄

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