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

戻る
戻る
 
次へ
次へ
 

F Oracle BAMアラート・ルール・オプション

次の各項では、アラート・ルールを作成する場合のオプションを示します。

F.1 イベント

イベントは、ルールを起動し、アクションをトリガーします。各ルールに含まれるイベントは1つのみです。 Oracle BAMには、次のイベントがあります。

F.1.1 特定の時間

「特定の時間」イベントを選択したときは、秒、分または時間で時間間隔を選択してルール式を完成する必要があります。

F.1.2 本日の特定の時間

「本日の特定の時間」イベントを選択したときは、アラートを起動する時間を選択してルール式を完成する必要があります。

F.1.3 指定日の特定の時間

「指定日の特定の時間」イベントを選択したときは、アラートを起動する日付と時刻の両方を選択してルール式を完成する必要があります。

F.1.4 時間間隔ごと

「時間間隔ごと」イベントを選択したときは、次の設定を構成してルール式を完成する必要があります。

  • 時間間隔の選択

    アラートを起動する間隔を分数、時間数または日数で設定します。

  • 時間の選択

    ルールが有効となりアラートが起動される時間の範囲を設定します。

F.1.5 指定日の特定の時間以降の日付間隔ごと

「指定日の特定の時間以降の日付間隔ごと」イベントを選択したときは、次の設定を構成してルール式を完成する必要があります。

  • 日付間隔の選択

    アラートを起動する間隔を毎日、毎週、毎月または毎年に設定します。

  • 日付の選択

    ルールが有効となりアラートが起動される日付を設定します。

  • 時間の選択

    ルールが有効となりアラートが起動される時刻を設定します。

F.1.6 レポートの変更時

「レポートの変更時」は、レポートにランタイム変更(レポート定義の変更はなし)が発生したときに起動し、そのたびに変更リストがOracle BAM Serverのレポートに配信されます。 レポートの変更には、データ・オブジェクトのデータに対する変更、および「Active Now」設定による変更を含めることができます。

「レポートの変更時」イベントを選択したときは、次の設定を構成してルール式を完成する必要があります。

  • レポートの選択

    変更を監視するレポートを選択します。

  • <user_name>として実行(このオプションは、アラートを作成するユーザーが管理者ロールのメンバーである場合のみ表示されます。)

    選択したレポートを実行するOracle BAMユーザーを選択します。選択できる実行ユーザーは1人のみです。デフォルトの実行ユーザーは、アラートを作成するログイン済のOracle BAMユーザーです。

    レポート変更に関する通知を受信するのは、実行ユーザーと同等かそれ以上のセキュリティ権限がある受信者のみです。また、レポートで使用するデータ・オブジェクトでは、Oracle BAMアーキテクトによる実装に従って、行レベルのセキュリティが優先されます。

    先頭にハッシュ(#)がある名前は、ディストリビューション・リストです。

    レポートのデータ・オブジェクト行に変更があり、アラート受信者の誰にもその行へのアクセス権がない場合、受信者への通知はありません。

F.1.7 データ・オブジェクトのデータ・フィールド変更時

「データ・オブジェクトのデータ・フィールド変更時」イベントを選択したときは、次の設定を構成してルール式を完成する必要があります。


注意:

「データ・オブジェクトのデータ・フィールドが特定の条件を満たす場合」イベントは、行の挿入と行の更新に対してのみ対応し、行の削除には対応しません。ただし、「データ・オブジェクトのデータ・フィールド変更時」イベントは行の削除に対応します。

  • データ・フィールドの選択

    変更を監視するデータ・オブジェクト・フィールドを選択します。 「フィールドの選択」ダイアログ・ボックスの左上にあるセクションでデータ・オブジェクトを検索し、次に右上にあるセクションでフィールドを選択します。最後に、グループ化する1つ以上のフィールドを選択し、選択したフィールドに対して集計関数を選択します。

  • <user_name>として実行(このオプションは、アラートを作成するユーザーが管理者ロールのメンバーである場合のみ表示されます。)

    選択したレポートを実行するOracle BAMユーザーを選択します。選択できる実行ユーザーは1人のみです。デフォルトの実行ユーザーは、アラートを作成するログイン済のOracle BAMユーザーです。

    レポート変更に関する通知を受信するのは、実行ユーザーと同等かそれ以上のセキュリティ権限がある受信者のみです。また、レポートで使用するデータ・オブジェクトでは、Oracle BAMアーキテクトによる実装に従って、行レベルのセキュリティが優先されます。

    先頭にハッシュ(#)がある名前は、ディストリビューション・リストです。

    レポートのデータ・オブジェクト行に変更があり、アラート受信者の誰にもその行へのアクセス権がない場合、受信者への通知はありません。

F.1.8 レポートのデータ・フィールドが特定の条件を満たす場合

「データ・オブジェクトのデータ・フィールド変更時」イベントを選択したときは、次の設定を構成してルール式を完成する必要があります。

  • レポートの選択

    変更を監視するレポートを選択します。

  • このデータ・フィールドにはxの条件があります

    「アラート・ルール・エディタ」ダイログ・ボックスで、監視するデータ・オブジェクトを選択します。 これで、アラートを起動する条件を設定できます。

    • 行フィルタ: データ・オブジェクトのフィールドにフィルタを作成して、条件を満たしたときにルールを起動する条件を示します。レポート・フィルタで使用できるすべての機能が用意されています。 詳細は、『Oracle Fusion Middleware User's Guide for Oracle Business Activity Monitoring』のデータのフィルタに関する項を参照してください。

    • グループ・フィルタ: 「グループ・フィルタ」は、レポート・フィルタで使用できるすべてのフィルタ機能が用意されている点で「行フィルタ」に類似しています。ここでの特別な機能は、集計関数が適用されているフィールドに対してフィルタを作成できることです。 フィルタ式の作成方法の詳細は、『Oracle Fusion Middleware User's Guide for Oracle Business Activity Monitoring』のデータのフィルタに関する項を参照してください。

    • グループ: 1つ以上のフィールドを選択してグループを作成し、「行フィルタ」タブまたは「グループ・フィルタ」タブで作成したフィルタに複雑性を追加します。

  • <user_name>として実行(このオプションは、アラートを作成するユーザーが管理者ロールのメンバーである場合のみ表示されます。)

    選択したレポートを実行するOracle BAMユーザーを選択します。選択できる実行ユーザーは1人のみです。デフォルトの実行ユーザーは、アラートを作成するログイン済のOracle BAMユーザーです。

    レポート変更に関する通知を受信するのは、実行ユーザーと同等かそれ以上のセキュリティ権限がある受信者のみです。また、レポートで使用するデータ・オブジェクトでは、Oracle BAMアーキテクトによる実装に従って、行レベルのセキュリティが優先されます。

    先頭にハッシュ(#)がある名前は、ディストリビューション・リストです。

    レポートのデータ・オブジェクト行に変更があり、アラート受信者の誰にもその行へのアクセス権がない場合、受信者への通知はありません。

F.1.9 データ・オブジェクトのデータ・フィールドが特定の条件を満たす場合

「データ・オブジェクトのデータ・フィールドが特定の条件を満たす場合」イベントを選択したときは、次の設定を構成してルール式を完成する必要があります。


注意:

「データ・オブジェクトのデータ・フィールドが特定の条件を満たす場合」イベントは、行の挿入と行の更新に対してのみ対応し、行の削除には対応しません。ただし、「データ・オブジェクトのデータ・フィールド変更時」イベントは行の削除に対応します。

  • このデータ・フィールドにはxの条件があります

    「アラート・ルール・エディタ」ダイログ・ボックスで、監視するデータ・オブジェクトを選択します。 これで、アラートを起動する条件を設定できます。

    • 行フィルタ: データ・オブジェクトのフィールドにフィルタを作成して、条件を満たしたときにルールを起動する条件を示します。レポート・フィルタで使用できるすべての機能が用意されています。 詳細は、『Oracle Fusion Middleware User's Guide for Oracle Business Activity Monitoring』のデータのフィルタに関する項を参照してください。

    • グループ・フィルタ: 「グループ・フィルタ」は、レポート・フィルタで使用できるすべてのフィルタ機能が用意されている点で「行フィルタ」に類似しています。ここでの特別な機能は、集計関数が適用されているフィールドに対してフィルタを作成できることです。 フィルタ式の作成方法の詳細は、『Oracle Fusion Middleware User's Guide for Oracle Business Activity Monitoring』のデータのフィルタに関する項を参照してください。

    • グループ: 1つ以上のフィールドを選択してグループを作成し、「行フィルタ」タブまたは「グループ・フィルタ」タブで作成したフィルタに複雑性を追加します。

  • <user_name>として実行(このオプションは、アラートを作成するユーザーが管理者ロールのメンバーである場合のみ表示されます。)

    選択したレポートを実行するOracle BAMユーザーを選択します。選択できる実行ユーザーは1人のみです。デフォルトの実行ユーザーは、アラートを作成するログイン済のOracle BAMユーザーです。

    先頭にハッシュ(#)がある名前は、ディストリビューション・リストです。

    レポート変更に関する通知を受信するのは、実行ユーザーと同等かそれ以上のセキュリティ権限がある受信者のみです。また、レポートで使用するデータ・オブジェクトでは、Oracle BAMアーキテクトによる実装に従って、行レベルのセキュリティが優先されます。

    レポートのデータ・オブジェクト行に変更があり、アラート受信者の誰にもその行へのアクセス権がない場合、受信者への通知はありません。

F.1.10 このルールの起動時

「このルールの起動時」イベントは、「ルールの起動」アクションを使用している他のルールに従ってルールを作成する場合に使用します。階層内で「このルールの起動時」を使用すると、複数のルールを作成できます。

F.2 条件

条件はアラートが起動される期間を制限するためのオプション設定です。条件はいくつでも、どのような組合せでも選択できます。 Oracle BAMには、次の条件があります。

F.2.1 時間間隔の場合

ルールを起動する時間範囲を示す2つの時刻を選択します。

F.2.2 日間隔の場合

ルールを起動する日付範囲を示す2つの日付を選択します。

F.2.3 特定の曜日の場合

ルールを起動する曜日を選択します。

F.3 アクション

アクションは、ルール式で満たした条件とイベントの結果です。アクションはいくつでも、どのような組合せでも構成できます。 Oracle BAMには、次のアクションがあります。

F.3.1 電子メールでレポートを送信

レポートを選択し、そのレポートをレポート・リンクまたはレンダリングされたレポートとして送信するように選択して、受信者を選択します。

F.3.2 電子メールでメッセージを送信

送信する電子メール・メッセージを作成し、受信者を選択します。

F.3.3 電子メールでレポートを送信し、指定期間の経過後別のユーザーにエスカレート

指定したユーザーに送信するレポートを選択します。最初の受信者が指定時間内に応答しない場合にメッセージを受信する2番目の受信者を選択します。2番目の受信者は、1人のユーザーまたはディストリビューション・リストのいずれかです。

アラート・ルールの条件を満たすと、レポート・リンクが受信者に送信されます。 このアラートに応答するために、受信者は、レポート・リンクをクリックしてレポートを表示する必要があります。 受信者がレポートを表示しないと、そのレポートは2番目のユーザー(またはディストリビューション・リスト)にエスカレートされます。

F.3.4 パラメータ化されたメッセージを送信

このオプションを使用すると、パラメータ入力が必要なレポートをOracle BAMユーザーに電子メールで送信できます。 このアクションでは、完全に構成可能な電子メール・メッセージと、レポートに渡されるパラメータ値を作成できます。

Oracle BAMダッシュボードでのプロンプトおよびパラメータの作成方法については、『Oracle Fusion Middleware User's Guide for Oracle Business Activity Monitoring』のプロンプトおよびパラメータの使用に関する項を参照してください。

このオプションを使用すると、アラート・メッセージに指定した条件に従って、レポートを他のユーザーに送信できます。このアクションは、「データ・オブジェクトのデータ・フィールド変更時」および「データ・オブジェクトのデータ・フィールドが特定の条件を満たす場合」イベントで使用できます。

このアラート・アクションでは、「メッセージの作成」と「パラメータの設定」の2つのプロパティを構成する必要があります。

bam_alert_param_expr.gifの説明は次にあります。
図bam_alert_param_expr.gifの説明

メッセージを作成する手順は、次のとおりです。

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

  2. 受信者に送信する件名およびメッセージを入力します。 図F-1に示すように、メッセージ本文で、送信するレポートへのリンクを選択することもできます。

    図F-1 「アラート・メッセージ」ダイアログ・ボックス

    図F-1の説明は次にあります。
    「図F-1 「アラート・メッセージ」ダイアログ・ボックス」の説明

受信者がレポートを開くときにレポートに渡されるパラメータ値を構成する手順は、次のとおりです。

  1. ルール式で、「パラメータの設定」をクリックします。

  2. 「アラート・アクション・パラメータの作成および編集」ダイアログ・ボックスで、「ユーザー」「配信」および「レポート」の各フィールドに事前定義済の値を移入するか、またはデータ・オブジェクト・フィールドから動的に移入します。 各ボタンを使用してフィールド値を設定します。 「フィールドの選択」を使用すると、データ・オブジェクトのフィールドを値として選択できます。

    図F-2 「アラート・アクション・パラメータの作成および編集」ダイアログ・ボックス

    図F-2の説明は次にあります。
    「図F-2 「アラート・アクション・パラメータの作成および編集」ダイアログ・ボックス」の説明

    • 「ユーザー」フィールド

      「ユーザーの選択」ボタンを使用してこのフィールドに移入する場合は、図F-3に示すように、Oracle BAMアドミニストレータにリスト表示されるOracle BAMユーザーから受信者を選択します。

      図F-3 「名前の選択」ダイアログ・ボックス

      図F-3の説明は次にあります。
      「図F-3 「名前の選択」ダイアログ・ボックス」の説明

    • 「配信」フィールド

      このフィールドにリストの事前定義済の値を移入する場合、このフィールドに表示される値は、Emailのみです。

      フィールドがsmtpに設定されたデータ・オブジェクトを移入する必要があるときは、「フィールドの選択」ボタンの使用はお薦めしません。これは、サポートされている配信方法がEmailのみであるためです (他の配信オプションはサポートされていません)。

    • 「レポート」フィールド

      「レポートの選択」ボタンを使用してこのフィールドに移入する場合、このフィールドに表示される値は、レポートの表示名です。

      データ・オブジェクトからこのフィールドに移入する場合の値は、レポートの表示名ではなくレポートIDである必要があります。 レポートIDを取得するには、レポートをクリックし、「ショートカットのコピー」リンクをクリックします。 次のようなリンクが示されているウィンドウが開きます。

      http://myServer/oraclebam/ReportServer/default.aspx?Event=ViewReport&
      ReportDef=1&Buttons=False
      

      このリンクでは、ReportDefの値(1)がレポートEmp_ReportのレポートIDです。Oracle Business Activity Monitoring内のすべてのレポートに、一意のレポートIDがあります。

  3. レポート・パラメータ値を構成します。

    レポートに必要なすべてのパラメータを入力します。

    「レポート・パラメータ値」リストで、「新規」をクリックし、パラメータを構成します。

    bam_alert_para_cfg_cr.gifの説明は次にあります。
    図bam_alert_para_cfg_cr.gifの説明

    「名前」フィールドにパラメータ名を入力して、「フィールドの選択」をクリックし、パラメータが機能するフィールドを選択します。

    bam_alert_para_cfg_nm.gifの説明は次にあります。
    図bam_alert_para_cfg_nm.gifの説明

    パラメータ値を入力するか、「フィールドの選択」ダイアログ・ボックスでフィールドを選択し、「OK」をクリックします。

    特殊な値には、_ALL_、_BLANK_、_NULL_など、アンダースコア(_)を使用します。

    bam_alert_para_cfg_fld.gifの説明は次にあります。
    図bam_alert_para_cfg_fld.gifの説明

    選択したフィールドIDが「値」テキスト・ボックスに表示されます。 「OK」をクリックして確認し、パラメータ・リストに戻ります。

    bam_alert_para_cfg_sel.gifの説明は次にあります。
    図bam_alert_para_cfg_sel.gifの説明

F.3.5 ルールの起動

「このルールの起動時」イベントを含む依存ルールを選択します。 依存ルールの構成例については、第37.5項「複合アラートの作成」を参照してください。

F.3.6 アクションが失敗した場合、ルールを起動

ルールに含まれるアクションのいずれかが失敗したときに起動する依存ルールを選択します。 依存ルールの構成例については、第37.5項「複合アラートの作成」を参照してください。

F.3.7 データ・オブジェクトから行を削除

データ・オブジェクトを選択し、フィルタ条件が満たされたときに行がデータ・オブジェクトから削除されるフィルタ・エントリを構成します。

F.3.8 Webサービスのコール

このアクションを選択した場合は、次の手順に従ってWebサービスを構成します。

  1. WebサービスまたはWSILエンドポイントURLを入力します。 URLは、「http」スキームで開始し、有効な拡張子(?WSDL、.WSDLまたは.WSIL)で終了している必要があります。

    次に例を示します。

    http://host_name:port_number/OracleBAMWS/WebServices/DataObjectOperationsByID?WSDL
    
    http://api.google.com/GoogleSearch.wsdl
    
    http://host_name:port_number/inspection.wsil
    

    安全性の高いWebサービスの場合は、ボックスを選択し、必要な資格証明を入力します。


    注意:

    Oracle BAMでは、Webサービスをホストしているサーバーが保護サーバーの背後にあるかどうかを判断できません。 WebサービスがHTTP基本認証ベース・サーバーの背後にあるかどうかを示すことは開発者の責任であり、資格証明が必要な場合は、有効な資格証明を入力する必要があります。

  2. 「サービスの表示」をクリックして、フィールドに入力したURLの使用可能なサービスを表示します。

  3. 「パラメータのマップ」をクリックします。

    イベントがデータ・オブジェクトの変更に基づいている場合(例: 「データ・オブジェクトのデータ・フィールド変更時」「レポートのデータ・フィールドが特定の条件を満たす場合」「データ・オブジェクトのデータ・フィールドが特定の条件を満たす場合」)は、パラメータをマップできるフィールドの選択リストが表示されます。

    パラメータをマップするには 「データ・オブジェクト・フィールド」オプションを選択し、「Webサービスのアラート - パラメータ・マッピング」ダイアログ・ボックスに表示された各Webサービス・パラメータの横にあるリストからデータ・オブジェクト・フィールドを選択します。

    イベントがデータ・オブジェクトの変更に基づいていない場合は、値をテキスト・ボックスに入力します。

  4. 「OK」をクリックして「Webサービスのアラート - パラメータ・マッピング」ダイアログ・ボックスと「Webサービス設定のアラート」ダイアログを閉じます。


注意:

Webサービスがコールに応答しない場合、レスポンスなしや失敗に関する使用可能なログはありません。

F.3.9 Oracle Data Integratorシナリオの実行

このアクションを使用して、Oracle Data Integratorにあるシナリオをトリガーします。 このアクションを使用できるのは、Oracle Data Integrator統合ファイルがインストールされている場合のみです。 詳細は、第34.2項「Oracle Data Integrator統合ファイルのインストール」を参照してください。

Oracle Data Integratorエージェントが実行中で、そのエージェントのホスト、ポートおよびログイン資格証明がOracle Enterprise Manager Fusion Middleware Controlに適切に構成されている必要があります。 Oracle BAMではOracle Data Integratorエージェントが実行中であることの検証はされません。エージェントが実行中でない場合、アラートは起動しますが、必要なアクションは実行されません。 また、Oracle Data IntegratorシナリオをトリガーするOracle BAMアラートは、Oracle Data Integratorシナリオ・コールの成功または失敗を追跡せず、Oracle BAM側で記録されることもありません。 詳細は、『Oracle Fusion Middleware Oracle SOA Suite管理者ガイド』のOracle Data Integratorプロパティの構成に関する項を参照してください。

「アラートの作成」ダイアログで、ドロップダウン・リストからシナリオの名前とバージョンを選択して、起動するOracle Data Integratorシナリオを選択します。

シナリオで変数が使用されている場合は、値を選択(値を入力するか、データ・オブジェクトからフィールド値を選択)して、同じ画面の「シナリオ変数」に渡します。

F.4 頻度制限

頻度制限機能は、特定の時間間隔の間に送信できるアラート・メッセージの件数を制限することによって、ユーザーの電子メール受信ボックスがアラートでいっぱいになることを防止します。

頻度制限は、選択したイベントに対して適切な場合にのみ編集できます。そうでない場合は、使用できません。頻度制限は、時間の値(秒、分または時間)に設定できます。

これによって、ある期間にルールが起動する回数が制限されます。リアルタイム・データでは、トランザクションが1ミリ秒ごとに発生する可能性があるため、アラートの頻度を制御する必要があります。