Einstellungen: Bereichsbezogen, Global

Die Einstellungen API ruft Benachrichtigungsziele für einen Anwender ab.

Ein Benachrichtigungsziel ist ein Ort, an den eine Benachrichtigung gesendet werden kann, z. B. eine bestimmte E-Mail-Adresse oder Telefonnummer. Diese API basiert auf Benachrichtigungen aus der Benachrichtigungstabelle [sys_Notification]. Benachrichtigungen werden über Kanäle wie E-Mail oder gesendet Arbeitsbereich. Ein Kanal kann verwendet werden, um Benachrichtigungen an mehrere Arten von Zielen zu senden. Beispielsweise kann ein E-Mail-Kanal Benachrichtigungen sowohl an private als auch an geschäftliche E-Mail-Ziele senden. Zieltypen werden in der Tabelle „Benachrichtigungszieltyp“ [sys_notif_destination_type] aufgeführt.

Verwenden Sie diese API mit PreferenceDestination API zum Aktualisieren der Einstellungen für Anwenderbenachrichtigungen.

Diese Klasse verwendet sn_Notification Namespace-Bezeichner.

Einstellungen – Einstellungen (GlideRecord-Empfänger)

Instanziiert ein Einstellungsobjekt für einen angegebenen Anwender.

Tabelle : 1. Parameter

Name	Typ	Beschreibung
Empfänger	GlideRecord	GlideRecord aus der Anwendertabelle [sys_user] für t Er Anwender, für den Sie Benachrichtigungsziele abrufen möchten.

In diesem Beispiel wird ein Einstellungsobjekt für den Anwender Abel Tuter instanziiert.

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

Einstellungen – getDestinations()

Gibt die Benachrichtigungsziele eines Anwenders zurück.

Tabelle : 2. Parameter

Name	Typ	Beschreibung
Keine

Tabelle : 3. Ergebnisse

Typ	Beschreibung
Array	Array von PreferenceDestination Objekte. Wenn der Anwender keine Ziele hat, ist das Array leer.

Dieses Beispiel ruft alle Benachrichtigungsziele von Abel Tuter ab. Die Ausgabe zeigt an, dass Abel ein Ziel hat.

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);

Ausgabe:

[object PreferenceDestination]

Einstellungen – getDestinationsByChannel(GlideRecord-Kanal)

Gibt die Benachrichtigungsziele eines Anwenders zurück, die einen angegebenen Kanal verwenden.

Tabelle : 4. Parameter

Name	Typ	Beschreibung
Kanal	GlideRecord	GlideRecord aus der Tabelle „Benachrichtigungskanal“ [sys_Notification_Channel] für t Er Kanal, nach dem Sie filtern möchten.

Tabelle : 5. Rückgaben

Typ	Beschreibung
Array	Array von PreferenceDestination Objekte. Wenn der Anwender keine Benachrichtigungsziele hat, die den Kanal verwenden, oder wenn der Kanal nicht vorhanden ist, ist das Array leer.

In diesem Beispiel werden alle Ziele von Abel Tuter abgerufen, die den Arbeitsbereich-Kanal verwenden. Die Ausgabe zeigt an, dass Abel ein Ziel hat, das den Arbeitsbereich-Kanal verwendet.

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);

Ausgabe:

[object PreferenceDestination]