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


---

# Präferenzziel: Bereichsbezogen, global

# Präferenzziel: Bereichsbezogen, global {#ariaid-title1}

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

Die Voreinstellungsziel API aktualisiert Anwenderbenachrichtigungseinstellungen.

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.

Ein Anwender kann seine eigenen Benachrichtigungseinstellungen aktualisieren, und ein Administrator kann Benachrichtigungseinstellungen für jeden Anwender aktualisieren. Anwenderbenachrichtigungseinstellungen steuern, welche Ziele welche Benachrichtigungen erhalten.

Verwenden Sie diese API mit [Einstellungen](https://servicenow-prod.fluidtopics.net/Gzc6xuVtRlxG9wMGIQNMxA#PreferencesBothAPI "Die Einstellungen API ruft Benachrichtigungsziele für einen Anwender ab.")API. Bevor Sie Methoden in dieser Klasse aufrufen, müssen Sie aufrufen Einstellungen.getZiele() Oder Einstellungen.getZielByChannel() Methoden zum Instanziieren eines Präferenzzielobjekts.

Diese Klasse verwendet `sn_Notification `Namespace-Bezeichner.

## PreferenceDestination -- getChannel() {#ariaid-title2}

Gibt den Kanal zurück, der zum Senden von Benachrichtigungen an das Ziel verwendet wird.
{#PrefDest-getChannel__table_hhz_g4h_wnb__entry__3}

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

{#PrefDest-getChannel__table_hhz_g4h_wnb} {#PrefDest-getChannel__table_ihz_g4h_wnb__entry__2}

| Typ | Beschreibung |
|-|-|
| GlideRecord | GlideRecord aus der Tabelle „Benachrichtigungskanal" \[sys_Notification_Channel\] für den Kanal, der zum Senden von Benachrichtigungen an das Ziel verwendet wird. |
[Tabelle : 2. Rückgaben]

{#PrefDest-getChannel__table_ihz_g4h_wnb}  
In diesem Beispiel wird der Kanal gedruckt, der zum Senden von Benachrichtigungen für jedes der Ziele von Abel Tuter verwendet wird.

    var recipient = new GlideRecord('sys_user');
    recipient.get('last_name', 'Tuter');
    var prefs = new sn_notification.Preferences(recipient);
    var dests = prefs.getDestinations();
    for (var i=0; i<dests.length; i++) {
         gs.print('Channel for destination '+(i+1)+' is '+dests[i].getChannel().name); 
    }

Ausgabe:

    Channel for destination 1 is Workspace

## PreferenceDestination -- getDeliverTo() {#ariaid-title3}

Gibt den Bezeichner für das Ziel zurück.
{#PrefDest-getDeliverTo__table_uzj_k4h_wnb__entry__3}

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

{#PrefDest-getDeliverTo__table_uzj_k4h_wnb} {#PrefDest-getDeliverTo__table_vzj_k4h_wnb__entry__2}

| Typ | Beschreibung |
|-|-|
| Zeichenfolge | Bezeichner für das Ziel. Beispiel: Eine E-Mail-Adresse, ein Push-Anwendungs-Installationstoken oder eine sys_ID |
[Tabelle : 4. Rückgaben]

{#PrefDest-getDeliverTo__table_vzj_k4h_wnb}  
In diesem Beispiel wird der Bezeichner für jedes der Ziele von Abel Tuter gedruckt. Die Ausgabe zeigt den Bezeichner für Abel an ArbeitsbereichZiel ist die sys_ID des Anwenders

    var recipient = new GlideRecord('sys_user');
    recipient.get('last_name', 'Tuter');
    var prefs = new sn_notification.Preferences(recipient);
    var dests = prefs.getDestinations();
    for (var i=0; i<dests.length; i++) {
         gs.print('The identifier for '+recipient.first_name+'\'s '+dests[i].getDestinationType().name+' destination is '+dests[i].getDeliverTo());
    }

Ausgabe:

    The identifier for Abel's Workspace destination is 62826bf03710200044e0bfc8bcbe5df1

## PreferenceDestination -- getDestinationType() {#ariaid-title4}

Gibt den Typ des Ziels zurück, z. B. private E-Mail-Adresse oder geschäftliche E-Mail-Adresse.
{#PrefDest-getDestinationType__table_fkz_34h_wnb__entry__3}

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

{#PrefDest-getDestinationType__table_fkz_34h_wnb} {#PrefDest-getDestinationType__table_gkz_34h_wnb__entry__2}

| Typ | Beschreibung |
|-|-|
| GlideRecord | GlideRecord aus der Tabelle „Benachrichtigungszieltyp" \[sys_notif_destination_type\] für den Zieltyp. |
[Tabelle : 6. Rückgaben]

{#PrefDest-getDestinationType__table_gkz_34h_wnb}  
In diesem Beispiel wird der Bezeichner für jedes der Ziele von Abel Tuter gedruckt. Die Ausgabe zeigt den Bezeichner für Abel an ArbeitsbereichZiel ist die sys_ID des Anwenders

    var recipient = new GlideRecord('sys_user');
    recipient.get('last_name', 'Tuter');
    var prefs = new sn_notification.Preferences(recipient);
    var dests = prefs.getDestinations();
    for (var i=0; i<dests.length; i++) {
         gs.print('The identifier for '+recipient.first_name+'\'s '+dests[i].getDestinationType().name+' destination is '+dests[i].getDeliverTo());
    }

Ausgabe:

    The identifier for Abel's Workspace destination is 62826bf03710200044e0bfc8bcbe5df1

## Voreinstellungsziel -- isActive (GlideRecord-Benachrichtigung) {#ariaid-title5}

Überprüft, ob das Ziel berechtigt ist, eine Benachrichtigung zu erhalten.
{#PrefDest-isActive_O__table_j4d_bw3_wnb__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| Benachrichtigung | GlideRecord | Optional. Benachrichtigung, um zu überprüfen, ob das Ziel über die Berechtigung zum Empfang dieser Benachrichtigung verfügt. Eine Ausnahme wird ausgelöst, wenn die Benachrichtigung nicht vorhanden ist oder wenn die Benachrichtigung für den Anwender des Ziels nicht lesbar ist. Wenn keine Benachrichtigung angegeben ist, überprüft diese Methode, ob das Ziel über die Berechtigung zum Empfangen von Benachrichtigungen verfügt. |
[Tabelle : 7. Parameter]

{#PrefDest-isActive_O__table_j4d_bw3_wnb} {#PrefDest-isActive_O__table_k4d_bw3_wnb__entry__2}

| Typ | Beschreibung |
|-|-|
| Boolean | Kennzeichnung, die angibt, ob das Ziel über die Berechtigung zum Empfangen einer Benachrichtigung verfügt. Mögliche Werte: * Wahr: Das Ziel hat die Berechtigung, eine Benachrichtigung zu erhalten. * Falsch: Das Ziel hat keine Berechtigung zum Empfangen einer Benachrichtigung. {#PrefDest-isActive_O__ul_jx4_bql_wnb} |
[Tabelle : 8. Rückgaben]

{#PrefDest-isActive_O__table_k4d_bw3_wnb}  
In diesem Beispiel wird überprüft, ob jedes der Ziele von Abel Tuter über die Berechtigung zum Empfang der Benachrichtigung über die Genehmigungsanforderung verfügt.

    var recipient = new GlideRecord('sys_user');
    recipient.get('last_name', 'Tuter');
    var prefs = new sn_notification.Preferences(recipient);
    var dests = prefs.getDestinations();
    var notif = new GlideRecord('sys_notification'); 
    notif.get('name', 'Approval Request'); 
    for (var i=0; i<dests.length; i++) {
       var active = dests[i].isActive(notif) ? 'active' : 'inactive'; 
       gs.print(dests[i].getDestinationType().name + ' ' + dests[i].getDeliverTo() + ' is ' + active + ' for this notification');
    }

Ausgabe:

    Workspace 62826bf03710200044e0bfc8bcbe5df1 is active for this notification

## PreferenceDestination -- isOverriden (GlideRecord-Benachrichtigung) {#ariaid-title6}

Überprüft, ob eine Benachrichtigung die Einstellungen eines Anwenders für das Ziel überschreibt.
{#PrefDest-isOverriden_O__table_s1c_5v3_wnb__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| Benachrichtigung | GlideRecord | Geben Sie An Eine Benachrichtigung, um zu überprüfen, ob Anwendereinstellungen für das Ziel überschrieben werden. Die Benachrichtigung muss ein GlideRecord aus der Benachrichtigungstabelle \[sys_Notification\] sein. |
[Tabelle : 9. Parameter]

{#PrefDest-isOverriden_O__table_s1c_5v3_wnb} {#PrefDest-isOverriden_O__table_t1c_5v3_wnb__entry__2}

| Typ | Beschreibung |
|-|-|
| Boolean | Kennzeichnung, die angibt, ob die Benachrichtigung Anwendereinstellungen für das Ziel überschreibt. Gültige Werte: * Wahr: Anwendereinstellungen für das Ziel werden für diese Benachrichtigung ignoriert. * Falsch: Das Ziel empfängt die Benachrichtigung gemäß der Anwendereinstellung oder empfängt sie nicht. {#PrefDest-isOverriden_O__ul_mcq_txl_wnb} |
[Tabelle : 10. Rückgaben]

{#PrefDest-isOverriden_O__table_t1c_5v3_wnb}  
Dieses Beispiel überprüft, ob die Benachrichtigung über die Genehmigungsanforderung Anwendereinstellungen für eines der Ziele von Abel Tuter überschreibt. Wenn die Benachrichtigung Anwendereinstellungen nicht überschreibt, erhält das Ziel die Berechtigung zum Empfang der Benachrichtigung. Andernfalls wird keine Einstellung festgelegt, da die Benachrichtigung die Einstellung überschreibt.

    var recipient = new GlideRecord('sys_user');
    recipient.get('last_name', 'Tuter');
    var prefs = new sn_notification.Preferences(recipient);
    var dests = prefs.getDestinations();
    var notif = new GlideRecord('sys_notification'); 
    notif.get('name', 'Approval Request'); 
    var firstDest = dests[0]; 
    if (!firstDest.isOverridden(notif)) { 
         dests[0].setActive(notif, true); 
    } else { 
         gs.print('This notification overrides user preference, so don't bother to set a preference.'); 
    } 

## PreferenceDestination -- setActive(GlideRecord-Benachrichtigung, boolescher Wert aktiv) {#ariaid-title7}

Legt die Anwendereinstellung für ein Ziel fest, um Benachrichtigungen zu erhalten oder nicht zu erhalten.
Die IsÜberschrieben() Die Methode kann zuerst aufgerufen werden, um zu überprüfen, ob die Anwendereinstellung ignoriert wird, sie ist jedoch nicht erforderlich.
{#PrefDest-setActive_O_B__table_h3k_kw3_wnb__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| Benachrichtigung | GlideRecord | Optional. Wenn eine Benachrichtigung angegeben ist, wird die Anwendereinstellung so festgelegt, dass das Ziel diese Benachrichtigung empfängt oder nicht empfängt. Die Benachrichtigung muss ein GlideRecord aus der Benachrichtigungstabelle \[sys_Notification\] sein. Wenn keine Benachrichtigung angegeben ist, wird die Anwendereinstellung so festgelegt, dass das Ziel alle Benachrichtigungen empfängt oder nicht empfängt. |
| aktiv | Boolean | Kennzeichnung, die angibt, ob das Ziel über die Berechtigung zum Empfangen einer Benachrichtigung verfügt. Gültige Werte: * Wahr: Das Ziel hat die Berechtigung, eine Benachrichtigung zu erhalten. * Falsch: Das Ziel hat keine Berechtigung zum Empfangen einer Benachrichtigung. {#PrefDest-setActive_O_B__ul_jx4_bql_wnb} |
[Tabelle : 11. Parameter]

{#PrefDest-setActive_O_B__table_h3k_kw3_wnb} {#PrefDest-setActive_O_B__table_i3k_kw3_wnb__entry__2}

| Typ | Beschreibung |
|-|-|
| Keine |   |
[Tabelle : 12. Rückgaben]

{#PrefDest-setActive_O_B__table_i3k_kw3_wnb}  
Dieses Beispiel überprüft, ob die Benachrichtigung über die Genehmigungsanforderung Anwendereinstellungen für eines der Ziele von Abel Tuter überschreibt. Wenn die Benachrichtigung Anwendereinstellungen nicht überschreibt, erhält das Ziel die Berechtigung zum Empfang der Benachrichtigung. Andernfalls wird keine Einstellung festgelegt, da die Benachrichtigung die Einstellung überschreibt.

    var recipient = new GlideRecord('sys_user');
    recipient.get('last_name', 'Tuter');
    var prefs = new sn_notification.Preferences(recipient);
    var dests = prefs.getDestinations();
    var notif = new GlideRecord('sys_notification'); 
    notif.get('name', 'Approval Request'); 
    var firstDest = dests[0]; 
    if (!firstDest.isOverridden(notif)) { 
         dests[0].setActive(notif, true); 
    } else { 
         gs.print('This notification overrides user preference, so don't bother to set a preference.'); 
    } 


