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

 Release :

    - yokohama

ft:locale :

    - de-DE

ft:publication_title :

    - Yokohama-API-Referenz

ft:clusterId :

    - crapiref

bundleId :

    - crapiref

workflow :

    - Creator


---

# Einstellungen: Umfang, Global

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

* Freigeben Version: Yokohama
* 
* Aktualisiert 30. Januar 2025
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 1 Minute Lesedauer

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 Zieltypen zu senden. Beispielsweise könnte ein E-Mail-Kanal Benachrichtigungen sowohl an private E-Mail-Ziele 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 [Voreinstellungsziel](https://servicenow-prod.fluidtopics.net/O2V1inK~6T76Auuvum9rcw#PreferenceDestinationBothAPI "Die Voreinstellungsziel API aktualisiert Anwenderbenachrichtigungseinstellungen.")API zum Aktualisieren von Anwenderbenachrichtigungseinstellungen.

Diese Klasse verwendet `sn_Notification `Namespace-Bezeichner.

## Einstellungen -- Einstellungen (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 t Er Anwender, für den Sie Benachrichtigungsziele abrufen möchten. |
[Tabelle : 1. Parameter]

{#Preferences-Preferences_O__table_bkn_fx3_wnb}  
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() {#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 [Voreinstellungsziel](https://servicenow-prod.fluidtopics.net/O2V1inK~6T76Auuvum9rcw#PreferenceDestinationBothAPI "Die Voreinstellungsziel API aktualisiert Anwenderbenachrichtigungseinstellungen.")Objekte. Wenn der Anwender keine Ziele hat, ist das Array leer. |
[Tabelle : 3. Rückgaben]

{#Preferences-getDestinations__table_fpt_hx3_wnb}  
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) {#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 t Er 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 [Voreinstellungsziel](https://servicenow-prod.fluidtopics.net/O2V1inK~6T76Auuvum9rcw#PreferenceDestinationBothAPI "Die Voreinstellungsziel API aktualisiert Anwenderbenachrichtigungseinstellungen.")Objekte. Wenn der Anwender keine Benachrichtigungsziele hat, die den Kanal verwenden, oder wenn der Kanal nicht vorhanden ist, ist das Array leer. |
[Tabelle : 5. Rückgaben]

{#Preferences-getDestinationsByChannel_O__table_y4m_lx3_wnb}  
Dieses Beispiel ruft alle Ziele von Abel Tuter ab, die den Arbeitsbereichskanal 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]


