Einstellungen – Bereichsbezogen, Global

Die Preferences- API ruft Benachrichtigungsziele für einen Benutzer 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 Arbeitsbereichgesendet. Ein Kanal kann zum Senden von Benachrichtigungen an mehrere Arten von Zielen verwendet werden. 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] aufgelistet.

Verwenden Sie diese API mit der PreferenceDestination- API, um die Benutzerbenachrichtigungseinstellungen zu aktualisieren.

Diese Klasse verwendet den Namespace-Identifier sn_notification.

Preferences – getDestinations()

Gibt die Benachrichtigungsziele eines Anwenders zurück.

Tabelle : 1. Parameter

Name	Typ	Beschreibung
Keine

Tabelle : 2. Ergebnisse

Typ	Beschreibung
Array	Array von PreferenceDestination- Objekten. Wenn der Benutzer keine Ziele hat, ist das Array leer.

In diesem Beispiel werden alle Benachrichtigungsziele von Abel Tuter abgerufen. Die Ausgabe zeigt, 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]

Preferences – getDestinationsByChannel(GlideRecord channel)

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

Tabelle : 3. Parameter

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

Tabelle : 4. Ergebnisse

Typ	Beschreibung
Array	Array von PreferenceDestination- Objekten. Wenn der Benutzer 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 Arbeitsbereichskanal verwenden. Die Ausgabe zeigt, dass Abel ein Ziel hat, das den Arbeitsbereichskanal 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]

Preferences – Preferences(GlideRecord recipient)

Instanziiert ein Einstellungsobjekt für einen angegebenen Anwender.

Tabelle : 5. Parameter

Name	Typ	Beschreibung
Empfänger	GlideRecord	GlideRecord aus der Benutzertabelle [sys_user] fürden Benutzer, für den Sie Benachrichtigungsziele abrufen möchten.

In diesem Beispiel wird ein Preferences-Objekt für den Benutzer Abel Tuter instanziiert.

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