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

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

手順 5 : ビジネス プロセスと Worklist の使用

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

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

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

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

 

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

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

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


    新しいプロセスの定義

  6. [終了] をクリックしてプロセスを終了します。

    7. デザイン ビューに新しいビジネス プロセスが表示されます (図 6-2 を参照)。

    図 6-2 新しいプロセスの作成


    新しいプロセスの作成

  7. [ダブルクリックして開始イベントを選択] をダブルクリックします (図 6-2 を参照)。

    8. ノード ビルダが表示されます。

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


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

  11. [一般的な設定] タブで [コードの表示] をクリックし、 
    12. @com.bea.wli.control.broker.MessageBroker.StaticSubscription(xquery = "", filterValueMatch = "", channelName = "", messageBody ="{x0}")
    public void subscription(org.apache.xmlbeans.XmlObject x0) {

    を以下のコードに置き換えます。 

    @com.bea.wli.control.broker.MessageBroker.StaticSubscription(xquery = "", filterValueMatch = "", channelName = "/WorklistEvent", messageBody = "{x0}", messageMetaData = "{x1}")
    public void subscription(com.bea.data.RawData x0, com.bea.wli.worklist.xml.TaskEventMetadataDocument x1) {
  12. [保存] をクリックし、[デザイン] を選択してデザイン ビューに戻ります。
  13. 開始ノードをダブルクリックし、[フィルタの指定] タブで [TaskEventMetadata] xml ツリーから eventType を選択し、フィルタの値として CREATE を入力します。
  14. [データの受信] タブで、次の手順を実行します。
    • RawData x0 の横にある [変数の新規作成] を選択する。[変数を作成] ダイアログ ボックスが表示されたら、[変数名] フィールドに worklistEventData を入力し、そのタイプとして [com.bea.data.RawData] を選択する。
    • xl の横にある [変数の新規作成] をクリックする。[変数を作成] ダイアログ ボックスが表示されたら、[変数名] フィールドに worklistEventMetaData を入力し、そのタイプとして com.bea.wli.worklist.xml.TaskEventMetadataDocument を入力する。
  15. [OK] をクリックして変数名を設定し、開始ノード コンフィグレーションで [閉じる] をクリックしてこの手順を終了します。

 

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

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

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


    実行ノードの追加

  3. ビジネス プロセスの [ソース] タブをクリックして、実行メソッド定義を強調表示します。
  4. 実行メソッドに次のコードを入力します。 
    5. 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());
  5. ビジネス プロセスの先頭部分に次の import 文を入力します。 
    6. import java.io.ByteArrayInputStream; 
    import java.io.ObjectInputStream; 
    import com.bea.wli.worklist.api.events.data.*;
  6. [ファイル｜保管] を選択するか、〔Ctrl〕+〔S〕を使用してファイルを保存します。

Loan_JPD のデプロイ

  1. [パッケージ・エクスプローラー] ペインで以前に作成した [Loan_jpd.java] プロジェクトを右クリックし、[実行｜サーバーで実行] を選択します。

    2. [サーバーで実行] ダイアログ ボックスが表示されます。

  2. [既存のサーバーを選択] を選択し、[選択] から使用するサーバを選択します。リストから [myworklist] サーバを選択し、[次へ] をクリックします。

    3. [プロジェクトの追加および除去] ダイアログ ボックスが表示されます。

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

 

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

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

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


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

  4. [タスクの作成] ポートレットの [/Loan/loan_approval 1.0] オプションをクリックします。[新しいタスク] ページが表示されます。
  5. タスク プラン コンストラクタとして [NewLoan] を選択していることを確認します。
  6. ページの他のフィールドに、表 6-1 に示す詳細を指定します。

    7. 表 6-1 新しい融資承認タスク インスタンスの詳細
    フィールド名
    値
    [タスク名]
    Maggie JPD の自動車ローン
    [ユーザのプロパティ: SSN]
    222-33-4444
    [ユーザのプロパティ: LoanAmt]
    40000
    [ユーザのプロパティ: 名前]
    Maggie JPD

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

Oracle WebLogic Worklist Console にログインすると、ビジネス プロセス インスタンスの作成も検証できます。

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

    5. [ワークリスト タスクの詳細] が表示されます (図 6-6 を参照)。

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


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

 

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

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

ワークリスト ビジネス プロセスの作成

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

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

    4. [終了] をクリックしてプロセスを終了します。

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

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


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

  4. [ダブルクリックして開始イベントを選択] をダブルクリックします (図 6-7 を参照)。

    5. ノード ビルダが表示されます。

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


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

  7. [一般的な設定] タブで [追加] をクリックして、パラメータを定義するダイアログ ボックスを表示します。表 6-2 に示すように 4 つのパラメータを作成し、作成したパラメータのタイプをコンフィグレーションします。

    8. 表 6-2 クライアント要求のパラメータの設定
    パラメータ名
    型
    TaskName
    String
    Name
    String
    SSN
    String
    LoanAmt
    Long

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


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

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

  9. [閉じる] をクリックして続行すると、図 6-10 に示すようにビジネス プロセスが表示されます。
    10. 図 6-10 [Client Request] 開始ノードを使用した WorkListControl プロセス


    [Client Request] 開始ノードを使用した WorkListControl プロセス

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

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

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


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

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


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

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

ビジネス プロセスへのタスク プラン コンストラクタの追加

この節では、ワークリスト ビジネス プロセスにタスク インスタンス作成コンストラクタを追加します。

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


    NewLoan メソッドの選択

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


    NewLoan ノードを使用した WorklistControl プロセス

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


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

  5. [閉じる] をクリックして設定を実装します。
  6. [ファイル｜保管] を選択するか、〔Ctrl〕+〔S〕を使用してビジネス プロセスを保存します。

WorklistControl ビジネス プロセスの検証

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

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


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

  3. 表 6-3 に示すように、対応するフィールドにテスト値を入力します。

    4. 表 6-3 WorklistControl プロセスのテスト値
    パラメータ
    値
    TaskName
    John Doe 向け融資
    Name
    John Doe
    SSN
    123-456
    LoanAmt
    20000

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


    WorklistControl ビジネス プロセスの正常な実行

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

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

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


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

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


  ページの先頭       前  次