設定 - スコープ対象、グローバル

設定 API は、ユーザーの通知先を取得します。

通知先とは、特定のメールアドレスや電話番号など、通知を配信できる場所です。この API は、通知 [sys_notification] テーブルからの通知に基づいています。通知は、メールや ワークスペースなどのチャネルを介して送信されます。チャネルを使用して、複数のタイプの宛先に通知を送信できます。たとえば、メールチャネルは、個人用メールと仕事用メールの両方の宛先に通知を送信できます。宛先タイプは、通知宛先タイプ [sys_notif_destination_type] テーブルに一覧表示されます。

この API を PreferenceDestination API とともに使用して、ユーザー通知設定を更新します。

このクラスは、 sn_notification 名前空間識別子を使用します。

設定:設定 (GlideRecord 受信者)

指定されたユーザーの設定オブジェクトをインスタンス化します。

表 : 1. パラメーター

名前	タイプ	説明
受信者	GlideRecord	通知先を取得するユーザーに対するユーザー [sys_user] テーブルからの GlideRecord 。

この例では、ユーザー Abel Tuter の Preferences オブジェクトをインスタンス化します。

var recipient = new GlideRecord('sys_user'); 
recipient.get('last_name', 'Tuter'); 
var prefs = new sn_notification.Preferences(recipient);

設定:getDestinations()

ユーザーの通知先を返します。

表 : 2. パラメーター

名前	タイプ	説明
なし

表 : 3. 返される内容

タイプ	説明
アレイ	PreferenceDestination オブジェクトのアレイ。ユーザーに宛先がない場合、アレイは空です。

この例では、Abel Tuter のすべての通知先を取得します。出力は、Abel の宛先が 1 つであることを示しています。

var recipient = new GlideRecord('sys_user'); 
recipient.get('last_name', 'Tuter'); 
var prefs = new sn_notification.Preferences(recipient);
var dests = prefs.getDestinations();
gs.print(dests);

出力：

[object PreferenceDestination]

設定:getDestinationsByChannel(GlideRecord channel)

指定されたチャネルを使用するユーザーの通知宛先を返します。

表 : 4. パラメーター

名前	タイプ	説明
チャネル	GlideRecord	フィルターを適用するチャネルの通知チャネル [sys_notification_channel] テーブルからの GlideRecord 。

表 : 5. 返される内容

タイプ	説明
アレイ	PreferenceDestination オブジェクトのアレイ。ユーザーがチャネルを使用する通知先を持っていない場合、またはチャネルが存在しない場合、アレイは空です。

この例では、ワークスペースチャネルを使用するすべての Abel Tuter の宛先を取得します。出力は、Abel にワークスペースチャネルを使用する宛先が 1 つあることを示しています。

var recipient = new GlideRecord('sys_user'); 
recipient.get('last_name', 'Tuter'); 
var prefs = new sn_notification.Preferences(recipient);
var channel = new GlideRecord('sys_notification_channel');
channel.get('name', 'Workspace'); 
var dests = prefs.getDestinationsByChannel(channel);
gs.print(dests);

出力：

[object PreferenceDestination]