送信通知にプロデューサーフレームワークを使用する

  • リリースバージョン: Washingtondc
  • 更新日 2024年02月01日
  • 読む4読むのに数分
  • プロデューサーフレームワークはインスタンスから ServiceNow イベントを選択し、送信通知を外部システムに送信します。外部システムにインストールされているメッセージングサービスからの通知の詳細を消費できます。

    システムプロパティ

    送信通知にプロデューサーフレームワークを使用するには、システムプロパティを設定する必要があります。次の表では、ジョブスケジュールに設定されているシステムプロパティのリストについて説明します。

    表 : 1. プロデューサーフレームワークのシステムプロパティ
    プロパティ 説明 タイプ
    sn_api_notif_mgmt.event.log
    デバッグログに書き込まれるログのレベル。次のロギングレベルを選択できます。
    • emerg:全面的な失敗。
    • alert: たとえば、データベースのシステムが破損しています。
    • crit: 通常、ハードウェアエラーなどに使用されます。
    • err: エラー。
    • warning: 警告
    • 注意:必要なアクションは可能ですが、必須ではありません。
    • 情報: アクションは必要ありません。
    • debug: 通常、障害検出のためにすべてをキャプチャする以外には使用されません。

    デフォルト値: err

    文字列
    sn_api_notif_mgmt.publisher_message_bus_configuration Hermes Messaging Service、Open Message Bus、またはその両方のメッセージバスを使用してメッセージを公開するかどうかを定義します。次の値を使用できます。
    • openMessageBus
    • エルメス
    • 両方とも

    デフォルト値: openMessageBus

    文字列
    sn_api_notif_mgmt.inboundQueue.maxRecords 1 回のスケジューラー実行でスケジューラーが受信キューからプルするレコードの最大数。この値は、 sn_api_notif_mgmt.inboundqueue.batch.limit パラメーターと組み合わせて使用されます。
    • デフォルト値: 200
    • 使用可能なその他の値:必要に応じて

    たとえば、バッチ制限が 50 に設定され、maxrecords が 200 に設定され、受信キュー内のレコードの数が 130 の場合、スケジューラは 1 回の実行で 3 つの異なるバッチのレコードをプルします。2 つは 50 レコード、もう 1 つは 30 レコードです。受信キューのレコード数が 220 の場合、スケジューラーは 50 レコードの 4 つのバッチをプルし、残りの 20 レコードは次にスケジューラーが実行されるまで処理されません。

    この値を設定するときは、スケジューラーが複数のバッチを処理するのにかかる時間も考慮し、それに応じて sn_api_notif_mgmt.schedule.max.runtime 値を設定する必要があります。

    整数
    sn_api_notif_mgmt.inboundQueue.batch.limit スケジューラーが受信キューから 1 つのバッチでプルして処理するレコードの数。
    • デフォルト値: 200
    • 使用可能なその他の値:必要に応じて
    整数
    sn_api_notif_mgmt.glide.mutex.script.maxspins 受信キューレコードでミューテックスロックを取得する最大試行回数
    • タイプ:整数
    • デフォルト値:100
    • 使用可能なその他の値:必要に応じて
    整数
    sn_api_notif_mgmt.schedule.max.runtime スケジュール設定済みジョブが失敗してエラーを報告するまでに実行できる最大時間 (ミリ秒)。
    • タイプ:整数
    • デフォルト値: 90000
    • 使用可能なその他の値:必要に応じて
    整数
    sn_api_notif_mgmt.glide.mutex.script.spinwait 受信キューのレコードに対するミューテックスロックの取得を試行する間に待機する最大時間 (ミリ秒)。
    • タイプ:整数
    • デフォルト値:100
    • 使用可能なその他の値:必要に応じて
    整数

    プロデューサーフレームワークのワークフロー

    イベントがステージングテーブルにプッシュされると、プロデューサーフレームワークメカニズムの一部として次の手順が実行されます 。
    1. スケジューラーは、事前設定された間隔で多数のレコードを選択し、Glide スナップショットをイベントプロセッサに送信します。
    2. イベントタイプに基づいて、Glide スナップショットが TMF 688 苦情イベントペイロードに変換されます。

      トラブルチケットイベントの TMF 準拠のペイロードを定義および生成するために使用されるメソッドの詳細については、次を参照してください TopicAPIUtilsOOB - Scoped

    3. 通知設定の対象が Hermes Kafka 用かオープンメッセージバス用かがチェックされます。

      プロデューサーイベント通知フレームワークの構成の詳細については、次を参照してください Producer Event Notification Framework developer guide