IEventSender - グローバル

IEventSender API は、MID サーバー から ServiceNow インスタンスにイベントを送信し、イベントキューのステータスを照会するメソッドを提供します。

このクラス内のメソッドを呼び出す前に、SNEventSenderProvider.getEventSender() メソッドを呼び出して IEvent オブジェクトをインスタンス化する必要があります。

Event API を使用して、イベント内のフィールドを追加/更新します。SNEventSenderProvider API を使用して、イベント送信者オブジェクトをインスタンス化します。その後で IEventSender API を使用して、ServiceNow インスタンスにイベントを送信します。

この API にアクセスするには、Event Management (com.glideapp.itom.snac) プラグインを有効にする必要があります。イベント管理プラグインには個別のサブスクリプションが必要であり、アクティブ化する必要があります。このプラグインにはデモ データが含まれ、関連プラグインがまだアクティブ化されていない場合はアクティブ化します。

イベント管理の詳細については、「 イベント管理」を参照してください。

IEventSender - getQueueSize()

イベントキューのサイズを返します。

表 : 1. パラメーター

名前	タイプ	説明
なし

表 : 2. 返される内容

タイプ	説明
数字	イベントキューのサイズ。 イベントキューが現在実装されていない場合は「0」を返します。

var event = new Event();
event.setField("source","SAP Solman");
event.setField("severity","3");
event.setField("time_of_event", "2019-18-05 13:12:05");
event.setField("type", "SAP object");
event.setField("user", "admin"); // parameter added to additional info section

var eventSender = SNEventSenderProvider.getEventSender();
var sendStatus = eventSender.sendEvent(event); //send event     
var queueSize = eventSender.getQueueSize() // check the size of the event queue

IEventSender - isFullQueue()

イベントキューが最大サイズを超えたかどうかを確認します。

表 : 3. パラメーター

名前	タイプ	説明
なし

表 : 4. 返される内容

タイプ	説明
ブーリアン	イベントキューが最大サイズを超えたかどうかを示すフラグ。このフラグが出た場合、キューのサイズが小さくなるまで、追加のイベントメッセージをキューに入れることはできません。 有効な値： true：イベントキューが満杯です。 false：イベントキューが満杯でないため、さらにイベントエントリーを追加できます。

var eventSender = SNEventSenderProvider.getEventSender();
if (!eventSender.isFullQueue()) // If queue is not full, send event
  eventSender.sendEvent(event);     

IEventSender - sendEvent(オブジェクト event)

指定されたイベントをイベントキューに配置します。

表 : 5. パラメーター

名前	タイプ	説明
event	IEventSender	イベントキューに配置するイベントオブジェクト。

表 : 6. 返される内容

タイプ	説明
ブーリアン	イベントが正常にキューに格納されたかどうかを示すフラグ。 有効な値： true：イベントがキューに格納されました false：エラー

var eventSender = SNEventSenderProvider.getEventSender();
eventSender.sendEvent(event); //send event