チュートリアル : Worklist アプリケーションの構築

     前  次    新しいウィンドウで目次を開く     
ここから内容

手順 5 : JPD と Worklist の使用

この節では、ワークリスト システムを介してビジネス プロセスとヒューマン アクターの統合をサポートするために、JPD とワークリスト コントロールを使用する方法について説明します。

このコントロールは、Workshop for WebLogic Platform の他の組み込みコントロールと同様に、コントロールのインスタンスをビジネス プロセスに追加して使用します。その後で、1つまたは複数のヒューマン アクターと対話するビジネス プロセス内の箇所で、コントロールに対する操作を呼び出します。

この手順では、次のタスクを実行します。

この節で説明する内容は、前の節の延長です。そのため、融資アプリケーションが開いており、myworklist サーバが起動して動作中であることを前提としています。

 


ワークリスト イベントへのサブスクライブ

メッセージ ブローカ チャネルへのアクセスをコンフィグレーションして、開始イベントを使用してアクセスを開始するには、以下の手順を実行します。

  1. [パッケージ・エクスプローラー] ペインで Loan_Web\src フォルダを右クリックし、[新規Arrow symbolフォルダー] を選択します。[新規フォルダー] ダイアログ ボックスが表示されます。
  2. [フォルダー名] フィールドに「processes」と入力し、[終了] をクリックします。
  3. processes フォルダを選択し、〔Ctrl〕+〔N〕を使用して [ウィザードを選択] ダイアログ ボックスを表示します。
  4. [WebLogic IntegrationArrow symbolプロセス] を選択し、[次へ] をクリックして [新しいプロセス] ダイアログ ボックスを表示します。
  5. [名前] フィールドに Loan_jpd を入力します。新しく作成したプロセス フォルダに JPD プロセス ファイル Loan_jpd.java が作成されます (図 6-1 を参照)。
  6. 図 6-1 新しい JPD ファイルの定義


    新しい JPD ファイルの定義

  7. [終了] をクリックしてプロセスを終了します。
  8. デザイン ビューに新しい JPD が表示されます (図 6-2 を参照)。

    図 6-2 新しい JPD の作成


    新しい JPD の作成

  9. [ダブルクリックして開始イベントを選択] をダブルクリックします (図 6-2 を参照)。
  10. ノード ビルダが表示されます。

  11. ノード ビルダで、[メッセージ ブローカ チャネルをサブスクライブし、イベント (タイマー、電子メール、ファイル、アダプタなど) から開始する] を選択し、[閉じる] をクリックします。JPD デザイン ビューが更新され、開始ノードの名前が Subscription になります。
  12. [Subscription] をクリックして Subscribe worklist event に置き換えます。
  13. [開始] ノードをダブルクリックしてコンフィグレーションします (図 6-3 を参照)。
  14. 図 6-3 開始ノードのコンフィグレーション


    開始ノードのコンフィグレーション

  15. [一般的な設定] タブで、[チャネル名] として /WorklistEvent を選択します。
  16. [フィルタの指定] タブで [TaskEventMetadata] xml ツリーから eventType を選択し、フィルタの値として CREATE を入力します。
  17. [データの受信] タブで、次の手順を実行します。
    • RawData x0 の横にある [変数の新規作成] を選択する。[変数を作成] ダイアログ ボックスが表示されたら、[変数名] フィールドに worklistEventData を入力し、そのタイプとして [com.bea.data.RawData] を選択する。
    • TaskEventMetadataDocumentx1 の横にある [変数の新規作成] をクリックする。[変数を作成] ダイアログ ボックスが表示されたら、[変数名] フィールドに worklistEventMetaData を入力し、そのタイプとして com.bea.wli.worklist.xml.TaskEventMetadataDocument を入力する。
  18. [OK] をクリックして変数名を設定し、開始ノード コンフィグレーションで [閉じる] をクリックしてこの手順を終了します。

 


実行ノードのコンフィグレーション

起動するワークリスト イベントにサブスクライブする JPD を作成したら、イベントをエコーするために実行ノードを作成およびコンフィグレーションします。以下の手順を実行します。

  1. デザイン ビューで [InsertArrow symbolPerform] を選択して、[サブスクリプション] ノードと [完了] ノードの間にアクション ノードを挿入します。
  2. 図 6-4 に示すように、ノードに Print Messages と名前を付けます。
  3. 図 6-4 実行ノードの追加


    実行ノードの追加

  4. JPD の [ソース] タブをクリックして、実行メソッド定義を強調表示します。
  5. 実行メソッドに次のコードを入力します。
  6. System.out.println("####Got worklist event for loan task type");  
    ByteArrayInputStream bais = new ByteArrayInputStream(worklistEventData.byteValue());  
    ObjectInputStream ois = new ObjectInputStream(bais); 
    TaskEvent event = (TaskEvent)ois.readObject(); 
    System.out.println("####Got TaskEvent data in JPD: " + event.getSummary());  
  7. JPD の先頭部分に次の import 文を入力します。
  8. import java.io.ByteArrayInputStream; 
    import java.io.ObjectInputStream; 
    import com.bea.wli.worklist.api.events.data.*;  
  9. [ファイルArrow symbol保管] を選択するか、〔Ctrl〕+〔S〕を使用してファイルを保存します。

Loan_JPD のデプロイ

  1. [パッケージ・エクスプローラー] ペインで以前に作成した [Loan_jpd.java] プロジェクトを右クリックし、[実行Arrow symbolサーバーで実行] を選択します。
  2. [サーバーで実行] ダイアログ ボックスが表示されます。

  3. [既存のサーバーを選択] を選択し、[選択] から使用するサーバを選択します。リストから [myworklist] サーバを選択し、[次へ] をクリックします。
  4. [プロジェクトの追加および除去] ダイアログ ボックスが表示されます。

  5. [次へ] をクリックします。
  6. [構成プロジェクト] リストに Loan_EAR が表示されていることを確認します。表示されていない場合は、[使用可能プロジェクト] リストから Loan_EAR を選択して、[追加] をクリックします。
  7. [終了] をクリックしてサーバでプロジェクトのデプロイを開始します。

 


ワークリスト イベントのパブリッシュの検証

Worklist User Portal を使用して新しいタスク インスタンスを作成し、アプリケーションをテストします。タスク インスタンスを作成すると、ワークリスト イベントがメッセージ ブローカにパブリッシュされ、イベントにより JPD インスタンスが起動されます。以下の手順を実行します。

  1. 次の URL を使用して、Web ブラウザで融資 Web プロジェクトの新しいセッションを開始します。
  2. http://localhost:7001/Loan_Web
  3. 次の資格情報を使用してポータルにログインします。
  4. ユーザ名 : weblogic 
    パスワード : weblogic 
  5. [ログイン] をクリックして、ユーザ weblogic の [タスク] ホームページを表示します (図 6-5 を参照)。
  6. 図 6-5 ユーザ weblogic の [タスク] ホームページの表示


    ユーザ weblogic の [タスク] ホームページの表示

  7. [タスクの作成] ポートレットの [/Loan/loan_approval 1.0] オプションをクリックします。[新しいタスク] ページが表示されます。
  8. タスク プラン コンストラクタとして [NewLoan] を選択していることを確認します。
  9. ページの他のフィールドに、表 6-1 に示す詳細を指定します。
  10. 表 6-1 新しい融資承認タスク インスタンスの詳細
    フィールド名
    [タスク名]
    Maggie JPD の自動車ローン
    [ユーザのプロパティ: SSN]
    222-33-4444
    [ユーザのプロパティ: LoanAmt]
    40000
    [ユーザのプロパティ: 名前]
    Maggie JPD

  11. [タスクの作成] をクリックします。タスクが作成されて、ホームページの [近日中のタスク] ポートレットに表示されます。

WebLogic Worklist Console にログインすると、JPD インスタンスの作成も検証できます。

  1. Web ブラウザを開き、次の URL を入力して WebLogic Worklist Console を開きます。
  2. http://localhost:7001/worklistconsole  
  3. 次の資格情報を使用して Worklist Console に管理者権限でログインします。
  4. ユーザ名 : weblogic 
    パスワード : weblogic 
  5. Loan_EAR ワークリスト システム インスタンスの [タスクの表示] をクリックします。
  6. [タスクの概要] ページで、タスク [Maggie JPD の自動車ローン] に隣接するチェックボックスをクリックして、リストからタスクを選択します。
  7. [ワークリスト タスクの詳細] が表示されます (図 6-6 を参照)。

    図 6-6 [ワークリスト タスクの詳細] - Maggie JPD


    [ワークリスト タスクの詳細] - Maggie JPD

 


ワークリスト コントロールの使用

この節では、JPD のタスク コントロールを使用して、融資処理タスク インスタンスを作成します。このプロセスで、ワークリスト JPD (WorklistControl) およびタスク コントロール (MyControl) を作成し、プロセスをデプロイしてから、サンプル タスクを作成してタスク インスタンスの作成を検証します。

ワークリスト JPD の作成

この節では、ワークリスト JPD を作成する手順について説明します。

  1. [パッケージ・エクスプローラー] ペインで Loan_Web\src\processes フォルダを選択し、〔Ctrl〕+〔S〕を使用して [ウィザードを選択] ダイアログ ボックスを表示します。
  2. [WebLogic IntegrationArrow symbolプロセス] を選択し、[次へ] をクリックして図 6-1 と同様の [新しいプロセス] ダイアログ ボックスを表示します。
  3. [名前] フィールドに WorklistControl を入力します。プロセス フォルダに JPD プロセス ファイル WorklistControl.java が作成されます。
  4. [終了] をクリックしてプロセスを終了します。

    デザイン ビューに新しい JPD が表示されます (図 6-7 を参照)。

    図 6-7 ワークリスト コントロールを使用した新しい JPD


    ワークリスト コントロールを使用した新しい JPD

  5. [ダブルクリックして開始イベントを選択] をダブルクリックします (図 6-7 を参照)。
  6. ノード ビルダが表示されます。

  7. ノード ビルダで [クライアント要求で呼び出す] を選択し、[閉じる] をクリックします。JPD デザイン ビューが更新され、開始ノードの名前が Client Request になります。
  8. [Client Request] ノードをダブルクリックして、図 6-8 に示すようにクライアント要求ノードのノード ビルダを呼び出します。
  9. 図 6-8 クライアント要求のコンフィグレーション


    クライアント要求のコンフィグレーション

  10. [一般的な設定] タブで [追加] をクリックして、パラメータを定義するダイアログ ボックスを表示します。表 6-2 に示すように 4 つのパラメータを作成し、作成したパラメータのタイプをコンフィグレーションします。
  11. 表 6-2 クライアント要求のパラメータの設定
    パラメータ名
    TaskName
    String
    Name
    String
    SSN
    String
    LoanAmt
    java.lang.Long

  12. [データの受信] タブをクリックして新しい変数を作成し、前の手順で作成した対応するパラメータに割り当てます。変数の割り当ての詳細を図 6-9 に示します。
  13. 図 6-9 パラメータへの変数の割り当て


    パラメータへの変数の割り当て

    新しい 4 つの変数のデフォルトの型は、TaskName(String)Name(String)SSN(String)、および LoanAmt(Long) です。

  14. [閉じる] をクリックして続行すると、図 6-10 に示すように JPD が表示されます。
  15. 図 6-10 [Client Request] 開始ノードを使用した WorkListControl JPD


    [Client Request] 開始ノードを使用した WorkListControl JPD

タスク コントロールの作成

この節では、タスク インスタンスの作成をトリガするタスク コントロールを作成します。

  1. [パッケージ・エクスプローラー] ペインで Loan_Web\src\processes フォルダを選択し、〔Ctrl〕+〔S〕を使用して [ウィザードを選択] ダイアログ ボックスを表示します。
  2. [Weblogic Integration コントロールタスク] を選択し、[次へ] をクリックして [Insert control: タスク] ダイアログ ボックスの [コントロールの作成] ページを表示します。
  3. 図 6-11 に示すように、[名前] フィールドに MyControl を入力して、他のフィールドにも同じ値が設定されていることを確認します。
  4. 図 6-11 タスク コントロールの作成


    タスク コントロールの作成

  5. [次へ] をクリックして [Insert control: タスク] ダイアログ ボックスの [タスク プラン] ページに進みます。
  6. [タスク プラン] フィールドで [参照] をクリックして、図 6-12 に示すように Loan_EAR\EarConten\Loan\loan_approval.task を選択します。
  7. 図 6-12 融資承認タスク プランの選択


    融資承認タスク プランの選択

  8. [OK] をクリックして続行します。
  9. [終了] をクリックして JPD に新しいタスク コントロールを追加します。
  10. [パッケージ・エクスプローラー] から MyControl.java を選択し、データ パレットの Controls フォルダにドラッグ アンド ドロップします。
注意 : [データ パレット] ペインが表示されない場合は、[ウィンドウArrow symbolビューの表示Arrow symbolその他Arrow symbolWebLogic Integration] を選択し、[データ パレット] に移動してください。
  1. [ファイルArrow symbol保管] を選択するか、〔Ctrl〕+〔S〕を使用して JPD を保存します。

JPD へのタスク プラン コンストラクタの追加

この節では、ワークリスト JPD にタスク インスタンス作成コンストラクタを追加します。

  1. [パッケージ・エクスプローラー] ペインの WorklistControl.java ファイルを右クリックして、[アプリケーションから開くArrow symbolプロセス エディタ] オプションを選択します。[デザイン] タブに JPD が表示されており、プロセス パースペクティブを使用していることを確認します。
  2. IDE の右下にある [データ パレット] ペインから [コントロールArrow symbolmyControl] に移動して、[OfficerReviewPending NewLoan(String taskName, String SSN, Long LoanAmt, String Name)] メソッドを選択します。図 6-13 を参照してください。
  3. 図 6-13 NewLoan メソッドの選択


    NewLoan メソッドの選択

  4. 選択したメソッドを [Client Request] ノードと [完了] ノードの間にある WorklistControl JPD にドラッグ アンド ドロップします。NewLoan としてメソッドが追加されます (図 6-14 を参照)。
  5. 図 6-14 NewLoan ノードを使用した WorklistControl JPD


    NewLoan ノードを使用した WorklistControl JPD

  6. [NewLoan] をダブルクリックして、図 6-15 に示すように [データの送信] プロパティをコンフィグレーションします。[一般的な設定] プロパティと [データの受信] プロパティは、そのままにしておきます。
  7. 図 6-15 コントロール パラメータを使用したデータの送信変数のマッピング


    コントロール パラメータを使用したデータの送信変数のマッピング

  8. [閉じる] をクリックして設定を実装します。
  9. [ファイルArrow symbol保管] を選択するか、〔Ctrl〕+〔S〕を使用して JPD を保存します。

WorklistControl JPD の検証

この節では、JPD をデプロイし、デプロイが正常に終了した後で、テスト値を使用して JPD を検証します。

  1. [パッケージ・エクスプローラー] で WorklistControl.java を選択していることを確認し、[実行Arrow symbol実行名] オプションをクリックします。デプロイが正常に終了すると、IDE ブラウザに JPD プロセス ページが起動します。
  2. 図 6-16 に示すように、WorklistControl プロセス ブラウザの [テスト フォーム] タブをクリックします。
  3. 図 6-16 WorklistControl プロセスの [テスト フォーム] ページ


    WorklistControl プロセス [テスト フォーム] ページ

  4. 表 6-3 に示すように、対応するフィールドにテスト値を入力します。
  5. 表 6-3 WorklistControl プロセスのテスト値
    パラメータ
    TaskName
    John Doe 向け融資
    Name
    John Doe
    SSN
    123-456
    LoanAmt
    20000

  6. [ClientRequest] をクリックし、テスト値を使用してプロセスを実行します。正常に実行されると、[TestForm] タブが更新されます (図 6-17 を参照)。
  7. 図 6-17 WorklistControl JPD の正常な実行


    WorklistControl JPD の正常な実行

  8. 次の URL を使用して、Web ブラウザで Loan_Web プロジェクトの新しいセッションを開始します。
  9. http://localhost:7001/Loan_Web 
  10. 次の資格情報を使用してポータルにログインします。
  11. ユーザ名 : John 
    パスワード : password 

    ユーザ JohnloanOfficer グループに属しており、作成されたタスク インスタンスが John の [担当タスク] ポートレット ボックスに表示されます。

  12. [ログイン] をクリックし、図 6-18 に示すようにユーザ John の [タスク] ホームページを表示します。
  13. 図 6-18 ユーザ John の [タスク] ホームページ


    ユーザ John の [タスク] ホームページ

[担当タスク] ポートレット ボックスにタスク「John Doe 向け融資」が表示されます。コントロールを使用して JPD でタスク インスタンスが作成されたことが確認できます。


  ページの先頭       前  次