Data Integration ソ フ ト ウ ェ アには、WebLogic Integration 内での Business Process
Management (BPM) の統合を理解する ために設計さ れた 2 つのサンプル アプ リ
ケーシ ョ ンが含まれています。 こ の節では、 こ の 2 つのサンプルに基づき アプ リ ケーシ ョ ンの実行について段階的に説明し ます。 説明する ト ピ ッ ク は以下の と お
り です。
前提条件
サーブレ ッ ト サンプルの実行
EJB サンプルの実行
前提条件
こ の節の説明は、 WebLogic Integration について、 特に Data Integration と WebLogic Integration プ ロ セス エンジンについて理解さ れてい る こ と を前提 と し て書かれています。 また、 サンプル アプ リ ケーシ ョ ン を実行する ためには、
WebLogic Integration を正し く イ ンス ト ールし、 サンプル ワー ク フ ローを実行し てお く 必要があ り ます。
サーブレ ッ ト サンプルの実行
こ のサン プル アプ リ ケーシ ョ ンでは、 サーブレ ッ ト を イ ンス ト ールする Web
と に よ っ て応答し ます。 さ ら に、 アプ リ ケーシ ョ ンはデータ を XML 形式ま たは バイ ナ リ 形式のいずれかで WebLogic Integration イベント ト ピ ッ ク にポ ス ト さ れ ます。 こ のデータ を使用し て ワー ク フ ローを開始で き ます。
サーブレ ッ ト サンプルの内容
サーブレ ッ ト サンプル アプ リ ケーシ ョ ンは WebLogic Integration イ ン ス ト ール の SAMPLES_HOME\integration\samples\di\wlpiデ ィ レ ク ト リ に格納さ れま す。SAMPLES_HOMEは WebLogic Platform イ ン ス ト ールにおけ るサン プル デ ィ レ
ク ト リ です。 次の表では、 サーブレ ッ ト サンプル アプ リ ケーシ ョ ンに含まれる フ ァ イルについて説明し ています。
表3-1 サーブ レ ッ ト サンプルアプ リ ケーシ ョ ン フ ァ イル
デ ィ レ ク ト リ フ ァ イル 説明
\wlpi\source WLPI_sample.java HTML フ ァ イ ルを画面に表示する 、 お よびバ イ ナ リデータ を XML に変換する ためのサーブ レ ッ
ト の ソ ース コー ド 。 こ の XML は、 オプシ ョ ン と し て JMS ト ピ ッ ク 上に置 く こ と も で き る。
\wlpi SampleData.mfl サンプル ワー ク フ ロ ーの開始に使用す る サンプ
ルバ イ ナ リ デー タ フ ァ イ ルの メ ッ セージ フ ォー マ ッ ト言語に よ る記述。
\wlpi SampleData.data サンプル ワー ク フ ロ ーの開始時に イ ンプ ッ トと し て使用 さ れたサンプルデー タ フ ァ イ ル。
\wlpi DI_ServletSample.jar サンプルで使用 さ れ る、 エ ク ス ポー トさ れ る ワー ク フ ロ ー。 ワー ク フ ローはサンプルを設定 す る と 自動的に イ ンポー トさ れ る 。 説明につい ては3-4 ページの 「ス テ ッ プ 1. Sample Application Launcher の起動」を参照。
サー ブ レ ッ ト サ ン プルの実行
サーブレ ッ ト サンプルの実行方法
サーブレ ッ ト サンプルを実行する には、 こ の節で説明する手順を実行し ます。
WebLogic Server および BPM 機能固有の タ ス ク の説明については、
edocs.beasys.co.jp/e-docs/index.htmlの BEA ド キ ュ メ ン ト を参照し て く だ さ い。
\wlpi\images bealogo.jpg サンプルサーブレ ッ ト に よ っ て HTML ページ上 に表示 さ れ る BEA ロ ゴ イ メ ージ。
\wlpi\WEB-INF hello.html ユーザか ら の入力デー タ を取得する サンプル サーブレ ッ トに よ って使用 さ れ る HTML ページ。
\wlpi\WEB-INF web.xml サンプルサーブレ ッ トのデプ ロ イ メ ン ト情報を 定義する J2EE コ ン フ ィ グ レーシ ョ ン フ ァ イル。
\wlpi\WEB-INF weblogic.xml サンプルサーブレ ッ トの WebLogic の固有情報 を定義す る BEA コ ン フ ィ グ レーシ ョ ン フ ァ イ ル。
wlpi\WEB-INF\lib cos.jar サンプル コー ド の実行で使用 さ れ る ユーテ ィ リ テ ィ ラ イ ブ ラ リ 。
wlpi\WEB-INF\lib HtmlScreen.jar サンプル コー ド の実行で使用 さ れ る ユーテ ィ リ テ ィ ラ イ ブ ラ リ 。
WebLogic Platform ホームデ ィ レ ク ト リ直下 samples\
integration\
config\samples\
applications
WLPI_sample.war すべての実行可能なサンプル コ ー ド と コ ン フ ィ グ レーシ ョ ン フ ァ イ ルを含む Web Archive フ ァ イ ル。 こ のフ ァ イルは、 イ ン ス ト ール時に WebLogic Integration アプ リ ケーシ ョ ンデ ィ レ ク
トリ に自動的にデプ ロ イ さ れ る 。 表3-1 サーブレ ッ ト サンプルアプ リ ケーシ ョ ンフ ァ イル
デ ィ レ ク ト リ フ ァ イル 説明
ステ ッ プ 1. Sample Application Launcher の起動
初めて使用する場合
Sample Application Launcher を起動する には、 プ ラ ッ ト フ ォームに合わせて適切 な手順を実行し ます。
Windows
1. [ス タ ー ト | BEA WebLogic Platform 7.0 | WebLogic Integration 7.0 | Integration Samples| Start Server] を選択し て [Launch Example] を選択し ま す。 すべてのサンプルが設定 さ れていれば、 サンプル起動ページが表示 さ れ ます。 すべてのサンプルが設定さ れ るのに数分かか り ます。 図 3-1 は Sample Application Launcher です。
図3-1 Sample Application Launcher
2. [Data Integration Servlet] をサンプル アプ リ ケーシ ョ ン リ ス ト か ら選択し ま
サー ブ レ ッ ト サ ン プルの実行 図3-2 Data Integration Servlet サンプルページ
UNIX
1. PATH環境変数に、 Netscape 実行フ ァ イ ル (netscape) が格納 さ れたデ ィ レ ク ト リ が含まれてい る こ と を確認し ます。 含まれていない場合は、 サンプル 起動ページ を表示でき ません。
2. WebLogic Integraion のホーム デ ィ レ ク ト リ (WebLogic Integraion の イ ン ス ト ール先デ ィ レ ク ト リ ) に移動し ます。 た と えば、
cd /home/me/bea/weblogic700/integration
3. setenv ス ク リ プ ト を実行し て、 最上位の WebLogic Integraion 環境変数を設 定し ます。
. setenv.sh
4. RunSamples ス ク リ プ ト を実行し ます。 た と えば、
cd /home/me/bea/weblogic700/samples/integration/samples/bin RunSamples
5. RunSamplesス ク リ プ ト の コ ン フ ィ グ レーシ ョ ン セ ク シ ョ ンが実行済みであ
data in the repository and create and populate the WebLogic Integration repository, again?
Y for Yes, N for No
こ の質問に N と 入力する と 、 リ ポジ ト リ の作成および格納を行 う 手順が省略 さ れ、 WebLogic Server のサンプル イ ン ス タン ス を起動する手順のみが実行 さ れます。
こ の質問に Y と 入力する と 、 リ ポジ ト リ の作成および格納が改めて行われ、
その後で WebLogic Server のサンプル イ ン ス タン ス を起動する手順が実行 さ れます。Yと 入力し た場合、 その時点で リ ポジ ト リ に格納さ れてい る全デー
タが破棄さ れ、 リ ポジ ト リ にサンプル データが再ロー ド さ れます。 現在のサ ンプル データが変更ま たは削除 さ れ、 新規ま たは未変更のサンプル データ を リ ポジ ト リ に格納する場合にのみ、Y を入力し て く だ さ い。
以上に よ り 、 WebLogic Server の イ ン ス タ ン スがバ ッ ク グ ラ ウ ン ド プ ロセ ス と し て起動さ れ、 サンプル起動ページが表示 さ れます。
以前にサンプルを設定し ている場合
サーバを起動し て Sample Launcher を表示するには、 プ ラ ッ ト フ ォームに合わせ て適切な手順を実行し ます。
Windows
1. [ス タ ー ト | BEA WebLogic Platform 7.0 | WebLogic Integration 7.0 | Integration Examples| Start Server] を選択し ます。
2. [ス タ ー ト | BEA WebLogic Platform 7.0 | WebLogic Integration 7.0 | Integration Examples| Launcher Examples] を選択し ます。
3. [Data Integration Servlet] を選択し [Data Integration Servlet サンプル ] ページ を開き ます。
UNIX
1. サンプル ド メ イ ンの binデ ィ レ ク ト リ に移動し ます。 た と えば、 製品をデ フ ォル ト のデ ィ レ ク ト リ に イ ン ス ト ールし た場合、 次の よ う に入力し ます。
サー ブ レ ッ ト サ ン プルの実行
StartServer execution successful
4. Web ブ ラ ウザを起動し て次の URL を入力し ます。
http://localhost:7001/index.html Samples Launcher Web ページが表示さ れます。
ステ ッ プ 2. メ ール セ ッ シ ョ ンの設定
メ ール ホ ス ト をすでに設定し てい る場合は、 こ の ス テ ッ プを省いて も構いませ ん。 コ ン フ ィ グ レーシ ョ ン を検証し たい場合は、 実行する と よいで し ょ う 。 1. Samples Launcher の Administration Console か ら [WebLogic Server] を ク リ ッ
ク し ます。 WebLogic Server Administration Console が表示さ れます。
2. ナビゲーシ ョ ン ツ リ ーか ら [ サービ ス| メ ール| wlpiMailSession] を選択し ます。
3. 正し い情報を入力し て メ ール ホ ス ト を設定し ます。 こ の場合、 必ず mail.host=mailserver と し ます。 [ メ ール セ ッ シ ョ ン ] 画面の [ コ ン フ ィ グ レーシ ョ ン ] タブの例を次の図に示し ます。
図3-3 [ メ ール セ ッ シ ョ ン] 画面の [コ ン フ ィ グレーシ ョ ン] タ ブ
5. 次の図に示すよ う に、 メ ール サーバ名を [Available] 列か ら [Chosen] 列に移 動し ます。
図3-4 [ メールセ ッ シ ョ ン] 画面の [サーバ] タ ブ
6. [適用 ] を ク リ ッ ク し ます。
ステ ッ プ 3. サンプル XML データの更新と メ ッ セージの送信
1. テキ ス ト エデ ィ タで
SAMPLES_HOME\integration\samples\di\wlpi\SampleData.data フ ァ イ ルを開き ます。 テキ ス ト user@nowhere.comを、 ワーク フ ローが電子 メ ール
メ ッ セージの配信に使用する有効な電子 メ ール ア ド レ スで置き換え ます。
2. [Sample Application Launcher] の [Input File] フ ィ ール ド で次のデータ フ ァ イ ルに移動し ます。
SAMPLES_HOME\integration\samples\di\wlpi\SampleData.data
指定し た フ ァ イ ルはローカル シ ス テ ム内に無ければな り ませんが、 サーバを 実行し ている ものでな く て構いません。 フ ァ イ ルが ローカル シ ス テムに無い
EJB サ ン プルの実行
EJB サンプルの実行
こ のサンプルは、 給与データの入力に よ っ て開始 さ れる、 HR シ ス テ ムか ら給与 シ ス テムへのデータ フ ローを シ ミ ュ レー ト し ます。 従業員のデータは、 バ イ ナ
リ データが使用さ れてい る従来の給与シ ス テ ムか ら取得 さ れます。 データは XML に変換さ れる ので、 従業員への支払情報を確定する ための計算を実行でき ます。 計算の結果は、 再びバ イ ナ リ フ ォーマ ッ ト に変換 さ れ、 給与シ ス テムに 送られます。
EJB サンプルの内容
EJB サンプル アプ リ ケーシ ョ ンは WebLogic Integration イ ン ス ト ールの SAMPLES_HOME\integration\samples\di\ejbデ ィ レ ク ト リ にあ り ます。 次の 表では、 EJB サンプル アプ リ ケーシ ョ ンに含まれ る フ ァ イルについて説明し て います。
表3-2 EJB サンプルアプ リ ケーシ ョ ン フ ァ イル
デ ィ レ ク ト リ フ ァ イル 説明
\ejb makefile サンプルソ ース を.jarフ ァ イ ルに構築する ため
の メ イ ク フ ァ イ ル。
WLXTExample.jar Data Integration か ら エ ク ス ポー ト さ れたサ ンプ ル ワー ク フ ロー
HR.mfl サンプルの HR Bean か ら 返 さ れ る バ イナ リ デー タ の MFL フ ァ イ ル。
Payroll.mfl サンプルの Payroll Bean に渡 さ れ る バ イ ナ リ データ の MFL フ ァ イ ル。
Autopay.cmd コ マ ン ド ラ イ ンか ら ワー ク フ ローを開始す る た めの Windows NT コ マ ン ド ス ク リ プ ト 。 Autopay.sh コ マ ン ド 行か ら ワー ク フ ローを開始す る ための
UNIX シ ェルス ク リ プ ト 。
build.cmd ソ ース か らwlxtejb.jarを構築す る 。
EJB サ ン プルの実行
EJB サンプルの実行方法
EJB サンプルを実行する には、 次に説明する手順に従っ て く だ さ い。
ステ ッ プ 1. ワーク フ ロー定義のイ ンポー ト
\ejb\source Payroll.java 従来の給与シ ス テ ム を表すサンプル EJB。 PayrollHome.java
PayrollBean.java
HR.java 従来の HR シ ス テ ム を表すサンプル EJB。 HRHome.java
HRBean.java
AutoPay.java プ リ フ ォーマ ッ ト さ れた メ ッ セージ を Event Topic 上に配置し てサンプルワー ク フ ローを開始 さ せ る プ ロ グ ラ ム。
HexDump.java サンプル EJB に よ って使用 さ れ る ユーテ ィ リ テ ィ ク ラ ス。
EmployeeRecord.java サンプル HR EJB に よ っ て使用 さ れ る従業員の デー タ ク ラ ス。
WebLogic Platform ホームデ ィ レ ク ト リ直下 samples\
integration\
samples\di\
ejb\lib
WLXTEJB.jar サンプルアプ リ ケーシ ョ ンの実行フ ァ イ ル。
表3-2 EJB サンプルアプ リ ケーシ ョ ン フ ァ イル (続き)
デ ィ レ ク ト リ フ ァ イル 説明