企業の購買プロセス

[アーティクル]
05/09/2023

PurchaseProcess サンプルは、提案要求 (RFP) に基づくごく基本的な購買プロセスを作成する方法を示しています。この購買プロセスでは最良の提案が自動的に選択されます。このサンプルでは、Parallel、ParallelForEach<T>、および ForEach<T> と、プロセスを表すワークフローを作成するカスタムアクティビティが組み合わされています。

このサンプルには、さまざまな参加者として (元の要求者や特定のベンダーとして) プロセスとやり取りできる ASP.NET クライアントアプリケーションが含まれています。

対象

カスタムアクティビティ。
アクティビティの構成。
ブックマーク
永続性。
スキーマ化された永続化。
トレース。
追跡。
さまざまなクライアント (ASP.NET Web アプリケーションと WinForms アプリケーション) での WF のホスティング。

プロセスの説明

このサンプルは、任意の会社のためにベンダーからの提案を集める Windows Workflow Foundation (WF) プログラムの実装を示しています。

Company X の従業員が Request for Proposal (RFP) を作成します。
1. RFP のタイトルと説明を入力します。
2. 提案の送信を依頼するベンダーを選択します。
従業員が提案を送信します。
1. ワークフローのインスタンスが作成されます。
2. ワークフローは、すべてのベンダーから提案が送信されるまで待機します。
すべての提案が受信されると、それらがワークフローによって反復処理されて、最良の提案が選択されます。
1. ベンダーにはそれぞれ評価があります (評価リストは VendorRepository.cs に格納されています)。
2. 提案の合計金額は、(ベンダーによって入力された金額) * (記録されているベンダーの評価) / 100 という式によって決定されます。
元の要求者は、送信されたすべての提案を表示できます。最良の提案はレポートの特別なセクションに表示されます。

プロセスの定義

このサンプルのコアロジックでは ParallelForEach<T> アクティビティが使用されています。このアクティビティは、各ベンダーからの提案を待機して (ブックマークを作成するカスタムアクティビティを使用)、ベンダーの提案を RFP として登録します (InvokeMethod アクティビティを使用)。

その後、RfpRepository に格納されている受信したすべての提案が反復処理されて、調整金額が計算されます (Assign アクティビティと System.Activities.Expressions アクティビティを使用)。調整金額が前の最良の提案より優れている場合は、その新しい金額が最良の提案に割り当てられます (If アクティビティと Assign アクティビティを使用)。

このサンプルのプロジェクト

このサンプルには次のプロジェクトが含まれています。

プロジェクト	説明
共通	プロセス内で使用されるエンティティオブジェクト (Request for Proposal、Vendor、および Vendor Proposal)。
WfDefinition	購買プロセスワークフローのインスタンスの作成および使用のためにクライアントアプリケーションによって使用されるプロセス (WF プログラムとしてのプロセス) とホスト (`PurchaseProcessHost`) の定義。
WebClient	購買プロセスのインスタンスを作成したりそれに参加したりできる ASP.NET クライアントアプリケーション。独自に作成したホストを使用してワークフローエンジンとやり取りします。
WinFormsClient	購買プロセスのインスタンスを作成したりそれに参加したりできる Windows フォームクライアントアプリケーション。独自に作成したホストを使用してワークフローエンジンとやり取りします。

WfDefinition

次の表には、WfDefinition プロジェクトの最も重要なファイルの説明が含まれています。

ファイル	説明
IPurchaseProcessHost.cs	ワークフローのホストのインターフェイス。
PurchaseProcessHost.cs	ワークフローのホストの実装。ホストは、ワークフローランタイムの詳細を抽象化します。`PurchaseProcess` ワークフローのインスタンスの読み込み、実行、およびインスタンスとのやり取りのために、すべてのクライアントアプリケーションで使用されます。
PurchaseProcessWorkflow.cs	Purchase Process ワークフローの定義を含むアクティビティ (Activity から派生します)。 Activity から派生するアクティビティは、既存のカスタムアクティビティと .NET Framework 4.6.1 アクティビティライブラリのアクティビティをまとめることで機能を構成します。これらのアクティビティをまとめることは、カスタム機能を作成するための最も基本的な方法です。
WaitForVendorProposal.cs	このカスタムアクティビティは NativeActivity から派生し、後にベンダーが提案を送信するときに再開する必要がある名前付きブックマークを作成します。 NativeActivity から派生するアクティビティは、CodeActivity から派生するアクティビティと同様に、Execute をオーバーライドすることで、命令型機能を作成します。ただし、ActivityContext メソッドに渡される `Execute` を介して、ワークフローランタイムのすべての機能にもアクセスできます。このコンテキストでは、子アクティビティのスケジュールと取り消し、非永続化ゾーン (アトミックトランザクションの中など、ランタイムによってワークフローのデータが永続化されない実行ブロック) の設定、および Bookmark オブジェクト (一時停止したワークフローの再開を処理) がサポートされています。
TrackingParticipant.cs	すべての追跡イベントを受信してテキストファイルに保存する TrackingParticipant。追跡参加要素は拡張としてワークフローインスタンスに追加されます。
XmlWorkflowInstanceStore.cs	ワークフローアプリケーションを XML ファイルに保存するカスタムの InstanceStore。
XmlPersistenceParticipant.cs	Request for Proposal のインスタンスを XML ファイルに保存するカスタムの PersistenceParticipant。
AsyncResult.cs / CompletedAsyncResult.cs	永続化コンポーネントに非同期パターンを実装するためのヘルパークラス。

共通

次の表には、Common プロジェクトの最も重要なクラスの説明が含まれています。

クラス	説明
ベンダー	Request for Proposals で提案を送信するベンダー。
RequestForProposal	Request for Proposals (RFP) は、ベンダーに特定の商品またはサービスについての提案の送信を求める依頼書です。
VendorProposal	ベンダーによって具象 RFP に送信された提案。
VendorRepository	Vendor のリポジトリ。この実装には、Vendor のインスタンスのメモリ内コレクションと、それらのインスタンスを公開するためのメソッドが含まれています。
RfpRepository	Request for Proposals のリポジトリ。この実装は、Linq to XML を使用して、スキーマ化された永続化によって生成された Request for Proposal の XML ファイルをクエリします。
IOHelper	このクラスは、I/O 関連のすべての問題を処理します (フォルダー、パスなど)。

Web クライアント

次の表には、Web Client プロジェクトの最も重要な Web ページの説明が含まれています。

ファイル	説明
CreateRfp.aspx	新しい Request for Proposals を作成して送信します。
Default.aspx	アクティブな Request for Proposals と完了した Request for Proposals をすべて表示します。
GetVendorProposal.aspx	具象 Request for Proposals 内のベンダーからの提案を取得します。このページを使用するのはベンダーだけです。
ShowRfp.aspx	Request for Proposals に関するすべての情報 (受信した提案、日付、金額、およびその他の情報) を表示します。このページを使用するのは Request for Proposal の作成者だけです。

WinForms Client

次の表には、WinForms Client プロジェクトの最も重要なフォームの説明が含まれています。

フォーム	説明
NewRfp	新しい Request for Proposals を作成して送信します。
ShowProposals	アクティブな Request for Proposals と完了した Request for Proposals をすべて表示します。注: Request for Proposal を作成または変更した後にこの画面に変更内容が表示されない場合は、UI の [更新] ボタンをクリックしてください。
SubmitProposal	具象 Request for Proposals 内のベンダーからの提案を取得します。このウィンドウを使用するのはベンダーだけです。
ViewRfp	Request for Proposals に関するすべての情報 (受信した提案、日付、金額、およびその他の情報) を表示します。このウィンドウを使用するのは Request for Proposals の作成者だけです。

永続化ファイル

次の表は、永続化プロバイダー (XmlPersistenceProvider) によって生成されるファイルを示しています。これらのファイルは、現在のシステムの一時フォルダーのパスに配置されます (GetTempPath を使用)。トレースファイルは現在の実行パスに作成されます。

ファイル名	説明	Path
rfps.xml	アクティブな Request for Proposals と完了した Request for Proposals をすべて含む XML ファイル。	GetTempPath
[instanceid]	このファイルには、ワークフローインスタンスに関するすべての情報が含まれています。このファイルは、スキーマ化された永続化の実装 (XmlPersistenceProvider の PersistenceParticipant) によって生成されます。	GetTempPath
[instanceId].tracking	具象インスタンス内で発生したすべてのイベントを含むテキストファイル。このファイルは TrackingParticipant によって生成されます。	GetTempPath
PurchaseProcess.Tracing.TraceLog.txt	App.config ファイルまたは Web.config ファイルの構成パラメーターに基づいてワークフローによって生成されるトレースファイル。	現在の実行パス

このサンプルを使用するには

Visual Studio を使用して、PurchaseProcess.sln ソリューションファイルを開きます。
Web Client プロジェクトを実行するには、ソリューションエクスプローラーを開き、 [Web Client] プロジェクトを右クリックして、 [スタートアッププロジェクトに設定] をクリックします。
WinForms Client プロジェクトを実行するには、ソリューションエクスプローラーを開き、 [WinForms Client] プロジェクトを右クリックして、 [スタートアッププロジェクトに設定] をクリックします。
ソリューションをビルドするには、Ctrl キーと Shift キーを押しながら B キーを押します。
ソリューションを実行するには、Ctrl キーを押しながら F5 キーを押します。

Web Client のオプション

新しい rfp を作成: 新しい Request for Proposals (RFP) を作成し、Purchase Process ワークフローを開始します。
更新: メインウィンドウの [Active and Finished RFPs] の一覧を更新します。
View: 既存の RFP の内容を表示します。ベンダーは自身の提案を送信できます (依頼されている場合。依頼されていない場合は RFP が完了していません)。
View As: さまざまな ID を使用して RFP にアクセスできます。そのためには、アクティブな RFP のグリッドの [View as] ボックスで目的の参加者を選択します。

WinForms Client のオプション

Rfp の作成: 新しい Request for Proposals (RFP) を作成し、Purchase Process ワークフローを開始します。
更新: メインウィンドウの [Active and Finished RFPs] の一覧を更新します。
Rfp の表示: 既存の RFP の内容を表示します。ベンダーは自身の提案を送信できます (依頼されている場合。依頼されていない場合は RFP が完了していません)。
Connect As: さまざまな ID を使用して RFP にアクセスできます。そのためには、アクティブな RFP のグリッドの [View as] ボックスで目的の参加者を選択します。