BEA
WebLogic
Integration
™
BPM - Workshop
サンプル
ユーザーズ
限定的権利条項
本ソ フ ト ウ ェ アおよびマニ ュ アルは、 BEA Systems, Inc. 又は日本ビー ・ イー ・ エー ・ シ ス テム ズ株式会社 ( 以下、 「BEA」 と いいます ) の使用許諾契約に基づいて提供さ れ、 その内容に同意 する場合にのみ使用する こ と がで き、 同契約の条項通 り にのみ使用ま たはコ ピーする こ と がで き ます。 同契約で明示的に許可 さ れている以外の方法で同 ソ フ ト ウ ェ アを コ ピーする こ と は法 律に違反し ます。 こ のマニ ュ アルの一部ま たは全部を、 BEA Systems, Inc. か ら の書面に よ る事 前の同意な し に、 複写、 複製、 翻訳、 あ る いはいかな る電子媒体ま たは機械可読形式への変換
も行 う こ と はで き ません。
米国政府に よ る使用、 複製 も し く は開示は、 BEA の使用許諾契約、 および FAR 52.227-19 の 「Commercial Computer Software-Restricted Rights」 条項のサブパラ グ ラ フ (c)(1)、 DFARS
252.227-7013 の 「Rights in Technical Data and Computer Software」 条項のサブパ ラ グ ラ フ (c)(1)(ii) 、 NASA FAR 補遺 16-52.227-86 の 「Commercial Computer Software--Licensing」 条項の
サブパ ラ グ ラ フ (d)、 も し く はそれ ら と 同等の条項で定め る制限の対象 と な り ます。 こ のマニ ュ アルに記載さ れてい る内容は予告な く 変更 さ れる こ と があ り 、 ま た BEA に よ る責務 を意味する も のではあ り ません。 本ソ フ ト ウ ェ アおよびマニ ュ アルは 「現状のま ま」 提供さ れ、 商品性や特定用途への適合性を始め と する ( ただ し、 こ れ らには限定 さ れない ) いかな る種類の 保証 も与え ません。 さ ら に、 BEA は、 正当性、 正確さ 、 信頼性な どについて、 本 ソ フ ト ウ ェ ア ま たはマニ ュ アルの使用も し く は使用結果に関し ていかな る確約、 保証、 あ るいは表明も行い ません。
商標または登録商標
BEA、 Jolt、 Tuxedo、 および WebLogic は BEA Systems, Inc. の登録商標です。 BEA Builder、 BEA Campaign Manager for WebLogic、 BEA eLink、 BEA Manager、 BEA WebLogic Commerce Server、 BEA WebLogic Enterprise、 BEA WebLogic Enterprise Platform、 BEA WebLogic Express、 BEA WebLogic Integration、 BEA WebLogic Personalization Server、 BEA WebLogic Platform、BEA WebLogic Portal、BEA WebLogic Server、BEA WebLogic Workshop および How Business Becomes E-Business は、 BEA Systems, Inc の商標です。
その他の商標はすべて、 関係各社が著作権を有し ます。
BEA WebLogic Integration 7.0 サンプルユーザーズガイ ド
パー ト 番号 日付 ソ フ ト ウ ェ アのバージ ョ ン
目次
このマニュアルの内容
対象読者... v e-docs Web サ イ ト ... v こ のマニ ュ アルの印刷方法 ... vi 関連情報...vi サポー ト 情報 ...vi 表記規則...vii1.
概要
相互運用のシナ リ オ...1-1 シナ リ オの実装方法 ...1-3 サンプルでのシナ リ オの実行方法...1-4 WebLogic Integration の イ ン ス タ ン スが 1 つであ る理由...1-122.
サンプルの実行
ワー ク フ ローの設定...2-1 要件 ...2-1 サンプルの設定方法 ...2-2 手順 1: Domain Configuration Wizard を実行する...2-2 手順 2 : WebLogic Server を コ ン フ ィ グ レーシ ョ ンする ...2-7 手順 3 : WebLogic Integration Studio を設定する ...2-10 手順 4 : WebLogic Workshop を設定する ...2-12 手順 5 : Web サービ ス を起動する ...2-14 手順 6 : WebLogic Integration Swing Worklist を設定する ...2-213.
BPM-Workshop
相互運用性プロセス
サンプルの実行 ...3-1
このマニュ アルの内容
こ のマニ ュ アルでは、 WebLogic Integration BPM - Worklist 相互運用性サンプル の使用方法について説明し ます。 こ のマニ ュ アルの内容は以下の と お り です。 第 1 章 「概要」 では、 サンプルに示さ れてい る SOAP over HTTP および XML over HTTP と い う 2 種類の メ ッ セージ交換について説明し ます。 第 2 章 「サンプルの実行」 では、 サンプルを設定および実行する方法につい て説明し ます。 第 3 章 「BPM-Workshop 相互運用性プロ セ ス」 では、 サンプルの実行内容に ついて説明し ます。
対象読者
こ のマニ ュ アルは、 Web サービ ス を使用し て XML ド キ ュ メ ン ト を交換する ユー ザを対象 と し ています。e-docs Web
サイ ト
BEA 製品の ド キ ュ メ ン ト は、 BEA Systems, Inc. の Web サ イ ト で入手で き ます。 BEA のホーム ページで [ 製品の ド キ ュ メ ン ト ] を ク リ ッ ク する か、 ま たは
「e-docs」 と い う 製品 ド キ ュ メ ン ト ページ
Web ブ ラ ウ ザの [ フ ァ イル｜印刷 ] オプシ ョ ン を使用する と 、 Web ブ ラ ウザか ら
こ のマニ ュ アルを一度に 1 フ ァ イルずつ印刷で き ます。
こ のマニ ュ アルの PDF 版は、 WebLogic Integration の Web サ イ ト で入手で き ま す。 PDF を Adobe Acrobat Reader で開 く と 、 マニ ュ アルの全体 ( ま たは一部分 ) を書籍の形式で印刷でき ます。 PDF を表示する には、 WebLogic Integration ド キ ュ メ ン ト のホー ム ページ を開き、 [PDF 版 ] ボ タ ン を ク リ ッ ク し て、 印刷する マニ ュ アルを選択し ます。
Adobe Acrobat Reader がない場合は、 Adobe の Web サ イ ト (http://www.adobe.co.jp/) で無料で入手で き ます。
関連情報
以下の WebLogic Integration ド キ ュ メ ン ト には、 こ の製品の使用に関連し た情報 が含まれています。
WebLogic Integration BPM ユーザーズ ガ イ ド WebLogic Integration Studio ユーザーズ ガ イ ド
サポー ト 情報
WebLogic Integration の ド キ ュ メ ン ト に関する ユーザか ら のフ ィ ー ド バ ッ ク は弊
社に と っ て非常に重要です。 質問や意見などがあれば、 電子 メ ールで
docsupport-jp@beasys.com までお送 り く だ さ い。 寄せられた意見については、 WebLogic Integration の ド キ ュ メ ン ト を作成および改訂する BEA の専門の担当者
本バージ ョ ンの WebLogic Integration Worklist について不明な点があ る場合、 ま たは Worklist の イ ン ス ト ールおよび動作に問題があ る場合は、 BEA WebSupport
(http://websupport.bea.com/custsupp) を通じ て BEA カ ス タマ サポー ト ま でお問い合わせ く だ さ い。 カ ス タ マ サポー ト への連絡方法については、 製品 パ ッ ケージに同梱さ れてい る カ ス タ マ サポー ト カー ド に も記載 さ れています。 カ ス タ マ サポー ト では以下の情報をお尋ねし ますので、 お問い合わせの際はあ ら か じ めご用意 く だ さ い。 お名前、 電子 メ ール ア ド レ ス、 電話番号、 フ ァ ッ ク ス番号 会社の名前 と 住所 お使いの機種 と コー ド 番号 製品の名前 と バージ ョ ン 問題の状況 と 表示さ れ るエ ラー メ ッ セージの内容
表記規則
こ のマニ ュ アルでは、 全体を通し て以下の表記規則が使用 さ れています。 表記法 適用 〔Ctrl〕 + 〔Tab〕 複数のキーを同時に押す こ と を示す。 斜体 強調ま たは書籍の タ イ ト ルを示す。の メ ン バー、 データ 型、 デ ィ レ ク ト リ 、 お よびフ ァ イ ル名 と その 拡張子を示す。 等幅テキ ス ト はキーボー ド か ら 入力する テキ ス ト
も 示す。 例
#include <iostream.h> void main ( ) the pointer psz chmod u+w * \tux\data\ap .doc tux.doc BITMAP float 斜体の等幅テ キスト 例コ ー ド 内の変数を示す。 String expr すべて大文字 のテ キ ス ト デバ イ ス名、 環境変数、 およ び論理演算子を示す。例 LPT1 SIGNON OR {} 構文の中で複数の選択肢を示す。 実際には、 こ の括弧は入力 し な い。 [] 構文の中で任意指定の項目を示す。 実際には、 こ の括弧は入力 し ない。 例
buildobjclient [-v] [-o name ] [-f file-list]...[-l file-list]...
| 構文の中で相互に排他的な選択肢を区切る 。 実際には、 こ の記号
... コ マン ド ラ イ ンで以下のいずれかを示す。 引数を複数回繰 り 返す こ と がで き る 。 任意指定の引数が省略 さ れてい る。 パ ラ メ ー タや値な どの情報を追加入力で き る 。 実際には、 こ の省略記号は入力 し ない。 例
buildobjclient [-v] [-o name ] [-f file-list]...[-l file-list]... . . . コー ド サンプルま たは構文で項目が省略 さ れてい る こ と を示す。 実際には、 こ の省略記号は入力 し ない。 表記法 適用
相互運用のシ ナ リ オ
1
概要
WebLogic Integration BPM ñ Workshop サンプルは、 Web サービ ス と Web ワーク
フ ローの間で XML ド キ ュ メ ン ト 交換に よ る相互呼び出し がどの よ う に行われ る かを示し ます。 こ のサンプルには次の 2 つのシナ リ オが示 さ れています。 Web サービ ス を呼び出し て XML を渡し、 後で Web サービ ス か ら XML を 受け取る ワーク フ ロー ワー ク フ ローを呼び出し て XML を渡し 、 後でワー ク フ ローか ら XML を受 け取る Web サービ ス ま た、 こ のサンプルには次の 2 種類の メ ッ セージ フ ォーマ ッ ト が示 さ れていま す。
HTTP (Hypertext Transfer Protocol protocol) を使用し た SOAP (Simple Object
Access Protocol)。 メ ッ セージ交換は対話的に行われ るか、 非同期応答を伴い ます。 HTTP を使用し た未加工の XML。 メ ッ セージ交換は非対話的に行われます。 注意: BPM - Workshop サンプルは Windows シ ス テ ムでのみ動作し ます。 こ の章の内容は以下の と お り です。 相互運用のシナ リ オ サンプルでのシナ リ オの実行方法
相互運用のシナ リ オ
図 1-1 は、 ワー ク フ ローか ら Web サービ ス を呼び出し て XML メ ッ セージ を渡 し、 後で Web サービ スか ら ワー ク フ ローに XML メ ッ セージ を受け取る方法を 示し てい ます。図1-1 Web サービスを呼び出し て XML を渡し、 後で Web サービスから XML を受け取るワーク フ ロー こ のワー ク フ ローでは、 Web サービ ス を呼び出し て XML ド キ ュ メ ン ト を渡すた めに、 SOAP-HTTP ま たは HTTP-XML を使用し て XML メ ッ セージを渡し ます。 XML メ ッ セージ を受け取っ た Web サービ スは、 ビ ジネス ロ ジ ッ ク の処理を開 始し ます。 その処理途中ま たは処理後に、 Web サービ スは XML ド キ ュ メ ン ト を 含む メ ッ セージを ワーク フ ローに送信し ます。 こ のシナ リ オは非同期の Web サービ スの特徴を表し ています。 ワー ク フ ローは Web サービ ス を イ ン ス タ ン ス化し た後、 ワー ク フ ロー自身の処理を自由に実行 し、 後か ら Web サービ スに応答を要求で き ます。 Web サービ スの各イ ン ス タ ン スは、 サービ ス を呼び出し た ワーク フ ロー イ ン ス タ ン スに XML の結果を返さ な ければな り ません。 注意: 厳密に言 う と 、XML over HTTP のサンプルの Web サービ ス メ ソ ッ ド は、 同期 メ ソ ッ ド です。 こ れは、 HTTP に よ る XML のみのバ イ ン ド をサポー ト する JWS メ ソ ッ ド が空の戻 り 値をサポー ト し ない と い う WebLogic Workshop の特徴に よ る も のです。 そのため、 Workshop JWS 内で非同期 XML/HTTP 専用 メ ソ ッ ド を使用する こ と はでき ません。 サンプルでは、 JWS でダ ミ ーの整数を戻 り 値 と し て返すこ と によ り 、 こ の制限に対処し ています。
相互運用のシ ナ リ オ
シナ リ オの実装方法
図 1-2 に示すよ う に、 仲介 Web サービ ス を使用する こ と で、 ターゲ ッ ト Web サービ スのプ ロ ト コルや メ ッ セージ フ ォーマ ッ ト か ら ワーク フ ローを切 り 離し ています。 図1-2 Web サービスを呼び出し て XML を渡し、 後で Web サービスから XML を受け取るワーク フ ロー 仲介 Web サービ スは、 ターゲ ッ ト Web サービ スか ら受け取った応答 XML が、 元の XML メ ッ セージ を送信し て呼び出し た Web サービ ス イ ン ス タ ン ス と 同一 の イ ン ス タ ン スか ら送信さ れた こ と を保証し ます。 ま た、 ターゲ ッ ト Web サー ビ スか ら、 そのサービ スに元の XML ド キ ュ メ ン ト を渡し た正し い ワーク フ ロー イ ン ス タ ン スへ、 XML の結果を伝達する こ と も保証し ます。 ワー ク フ ローには、 未加工の XML を仲介 Web サービ スに転送し、 後で仲介 Web サービ スか ら XML 応答を受け取る メ カニズムが必要です。 こ れら の XML 転送は両方 と も、 同じ仲介 Web サービ ス イ ン ス タ ン ス と ワー ク フ ロー イ ン ス タ ン スの間で実行 さ れる必要があ り ます。 仲介 Web サービ ス を使用する と 、 ワー ク フ ローは、 SOAP/XML over HTTP イ ン タ フ ェース をサポー ト する必要か ら解 放さ れます。 ワーク フ ローは JMS プ ロ シージ ャおよびコ ンシ ューマ と し て機能 し、 Web サービ スが SOAP/XML メ ッ セージ フ ォーマ ッ ト 変換を処理し ます。サンプルでのシナ リ オの実行方法
前述の と お り 、 こ のサンプルは、 発注書情報を含む XML ド キ ュ メ ン ト を ワー ク フ ローで生成する方法を示し てい ます。 こ のサンプルでは、 SendPO ワー ク フ ローは XML ド キ ュ メ ン ト を使 用し て ProcessPO ワーク フ ローを ト リ ガ し ます。 ProcessPO ワー ク フ ローは最終的に、 発注書情報の処理を完了し た後、 結果の XML ド キ ュ メ ン ト を SendPO ワー ク フ ローに返し ます。 図 1-3 は、 SOAP over HTTP サンプルの相互運用性プロ セ ス を示し ています。 表 1-1 は、 プ ロセ スの詳細です。 図 1-4 は、 XML over HTTP サンプルの相互運用性プロ セ ス を示し ています。 表 1-2 は、 プ ロセ スの詳細です。サ ン プルでのシナ リ オの実行方法 図1-3 ワーク フ ロー と Workshop の対話－ SOAP 注意: 各ス テ ッ プについては、 表 1-1 を参照し て く だ さ い。 図 1-3 に示すよ う に、 ProcessPO ワー ク フ ローは SendPO ワー ク フ ローか ら呼び 出さ れます。 ProcessPO ワー ク フ ローを呼び出し てその応答 XML を非同期に取 得する手段 と し て、 Process PO Web サービ スがデプ ロ イ さ れてい ます。 こ れに
よ り 、 Process PO Web サービ スが ProcessPO ワー ク フ ローを呼び出し てその結 果を受け取る際、SendPO ワーク フ ローは実質的に Process PO Web サービ スの ク
ラ イ アン ト と し て動作する こ と がで き ます。 こ れを可能にする には、 SendPO ワーク フ ローを実行する WebLogic Integration イ ン ス タ ン スか ら、 HTTP 経由で
Process PO Web サービ スにア ク セ スで き る こ と が必要です。
Send PO Web サービ スは、 Process PO Web サービ スの呼び出し と 結果の受信に
関する詳細を処理し ます。 Send PO Web サービ スは、 結果の XML を受け取る と 、 それを SendPO ワーク フ ローに伝達し ます。 SendPO ワーク フ ロー と
ProcessPO ワー ク フ ローは、 HTTP 経由で非同期に XML ド キ ュ メ ン ト を相互に
送信する手段 と し て、 Web サービ ス Send PO および Process PO を使用し ます。 表1-1 SOAP over HTTP サンプルで実行されるシナ リ オのステ ッ プ ステ ッ プ 説明 1 SendPO ワー ク フ ローが Web サービ ス専用の JMS キ ュー (jws.queue) に、 発注書を含む XML ド キ ュ メ ン ト を送信する 。 XML ド キ ュ メ ン ト には SendPO ワー ク フ ロ ーの イ ン ス タ ン ス ID も 含 まれてい る。SendPO Web サービ スは、 応答を返す と き に (ス テ ッ プ 11)、 その イ ン ス タ ン ス ID を WLPIInstanceIDs と い う JMS プ ロ パ テ ィ に割 り 当て る 。 こ れに よ り 次の こ と が保証 さ れ る 。 発注書を送信 し た SendPO ワー ク フ ロ ー イ ン ス タ ン ス が、 応答を 受け取る ワー ク フ ロー イ ン ス タ ン ス と 同一であ る こ と 。 応答が到着し た時点で SendPO ワー ク フ ロ ー イ ベン ト ノ ー ド で あ る Get PO Ack が まだア ク テ ィ ブにな っていない場合で も 、 応 答が受け取 ら れ る こ と 。
2 Send PO Web サービ ス の purchase メ ソ ッ ド には 、発注書 XML ド キ ュ
メ ン ト にマ ッ プ さ れ る パ ラ メ ー タ があ る 。 さ ら に、 こ の メ ソ ッ ド は jws.queue に到着 し た XML メ ッ セージ を処理する 。
注意: JMS コ ン ト ロ ールの受信キ ューは、 非請求 メ ッ セージ を受信 する ためには使用で き ない。 詳細については、WebLogic Workshop のオン ラ イ ン ヘルプで 「JMS コ ン ト ロ ール : Web サービ ス か ら Java Message Service のキ ュー と ト ピ ッ ク を使用 する 」 にあ る 「JMS コ ン ト ロールでサポー ト さ れない メ ッ セージ ン グのシナ リ オ」 を参照。
サ ン プルでのシナ リ オの実行方法
3 Send PO Web サービ ス が発注書 ド キ ュ メ ン ト を Process PO Web サー
ビ ス に送信する 。Send PO Web サービ スは、Process PO の jws フ ァ イ ルを使用し て作成 さ れたサービ ス コ ン ト ロ ールを使用する 。Send PO Web サービ ス と Process PO Web サービ ス は、SOAP フ ォーマ ッ ト の XML メ ッ セージ を HTTP 経由で交換する 。 SOAP メ ッ セージ交換に よ り 、Send PO Web サービ ス と Process PO Web サービ ス が異な る マ シ ン上で動作で き、SendPO ワー ク フ ロー と ProcessPO ワー ク フ ロ ー 間の リ モー ト 通信が可能にな る。Send PO Web サービ ス と Process PO
Web サービ ス間の SOAP メ ッ セージ交換は対話的に行われ、2 つの Web サービ ス間の要求 と 応答の相関を保証する ために、SOAP メ ッ セージ会話 ID が SOAP ヘ ッ ダに格納 さ れ る。 こ のサンプルは 1 台の マシ ンで実行す る こ と も で き る。 4 Process PO Web サービ ス が JMS コ ン ト ロ ールを使用 し て、 発注書 XML ド キ ュ メ ン ト を BPM イベン ト キ ュ ーに入れ る。 こ のキ ュ ーは ProcessPO ワー ク フ ローに よ っ てモニ タ さ れてい る 。JMS メ ッ セージ の JMSCorrelatioID ヘ ッ ダ フ ィ ール ド には、送信 メ ッ セージ を送っ た Process PO Web サービ ス イ ン ス タ ン ス に JMS 応答 メ ッ セージが返 さ れ る こ と を保証する ために、SOAP 会話 ID が格納 さ れてい る。 5 ProcessPO ワー ク フ ローが BPM イベン ト キ ュ ーか ら XML メ ッ セー ジ を取 り 出 し、 処理を開始す る。
6 ProcessPO が WLI Worklist ユーザに タ ス ク を割 り 当て、 発注書の受け
入れを要求する 。
7 ユーザが タ ス ク を実行し 、 発注書を受け入れ る 。
8 ProcessPO ワー ク フ ローが発注承認書 XML メ ッ セージ を BPM 応答
キ ューに入れ る 。 承認書 メ ッ セージのヘ ッ ダ フ ィ ール ド
JMSCorrelationID には、 意図 さ れた Process PO Web サービ ス イ ン ス タ ン ス だけが こ の メ ッ セージ を受け取 る こ と を保証する ために、 SOAP メ ッ セージ会話 ID が格納 さ れてい る。 9 Process PO Web サービ ス には JMS コ ン ト ロールがあ り 、 その コ ン ト ロ ールに よ っ て、BPM 応答キ ューか ら 発注承認書 XML メ ッ セージ が取 り 出 さ れ る 。 ステ ッ プ 説明
10 Process PO Web サービ ス が コ ールバ ッ ク メ ソ ッ ド を呼び出 し、 発注
承認書 メ ッ セージ を SendPO Web サービ ス に転送する 。 前述の と お り 、 いずれかの SOAP over HTTP を使用 し て Web サービ ス間の通信 が行われ る。 11 サービ ス コ ン ト ロ ールの コ ールバ ッ ク が JMS コ ン ト ロールを使用 し て、 発注承認書 XML メ ッ セージ を BPM イ ベン ト キ ュ ーに入れ る 。 12 SendPO ワー ク フ ローが BPM イベン ト キ ュ ーか ら 発注承認書 XML メ ッ セージ を取 り 出す。Send PO ワー ク フ ローの ワー ク フ ロ ー イ ン ス タ ン ス ID が メ ッ セージ ヘ ッ ダに格納 さ れたア ド レ ス指定 メ ッ セージ の受信に よ っ て、Get PO Ack イベン ト ノ ー ド が ト リ ガ さ れ る 。 こ れ に よ り 、 発注書 ド キ ュ メ ン ト を送信 し た ワー ク フ ロー イ ン ス タ ン ス の イ ベン ト ノ ー ド が PO 承認 メ ッ セージの受信で ト リ ガ さ れ る こ と を 保証 し てい る 。
13 SendPO ワー ク フ ローが WebLogic Integration Worklist ユーザに タ ス
ク を割 り 当て、 発注承認書の受け入れを要求する 。
14 ユーザが タ ス ク を実行 し、 発注承認書を受け入れ る。
サ ン プルでのシナ リ オの実行方法 図1-4 ワーク フ ロー と Workshop の対話－ XML 注意: 各ス テ ッ プについては、 表 1-2 を参照し て く だ さ い。 図 1-4 に示すよ う に、 ProcessPO ワー ク フ ローは SendPO ワー ク フ ローか ら呼び 出さ れます。 ProcessPO ワー ク フ ローを呼び出し、 その応答 XML を非同期に取 得する ための手段 と し て、 Process PO Web サービ スがデプ ロ イ さ れています。
こ れに よ り 、 Process PO Web サービ スが ProcessPO ワーク フ ローを呼び出し て その結果を受け取る際、SendPO ワー ク フ ローは実質的に Process PO Web サービ
スの ク ラ イ ア ン ト と し て動作する こ と ができ ます。 こ れを可能にするには、
SendPO ワー ク フ ローを実行する WebLogic Integration イ ン ス タ ン スか ら、HTTP
経由で Process PO Web サービ スにア ク セ スで き る こ と が必要です。
Send PO Web サービ スは、 Process PO Web サービ スの呼び出し と 結果の受信に
関する詳細を処理し ます。 Send PO Web サービ スは、 結果の XML を受け取る と 、 それを SendPO ワーク フ ローに伝達し ます。 SendPO ワーク フ ロー と
ProcessPO ワー ク フ ローは、 HTTP 経由で非同期に XML ド キ ュ メ ン ト を相互に
送信する手段 と し て、 Web サービ ス Send PO および Process PO を使用し ます。 表1-2 XML over HTTP サンプルで実行されるシナリ オのステ ッ プ
ステ ッ プ 説明
1 SendPO ワー ク フ ローが Web サービ ス専用の JMS キ ュー
(jws.queue) に、 発注書を含む XML ド キ ュ メ ン ト を送信する 。 XML ド キ ュ メ ン ト には SendPO ワー ク フ ロ ーの イ ン ス タ ン ス ID も 含 まれてい る。Send PO Web サービ ス が PO Ack 応答を返 し た時点で (ス テ ッ プ 11)、 メ ッ セージ ペ イ ロー ド には 、SendPO ワー ク フ ロ ーの
イ ン ス タ ン ス ID が含まれてい る。SendPO ワー ク フ ロー イ ン ス タ ン ス の Get PO Ack イベン ト ノ ー ド は 、 メ ッ セージ ペ イ ロ ー ド にその イ ン ス タ ン ス ID を含む イベン ト キーを検索す る。
注意: こ の形式の要求 と 応答の相関は、SOAP のサンプル と は異な
る。SOAP のサンプルでは、SendPO ワー ク フ ローの Get PO Ack イ ベン ト ノ ー ド は、 ア ド レ ス指定 メ ッ セージの受信に
よ っ て ト リ ガ さ れ る。
2 Send PO Web サービ ス の sendXMLEvent メ ソ ッ ド には 、発注書 XML ド キ ュ メ ン ト にマ ッ プ さ れ る パ ラ メ ータ があ る。 さ ら に、 こ の メ ソ ッ ド は jws.queue に到着し た XML メ ッ セージ を処理す る。
注意: JMS コ ン ト ロ ールの受信キ ューは、 非請求 メ ッ セージ を受信 する ためには使用で き ない。 詳細については、WebLogic Workshop のオン ラ イ ン ヘルプで 「JMS コ ン ト ロ ール : Web サービ ス か ら Java Message Service のキ ュー と ト ピ ッ ク を使用 する 」 にあ る 「JMS コ ン ト ロールでサポー ト さ れない メ ッ セージ ン グのシナ リ オ」 を参照。
サ ン プルでのシナ リ オの実行方法
3 Send PO Web サービ ス が、Process PO Web サービ ス の onXMLEvent メ ソ ッ ド を呼び出す こ と に よ っ て、Process PO Web サービ ス に発注 書 XML ド キ ュ メ ン ト を送信す る。Send PO Web サービ ス は、Process PO Web サービ ス の jws フ ァ イ ル (WLW2BPM.jws) を使用し て作成 さ れ たサービ ス コ ン ト ロ ールを使用する 。Send PO Web サービ ス と Process PO Web サービ ス は、未加工の XML メ ッ セージ を HTTP 経由 で交換する 。 注意: こ れは SOAP サンプル と は異な る。 SOAP サンプルでは、 2 つの Web サービ スが SOAP メ ッ セージを使 用し て相互 に通信する。 4 Process PO Web サービ ス が JMS コ ン ト ロ ールを使用 し て、 発注書 XML ド キ ュ メ ン ト を BPM イベン ト キ ュ ーに入れ る。 こ のキ ュ ーは ProcessPO ワー ク フ ローに よ っ てモニ タ さ れてい る 。 メ ッ セージ ペ イ ロ ー ド には SendPO ワー ク フ ロ ーの イ ン ス タ ン ス ID が格納 さ れてい る 。 5 ProcessPO ワー ク フ ローが BPM イベン ト キ ュ ーか ら XML メ ッ セー ジ を取 り 出 し、 処理を開始す る。
6 ProcessPO が WebLogic Integration Worklist ユーザに発注書の受け入
れを要求す る タ ス ク を割 り 当て る 。 7 ユーザが タ ス ク を実行し 、 発注書を受け入れ る 。 8 ProcessPO ワー ク フ ローが発注承認書 XML メ ッ セージ を Workshop JMS キ ュー (jws.queue) に入れ る 。 メ ッ セージ ヘ ッ ダには 、 メ ッ セージが JMS キ ュ ーで受信 さ れた と き に呼び出 さ れ る Process PO Web サービ ス メ ソ ッ ド (WLW2BPM.jws の sendPOAck) を識別す る情 報が格納 さ れてい る 。 9 10
Process PO Web サービ ス の sendPOAck メ ソ ッ ド が、Send PO Web サービ ス に対し て定義 さ れてい る サービ ス コ ン ト ロ ール
(BPM2WLWControl.ctrl) を通 し て、Send PO Web サービ ス の sendPOAckメ ソ ッ ド を呼び出す。 前述の と お り 、Process PO Web サービ ス と Send PO Web サービ ス間の メ ッ セージ交換は、HTTP を使 用 し て未加工の XML フ ォーマ ッ ト で行われ る。
WebLogic Integration
のイ ンス タ ンスが
1
つであ
る理由
サンプルは WebLogic Integration の 1 つの イ ン ス タ ン スで実行さ れます。 実際に は、 2 つの イ ン ス タ ン スが HTTP 経由で相互に接続で き る こ と を条件に、
SendPO ワー ク フ ロー と Send PO Web サービ ス を 1 つの イ ン ス タ ン スにデプロ イ
し、 Process PO Web サービ ス と ProcessPO ワー ク フ ローを別の イ ン ス タ ン スに デプ ロ イ でき ます。
サンプルのス テ ッ プを一度に 1 つずつ実行でき る よ う に、 サンプル実行中は
WebLogic Integration Swing Worklist ク ラ イ アン ト を使用し て、 設定 さ れた間隔
の 2 回に 1 回ユーザか ら の入力が取得 さ れます。 Worklist と の対話が果たす機能 は、 ユーザが一度に 1 つのセ ク シ ョ ンの実行を見る こ と ができ る よ う に、 サンプ ルの実行を セ ク シ ョ ンに分割する こ と だけです。 11 Send PO Web サービ ス が JMS コ ン ト ロ ールを使用 し て、 発注承認書 XML メ ッ セージ を BPM イベン ト キ ュ ーに入れ る。 承認書 メ ッ セー ジの メ ッ セージ ペ イ ロ ー ド には SendPO ワー ク フ ローの イ ン ス タ ン ス ID が格納 さ れてい る 。 12 SendPO ワー ク フ ローが BPM イベン ト キ ュ ーか ら 発注承認書 XML メ ッ セージ を取 り 出す。Get PO Ack イベン ト ノ ー ド は 、 イベン ト キー値式を使用し て、 それ自身 と 同 じ ワー ク フ ロ ー イ ン ス タ ン ス ID を含む メ ッ セージだけを受け入れ る 。
13 SendPO ワー ク フ ローが WebLogic Integration Worklist ユーザに発注 承認書の受け入れを要求す る タ ス ク を割 り 当て る 。
14 ユーザが タ ス ク を実行 し、 発注承認書を受け入れ る。
ワー ク フ ロ ーの設定
2
サンプルの実行
ワーク フ ローの設定
こ の章では、 BEA WebLogic Integration BPM と WebLogic Workshop の相互運用 性サンプルの実行方法を説明し ます。
要件
注意: こ のサンプルを実行するには、 標準イ ン ス ト ール オプシ ョ ン を使用し て WebLogic Platform SP2 を イ ン ス ト ール し てお く 必要があ り ます。 カ ス タ ム イ ン ス ト ールでは、 サンプルで使用する Platform Domain は イ ン ス ト ール さ れません。 詳細については、 『WebLogic Platform の イ ン ス ト ー ル』 (http://edocs.beasys.co.jp/e-docs/platform/docs70/install/index.html) を 参照し て く だ さ い。サンプルを実行するには、 WebLogic Integration および WebLogic Workshop に関 する基本知識が必要です。 以下の概念に精通し ている必要があ り ます。 HTTP ま たは JMS をサポー ト する Web サービ スの作成 Web サービ スでのサービ ス コ ン ト ロールま たは JMS コ ン ト ロールの 使用 Web サービ スへの対話サポー ト の追加 詳細については、 WebLogic Workshop のマニ ュ アル (http://edocs.beasys.co.jp/e-docs/workshop/docs70/index.html) および 『BPM ユーザーズ ガ イ ド』 (http://edocs.beasys.co.jp/e-docs/wli/docs70/bpmtutor/index.htm) を参照し て く だ さ い。
サンプルの設定方法
サンプルを設定する には、 次の手順を実行し ます。
手順
1: Domain Configuration Wizard
を実行する
注意: WLW_BPM ド メ イ ン を作成済みの場合は、 2-7 ページの 「手順 2 :
WebLogic Server を コ ン フ ィ グ レーシ ョ ンする」 に進んで く だ さ い。 1. [ス ター ト ｜プ ロ グ ラ ム｜ BEA WebLogic Platform 7.0 ｜ Domain
Configuration Wizard] を選択し、 Domain Configuration Wizard を起動し ます。 2. Configuration Wizard が実行中の状態になっ た後、 図 2-1 に示すよ う に、
Platform Domain テンプレー ト を選択し ます。
ワー ク フ ロ ーの設定
4. [サーバ タ イ プを選択 ] ウ ィ ン ド ウで [Single Server] を選択し、 [Next] を ク
リ ッ ク し ます。 5. [ド メ イ ンの場所を選択 ] ウ ィ ン ド ウ で、 WLW_BPM ド メ イ ンの場所 と し て 以下のデ ィ レ ク ト リ を指定し、 [Next] を ク リ ッ ク し ます。 BEA_HOME\user_projects\ こ の指定に よ っ て BEA_HOME\user_projects\WLW_BPMデ ィ レ ク ト リ が作成 さ れます。 6. 図 2-2 に示すよ う に、 [ ス タ ンド アロ ン / 管理サーバのコ ンフ ィ グレ ーショ ン ] ウ ィ ン ド ウ でデフ ォル ト 値を選択し、 [Next] を ク リ ッ ク し ます。 図2-2 ス タ ン ド アロン/管理サーバのコ ン フ ィ グレーシ ョ ン 7. [管理ユーザを作成 ] ウ ィ ン ド ウ ( 図 2-3) で、 ユーザ名 と パス ワー ド を入力 し、 [Next] を ク リ ッ ク し ます。
図2-3 管理ユーザを作成 8. [データベース メ ール セ ッ シ ョ ンの コ ン フ ィ グ レーシ ョ ン ] ウ ィ ン ド ウ で、 電子 メ ールのア ド レ ス と ホ ス ト を入力し、 [Next] を ク リ ッ ク し ます。 注意: こ のサンプルでは、 ワー ク フ ローか ら 電子 メ ールは送信 さ れません。 し か し、 先に進むには こ の情報を入力する必要があ り ます。 9. Windows のみ : [ サーバの [ ス ター ト ] メ ニ ュー エン ト リ を作成 ] ウ ィ ン ド ウ で、 目的の ラ ジオ ボ タ ン を選択し、 [Next] を ク リ ッ ク し ます。 不確かな場合 は [No] を選択し ます。
ワー ク フ ロ ーの設定
図2-4 サーバの [ス ター ト ] メ ニューエン ト リ を作成
10. [コ ン フ ィ グ レーシ ョ ンの概要 ] ウ ィ ン ド ウ ( 図 2-5) で、 [Create] を ク リ ッ ク
図2-5 コ ン フ ィ グレーシ ョ ンの概要
11. [コ ン フ ィ グ レーシ ョ ン ウ ィ ザー ド が完了し ま し た ] ウ ィ ン ド ウ ( 図 2-6) で、 [コ ン フ ィ グ レーシ ョ ン を終了し ます ] ラ ジオ ボ タ ンが選択さ れてい る こ と
ワー ク フ ロ ーの設定 図2-6 コ ンフ ィ グレーシ ョ ンウ ィ ザー ド完了
手順
2 : WebLogic Server
を コ ン フ ィ グレーシ ョ ンする
1. 以下を実行し て WebLogic Server を起動し ます。 BEA_HOME\user_projects\WLW_BPM\startWebLogic.cmd サーバが起動開始し、 Pointbase データベースが作成 さ れます ( データベース の作成は、 新し い ド メ イ ンのサーバを最初に起動し た場合にのみ実行 さ れま す )。 2. データベースが作成 さ れた後、 コ マン ド ラ イ ンでユーザ名 と パス ワー ド の入力を求め られます。 Domain Configuration Wizard で作成し たユーザ名 と パス ワー ド を入力し ます。
3. 起動プ ロ セスの終わ り に、 コ マン ド ラ イ ンで ク レ ジ ッ ト カー ド の暗号化 / 暗
号化解除キーを作成するかど う か確認を求め られます。 「y」 と 入力し ます。 「< サーバが RUNNING モー ドで起動し ま し た >」 と い う 行が表示 さ れる ま で待ってか ら、 次の手順に進みます。
注意: JMS 応答キ ューを以前に作成済みの場合は、 2-10 ページの 「手順 3 : WebLogic Integration Studio を設定する」 に進みます。
4. サーバが実行中であ る こ と が コ マン ド ラ イ ンに表示さ れた後、 次のよ う に し
て JMS 応答キ ューを作成し ます。
a. ブ ラ ウ ザを開き、 次の URL を入力し ます。 http://localhost:7501/console
WebLogic Server Administration Console が開き ます。
b. Domain Configuration Wizard で作成し たユーザ名 と パス ワー ド を入力し、 [サ イ ン イ ン ] を ク リ ッ ク し ます。 図 2-7 に示す WebLogic Server ホーム
ページが表示 さ れます。
図2-7 WebLogic Server Administration Console
c. 左ペイ ンで、 [WLW_BPM ｜サービ ス｜ JMS ｜サーバ ] の順に ノ ー ド を
ワー ク フ ロ ーの設定 図2-8 WLIJMSServer e. [送 り 先の コ ン フ ィ グ レーシ ョ ン ] を ク リ ッ ク し ます。 [JMS 送 り 先 ] ペー ジが表示さ れます。 f. [新 し い JMSQueue のコ ン フ ィ グ レーシ ョ ン ] を ク リ ッ ク し ます。 図 2-9 に示す [ 新し い JMSQueue の作成 ] ページが表示 さ れます。 図2-9 新しい JMSQueue の作成
g. [名前 ] フ ィ ール ド に 「WLW_BPM_EVENT_RESPONSE」 と 入力し ます。 h. [JNDI 名 ] フ ィ ール ド に 「com.bea.wli.bpm.WLWResponseQueue」 と 入
力し ます。
i. [作成 ] を ク リ ッ ク し ます。 新し い送 り 先がツ リ ーの [サーバ \WLIJMSSERVER\送り先] デ ィ レ ク ト リ の下に表示さ れます。
手順
3 : WebLogic Integration Studio
を設定する
1. [ス ター ト ｜プ ロ グ ラ ム｜ BEA WebLogic Platform 7.0 ｜ WebLogic Integration 7.0｜ Studio] を選択し て、 Studio を起動し ます。
2. 次の よ う に指定し て Studio に ロ グ イ ン し ます ( 図 2-10 を参照 )。 [ユーザ名 ]: wlisystem [パス ワー ド ]: wlisystem [サーバ URL]: t3://localhost:7501 注意: 使用する ポー ト 番号が、 Domain Wizard で選択し たポー ト 番号 と 同じ であ る こ と を確認し て く だ さ い。
図2-10 図 4-1: WebLogic Integration Studio へのログオン
ワー ク フ ロ ーの設定 削除するには、 [ オーガニゼーシ ョ ン ] ツ リ ーで個々のテンプレー ト 定義を右ク リ ッ ク し、 ポ ッ プア ッ プ メ ニ ューか ら [ 削除 ] を選択し ま す。 その後、 手順 4 に進みます。 a. Studio の メ ニ ューか ら [ コ ン フ ィ グ レーシ ョ ン｜オーガニゼーシ ョ ン ] を 選択し ます。 [ オーガニゼーシ ョ ン を定義 ] ウ ィ ン ド ウ が表示 さ れます。 b. [追加 ] を ク リ ッ ク し、 「BPMWLW」 と い う オーガニゼーシ ョ ン を作成し ます。 c. [オーガニゼーシ ョ ン を定義 ] ウ ィ ン ド ウ が表示さ れた ら、 BPMWLW オーガニゼーシ ョ ン を選択し、 [ 閉じ る ] を選択し ます。 4. Studio の [ オーガニゼーシ ョ ン ] ド ロ ッ プダ ウ ン リ ス ト か ら BPMWLW を選 択し ます。 5. 次の よ う に BPM_WLW ワー ク フ ローを イ ンポー ト し ます。 a. Studio の メ ニ ューか ら [ ツール｜パ ッ ケージを イ ンポー ト ] を選択し ま す。 b. SOAP over HTTP サンプルを設定する場合は、 BEA_HOME/weblogic700/samples/integration/samples/BPM-WLW/wor kflowsデ ィ レ ク ト リ か ら bpmwlwsoaphttp.jarを イ ンポー ト し ます。 XML over HTTP サンプルを設定する場合は、 BEA_HOME/weblogic700/samples/integration/samples/BPM-WLW/wor kflowsデ ィ レ ク ト リ か ら bpmwlwxmlhttp.jar フ ァ イルを イ ンポー ト し ます。
こ の BEA_HOMEは、 WebLogic Platform のホーム デ ィ レ ク ト リ です。
c. [イ ンポー ト : イ ンポー ト する コ ンポーネン ト を選択 ] ウ ィ ン ド ウ で、 す べての コ ンポーネン ト が選択さ れてい る こ と 、 および [ イ ンポー ト 後に ワー ク フ ローを ア ク テ ィ ブ化 ] チェ ッ ク ボ ッ ク スがチェ ッ ク さ れてい る こ と を確認し、 [ イ ンポー ト ] を選択し ます。 注意: 既存のテ ンプレー ト 定義 と イベン ト キーを上書きするかど う か確認 する メ ッ セージが表示 さ れた ら、 [ すべてはい ] を ク リ ッ ク し ます。 こ れに よ り 、 以前に実行し たサンプルのテ ンプレー ト 定義が新し い定 義で上書き さ れます。
図2-11 イ ンポー ト する コ ンポーネン ト を選択 d. [イ ンポー ト 概略を確認 ] ウ ィ ン ド ウ で、 [ 閉じ る ] を ク リ ッ ク し ます。 テ ンプレー ト が [ オーガニゼーシ ョ ン ] ツ リ ーに表示 さ れます。
手順
4 : WebLogic Workshop
を設定する
1. サンプルの jar フ ァ イ ルを次の よ う に圧縮解除し ます。 a. SOAP over HTTP サンプル － BEA_HOME\weblogic700\samples\integration\samples\BPM-WLW\lib \wlw_bpm_soap.jarフ ァ イ ルを BEA_HOME\user_projects\WLW_BPM\applicationsデ ィ レ ク ト リ に圧縮 解除し ます。 wlw_bpm_soapデ ィ レ ク ト リ が作成 さ れます。 こ のデ ィ レ ク ト リ には BPM2WLW.jwsフ ァ イル と WLW2BPM.jwsフ ァ イ ルが入っています。ワー ク フ ロ ーの設定 b. XML over HTTP サンプル － BEA_HOME\weblogic700\samples\integration\samples\BPM-WLW\lib \wlw_bpm_xml.jarフ ァ イ ルを BEA_HOME\user_projects\WLW_BPM\applicationsデ ィ レ ク ト リ に圧縮 解除し ます。 wlw_bpm_xmlデ ィ レ ク ト リ が作成 さ れます。 こ のデ ィ レ ク ト リ には BPM2WLW.jwsフ ァ イ ル と WLW2BPM.jwsフ ァ イ ルが入っ てい ます。 2. [ス ター ト ｜プロ グ ラ ム｜ BEA WebLogic Platform 7.0 ｜ WebLogic
Workshop｜ WebLogic Workshop] を選択し て、 WebLogic Workshop を起動
し ます。 Workshop の ウ ィ ン ド ウ が表示 さ れます。 注意: サンプルをすでに実行し た こ と があ る場合は、 Workshop で自動的に プ ロ ジ ェ ク ト が開始 さ れ、 サーバが起動し ます。 [ フ ァ イ ル ] メ ニューか ら [ プ ロ ジ ェ ク ト を閉じ る ] を選択し ます。 手順 5 に進みま す。 3. Workshop の メ ニ ューで、 [ ツール｜プ リ フ ァ レ ン ス｜パス ] を選択し 、 次の よ う に設定し ます。 a. [コ ン フ ィ グ レーシ ョ ン デ ィ レ ク ト リ ] を 「BEA_HOME\user_projects」 に設定し ます。 b. その他のパラ メ ータ を次の よ う に設定し ます。 [名前 ]: localhost [ポー ト ]: 7501 [ ド メ イ ン ]: WLW_BPM c. [OK] を ク リ ッ ク し ます。
図2-12 パス情報の設定 4. [OK] を ク リ ッ ク し ます。 [ プ リ フ ァ レ ン ス ] ウ ィ ン ド ウが閉じ ます。 5. Workshop の メ ニューか ら [ フ ァ イ ル｜プ ロ ジ ェ ク ト を開 く ] を選択し ます。 6. [プ ロ ジ ェ ク ト を開 く ] ウ ィ ン ド ウで、wlw_bpm_soap ま たは wlw_bpm_xml プ ロ ジ ェ ク ト を選択し、 [ 開 く ] を ク リ ッ ク し ます。
手順
5 : Web
サービスを起動する
1. 次の よ う に Send PO Web サービ ス (BPM2WLW.jws) を起動し ます。 のプ ロ ジ ェ ク ト ツ リ ーで、 フ ォルダを開き ます。ワー ク フ ロ ーの設定
b. BPM2WLW.jws ノ ー ド を ダブル ク リ ッ ク し ます。 Send PO Web サービ スが
右ペイ ンに表示 さ れます。図 2-13 (SOAP over HTTP) ま たは図 2-14 (XML
over HTTP) を参照し て く だ さ い。
図2-14 Send PO Web サービス－ XML over HTTP c. [デバ ッ グ ] メ ニ ューか ら [ 開始 ] を選択 し ます。 Workshop の画面左下に 「ビル ド を開始し ま し た」 と い う メ ッ セージが表示 さ れます。 ビル ド 完了 後、 メ ッ セージは 「サービ ス を実行中」 に変わ り ます。 次に、 ブ ラ ウザ ウ ィ ン ド ウが開き、 Send PO Web サービ ス (BPM2WLW.jws) のテ ス ト フ ォームが表示さ れます。図 2-15 (SOAP over HTTP) ま たは図 2-16 (XML over HTTP) を参照し て く だ さ い。
ワー ク フ ロ ーの設定
図2-15 Send PO Web サービス－ SOAP over HTTP
図2-16 Send PO Web サービス－ XML over HTTP
d. Workshop のプ ロ ジ ェ ク ト ツ リ ーで、wlw2bpmフ ォルダを開き、
注意: Process PO Web サービ ス (WLW2BPM.jws) がまだ実行中でない場合は、 [デバ ッ グ ] メ ニ ューで [ 開始 ] を選択し ます。 Workshop の画面左下 に 「ビル ド を開始し ま し た」 と い う メ ッ セージが表示さ れます。 ビル ド 完了後、 メ ッ セージは 「サービ ス を実行中」 に変わ り ます。 次に、 ブ ラ ウ ザ ウ ィ ン ド ウ が開き、 Process PO Web サービ スのテ ス ト フ ォームが表示さ れます。 図 2-19 (SOAP over HTTP) ま たは図 2-20 (XML over HTTP) を参照し て く だ さ い。
ワー ク フ ロ ーの設定
図2-18 Process PO Web サービス－ XML over HTTP
e. Process PO Web サービ ス (WLW2BPM.jws) のテ ス ト フ ォーム を表示するに は、 ブ ラ ウザに次の URL を入力し ます。 SOAP over HTTP: http://localhost:7501/wlw_bpm_soap/wlw2bpm/WLW2BPM.jws?.EXPL ORE=.TEST XML over HTTP: http://localhost:7501/wlw_bpm_xml/wlw2bpm/WLW2BPM.jws?.EXPLO RE=.TEST
図 2-19 は、 SOAP over HTTP のテ ス ト フ ォーム、 図 2-20 は XML over
図2-19 Process PO Web サービス－ SOAP over HTTP
図2-20 Process PO Web サービス－ XML over HTTP
注意: WebLogic Workshop の詳細については、WebLogic Workshop オン ラ イ ン
ヘルプで以下の ト ピ ッ ク を参照し て く だ さ い。
「Web サービ ス構築ガ イ ド 」 の 「コ ン ト ロール : Web サービ スか ら リ
ワー ク フ ロ ーの設定 「Web サービ ス構築ガ イ ド 」 の 「コ ン ト ロール : Web サービ スか ら リ ソース を使用する」 にあ る 「サービ ス コ ン ト ロール : 他の Web サー ビ ス を使 用する」 「Web サービ ス構築ガ イ ド 」 の 「会話を使用し て ス テー ト を保持す る」 「Web サービ ス構築ガ イ ド 」 の 「非同期性を利用し て長時間の処理を 実現する」 にあ る 「コールバ ッ ク を使用し て イ ベン ト の ク ラ イ アン ト に通知する」 「WebLogic Workshop リ フ ァ レ ン ス」 の 「ク ラ ス リ フ ァ レ ン ス」 にあ る 「JwsContext Interface」
手順
6 : WebLogic Integration Swing Worklist
を設定する
1. 以下を実行し て Swing Worklist ク ラ イ ア ン ト を起動し ます。 BEA_HOME\weblogic700\integration\bin\worklist_swing.cmd 2. 次の よ う に指定し て Worklist に ロ グオン し ます [ユーザ名 ]: wlisystem [パス ワー ド ]: wlisystem [サーバ URL]: t3://localhost:7501 Worklist が開き、 「ワー ク リ ス ト には保留中の タ ス ク はあ り ません。」 と い う メ ッ セージが表示さ れます。 3. [了解 ] を ク リ ッ ク し て メ ッ セージ を閉じ ます。 以上でサンプルの設定は完了です。 4. 第 3 章 「BPM-Workshop 相互運用性プロ セ ス 」 に進み、 サンプルの実行を完 了し ます。
サ ン プルの実行
3
BPM-Workshop
相互運用性プロ
セス
こ の章では、 相互運用性プ ロ セ スの完了に必要な手順、 および WebLogic Integration BPM - Workshop 相互運用性サンプルで交換 さ れる メ ッ セージについ て説明し ます。サンプルの実行
サンプルを実行するには、 以下の手順を実行し ます。 1. 図 3-1 に示すよ う に、 Worklist の [ オーガニゼーシ ョ ン ] ド ロ ッ プダ ウ ン リ ス ト か ら BPMWLW を選択し ます。 図3-1 Worklist でのオーガニゼーシ ョ ンの選択 2. [ワー ク フ ロー ] メ ニ ューか ら [ ワー ク フ ローを開始 ] を選択し ます。 図 3-2 に示す [ ワー ク フ ローを開始 ] ウ ィ ン ド ウ が表示 さ れます。図3-2 ワーク フ ローの開始 3. 選択し たオーガニゼーシ ョ ンが BPMWLW であ る こ と を確認し ます。 4. SendPO ワー ク フ ローを選択し 、 [OK] を ク リ ッ ク し ます。 ワー ク フ ローが開 始し た こ と を示す メ ッ セージ ボ ッ ク スが表示さ れます。 5. メ ッ セージ ボ ッ ク スで [ 了解 ] を選択し ます。 Worklist で SendPO ワー ク フ ローを開始する と 、 ワーク フ ローは次のいずれ かの URI を使用し て PO XML メ ッ セージ を jws.queue JMS キ ューに送信 し ます。
SOAP over HTTP: wlw_bpm_soap/bpm2wlw/BPM2WLW.jws.
XML over HTTP: wlw_bpm_xml/bpm2wlw/BPM2WLW.jws
SOAP over HTTP サンプルでは、 SendPO Web サービ スが PO を受信し 、 次
に purchase メ ソ ッ ド を起動し ます。 purchase メ ソ ッ ド は
WLW2BPMControl.sendXMLrequest メ ソ ッ ド を呼び出し、 次に、 その メ ソ ッ
ド が BPMControl.sendXMLrequest メ ソ ッ ド を呼び出し ます。 BPMControl.sendXMLEvent メ ソ ッ ド 呼び出し に よ り 、 PO が com.bea.wli.bpm.EventQueue JMS キ ューに入れ られます。
XML over HTTP サンプルでは、 Send PO Web サービ スが PO を受信し、 次
に sendXMLEvent メ ソ ッ ド を起動し ます。BPM2WLW.sendXMLEvent メ ソ ッ ド
サ ン プルの実行 次に、 ProcessPO ワー ク フ ローの開始 ノ ー ド は、 キ ューか ら PO を取 り 出 し、 その コ ンテン ツ を変数に抽出し ます。 ProcessPO ワーク フ ローの Approve PO ノ ー ド は、 タ ス ク を wlisystem ユーザに割 り 当て、 ユーザが Worklist で タ ス ク を実行する まで待機し ます。 図 3-3 を参照し て く だ さ い。 図3-3 Approve PO ワーク フ ロー ノ ー ド でのユーザへのタ スクの割り当て 6. タ ス ク を実行するには、 Approve PO タ ス ク をダブル ク リ ッ ク し ます。 Approve PO ノ ー ド が開き、 図 3-4 に示すよ う に、 PO の承認を求める ウ ィ ン ド ウ が表示 さ れます。 図3-4 [Approve PO] ウ ィ ン ド ウ 7. [はい ] を ク リ ッ ク する と タ ス ク が承認 さ れます。 こ の質問に対する コール バ ッ ク ア ク シ ョ ンに よ り 、 Approve PO ノ ー ド に完了マー ク が付き ます。 SOAP over HTTP サンプルでは、 以下の処理が実行さ れます。
す。 WLW2BPM Web サービ ス内の BPMControlコ ン ト ロールがキ ューか ら POAck メ ッ セージ を取 り 出し、 WLW2BPM Web サービ ス内の BPM_onXMLresponseコールバ ッ ク ハン ド ラ を起動し ます。 こ のコール バ ッ ク ハン ド ラは onXMLresponseハン ド ラ を呼び出し ます。 呼び出さ れ た onXMLresponseハン ド ラは、 POAck メ ッ セージを com.bea.wli.bpm.EventQueue JMS キ ューに送信 し ます。
SendPO ワー ク フ ローの Get PO Ack ノ ー ド では、 POAck メ ッ セージを取
得し、 実行を Notify PO Ack ノ ー ド に進めます。 Notify PO Ack ノ ー ド で は、 Notify PO Ack タ ス ク を Worklist に割 り 当て ます。 図 3-5 を参照し て
く だ さ い。 XML over HTTP サンプルでは、 以下の処理が実行 さ れます。 ワーク フ ローは Ack PO ノ ー ド に進みます。 こ の ノ ー ド では、 POAck XML メ ッ セージ を jws.queueに送信し ます。 POAck XML メ ッ セージ は、 SendPO ワーク フ ローの イ ン ス タ ン ス ID を メ ッ セージのペイ ロー ド に追加し ます。 メ ッ セージには 「URI」 ヘ ッ ダ も あ り 、 こ のヘ ッ ダには wlw_bpm_xml/wlw2bpm/WLW2BPM.jwsが指定 さ れてい ます。 そのため、 POAck XML メ ッ セージに よ って WLW2BPM Web サービ スが呼び出 さ れます。 WLW2BPM Web サービ スは POAck メ ッ セージ を キ ューか ら取 り 出し、 WLW2BPM.sendPOAck メ ソ ッ ド を ト リ ガ し ます。WLW2BPM.sendPOAck メ ソ ッ ド は、 BPM2WLW コ ン ト ロールの sendPOAck メ ソ ッ ド を呼び出し、 PO 番号を渡し ます。 sendPOAck メ ソ ッ ド は、 未加工の XML メ ッ セージ を HTTP 経由で BPM2WLW Web サービ スに送信し ます。 BPM2WLW Web サービ スは、 承認を受信する と 、 POAck メ ッ セージを com.bea.wli.bpm.EventQueue JMS キ ューに送信し ます。 SendPO ワー ク フ ローには、 POAck メ ッ セージ ペイ ロー ド 内の イ ン ス タ ン ス ID を検索する イ ベン ト キーがあ り ます。 該当する イ ン ス タ ン ス ID がキー値式に含まれ る イベン ト が イ ベン ト キ ューに到着する と 、 その イ ン ス タ ン スが Get PO Ack ノ ー ド を ト リ ガ し ます。 その結果、 POAck メ ッ セージが取得 さ れ、 実行は Notify PO Ack ノ ー ド に進みます。 こ の ノ ー ド では、 Notify PO Ack タ ス ク を Worklist に割 り 当て ます。 図 3-5 を 参照し て く だ さ い。
サ ン プルの実行 図3-5 Notify PO Ack ワーク フ ロー ノ ー ド でのユーザへのタ スクの割り当て 8. Notify PO Ack タ ス ク を ダブル ク リ ッ ク し て タ ス ク を実行し ます。 タ ス ク が Worklist か ら消え、 実行は停止 ノ ー ド に進みます。 こ れでサンプルは終了で す。 9. Web サービ ス間で渡 さ れる メ ッ セージを表示するには、 次の URL を使用し ます。 SOAP over HTTP: http://localhost:7501/wlw_bpm_soap/wlw2bpm/WLW2BPM.jws?.EXPL ORE=.TEST http://localhost:7501/wlw_bpm_soap/bpm2wlw/BPM2WLW.jws?.EXPL ORE=.TEST XML over HTTP: http://localhost:7501/wlw_bpm_xml/wlw2bpm/WLW2BPM.jws?.EXPLO RE=.TEST http://localhost:7501/wlw_bpm_xml/bpm2wlw/BPM2WLW.jws?.EXPLO RE=.TEST
注意: メ ッ セージ ロ グが空の場合は、[Web Service] ページの [Message Log]
セ ク シ ョ ンで [Refresh] を ク リ ッ ク し ます。
10. メ ッ セージ を表示する には、 [Message Log] の メ ッ セージを ク リ ッ ク し ます。
サ ン プルの実行
図3-8 Send PO Web サービスのメ ッ セージ ログ－ XML over HTTP
索引
D
Domain Configuration Wizard 2-2
E
e-docs Web サ イ ト v
S
Swing Worklist ク ラ イ アン ト 2-21
W
WebLogic Integration Studio、 設定 2-10 WebLogic Server の コ ン フ ィ グ レーシ ョ ン 2-7 WebLogic Workshop オン ラ イ ン ヘルプの ト ピ ッ ク 2-20 Web サービ スの起動 2-14
い
印刷、 製品のマニ ュ アル vi イ ン ス タ ン スが 1 つであ る理由 1-12か
カ ス タ マ サポー ト 情報 vi 関連情報 viさ
サンプル、 設定 2-1 サンプルに示さ れてい る シナ リ オ 1-1 サンプルに示さ れてい る メ ッ セージせ
設定WebLogic Integration Studio 2-10 WebLogic Server 2-7 Worklist 2-21 相互運用性サンプル 2-1
![図 2-3 管理ユーザを作成 8. [ データベース メ ール セ ッ シ ョ ンの コ ン フ ィ グ レーシ ョ ン ] ウ ィ ン ド ウ で、 電子 メ ールのア ド レ ス と ホ ス ト を入力し、 [Next] を ク リ ッ ク し ます。 注意 : こ のサンプルでは、 ワー ク フ ローか ら 電子 メ ールは送信 さ れません。 し か し、 先に進むには こ の情報を入力する必要があ り ます。 9](https://thumb-ap.123doks.com/thumbv2/123deta/8723761.963654/26.892.248.821.134.709/ユーザデータベースールレーシールスサンプルワーール.webp)
![図 2-11 イ ンポー ト する コ ンポーネン ト を選択 d. [ イ ンポー ト 概略を確認 ] ウ ィ ン ド ウ で、 [ 閉じ る ] を ク リ ッ ク し ます。 テ ンプレー ト が [ オーガニゼーシ ョ ン ] ツ リ ーに表示 さ れます。 手順 4 : WebLogic Workshop を設定する 1](https://thumb-ap.123doks.com/thumbv2/123deta/8723761.963654/34.892.241.842.120.625/インポーンポーネンンポーンプレーオーガニゼーシ.webp)
![図 2-12 パス情報の設定 4. [OK] を ク リ ッ ク し ます。 [ プ リ フ ァ レ ン ス ] ウ ィ ン ド ウが閉じ ます。 5. Workshop の メ ニューか ら [ フ ァ イ ル｜プ ロ ジ ェ ク ト を開 く ] を選択し ます。 6](https://thumb-ap.123doks.com/thumbv2/123deta/8723761.963654/36.892.253.781.133.783/スィンドウ閉じますWorkshopメニュールジェクト.webp)
