| Oracle® Fusion Middleware Oracle SOA Suite開発者ガイド 11g リリース1 (11.1.1.4.0) B56238-03 |
|
 前 |
 次 |
この章では、Oracle BAMのアラートの作成方法について説明します。
項目は次のとおりです。
アラートは、指定されたイベントと条件のセット(ルールと呼ばれる)によって起動されます。アラートは、レポート内のデータ変更によって起動されるようにしたり、毎日、毎時または設定された間隔でユーザーにレポートを送信するために使用できます。アラート・ルールにおけるイベントには、期間、特定の時間、または特定のレポート内の変更を指定できます。条件に応じて、アラート・ルールを特定の時間または日付の間に発生するイベントに制限できます。イベントおよび条件の結果として、電子メールを介してユーザーにレポートを送信できます。
アラートはOracle BAMアーキテクトおよびOracle BAMアクティブ・スタジオ両方のWebアプリケーションで作成できます。
アラートは「アラート・ルール」表に表示されます。Oracle BAMアクティブ・スタジオでは、この表に「最終起動日」列が表示され、アラート・ルールが最後に起動された日時が示されます。各アラート名とともに、そのステータスを示すアイコンが表示されます。このアイコンについては、表57-1で説明します。
表57-1 アラート・ルールのアイコン
| アイコン | 説明 |
|---|---|
|
|
「標準」は、アラートがアクティブであり、ルールに指定した条件に従って起動されることを示しています。 |
|
|
無効は、エラーによって、アラートが孤立または不完全な状態になっていることを示します。このアイコンは、アラートがイベント・エンジンに正しくロードできない場合に表示されます。ルールを修正する必要がある場合があります。 たとえば、レポートが削除され、そのレポートに基づいたアラートがまだ存在する場合、そのアラートは正しくロードできません。 このアイコンは、ルールがイベント・エンジンに(再起動時に)ロードされた場合のみ表示されます。このアイコンとともに表示されるアラートは、編集して修正するまで起動されません。 |
|
|
期限切れは、アラートが再度起動されないことを示します。このアイコンは、1回のみ起動される時間ベースのアラートに、そのアラートが起動された後で表示されます。ただし、これらのアラートは編集して再使用でき、状態を「標準」にリセットできます。 |
非アクティブのアラートと期限切れのアラートでは動作が異なることに注意してください。アラートを非アクティブ化できるのは実行中のみです。この動作は、ユーザーが一定期間アラートを受信しないようにするが、適切な時期にアラートをアクティブ化する機能は保持しておく場合に便利です。アクティブではなくても有効であるアラート(「標準」アイコンで表示されるアラート)は、再度アクティブ化できます。
期限切れのアラートは、指定した条件に対して実行されたアラートであり、再実行はされません。再実行のためにアクティブ化することはできません。ただし、期限切れのアラートを再利用する場合は、アラートをダブルクリックし、有効なルールになるように定義を更新して、アラート・ルール定義を保存します。アラートは再ロードされ、再度起動できる状態になります。
|
注意: Oracle BAMサーバー・システムで時間またはタイムゾーンを変更した場合は、Oracle BAMサーバー・アプリケーションを再起動する必要があります。再起動しないと時間ベースのアラートが失敗します。 |
|
注意: アラートは、アラートが定義(または再有効化)された時点以降にそのトリガー・イベント条件が満たされた場合にのみ起動されます。アラートが定義される前または無効化されている間にその条件が満たされていた場合は起動されません。 |
この項では、Oracle BAMアーキテクトでOracle BAMアラート・ルールを作成する方法について説明します。手順は、Oracle BAMアクティブ・スタジオで作成する場合と同じです。
ルールを作成する手順は、次のとおりです。
Oracle BAMアーキテクトの機能リストから「アラート」を選択します。
Oracle BAMアクティブ・スタジオでは、「アラート」タブを選択します。
「新規アラートの作成」をクリックします。
「ルールの作成および編集」ダイアログ・ボックスが表示されます。
「ルールの作成」をクリックします。
ルールの名前を入力します。
|
注意: Oracle BAMオブジェクト名(データ・オブジェクト名、レポート名、エンタープライズ・メッセージ・ソース名など)に一重引用符または二重引用符が含まれていると、実行時エラーが発生します。Oracle BAMオブジェクト名には、一重引用符または二重引用符を含めないでください。 |
アラートを起動するイベントを選択します。
各イベントについては、F.1項「イベント」を参照してください。
「次へ」をクリックします。
必要に応じて、1つ以上の条件を選択します。
各条件については、F.2項「条件」を参照してください。
1つ以上のアクションを選択します。各アクションについては、F.3項「アクション」を参照してください。
ルール式で下線付きの各アイテムをクリックし、値を指定してアラート・ルールを完成します。
たとえば、「レポートの選択」をクリックし、開いているダイアログ・ボックスでレポートを選択します。定義する他の値には、レポートを受信するユーザー名、日付と時間、時間間隔、特定のフィールドのフィルタ式などがあります。条件またはアクションの追加を続行するには、式の最後の行をクリックし、別の条件またはアクションを選択します。
「戻る」および「次へ」ボタンをクリックして、イベントのページとアクションや条件が表示されているページ間を移動し、作成済のアラート・ルール式の該当部分を変更できます。
「頻度の制限」ボタンをクリックすると、アラートの起動頻度に制限を設定できます。
デフォルトでは、アラートの頻度制限は5秒です。数値を入力し、時間の単位(秒、分、時間など)を選択して「OK」をクリックします。頻度制限を無効にするには、「制限の有効化」チェック・ボックスの選択を解除します。頻度制限の詳細は、F.4項「頻度制限」を参照してください。
アラート・ルールから行を削除するには、「この式の削除」をクリックします。
「OK」をクリックします。
アラート・ルールがリストに追加され、アクティブになります。
アラート・ルールは、作成すると自動的にアクティブになります。アラートを削除しないで一時的に非アクティブな状態にする場合は、「アクティブ化」チェック・ボックスの選択を解除することで無効にできます。
アラート・ルールのアクティビティ・ステータスを変更する手順は、次のとおりです。
Oracle BAMアーキテクトの機能リストから「アラート」を選択します。
アラート・ルールの「アクティブ化」チェック・ボックスを選択します。
チェック・ボックスが選択されている場合、アラート・ルールがアクティブであることを意味します。
チェック・ボックスの選択が解除されている場合、アラート・ルールが非アクティブであることを意味します。
「アクティブ化」チェック・ボックスを選択しても、アラートは起動されません。指定したイベントが発生した場合にアラートが起動されるように、ルールが有効化されるのみです。
アラート・アイコンに感嘆符が表示された場合、アラートが起動済で再度有効にならないか、またはアラートが参照するアイテムが欠落していて起動できないことを示しています。
テンプレートから作成したアラート・ルールを変更する場合は、テンプレートを使用せずにアラート・ルールを作成する場合と同様に、新しい行を追加し、条件とアクションを選択できます。
アラート・ルールを変更する手順は、次のとおりです。
編集するアラート・ルールを選択します。
「アラート・アクション」リストで、「編集」をクリックします。
「ルールの作成および編集」ダイアログ・ボックスが表示されます。
アラートを変更して「OK」をクリックします。
アラート・ルール・テンプレートは、一般的なユースケースに基づいて事前に選択された、イベントと条件の有効なグループです。
テンプレートからアラート・ルールを作成する手順は、次のとおりです。
「新規アラートの作成」をクリックします。
「アラート・ルールの作成」ダイアログ・ボックスが表示されます。
「テンプレートからルールを作成」をクリックします。
アラート・ルールの名前を入力します。
リストからテンプレートを選択します。
ルールの式ボックスで、下線付きの各アイテムをクリックし、値を指定してアラート・ルールを完成します。たとえば、「レポートの選択」をクリックし、開いているダイアログ・ボックスでレポートを選択します。定義する他の値には、レポートを受信するユーザー名、日付と時間、時間間隔、特定のフィールドのフィルタ式などがあります。
「頻度の制限」をクリックすると、アラートを起動できる頻度を設定できます。デフォルトでは、アラートの頻度制限は5秒です。数値を入力し、時間の単位(秒、分、時間など)を選択して「OK」をクリックします。
「このルールの変更」をクリックすると、テンプレートを使用せずにルールを変更できます。これによって、ルール作成におけるオプションが多くなります。
「OK」をクリックします。
アラート・ルールがリストに追加され、アクティブになります。
メッセージを送信するアラート・ルールを作成できます。メッセージには、レポート名、レポートへのリンク、ユーザー名などの情報を含めることができます。また、メッセージには、イベントの発生時刻、イベントを起動したデータなど、アラートの起動時に設定される変数を含めることもできます。データ変数を使用するには、イベントがデータに基づいている必要があります。
メッセージを送信するアラート・ルールを作成できます。メッセージには、レポート名、レポートへのリンク、ユーザー名などの情報を含めることができます。また、メッセージには、イベントの発生時刻、イベントを起動したデータなど、アラートの起動時に設定される変数を含めることもできます。データ変数を使用するには、イベントがデータに基づいている必要があります。
メッセージを含むアラート・ルールを作成する手順は、次のとおりです。
アラート・ルールの作成を開始します。
アクション「電子メールでメッセージを送信」を選択します。
ルール式で、「メッセージの作成」をクリックします。
「アラート・メッセージ」ダイアログ・ボックスが表示されます。
「件名」行に件名を入力します。
「メッセージ・テキスト」ボックスにメッセージを入力します。
メッセージに特殊フィールドを含めます。
特殊フィールドは、「アラート・メッセージ」ダイアログ・ボックスの左下にあるボックスに表示されます。表示される特殊フィールドは、ダイアログ・ボックスの右側でレポートを選択すると変更されます。
特殊フィールドをメッセージに挿入する手順は、次のとおりです。
リストから特殊フィールドを選択します。
「件名に挿入」または「テキストに挿入」をクリックします。
同じタイプの値を複数挿入できます。たとえば、様々なレポートへの複数のリンクを挿入できます。
レポート名の送信: 選択されたレポートの名前を挿入します。
レポート所有者の送信: 選択されたレポートの所有者名を挿入します。
レポート・リンクの送信: 選択されたレポートへのリンクを挿入します。
変更済のレポート名: 変更されたレポートの名前を挿入します。
変更済のレポート所有者: 変更されたレポートの所有者名を挿入します。
ターゲット・ユーザー: メッセージ受信者のユーザー名を挿入します。
送信日時: メッセージが送信された日時を挿入します。
「OK」をクリックします。
ネストされたルールを多くのアクションで作成したり、他のルールを起動する連鎖ルールを作成することができます。
次のような2つのタイプのルールを作成すると、ルールを連鎖関係にすることができます。
別のルールによって起動される依存ルール。
依存ルールを起動するアクションを持つルール。
依存ルールを作成する手順は、次のとおりです。
イベント「このルールの起動時」を含むルールを作成します。このイベントに値は必要ありません。
アクション「ルールの起動」または「アクションが失敗した場合、ルールを起動」を含むルールを作成します。「アクションが失敗した場合、ルールを起動」は、ルールに含まれるすべてのアクションに適用されます。
アクションで、「ルールの選択」をクリックします。
「依存ルールの選択」ダイアログ・ボックスが表示されます。
依存ルールを選択します。リストに表示されるのは、「このルールの起動時」イベントを含むルールのみです。
「OK」をクリックします。
アクションが失敗した場合に対処するには、アクション「アクションが失敗した場合、ルールを起動」を追加します。たとえば、ルールがメッセージを送信することになっていても、なんらかの理由でメッセージが送信されない場合、別のルールを起動して通知を送信できます。
アラート履歴は、Oracle BAMアクティブ・スタジオで使用でき、トリガーされたアラート・ルールとそのステータス・メッセージのリストを表示できます。
Oracle BAMアクティブ・スタジオの「アラート」タブでは、アラート・アクティビティの最近の履歴を表示できます。「アラート履歴」リストには、最近起動された25のアラートが表示されます。
「アラート履歴」リストには、最近起動されたアラートの名前、アラートに関連付けられたメッセージ、アラートを作成したユーザー、およびアラート・ルールがトリガーされた日時が表示されます。
電子メールを送信するアラート・ルールの場合、「アラート履歴」リストにアラートが表示されるのは、現在ログインしているユーザーが電子メール・アラートの受信者である場合のみです。ユーザーがアラートの作成者であってもアラートの受信者でない場合、「アラート履歴」リストには表示されません。
ただし、アラートがアラート受信者へのメールの送信に失敗した場合、アラート所有者が「アラート履歴」ペインにエラー・メッセージを表示し、必要に応じて修正措置を実行できるように、メッセージはその所有者の名前で記録されます。存在しない名前をアラート受信者の名前として記録することはできません。
アラート履歴のメッセージ
「アラート履歴」リストの「メッセージ」列には、アラート配信の成功または失敗に関する情報が表示されます。アラートの配信に成功した場合は、メッセージの横に緑色のチェックマークが表示されます。アラートの配信に失敗した場合は、赤色のxアイコンと、ロードまたは処理時にアラートがどのように失敗したかを示すメッセージが表示されます。xアイコンをクリックすると、エラーに関する追加情報が表示されます。
アラートによって参照されているレポートが削除されても、ユーザーに警告はありません。アラートがトリガーされると、削除されたレポートへの壊れた参照に関する具体的なエラーがないエラー・メッセージ「: 電子メールの送信中にエラーが発生しました」が発行されます。レポートの削除時にレポートがアラートによって参照されていないことを確認することが重要です。そうしないとエラーが発生します。
アラートのWebサービスを使用すると、アラートを手動で起動できます。詳細は、次のURLを参照してください。
http://host:http_port/OracleBAMWS/WebServices/ManualRuleFire?wsdl
ルール名は、次の書式を使用して定義します。
username.alertname
|
注意: アラートおよびレポート・リンクに使用されているOracle BAMアクティブ・スタジオのURLには、キャッシングやパフォーマンスを目的として、製品ビルド番号を使用した仮想ディレクトリが含まれています。このディレクトリはリンクに含める必要があり、このようなリンクは編集しないことをお薦めします。以前のバージョンのOracle BAMで作成されたリンクは、製品のアップグレード後は機能しません。アラートを編集するか、またはレポートのショートカットを再度コピーする必要があります。 |
外部アクションのコールは、カスタム・アクションの開発に使用します。Oracle BAMが提供するアクションではユーザーの要件を満たすことができない場合は、この機能を使用してアクション・セットを拡張します。
外部で動作するアクションは、デフォルトではOracle BAMアラート・ユーザー・インタフェースに表示されません。これらのアクションをユーザー・インタフェースに表示するには、Oracle BAMへの登録が必要です。
このタスクを実行するには、EventEngineインタフェースを実装し、このインタフェースに基づいてアクションを開発する必要があります。これは、Javaコードを記述し、コンパイル済のコードをJARファイルにバンドルする必要があることを意味します。次に、Oracle BAMアーキテクトでそのJARファイルをシステム/アラート/外部アクション・データ・オブジェクトのアクションとして登録します。
外部アクションのコール・アクションでは、Webサービスを起動する必要はありません。このアクションは、11gより前のリリースではWebサービスをコールする方法で使用されましたが、Oracle BAM 11gでは、「Webサービスのコール」アクションに置き換わりました。「Webサービスのコール」アクションでは、より高度で動的なWebサービス・クライアントが使用され、実行時にWSDLを読み取ることによってサービスを起動できます。
Oracle BAM共通構成ファイルでプロパティが設定されている場合、Oracle BAMからのアラートを、Oracle BAMで認識されていない電子メール・アカウントに送信できます。
この機能は、「電子メールでレポートを送信」および「電子メールでメッセージを送信」のアクションでのみ使用できます。
外部電子メール・アカウントにアラートを送信する手順は、次のとおりです。
BAMCommonConfig.xml構成ファイルで、プロパティAlertActionAllowExternalEmailをtrueに設定します。
Oracle BAM構成ファイルの編集の詳細は、『Oracle Fusion Middleware Oracle SOA SuiteおよびOracle Business Process Management Suite管理者ガイド』の拡張プロパティの構成に関する項を参照してください。
Oracle BAMを再起動します。
ユーザーにメッセージを送信するアクションを含むアラート・ルールを作成します。
「ユーザーの選択」をクリックし、電子メール・アドレスをセミコロンで区切って外部電子メール・アドレスの入力ボックスに入力します。
