---
sourceDocument: Référence de l’API Xanadu
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/fr-FR/xanadu/api-reference

 Release :

    - xanadu

ft:locale :

    - fr-FR

ft:publication_title :

    - Référence de l’API Xanadu

ft:clusterId :

    - crapiref

bundleId :

    - crapiref

workflow :

    - Creator


---

# Préférences - Inclus, Global

# Préférences - Inclus, Global {#ariaid-title1}

* Rversion finale: Xanadu
* 
* Mis à jour 1 août 2024
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 1 minute de lecture

L'API Préférences obtient les destinations de notification pour un utilisateur.

Une destination de notification se trouve un endroit où une notification peut être remise, comme une adresse e-mail ou un numéro de téléphone spécifique. Cette API est basée sur les notifications de la table de notification \[sys_notification\]. Les notifications sont envoyées via des canaux tels que l'e-mail ou Espace de travail. Un canal peut être utilisé pour envoyer des notifications à plusieurs types de destinations. Par exemple, un canal de messagerie peut envoyer des notifications à la fois à des destinations d'e-mail personnel et d'e-mail professionnel. Les types de destinations sont répertoriés dans la table Type de destination de notification \[sys_notif_destination_type\].

Utilisez cette API avec l'API [PreferenceDestination](https://servicenow-prod.fluidtopics.net/mjIXpJafRx5AdSkXrPqtjg#PreferenceDestinationBothAPI "L’API PreferenceDestination met à jour les préférences de notification de l’utilisateur.") pour mettre à jour les préférences de notification de l'utilisateur.

Cette classe utilise l'identificateur `d'espace` de noms sn_notification.

## Préférences : préférences (destinataire GlideRecord) {#ariaid-title2}

Instancie un objet Préférences pour un utilisateur spécifié.
{#Preferences-Preferences_O__table_bkn_fx3_wnb__entry__3}

| Nom | Type | Description |
|-|-|-|
| destinataire | GlideRecord | GlideRecord de la table Utilisateur \[sys_user\] pour l'utilisateur pour lequel vous souhaitez obtenir des destinations de notification. |
[Tableau 1. Paramètres]

{#Preferences-Preferences_O__table_bkn_fx3_wnb}  
Cet exemple instancie un objet Préférences pour l'utilisateur Abel Tuter.

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

## Préférences : getDestinations() {#ariaid-title3}

Renvoie les destinations de notification d'un utilisateur.
{#Preferences-getDestinations__table_ept_hx3_wnb__entry__3}

| Nom | Type | Description |
|-|-|-|
| Aucun |   |   |
[Tableau 2. Paramètres]

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

| Type | Description |
|-|-|
| Tableau | Tableau d'objets [PreferenceDestination](https://servicenow-prod.fluidtopics.net/mjIXpJafRx5AdSkXrPqtjg#PreferenceDestinationBothAPI "L’API PreferenceDestination met à jour les préférences de notification de l’utilisateur.") . Si l'utilisateur n'a pas de destinations, le tableau est vide. |
[Tableau 3. Renvoie]

{#Preferences-getDestinations__table_fpt_hx3_wnb}  
Cet exemple obtient toutes les destinations de notification d'Abel Tuter. La sortie montre qu'Abel a une destination.

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

Sortie :

    [object PreferenceDestination]

## Préférences : getDestinationsByChannel(canal GlideRecord) {#ariaid-title4}

Renvoie les destinations de notification d'un utilisateur qui utilisent un canal spécifié.
{#Preferences-getDestinationsByChannel_O__table_x4m_lx3_wnb__entry__3}

| Nom | Type | Description |
|-|-|-|
| canal | GlideRecord | GlideRecord de la table Canal de notification \[sys_notification_channel\] pour le canal sur lequel vous souhaitez filtrer. |
[Tableau 4. Paramètres]

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

| Type | Description |
|-|-|
| Tableau | Tableau d'objets [PreferenceDestination](https://servicenow-prod.fluidtopics.net/mjIXpJafRx5AdSkXrPqtjg#PreferenceDestinationBothAPI "L’API PreferenceDestination met à jour les préférences de notification de l’utilisateur.") . Si l'utilisateur n'a pas de destinations de notification qui utilisent le canal ou si le canal n'existe pas, le tableau est vide. |
[Tableau 5. Renvoie]

{#Preferences-getDestinationsByChannel_O__table_y4m_lx3_wnb}  
Cet exemple obtient toutes les destinations d'Abel Tuter qui utilisent le canal Espace de travail. La sortie montre qu'Abel a une destination qui utilise le canal Espace de travail.

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

Sortie :

    [object PreferenceDestination]