アラート通知
アラート通知技術アクセラレータを使用して、統合エラーまたは失敗が発生するたびにメッセージを送信します。 通知は、電子メール、ページャ、JIRAチケットまたはカスタム・ハンドラを介して送信できます。
説明
すべての統合でアラート通知技術アクセラレータを使用して、エラー通知の受信方法をカスタマイズできます。
このアクセラレータをすべての統合に追加することで、統合エラーまたは失敗が発生したときに通知を受信する単一の一貫性のあるメソッドを使用できます。 問題を解決するためのラウンド時間が短縮され、問題が適切な担当者に転送され、メンテナンスが合理化されて簡素化されます。
REST接続(タイプ、URLおよびセキュリティ・ポリシー)を構成する必要があります。 また、組織のメッセージID、メッセージ件名および通知タイプ(電子メールやページャなど)の値をカスタマイズ
Oracleによって開発された技術アクセラレータでは、接続を置換したり、統合を編集することはできません。
キー・パラメータ
アラート通知技術アクセラレータには、いくつかの必須フィールドまたはキー・パラメータがあります。
| フィールド名 | 説明 |
|---|---|
|
instanceID |
コール側サービスのインスタンスID |
|
instanceID_string |
インスタンスID (将来使用) |
|
IntgCode_Version |
コール側サービスの統合コードおよびバージョン |
|
messageID |
統合に関する特定の通知 |
|
messageDetail |
メッセージIDに対応するメッセージに関する情報 |
|
tracking_Var_1 |
コール側サービスのプライマリ・トラッキング変数 |
|
tracking_Var_2 |
コール側サービスのセカンダリ・トラッキング変数 |
|
tracking_Var_3 |
コール側サービスの3番目のトラッキング変数 |
|
faultCode |
コール側サービスのフォルト・コード |
|
faultReason |
コール側サービスのフォルト理由 |
|
faultDetails |
コール側サービスのフォルト詳細 |
サポートされる通知タイプ
アラート通知技術アクセラレータでは、次のタイプの通知がサポートされています:
-
「Eメール」 - エラー詳細を送信する有効な電子メール・アドレスを指定してください。
-
PagerDuty - ServiceID、EmailID、APITokenおよび割当て先を指定します。
-
「JIRAチケット」 - JIRAユーザー名、アクセス・トークン、プロジェクト・キー、割当て先IDおよびベースURLを指定します。
-
「カスタム・エラー・ハンドラ」 - 独自のエラー通知サービスが必要な場合は、RESTインタフェースを構築し、REST URLと資格証明を指定する必要があります。
接続
Alert Notificationテクニカル・アクセラレータは、次の2つの接続を使用します:
-
「Oracleアラート・サービス・トリガー」 - このREST接続はトリガー操作を処理します。 接続詳細はすでに構成されています。 接続を使用する準備ができました。
-
「Oracleアラート・サービス呼出し」 - このREST接続は呼出し操作を処理します。 次のパラメータを構成する必要があります:
-
接続タイプ: REST APIのベースURL
-
接続URL: 任意の有効なURL
-
セキュリティ・ポリシー: セキュリティ・ポリシーなし
-
ルックアップ
Alert Notificationテクニカル・アクセラレータは、3つのルックアップを使用します。 参照値を編集して、組織の通知サービスをカスタマイズします。
ORCL-T-GENRIC_ENS_NOTIFICATION_SELECTOR_MSGID参照は、次のパラメータを受け入れます:
-
Message_ID
-
Message_Subject
-
Notification_Type
ORCL-T-GENRIC_ENS_NOTIFICATION_DATA参照には、各通知タイプの実際のパラメータが格納されます。
ORCL-T-GENRIC_ENS_NOTIFICATION_SELECTORは、コール側サービスの通知タイプを定義する2つのパラメータを受け入れます。
-
IntegrationCode_Version - コール側サービスの統合コードとバージョンの組合せを指定します。
-
Notification_Type - 通知の種類を指定します。 たとえば、PAGERDUTYやEmailなどです。
各通知タイプに必要な値は次のとおりです。
| 通知タイプ | パラメータ | 指定する値 |
|---|---|---|
|
Eメール |
param1 |
通知の送信先ユーザーの電子メール |
|
PagerDuty |
param1 param2 param3 param4 |
PagerDuty管理者EメールID PagerDuty APIトークン PagerDutyサービスID PagerDuty割当て先 |
|
JIRA |
param1 param2 param3 param4 param5 param6 |
JIRA管理ユーザー名 JIRAアクセス・トークン JIRAプロジェクト名 JIRA問題タイプ名 JIRA担当者ID JIRAベースURL |
|
CUSTOM |
param1 param2 |
カスタム値 |
使用方法
すべての統合で、グローバル・フォルト・ハンドラからGenericErrorNotificationサービスをコールする必要があります。
GenericErrorNotificationサービスの次のパラメータを構成する必要があります:
-
IntegrationCode_Version: たとえば、ORCL-BA-NS2SFDC_INVENITEM_CREATE:: 01.00.0000。
-
InstanceID: マッパー関数を使用して、コール側サービスのインスタンスIDを取得します。 たとえば、
fn:format-number(nsmpr2:getFlowId(), "#")です。 -
FaultCode: GlobalFaultObjectからerrorCodeをマップします。
-
FaultReason: GlobalFaultObjectから理由をマップします。
-
FaultDetails: GlobalFaultObjectから詳細をマップします。