ServiceNow Notificationの宛先に関する仕様調査

Notificationの宛先に関する仕様調査

Notificationで宛先を設定する際の仕様について調べました。弊社ブログへも同様の記事を投稿しております。

①Event起動でParameterを宛先にする際、設定可能な内容

以下3つが使用可能なようです。

・Userレコードのsys_id

・Groupレコードのsys_id

・アドレスべた書き

以下サンプル

        // Userレコードを宛先として指定
        gs.eventQueue('event名', Notification対象のGlideRecord, sys_userのsys_id);

        // Groupレコードを宛先として指定
        gs.eventQueue('event名', Notification対象のGlideRecord, sys_user_groupのsys_id);

        // アドレスべた書きで宛先指定
        gs.eventQueue('event名', Notification対象のGlideRecord, "[e-mail]");

②Event起動でParameterを宛先にする際、複数宛先を設定する方法

配列を作成して、最終的に.toStringしたものを渡せばＯＫです。
以下サンプル

    // 宛先ユーザーを配列に追加
	var sendList = [];
	var user = new GlideRecord("sys_user");
	user.addQuery("department.name", "Sales");
	user.query();
	while(user.next()){
        sendList.push(user.sys_id + "");
    }

    // 配列に入れたユーザー達を宛先としEvent起動
    gs.eventQueue('event名', Notification対象のGlideRecord, sendList.toString());

ちなみに、①で記載した３つの内容が混在した配列でも問題なく送付できました。

③Groupを宛先に設定する際の挙動

Groupを宛先にする場合、
もしそのGroupレコードにメールアドレスが設定されていなければ、そのGroupの所属メンバー全員が宛先として自動設定されます。
もしそのGroupレコードにメールアドレスが設定されていれば、そのメールアドレスのみが宛先となり、所属メンバーのアドレス宛には送付されません。その場合、もし所属メンバー宛にも送付したければGroupレコードのInclude Membersカラムをtrueにすれば所属メンバーのアドレスも宛先に含める事が可能です。

④宛先としたUser/Groupレコードにメールアドレスが設定されていなかった際の挙動

宛先にしたUser/Groupの全てにメールアドレスが設定されていなかった場合、そのメール送付はスキップされます。
逆に言うとどれか1つの宛先にさえアドレス設定されていれば、仮に10件指定した宛先のうち9件がアドレスブランクであっても、存在する1件向けに送付はされる事となります。