---
sourceDocument: Xanadu-API-Referenz
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/de-DE/xanadu/api-reference

 Release :

    - xanadu

ft:locale :

    - de-DE

ft:publication_title :

    - Xanadu-API-Referenz

ft:clusterId :

    - crapiref

bundleId :

    - crapiref

workflow :

    - Creator


---

# Einstellungen: Bereichsbezogen, Global

# Einstellungen: Bereichsbezogen, Global {#ariaid-title1}

* Freigeben Version: Xanadu
* 
* Aktualisiert 1. August 2024
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 1 Minute Lesedauer

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-](https://servicenow-prod.fluidtopics.net/jkHclvfXPQw7dzdj5f~WfA#PreferenceDestinationBothAPI "Die PreferenceDestination- API aktualisiert die Benachrichtigungseinstellungen des Anwenders.") API, um die Benachrichtigungseinstellungen des Anwenders zu aktualisieren.

Diese Klasse verwendet den Namespace-Bezeichner `sn_notification`.

## Einstellungen: Preferences(GlideRecord-Empfänger) {#ariaid-title2}

Instanziiert ein Einstellungsobjekt für einen angegebenen Anwender.
{#Preferences-Preferences_O__table_bkn_fx3_wnb__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| Empfänger | GlideRecord | GlideRecord aus der Anwendertabelle \[sys_user\] für denden Anwender, für den Sie Benachrichtigungsziele abrufen möchten. |
[Tabelle : 1. Parameter]

{#Preferences-Preferences_O__table_bkn_fx3_wnb}  
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() {#ariaid-title3}

Gibt die Benachrichtigungsziele eines Anwenders zurück.
{#Preferences-getDestinations__table_ept_hx3_wnb__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| Keine |   |   |
[Tabelle : 2. Parameter]

{#Preferences-getDestinations__table_ept_hx3_wnb} {#Preferences-getDestinations__table_fpt_hx3_wnb__entry__2}

| Typ | Beschreibung |
|-|-|
| Array | Array von [PreferenceDestination-](https://servicenow-prod.fluidtopics.net/jkHclvfXPQw7dzdj5f~WfA#PreferenceDestinationBothAPI "Die PreferenceDestination- API aktualisiert die Benachrichtigungseinstellungen des Anwenders.") Objekten. Wenn der Anwender keine Ziele hat, ist das Array leer. |
[Tabelle : 3. Ergebnisse]

{#Preferences-getDestinations__table_fpt_hx3_wnb}  
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) {#ariaid-title4}

Gibt die Benachrichtigungsziele eines Anwenders zurück, die einen angegebenen Kanal verwenden.
{#Preferences-getDestinationsByChannel_O__table_x4m_lx3_wnb__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| Kanal | GlideRecord | GlideRecord aus der Tabelle „Benachrichtigungskanal" \[sys_notification_channel\] für denden -Kanal, nach dem Sie filtern möchten. |
[Tabelle : 4. Parameter]

{#Preferences-getDestinationsByChannel_O__table_x4m_lx3_wnb} {#Preferences-getDestinationsByChannel_O__table_y4m_lx3_wnb__entry__2}

| Typ | Beschreibung |
|-|-|
| Array | Array von [PreferenceDestination-](https://servicenow-prod.fluidtopics.net/jkHclvfXPQw7dzdj5f~WfA#PreferenceDestinationBothAPI "Die PreferenceDestination- API aktualisiert die Benachrichtigungseinstellungen des Anwenders.") Objekten. Wenn der Anwender keine Benachrichtigungsziele hat, die den Kanal verwenden, oder wenn der Kanal nicht vorhanden ist, ist das Array leer. |
[Tabelle : 5. Ergebnisse]

{#Preferences-getDestinationsByChannel_O__table_y4m_lx3_wnb}  
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]