Préférences : incluse dans le périmètre, globale

  • Rversion finale: Australia
  • Mis à jour 12 mars 2026
  • 1 minute de lecture

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

    Une destination de notification est 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 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 destinataires de messagerie personnelle et professionnelle. 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 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)

    Instancie un objet Préférences pour un utilisateur spécifié.

    Tableau 1. Paramètres
    Nom Type Description
    destinataire GlideRecord GlideRecord de la table Utilisateur [sys_user] pour l’utilisateur pour lequel vous souhaitez obtenir les destinations de notification.

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

    Renvoie les destinations de notification d’un utilisateur.

    Tableau 2. Paramètres
    Nom Type Description
    Néant
    Tableau 3. Renvoie
    Type Description
    Tableau Tableau d’objets PreferenceDestination . Si l’utilisateur n’a pas de destination, le tableau est vide.

    Cet exemple obtient toutes les destinations de notification d’Abel Tuter. La sortie montre qu’Abel a une seule 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)

    Renvoie les destinations de notification d’un utilisateur qui utilisent un canal spécifié.

    Tableau 4. Paramètres
    Nom Type Description
    canal GlideRecord GlideRecord de la table Canal de notification [sys_notification_channel] pour le canal sur lequel vous souhaitez filtrer.
    Tableau 5. Renvoie
    Type Description
    Tableau Tableau d’objets PreferenceDestination . Si l’utilisateur n’a aucune destination de notification qui utilisent le canal ou si le canal n’existe pas, le tableau est vide.

    Cet exemple obtient toutes les destinations d’Abel Tuter qui utilisent le canal Workspace. La sortie montre qu’Abel a une destination qui utilise le canal de l’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]