チュートリアル : 初めてのビジネス プロセス構築

     前  次    目次     
ここから内容

手順 2 : プロセスの開始方法の指定

この手順では、ビジネス プロセスの開始方法を指定します。

Web サービスとして、ビジネス プロセスはクライアントが要求を行うために呼び出すメソッドをとおして機能をエクスポーズします。また、ビジネス プロセスからプロセス コントロールを作成することもできます。プロセス コントロールの場合は、コントロール インタフェースを介して、他のリソースがビジネス プロセスと対話できます。プロセス コントロールの詳細については、このチュートリアルの「プロセス コントロールを使用した、ビジネス プロセスの呼び出し」を参照してください。

この手順では、「見積り要求」メッセージをクライアントから受信するために、ビジネス プロセスに開始ノードを設計します。このメッセージを受信すると、ビジネス プロセスが開始されます。また、受信した見積り要求メッセージを保持する変数も作成します。

デザイン ビューでは、ビジネス プロセスとクライアント アプリケーションとの間の対話がクライアント要求ノードおよびクライアント応答ノードによって表されます。このチュートリアルでは、クライアント要求ノードをビジネス プロセスに追加し、その後に、クライアントからのメッセージの受信を処理するコードをこのノードで作成します。

ビジネス プロセスを開始するクライアント要求ノードを設計するには、次のタスクを実行します。

ビジネス プロセスに開始ノードを作成するには
  1. [パッケージ・エクスプローラー] ペインで、RequestQuote.java をダブルクリックします。RequestQuote ビジネス プロセスがデザイン ビューに表示されます。

  2. 見積り要求

    この開始ノードにノードを追加して、ビジネス プロセスの開始方法を定義する必要があります。

  3. 開始ノードをダブルクリックし、開始ノード ビルダを開きます。
  4. ノード ビルダには、使用可能な開始方法が表示されます。


    見積り要求

  5. ノード ビルダで、[クライアント要求で呼び出す] を選択します。
  6. [閉じる] をクリックします。ノード ビルダが閉じ、開始ノードに関連付けられていた空のノードが [Client Request] ノードになります。
クライアント要求ノードを設計するには

クライアント要求ノードの設計では、クライアントがビジネス プロセスの開始をトリガするために使用するメソッドとパラメータを作成し、クライアントからの要求の受信を処理するロジックを設計します。

  1. [Client Request] ノードの名前を変更します。変更するには、[Client Request] ノードをクリックし、〔F2〕を押します。ノード名に Client Requests Quote と入力して、Client Request を置き換えます。〔Enter〕を押します。これで、ビジネス プロセスが次の図のようになります。

  2. 見積り要求

  3. デザイン ビューで、[Client Requests Quote] ノードをダブルクリックします。ノード ビルダが呼び出されます。

  4. 見積り要求

    注意 : ノード ビルダは、ビジネス プロセスとそのクライアントおよび他のリソースとの間の通信の設計を支援する、タスク駆動型ユーザ インタフェースを提供します。ノード ビルダにアクセスするには、デザイン ビューで目的のノードをダブルクリックします。これにより、選択したノードに固有のノード ビルダが、ビジネス プロセスにインラインで表示されます。

    前の図に示したように、クライアント要求ノードのノード ビルダには、クライアントとビジネス プロセスとの間の通信の設計に使用する、[一般的な設定] タブと [データの受信] タブが表示されます。

一般的な設定を指定するには

次の手順では、ビジネス プロセスによってクライアントにエクスポーズされるメソッドを指定する方法を説明します。クライアントはこのメソッドを起動してビジネス プロセスを開始し、ビジネス プロセスに対する要求を行います。

  1. [一般的な設定] タブの [メソッド名] フィールドで、デフォルトのメソッド名 clientRequestquoteRequest に変更します。
  2. 注意 : ビジネス プロセスをサービスとして提供する場合は、クライアント要求ノードでメソッドに割り当てた名前が、WSDL (Web Services Description Language) を介してエクスポーズされるメソッドの名前となります。一般には、ビジネス プロセスが提供するサービスを表す名前を定義することをお勧めします。
  3. quoteRequest メソッドに対するパラメータのデータ型を指定します。
    1. [一般的な設定] タブの [追加] をクリックします。データ型を示すパネルが表示されます。

    2. 見積り要求

      クライアントからの見積り要求メッセージは、XML メッセージです。したがって、このノードでは XML 型が関係します。

    3. 必要に応じて、[XML] を選択します。パネルには、プロジェクトで利用可能な XML スキーマ ファイルのリスト (型付き XML) および型なし XML オブジェクトのリストが表示されます。
    4. 注意 : このチュートリアルで見積り要求ビジネス プロセスを構築するときに必要な XML スキーマは、Tutorial_Process_Application_UTILITY\Schemas フォルダ内にあります。用意されているスキーマには、QuoteRequest.xsdPriceQuote.xsdAvailQuote.xsdQuote.xsd と、システム スキーマ DynamicProperties.xsd があります。

      アプリケーション内のサービスに利用できる XML スキーマは、プロジェクト内にあります。プロジェクト (Web プロジェクトまたはユーティリティ プロジェクト) は、[パッケージ・エクスプローラー] ペイン内でフォルダとして表現されます。

      この手順では、XML スキーマ QuoteRequest.xsd を使用して、クライアントが送信してビジネス プロセスを開始するドキュメントの構造を指定します。
    5. XML 型のリストで [型付き] に移動し、QuoteRequest.xsd レベルまで展開し、QuoteRequest.xsd の横にある + をクリックします。
    6. QuoteRequest.xsd で定義される XML スキーマのグラフィック表現が、ノード ビルダのペインに表示されます。

    7. [quoteRequest] ノードをクリックします。これは、XML ドキュメント内の親要素を表します。[型名] フィールドに XML 型 org.example.request.QuoteRequestDocument が表示されます。
    8. 図 4-1 見積り要求


      見積り要求

    9. [パラメータ名] で、デフォルトのパラメータ名 (x0) を requestXML に置き換えます。
  4. [OK] をクリックします。指定したパラメータ (パラメータの型が QuoteRequestDocument で名前が requestXML) が、ノード ビルダの [一般的な設定] タブに表示されます。
  5. この手順で、ビジネス プロセスによってクライアントにエクスポーズされるメソッドの指定が完了します。クライアントからのメッセージは、型付き XML であると予期されます。つまり、クライアントから受信するメッセージには、XML スキーマ (ここでは QuoteRequest.xsd) に対して有効な XML が含まれていなければなりません。

    注意 : クライアントから受信する XML メッセージの例 (QuoteRequest.xml および QuoteRequest_a.xml) が、プロジェクトの testxml フォルダ内にあります。これらのメッセージは、チュートリアルの後の部分でビジネス プロセスをテストするときに使用します。

    [一般的な設定] タブが更新されて、メソッド名とパラメータが正しく指定されたことを示します。見積り要求 はタスクが完了したことを示し、見積り要求 はタスクが完了していないことを示します。


    見積り要求

データの受信を指定するには
  1. [データの受信] タブをクリックします。このタブでは、実行時に割り当てられる、クライアントから見積り要求メッセージを受け取る変数を指定できます。デフォルトでは、[データの受信] タブを開くと [変数の割り当て] パネルが表示されます。
  2. 注意 : [データの受信] タブには 2 つのモードがあります。
    • [変数の割り当て] - このモードは、クライアントから受信したデータを同じデータ型の変数に割り当てる場合に使用します。
    • [トランスフォーメーション] - このモードは、変数に割り当てられたデータとメソッド パラメータが予期するデータ間のトランスフォーメーションを作成する場合に使用します。
    • 注意 : 型付き非 XML (MFL) データを [データの受信] タブ内の XML 変数に直接割り当てることもできます。この場合、トランスフォーメーションは不要です。型付き非 XML (MFL) データについては、このチュートリアルでは説明しません。MFL ファイル、およびビジネス プロセスの変数へのデータの割り当てについては、「ビジネス プロセス変数とデータ型」を参照してください。

      このチュートリアルでは、クライアントから受信した XML メッセージを同じデータ型の変数に直接割り当てるので、[変数の割り当て] モードを使用します。後の手順では、クライアントから受け取った見積り要求を割り当てる、型付き XML の変数 (QuoteRequestDocument) を作成します。

  3. [割り当てる変数を選択します] で矢印をクリックし、[変数の新規作成...] を選択します。

  4. 見積り要求

    [変数を作成] ダイアログ ボックスが表示されます。

  5. [変数を作成] ダイアログ ボックスで以下を行います。
    1. [変数名] フィールドに requestXML と入力します。
    2. 変数の型の選択フィールドの XML 型のリストで、[型付き] に移動し、QuoteRequest.xsd まで展開し、[quoteRequest] 要素を選択します。

    3. 見積り要求

      [変数の型] フィールドに org.example.request.QuoteRequestDocument が表示されます。

    4. [OK] をクリックします。新しい変数が作成され、[データの受信] タブに表示されます。

    5. 見積り要求

      注意 : requestXML 変数は、[アウトライン] 内の XML 変数としても表示されます。


      見積り要求

      ノード ビルダの両方のタブ ([一般的な設定] と [データの受信]) が、完了 見積り要求 とマークされます。

  6. [閉じる] をクリックします。Client Requests Quote ノード ビルダが閉じます。
  7. デザイン ビューでは、Client Requests Quote ノードの完了状態を示すアイコンが 見積り要求 から 見積り要求 に変り、ノードの設計が完了したことを示します。


    見積り要求

  8. Workshop メニューから [ファイルArrow symbolすべて保管] を選択します。

関連トピック

アプリケーションのコンポーネント

開始ノードの設計

データ型の操作

コントロールを使用してリソースと対話する


  ページの先頭       前  次