範例:處理商務程序流程

注意

2020 年 11 月生效:

  • Common Data Service 已重新命名為 Microsoft Dataverse。 深入了解
  • Microsoft Dataverse 中的部分術語已更新。 例如,實體 現在是 資料表,而 欄位 則是 資料行深入了解

本文章即將更新,以反映最新的術語。

此範例示範如何以程式設計方式使用商務程序流程,例如擷取商務程序流程執行個體的實體記錄、擷取使用中路徑的商務程序流程執行個體及其程序階段,以及變更使用中階段。 如需這些概念的資訊,請參閱以程式碼使用商務程序流程

此範例可以從範例:使用商務程序流程 下載。

先決條件

在您執行範例之前:

  1. 可存取 Microsoft Dataverse 環境。

  2. 擁有此範例中所使用的潛在客戶、商機和工作流程實體,以及商務程序流程定義實體記錄的適當權限。

  3. 有 Visual Studio 2015 或更新版本可用來執行範例。

  4. 有網際網路連線可用來下載範例專案以及還原範例專案中使用的 NuGet 套件。

此範例的作用

  1. 建立範例潛在客戶記錄。 這會針對潛在客戶記錄自動建立「潛在客戶轉商機銷售程序」商務程序流程的執行個體。

  2. 將潛在客戶記錄轉換成商機記錄。

  3. 擷取與「商機」記錄相關聯的商務程序流程執行個體,使用 RetrieveProcessInstances 訊息。 傳回的集合中第一筆記錄是使用中商務程序流程執行個體的商機記錄,此記錄在本例中為「潛在客戶變商機銷售程序」。

  4. 使用 RetrieveActivePath 訊息擷取使用中路徑和程序階段,取得「潛在客戶變商機銷售程序」執行個體。

  5. 擷取「潛在客戶變商機銷售程序」執行個體的目前使用中階段,並提示使用者是否要移至下一個階段。 確認移動時,將使用中路徑的下一個階段設定為「潛在客戶變商機銷售程序」執行個體的使用中階段。

  6. 最後,提示使用者是否要刪除在範例執行期間建立的記錄。

    以下是範例的輸出結果:

    範例輸出

執行範例

  1. 下載 WorkWithBPF Visual Studio 範例專案,並解壓縮至電腦上的資料夾。

  2. 在解壓縮的資料夾中尋找 WorkWithBPF.sln 檔案,並在 Visual Studio 中開啟。

  3. 範例專案使用 NuGet 套件,必須先還原才能執行範例。 確定已在 Visual Studio 中啟用自動還原 NuGet 套件。 其他資訊:啟用和停用 NuGet 套件還原

    或者,選取 專案 > 管理 NuGet 套件,並選取 還原,手動還原範例中使用的套件。

  4. 按 F5 鍵或選取 偵錯 > 開始偵錯

  5. 如果您先前尚未執行任一範例,您必須輸入資訊來執行程式碼,或輸入您先前設定的任一個執行個體的編號。

    提示 描述
    輸入 Dynamics 365 伺服器名稱和連接埠 [crm.dynamics.com] 輸入您的 Dynamics 365 server 名稱。 在北美洲,預設值是 Dynamics 365 (online) (crm.dynamics.com)。

    範例:
    crm5.dynamics.com
    此組織是否於 Microsoft 線上服務中佈建 (y/n) [n] 如果這是 Microsoft 線上服務佈建組織,請輸入 y。 否則,請輸入 n
    輸入 domain\username 輸入您的 Microsoft 帳戶。
    輸入密碼 請輸入您的密碼。 字元會在視窗中顯示為「*」。 您的密碼會安全地儲存在 Microsoft 認證管理員中並供往後使用。
    指定組織編號 (1-n) [1] 從組織清單中找到您所屬的組織,輸入對應的數字。 預設為 1,表示清單中的第一個組織。
  6. 此範例將會執行此範例的用途中所述的作業,而且可能會提示您使用其他選項。

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