BPEL デザイナー開発者ガイド
管理:
Anastasia Koval
最終更新日: 2008 年 4 月
目次
ログと警告
Sun BPEL サービスエンジンには、プロセスの実行中にメッセージや式の値を追跡できる機能があります。ログと警告の機能では、標準の WS-BPEL 拡張機構が使用されます。ログと警告は、ほとんどの BPEL アクティビティーでサポートされています。
IDE には、プロセスアクティビティーのログと警告を定義する機能があります。ログは、指定した式の値やパートナーリンクの終了点参照情報を、サーバーログに記録するために使用します。警告を使用すると、この情報の警告を受け取ることができます。ログと警告の条件を設定して BPEL プロセスを実行すると、ログレベルに応じて、指定した式の値がサーバーログファイルに書き込まれるか、ユーザーに警告が送信されます。
ログと警告は両方とも、ログ記録マッパーで定義されます。ログ記録マッパーは、BPEL プロセスのデザインビューまたはソースビューのタブになっています。
アクティビティーのログを定義するときは、次のコンポーネントの値を追跡できます。
マッピングでは、メニューバーから 1 つまたは複数の XPath 関数を使用できます。
変数の値をログに記録するには、次の手順に従います。
図の中でアクティビティーを選択します。ログへの記録は、アクティビティーの実行に関連して行われます。
BPEL エディタの「ログ記録」タブに移動します。ログ記録マッパーが開きます。アクティビティーを右クリックし、「移動」>「ログ記録」(Alt-L) を選択してログ記録マッパーを開くこともできます。
ソースツリー区画で、追跡する変数が表示されるまで変数のツリーを展開します。
宛先ツリー区画で、アクティビティーノードを展開します。ログ記録をいつ行うかを示すノードが表示されます。
ログ記録をいつ行うかを選択し、適切なノードを展開します。
LOG_onStart。 アクティビティーの開始時に変数の値がログに記録されます。 LOG_onComplete。 アクティビティーの実行が完了したときに、変数の値がログに記録されます。
ログのレベルを定義します。追跡する変数から、宛先ツリー区画の適切なノードまで接続をドラッグします。次のレベルのログがあります。
ログへの記録は、変数に定義されているログレベルが、アプリケーションサーバーにある BPEL SE に指定されているログレベルに対応している場合にのみ行われます。
BPEL SE のログレベルを設定するには、次の手順に従います。 BPEL SE のログレベルを指定するには、アプリケーションサーバーの管理コンソールを使用します。
「サービス」ウィンドウで「サーバー」ノードを展開します。GlassFish アプリケーションサーバーが実行中であることを確認します。横に緑色の矢印のバッジが表示されている必要があります。サーバーが実行中ではない場合は、サーバー名を右クリックし、コンテキストメニューから「起動」を選択します。
ブラウザで管理コンソールを開きます。このとき次の手順に従います。
「GlassFish V2」アプリケーションサーバーノードを右クリックし、コンテキストメニューから「プロパティー」を選択します。「サーバー」ウィンドウが開きます。「サーバー」区画で、GlassFish V2 が選択されていることを確認します。
「接続」タブで、「場所」フィールドの内容 (デフォルトでは localhost:4848 ) をコピーします。
この文字列をブラウザにペーストし、Enter キーを押します。Sun Java System Application Server の管理コンソールがブラウザウィンドウで開きます。
ユーザー名とパスワードを使用して管理コンソールにログインします。デフォルトでは、ユーザー名は admin 、パスワードは adminadmin です。
左側の区画で「JBI」ノードの下の「コンポーネント」>「sun-bpel-engine」を選択します。BPEL サービスエンジンのプロパティーページが開きます。
BPEL サービスエンジンのプロパティーページで、「ロガー」タブを選択します。「ロガー」タブで、個々のロガーのログレベルを指定できます。
ドロップダウンリストから、sun-bpel-engine に適切なログレベルを選択します。
プロセスアクティビティーにログが定義されていて、指定されているログレベルが、BPEL SE に設定されているログレベルに対応している場合、プロセスのテスト実行を行なったあと、選択した変数の値がサーバーログファイルに記録されます。
注: プロジェクトをアプリケーションサーバーに配備する必要があります。
ログファイルを表示するには、次の手順に従います。
「サービス」ウィンドウで「サーバー」ノードの下にある「GlassFish V2」アプリケーションサーバーノードを右クリックし、コンテキストメニューから「サーバーログを表示」を選択します。GlassFish サーバーログが「出力」ウィンドウで開きます。アクティビティーのメッセージ値がログに含まれます。「検索」を使用して検索できます。一部の間接的な情報は表示されません。
ログをテキストエディタで開き、すべての情報を確認することもできます。<アプリケーションサーバーのインストールディレクトリ>/domains/domain1/log/ に移動し、server.log ファイルをテキストエディタで開きます。ログでは、次の情報が縦棒で区切られています。
警告の機能によって、ユーザーは特定のイベントが発生したときに通知をうけとることができます。警告対象のイベントはプロセスアクティビティーの実行と結びつけられます。
警告を定義するための一般的な手順は次の通りです:
プロセスアクティビティーの警告レベルを設定
アプリケーションサーバーが実行中であることを確認し、プロジェクトを配備
MBean クライアントを選択または作成し、イベント発生の通知を受け取るように設定クライアントは警告メッセージを展開し、指定されたアクションを実行 (ログの記述/メール送信/何もしない)
プロセスを実行し通知を受け取る
ページの先頭へ
