Einstellungen: Bereichsbezogen, Global

Die Preferences 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 Arbeitsbereichgesendet. Ein Kanal kann zum Senden von Benachrichtigungen an mehrere Arten von Zielen verwendet werden. Beispielsweise könnte 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 der PreferenceDestination- API, um die Benachrichtigungseinstellungen des Anwenders zu aktualisieren.

Diese Klasse verwendet den Namespace-Bezeichner sn_notification.

Einstellungen: Preferences(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 denden Anwender, 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);

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- Objekten. Wenn der Anwender 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]

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 denden -Kanal, nach dem Sie filtern möchten.

Tabelle : 5. Ergebnisse

Typ	Beschreibung
Array	Array von PreferenceDestination- Objekten. 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 Workspace-Kanal verwenden. Die Ausgabe zeigt, 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]