サンプル: 業務プロセス フローの使用

  • [アーティクル]

このサンプルでは、エンティティ レコードの業務プロセス フロー インスタンスの取得、業務プロセス フロー インスタンスとそのプロセス ステージのアクティブパスの取得、アクティブ ステージの変更などの業務プロセス フローをプログラムで処理する方法を示します。 これらの概念については、「業務プロセス フローのモデル化」を参照してください。

このサンプルは サンプル : ビジネス プロセス フローを使って作業する からダウンロードできます。

前提条件

サンプルを実行するには:

  1. Customer Engagement (on-premises)、バージョン 9 組織へアクセスします。

  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 パッケージを使用します。 NuGet パッケージの自動復元が Visual Studio で有効になっていることを確認します。 詳細: NuGet パッケージの復元の有効化および無効化

    また、プロジェクト>NuGet パッケージの管理の順に選択してから、復元を選択し、サンプルで使用するパッケージを手動で復元します。

  4. F5 キーを押すか、またはデバッグ>デバッグ開始の順に選択します。

  5. 以前に、Dynamics 365 Customer Engagement (on-premises) 管理コード サンプルのいずれも実行していない場合は、コードを実行するための情報を入力する必要があります。そうでない場合は、すでに設定済みの Customer Engagement サーバーの 1 つに対応する数字を入力します。

    プロンプト 説明設定
    Dynamics 365 Server の名前とポート [crm.dynamics.com] を入力してください Dynamics 365 Server の名前を入力します。 既定値は、北米の Dynamics 365 for Customer Engagement (crm.dynamics.com) です。

    例:
    crm5.dynamics.com
    この組織は Microsoft Online Services でプロビジョニングされていますか (y/n) [n] Microsoft Online Services でプロビジョニングされている組織の場合は、y を入力します。 その他の場合、n を入力します。
    domain\username を入力してください Microsoft アカウントを入力します。
    パスワードを入力してください パスワードを入力します。 文字はウィンドウに “*” で表示されます。 パスワードは、後で再利用できるように Microsoft Credential Manager で安全に保存されます。
    組織番号を指定してください (1-n) [1] 組織の一覧から、所属する組織に該当する番号を入力します。 既定値は 1 です。これは一覧の最初の組織を示します。

  6. このサンプルでは、「このサンプルの概要」で説明されている操作を実行します。また、追加オプションの入力が求められる場合があります。

  7. サンプルが完了したら、[Enter] を押して、コンソール ウィンドウを閉じます。

関連項目

業務プロセス フローのモデル化