ドキュメント承認プロセス

2025-06-22

DocumentApprovalProcess サンプルでは、多くの Windows Workflow Foundation (WF) 機能と Windows Communication Foundation (WCF) 機能を一緒に使用する方法を示します。これらを組み合わせて、ドキュメント承認プロセスシナリオを実装します。クライアントアプリケーションは、承認のためにドキュメントを送信し、ドキュメントを承認できます。承認マネージャーアプリケーションは、クライアント間の通信を容易にし、承認プロセスの規則を適用するために存在します。承認プロセスは、複数の種類の承認を実行できるワークフローです。アクティビティは、単一の承認、クォーラム承認 (承認者の割合)、および一連のクォーラムと単一の承認で構成される複雑な承認プロセスを取得するために存在します。

サンプルの詳細

次の図は、ドキュメント承認プロセスのワークフローを示しています。

ドキュメント承認プロセスワークフロー

クライアントの観点からは、承認プロセスは次のように機能します。

クライアントは、承認プロセスシステムのユーザーとしてサブスクライブします。
WCF クライアントは、承認マネージャーアプリケーションによってホストされている WCF サービスに送信されます。
一意のユーザー ID がクライアントに返されます。クライアントは承認プロセスに参加できるようになりました。
参加すると、クライアントは、単一、クォーラム、または複雑な承認プロセスを使用して、承認のためにドキュメントを送信できます。
クライアントのインターフェイスのボタンがクリックされ、クライアントワークフローサービスホストでワークフローインスタンスが開始されます。
ワークフローは、承認マネージャーアプリケーションに承認要求を送信します。
ワークフローマネージャーは、承認プロセスを表すために独自の側でワークフローを開始します。
マネージャー承認ワークフローが実行されると、結果がクライアントに送り返されます。
クライアントに結果が表示されます。
クライアントは承認要求を受け取り、任意の時点で要求に応答できます。
クライアントでホストされている WCF サービスは、承認マネージャーアプリケーションから承認要求を受け取ることができます。
ドキュメント情報は、レビューのためにクライアントに表示されます。
ユーザーはドキュメントを承認または拒否できます。
WCF クライアントは、承認マネージャーアプリケーションに承認応答を送信するために使用されます。

承認マネージャーアプリケーションの観点から、承認プロセスは次のように機能します。

クライアントは、承認プロセスシステムへの参加を要求します。
承認マネージャーの WCF サービスは、承認プロセスシステムに含まれる要求を受け取ります。
クライアントに対して一意の ID が生成されます。ユーザー情報はデータベースに格納されます。
一意の ID がユーザーに送り返されます。
承認要求が受信されます。承認マネージャーが承認プロセスを実行します。
承認マネージャーが承認要求を受け取り、新しいワークフローを開始します。
要求の種類 (単純、クォーラム、または複雑) に応じて、異なるアクティビティが実行されます。
関連付けのある送受信アクティビティは、承認要求をレビューのためにクライアントに送信し、応答を受信するために使用されます。
承認プロセスワークフローの結果がクライアントに送信されます。

サンプルの使用

データベースを設定するには

管理者特権で開いた Visual Studio コマンドプロンプトから、この DocumentApprovalProcess フォルダーに移動し、Setup.cmd実行します。

アプリケーションを設定するには

Visual Studio を使用して、DocumentApprovalProcess.sln ソリューションファイルを開きます。
ソリューションをビルドするには、Ctrl キーと Shift キーを押しながら B キーを押します。
ソリューションを実行するには、ソリューション エクスプローラーで ApprovalManager プロジェクトを右クリックし、右クリックメニューから [デバッグ] > [新しいインスタンスの開始] をクリックして、承認マネージャーアプリケーションを起動します。

マネージャーの出力が準備完了であることを通知するまで待ちます。

単一承認シナリオを実行するには

管理者権限でコマンドプロンプトを開きます。
ソリューションを含むディレクトリに移動します。
ApprovalClient\Bin\Debug folder and execute two instances of ApprovalClient.exeに移動します。
[ 検出] をクリックし、 サブスクライブ ボタンが有効になるまで待ちます。
任意のユーザー名を入力し、[ サブスクライブ] をクリックします。 1 つのクライアントでは、 UserType1 を使用し、もう一方の種類の UserType2を使用します。
UserType1 クライアントで、ドロップダウンメニューから単一の承認の種類を選択し、ドキュメント名とコンテンツを入力します。 [ 承認の要求] をクリックします。
UserType2 クライアントに、承認待ちのドキュメントが表示されます。それを選択し、承認または拒否を押します。結果は、 UserType1 クライアントに表示されます。

クォーラム承認シナリオを実行するには

管理者権限でコマンドプロンプトを開きます。
ソリューションを含むディレクトリに移動します。
ApprovalClient\Bin\Debug folder and execute three instances of ApprovalClient.exeに移動します。
[ 検出] をクリックし、 サブスクライブ ボタンが有効になるまで待ちます。
任意のユーザー名を入力し、[ サブスクライブ] をクリックします。 1 つのクライアントでは、 UserType1 を使用し、もう 2 つの種類の UserType2を使用します。
UserType1 クライアントで、ドロップダウンメニューからクォーラム承認の種類を選択し、ドキュメント名とコンテンツを入力します。 [ 承認の要求] をクリックします。これにより、2 つの UserType2 クライアントがドキュメントを承認または拒否するように要求されます。 UserType2両方のクライアントが応答する必要がある一方で、承認するには 1 つのクライアントのみがドキュメントを承認する必要があります。
UserType2クライアントに、承認待ちのドキュメントが表示されます。それを選択し、承認または拒否を押します。結果は、 UserType1 クライアントに表示されます。

複雑な承認シナリオを実行するには

管理者権限でコマンドプロンプトを開きます。
ソリューションを含むディレクトリに移動します。
ApprovalClient\Bin\Debug folder and execute four instances of ApprovalClient.exeに移動します。
[ 検出] をクリックし、 サブスクライブ ボタンが有効になるまで待ちます。
任意のユーザー名を入力し、[ サブスクライブ] をクリックします。 1 つのクライアントでは UserType1を使用し、2 つのクライアントでは型 UserType2を使用し、最後の使用では UserType3。
UserType1 クライアントで、ドロップダウンメニューから単一の承認の種類を選択し、ドキュメント名とコンテンツを入力します。 [ 承認の要求] をクリックします。
UserType2クライアントに、承認待ちのドキュメントが表示されます。それを選択して承認を押すと、ドキュメントが UserType3 クライアントに渡されます。

ドキュメントが最初の UserType2 クォーラムによって承認された場合、ドキュメントは UserType3 クライアントに渡されます。
UserType3 クライアントからドキュメントを承認または拒否します。結果は、 UserType1 クライアントに表示されます。

クリーンアップするには

Visual Studio コマンドプロンプトから DocumentApprovalProcess フォルダーに移動し、Cleanup.cmd実行します。