ヘッダーをスキップ
Oracle Fusion Middleware Oracle SOA Suite開発者ガイド
11g リリース1(11.1.1)
B56238-01
  目次
目次
索引
索引

戻る
戻る
 
次へ
次へ
 

37 Oracle BAMアラートの作成

この章では、Oracle BAMのアラートの作成方法について説明します。

項目は次のとおりです。

37.1 アラートの作成の概要

アラートは、指定されたイベントと条件のセット(ルールと呼ばれる)によって起動されます。アラートは、レポート内のデータ変更によって起動されるようにしたり、毎日、毎時または設定された間隔でユーザーにレポートを送信するために使用できます。アラート・ルールにおけるイベントには、期間、特定の時間、または特定のレポート内の変更を指定できます。条件に応じて、アラート・ルールを特定の時間または日付の間に発生するイベントに制限できます。イベントおよび条件の結果として、電子メールを介してユーザーにレポートを送信できます。

アラートはOracle BAMアーキテクトおよびOracle BAMアクティブ・スタジオ両方のWebアプリケーションで作成できます。

アラートは「アラート・ルール」表に表示されます。 Oracle BAMアクティブ・スタジオでは、この表に「最終起動日」列が表示され、アラート・ルールが最後に起動された日時が示されます。 各アラート名とともに、そのステータスを示すアイコンが表示されます。このアイコンについては、表37-1で説明します。

図37-1 Oracle BAMアーキテクトの「アラート・ルール」表

図37-1の説明は次にあります。
「図37-1 Oracle BAMアーキテクトの「アラート・ルール」表」の説明

表37-1 アラート・ルールのアイコン

アイコン 説明

標準のアラート・アイコン


「標準」は、アラートがアクティブであり、ルールに指定した条件に従って起動されることを示しています。

無効なアラート・アイコン


無効は、エラーによって、アラートが孤立または不完全な状態になっていることを示します。このアイコンは、アラートがイベント・エンジンに正しくロードできない場合に表示されます。 ルールを修正する必要がある場合があります。

たとえば、レポートが削除され、そのレポートに基づいたアラートがまだ存在する場合、そのアラートは正しくロードできません。

このアイコンは、ルールがイベント・エンジンに(再起動時に)ロードされた場合のみ表示されます。 このアイコンとともに表示されるアラートは、編集して修正するまで起動されません。

期限切れアラート・アイコン


期限切れは、アラートが再度起動されないことを示します。 このアイコンは、1回のみ起動される時間ベースのアラートに、そのアラートが起動された後で表示されます。ただし、これらのアラートは編集して再使用でき、状態を「標準」にリセットできます。


非アクティブのアラートと期限切れのアラートでは動作が異なることに注意してください。 アラートを非アクティブ化できるのは実行中のみです。 この動作は、ユーザーが一定期間アラートを受信しないようにするが、適切な時期にアラートをアクティブ化する機能は保持しておく場合に便利です。 アクティブではなくても有効であるアラート(「標準」アイコンで表示されるアラート)は、再度アクティブ化できます。

期限切れのアラートは、指定した条件に対して実行されたアラートであり、再実行はされません。 再実行のためにアクティブ化することはできません。 ただし、期限切れのアラートを再利用する場合は、アラートをダブルクリックし、有効なルールになるように定義を更新して、アラート・ルール定義を保存します。 アラートは再ロードされ、再度起動できる状態になります。


注意:

Oracle BAMサーバー・システムで時間またはタイムゾーンを変更した場合は、Oracle BAMサーバー・アプリケーションを再起動する必要があります。再起動しないと時間ベースのアラートが失敗します。

37.2 アラート・ルールの作成

ルールでは、アラートが起動するイベントや条件を指定します。


注意:

アラートは、アラートが定義(または再有効化)された時点以降にそのトリガー・イベント条件が満たされた場合にのみ起動されます。 アラートが定義される前または無効化されている間にその条件が満たされていた場合は起動されません。

37.2.1 アラート・ルールの作成方法

この項では、Oracle BAMアーキテクトでOracle BAMアラート・ルールを作成する方法について説明します。 手順は、Oracle BAMアクティブ・スタジオで作成する場合と同じです。

ルールを作成する手順は、次のとおりです。

  1. Oracle BAMアーキテクトの機能リストから「アラート」を選択します。

    Oracle BAMアクティブ・スタジオでは、「アラート」タブを選択します。

  2. 「新規アラートの作成」をクリックします。

    「ルールの作成および編集」ダイアログ・ボックスが表示されます。

  3. 「ルールの作成」をクリックします。

  4. ルールの名前を入力します。

  5. アラートを起動するイベントを選択します。

    各イベントについては、F.1項「イベント」を参照してください。

  6. 「次へ」をクリックします。

  7. 必要に応じて、1つ以上の条件を選択します。

    各条件については、F.2項「条件」を参照してください。

  8. 1つ以上のアクションを選択します。各アクションについては、F.3項「アクション」を参照してください。

  9. ルール式で下線付きの各アイテムをクリックし、値を指定してアラート・ルールを完成します。

    たとえば、「レポートの選択」をクリックし、開いているダイアログ・ボックスでレポートを選択します。定義する他の値には、レポートを受信するユーザー名、日付と時間、時間間隔、特定のフィールドのフィルタ式などがあります。条件またはアクションの追加を続行するには、式の最後の行をクリックし、別の条件またはアクションを選択します。

    「戻る」および「次へ」ボタンをクリックして、イベントのページとアクションや条件が表示されているページ間を移動し、作成済のアラート・ルール式の該当部分を変更できます。

  10. 「頻度の制限」ボタンをクリックすると、アラートの起動頻度に制限を設定できます。

    デフォルトでは、アラートの頻度制限は5秒です。数値を入力し、時間の単位(秒、分、時間など)を選択して「OK」をクリックします。頻度制限を無効にするには、「制限の有効化」チェック・ボックスの選択を解除します。頻度制限の詳細は、F.4項「頻度制限」を参照してください。

  11. アラート・ルールから行を削除するには、「この式の削除」をクリックします。

  12. 「OK」をクリックします。

    アラート・ルールがリストに追加され、アクティブになります。

37.2.2 アラートのアクティブ化の方法

アラート・ルールは、作成すると自動的にアクティブになります。アラートを削除しないで一時的に非アクティブな状態にする場合は、「アクティブ化」チェック・ボックスの選択を解除することで無効にできます。

アラート・ルールのアクティビティ・ステータスを変更する手順は、次のとおりです。

  1. Oracle BAMアーキテクトの機能リストから「アラート」を選択します。

  2. アラート・ルールの「アクティブ化」チェック・ボックスを選択します。

チェック・ボックスが選択されている場合、アラート・ルールがアクティブであることを意味します。

チェック・ボックスの選択が解除されている場合、アラート・ルールが非アクティブであることを意味します。

「アクティブ化」チェック・ボックスを選択しても、アラートは起動されません。指定したイベントが発生した場合にアラートが起動されるように、ルールが有効化されるのみです。

アラート・アイコンに感嘆符が表示された場合、アラートが起動済で再度有効にならないか、またはアラートが参照するアイテムが欠落していて起動できないことを示しています。

37.2.3 アラート・ルールの変更方法

テンプレートから作成したアラート・ルールを変更する場合は、テンプレートを使用せずにアラート・ルールを作成する場合と同様に、新しい行を追加し、条件とアクションを選択できます。

アラート・ルールを変更する手順は、次のとおりです。

  1. 編集するアラート・ルールを選択します。

  2. 「アラート・アクション」リストで、「編集」をクリックします。

    「ルールの作成および編集」ダイアログ・ボックスが表示されます。

  3. アラートを変更して「OK」をクリックします。

37.2.4 アラートの削除方法

アラートを削除する手順は、次のとおりです。

  1. 削除するアラートを選択します。

  2. 「アラート・アクション」リストで、「削除」をクリックします。

    アラートを削除することを確認するダイアログ・ボックスが表示されます。

  3. 「OK」をクリックします。

    アラートが削除されます。

37.3 テンプレートからのアラート・ルールの作成

アラート・ルール・テンプレートは、一般的なユースケースに基づいて事前に選択された、イベントと条件の有効なグループです。

37.3.1 テンプレートからのアラート・ルールの作成方法

テンプレートからアラート・ルールを作成する手順は、次のとおりです。

  1. 「新規アラートの作成」をクリックします。

    「アラート・ルールの作成」ダイアログ・ボックスが表示されます。

  2. 「テンプレートからルールを作成」をクリックします。

  3. アラート・ルールの名前を入力します。

  4. リストからテンプレートを選択します。

  5. 「ルールの式」ボックスで、下線付きの各アイテムをクリックし、値を指定してアラート・ルールを完成します。 たとえば、「レポートの選択」をクリックし、開いているダイアログ・ボックスでレポートを選択します。定義する他の値には、レポートを受信するユーザー名、日付と時間、時間間隔、特定のフィールドのフィルタ式などがあります。

  6. 「頻度の制限」をクリックすると、アラートを起動できる頻度を設定できます。デフォルトでは、アラートの頻度制限は5秒です。数値を入力し、時間の単位(秒、分、時間など)を選択して「OK」をクリックします。

  7. 「このルールの変更」をクリックすると、テンプレートを使用せずにルールを変更できます。これによって、ルール作成におけるオプションが多くなります。

  8. 「OK」をクリックします。

    アラート・ルールがリストに追加され、アクティブになります。

37.4 メッセージを含むアラート・ルールの作成

メッセージを送信するアラート・ルールを作成できます。メッセージには、レポート名、レポートへのリンク、ユーザー名などの情報を含めることができます。また、メッセージには、イベントの発生時刻、イベントを起動したデータなど、アラートの起動時に設定される変数を含めることもできます。データ変数を使用するには、イベントがデータに基づいている必要があります。

37.4.1 メッセージを含むアラート・ルールの作成方法

メッセージを送信するアラート・ルールを作成できます。メッセージには、レポート名、レポートへのリンク、ユーザー名などの情報を含めることができます。また、メッセージには、イベントの発生時刻、イベントを起動したデータなど、アラートの起動時に設定される変数を含めることもできます。データ変数を使用するには、イベントがデータに基づいている必要があります。

メッセージを含むアラート・ルールを作成する手順は、次のとおりです。

  1. アラート・ルールの作成を開始します。

  2. アクション「電子メールでメッセージを送信」を選択します。

  3. ルール式で、「メッセージの作成」をクリックします。

    「アラート・メッセージ」ダイアログ・ボックスが表示されます。

  4. 「件名」行に件名を入力します。

  5. 「メッセージ・テキスト」ボックスにメッセージを入力します。

  6. メッセージに特殊フィールドを含めます。

    特殊フィールドは、「アラート・メッセージ」ダイアログ・ボックスの左下にあるボックスに表示されます。 表示される特殊フィールドは、ダイアログ・ボックスの右側でレポートを選択すると変更されます。

    特殊フィールドをメッセージに挿入する手順は、次のとおりです。

    1. リストから特殊フィールドを選択します。

    2. 「件名に挿入」または「テキストに挿入」をクリックします。

    同じタイプの値を複数挿入できます。たとえば、様々なレポートへの複数のリンクを挿入できます。

    • レポート名の送信: 選択されたレポートの名前を挿入します。

    • レポート所有者の送信: 選択されたレポートの所有者名を挿入します。

    • レポート・リンクの送信: 選択されたレポートへのリンクを挿入します。

    • 変更済のレポート名: 変更されたレポートの名前を挿入します。

    • 変更済のレポート所有者: 変更されたレポートの所有者名を挿入します。

    • ターゲット・ユーザー: メッセージ受信者のユーザー名を挿入します。

    • 送信日時: メッセージが送信された日時を挿入します。

  7. 「OK」をクリックします。

37.5 複合アラートの作成

ネストされたルールを多くのアクションで作成したり、他のルールを起動する連鎖ルールを作成することができます。

次のような2つのタイプのルールを作成すると、ルールを連鎖関係にすることができます。

37.5.1 依存ルールの作成方法

依存ルールを作成する手順は、次のとおりです。

  1. イベント「このルールの起動時」を含むルールを作成します。 このイベントに値は必要ありません。

  2. アクション「ルールの起動」または「アクションが失敗した場合、ルールを起動」を含むルールを作成します。「アクションが失敗した場合、ルールを起動」は、ルールに含まれるすべてのアクションに適用されます。

  3. アクションで、「ルールの選択」をクリックします。

    「依存ルールの選択」ダイアログ・ボックスが表示されます。

  4. 依存ルールを選択します。 リストに表示されるのは、「このルールの起動時」イベントを含むルールのみです。

  5. 「OK」をクリックします。

アクションが失敗した場合に対処するには、アクション「アクションが失敗した場合、ルールを起動」を追加します。たとえば、ルールがメッセージを送信することになっていても、なんらかの理由でメッセージが送信されない場合、別のルールを起動して通知を送信できます。

37.6 アラート履歴の使用

この機能はOracle BAMアクティブ・スタジオでのみ使用可能です。

37.6.1 アラート履歴の表示方法

「アラート」タブでは、アラート・アクティビティの最近の履歴を表示できます。「アラート履歴」リストには、最近起動された25のアラートが表示されます。

電子メール・アラートの場合、「アラート履歴」リストにアラートが表示されるのは、ログインしたユーザーがアラート受信者である場合のみです。 ユーザーがアラートの作成者であってもアラートの受信者でない場合、「アラート履歴」リストにアラートは表示されません。

アラート履歴を表示する手順は、次のとおりです。

「アラート履歴」リストには、最近起動されたアラート、アラートを作成したユーザー、およびアラートが起動された日時が表示されます。アラート内にレポート・リンクが含まれているアラートでは、レポート履歴リストからのレポートへのリンクが提供されます。

37.6.2 アラート履歴の消去方法

多数のアラートがアクティブに起動しており、アラート履歴リストが大きくなった場合は、アラート履歴リストを消去できます。

アラート履歴を消去する手順は、次のとおりです。

  1. 「アラート」タブで、「アラート履歴の消去」をクリックします。

    アラート履歴の消去を確認するメッセージが表示されます。

  2. 「OK」をクリックします。

    アラート履歴リストが削除されます。 消去後に起動された新しいアラートが、アラート履歴リストに表示されます。

37.7 Webサービスの起動によるアラートの起動

アラートのWebサービスを使用すると、アラートを手動で起動できます。詳細は、次のURLを参照してください。

http://host:http_port/OracleBAMWS/WebServices/ManualRuleFire?wsdl

ルール名は、次の書式を使用して定義します。

username.alertname

注意:

アラートおよびレポート・リンクに使用されているOracle BAMアクティブ・スタジオのURLには、キャッシングやパフォーマンスを目的として、製品ビルド番号を使用した仮想ディレクトリが含まれています。このディレクトリはリンクに含める必要があり、このようなリンクは編集しないことをお薦めします。 以前のバージョンのOracle BAMで作成されたリンクは、製品のアップグレード後は機能しません。 アラートを編集するか、またはレポートのショートカットを再度コピーする必要があります。