|
|
この手順では、ビジネス プロセスの開始方法を定義します。Web サービスとして、ビジネス プロセスはクライアントが要求を行うために呼び出すメソッドをとおして機能をエクスポーズします。また、ビジネス プロセスからプロセス コントロールを作成することもできます。プロセス コントロールの場合は、コントロール インタフェースを介して、他のリソースがプロセスと対話できます。
| 注意 : | プロセス コントロールの詳細については、「手順 6 : ビジネス プロセスの呼び出し」を参照してください。 |
この手順では、見積り要求 (RFQ) メッセージをクライアントから受信するために、ビジネス プロセスに開始ノードを設計します。RFQ メッセージを受信すると、ビジネス プロセスが開始されます。また、受信した RFQ メッセージを保持する変数も作成します。
[デザイン] ビューでは、ビジネス プロセスとクライアント間の対話がクライアント要求ノードおよびクライアント応答ノードによって表されます。このチュートリアルでは、クライアント要求ノードをビジネス プロセスに追加し、その後に、クライアントからのメッセージの受信を処理するコードをこのノードで作成します。
ビジネス プロセスを開始するクライアント要求ノードを設計するには、次のタスクを実行します。
クライアント要求ノードの設計では、クライアントがビジネス プロセスの開始をトリガするために使用するメソッドとパラメータを作成し、クライアントからの要求の受信を処理するロジックを設計します。
[Client Request] ノードを選択し、〔F2〕を押します。新しい名前として Client Requests Quote と入力し、〔Enter〕を押します。これで、ビジネス プロセスが次の図のようになります。
| 注意 : | ノード ビルダは、ビジネス プロセスとそのクライアントおよび他のリソースとの間の通信を設計する際に役立つ、タスク駆動型ユーザ インタフェースを提供します。ノード ビルダにアクセスするには、[デザイン] ビューで目的のノードをダブルクリックします。これにより、選択したノードのタイプに固有のノード ビルダが、ビジネス プロセスにインラインで表示されます。 |
次の手順では、ビジネス プロセスによってエクスポーズされるメソッドを指定する方法を説明します。クライアントはこのメソッドを呼び出してビジネス プロセスを開始し、ビジネス プロセスに対する要求を行います。
clientRequest を quoteRequest に変更します。| 注意 : | ビジネス プロセスをサービスとして提供する場合は、クライアント要求ノードでメソッドに割り当てた名前が、WSDL (Web Services Description Language) を介してエクスポーズされるメソッドの名前となります。ビジネス プロセスが提供するサービスを明確に示す名前を使用することをお勧めします。 |
quoteRequest メソッドのパラメータのデータ型を指定します。
RFQ は XML メッセージです。したがって、このノードでは XML データ型が必要です。
パネルには、プロジェクトで利用可能な XML スキーマ ファイルのリストが [型付き] 下に、型なし XML オブジェクトのリストが [型なし] 下に表示されます。
このチュートリアルで必要な XML スキーマは、ユーティリティ プロジェクトの Schemas フォルダ内にあります。用意されているスキーマには、QuoteRequest.xsd、PriceQuote.xsd、AvailQuote.xsd、Quote.xsd と、システム スキーマ DynamicProperties.xsd があります。
| 注意 : | アプリケーション内のサービスで利用する XML スキーマは、Web プロジェクトまたはユーティリティ プロジェクト下の Schemas フォルダ内に配置する必要があります。 |
この手順では、XML スキーマ QuoteRequest.xsd を使用して、クライアントが送信してビジネス プロセスをトリガするドキュメントの構造を指定します。
QuoteRequest.xsd] ノードまで展開します。
XML スキーマ QuoteRequest.xsd のグラフィック表現が表示されます。
quoteRequest] ノードを選択します。これは、XML ドキュメント内の親要素を表します。
[型名] フィールドに org.example.request.QuoteRequestDocument が表示されます。
x0) の代わりに requestXML と入力します。
パラメータの型 (QuoteRequestDocument) と名前 (requestXML) が、ノード ビルダの [一般的な設定] タブに表示されます。
この手順で、ビジネス プロセスによってクライアントにエクスポーズされるメソッドの指定が完了します。クライアントからのメッセージは、型付き XML であると予期されます。つまり、クライアントから受信するメッセージには、XML スキーマ (ここでは QuoteRequest.xsd) に対して有効な XML データが含まれていなければなりません)。
| 注意 : | testxml フォルダに用意されているサンプル XML ファイル (QuoteRequest.xml および QuoteRequest_a.xml) は、このチュートリアルの後の部分でプロセスをテストするときに使用します。 |
[一般的な設定] タブが更新されて、次の図のように、メソッド名とパラメータが正しく指定されたことが示されます。
| 注意 : | ![[一般的な設定] タブ - 更新済み](wwimages/complete.gif) は完了タスクを示し、![[一般的な設定] タブ - 更新済み](wwimages/Graycheck.gif) は未完了タスクを示します。 |
デフォルトでは、[変数の割り当て] パネルで [データの受信] タブが開きます。
| 注意 : | [データの受信] タブでは、型付き非 XML (MFL) データを XML 変数に直接割り当てることもできます。この場合、トランスフォーメーションは不要です。非 XML (MFL) データについては、このチュートリアルでは説明しません。MFL ファイル、およびビジネス プロセスの変数へのデータの割り当てについては、『ビジネス プロセス構築ガイド』の「ビジネス プロセスの変数およびデータ型」を参照してください。 |
このチュートリアルでは、クライアントから受信した XML メッセージを同じデータ型の変数に直接割り当てるため、[変数の割り当て] モードを使用します。後の手順では、クライアントから受け取った RFQ を割り当てる、型付き XML の変数 (QuoteRequestDocument) を作成します。
![[一般的な設定] タブ - 更新済み](wwimages/nodetasks.gif)
requestXML と入力します。
[型名] フィールドに org.example.request.QuoteRequestDocument が表示されます。
新しい変数が作成され、[データの受信] タブに表示されます。
| 注意 : | requestXML 変数は、[データ パレット] ビューに XML 変数として表示されます。 |
ノード ビルダの両方のタブ ([一般的な設定] と [データの受信]) が、完了 とマークされます。
[デザイン] ビューでは、[Client Requests Quote] ノードの完了状態を示すアイコンが、 から に変わり、ノードの設計が完了したことを示します。
すべて保管] を選択します。
|
![[変数を作成] ダイアログ ボックス](wwimages/xml_variable2.gif)
