Préférences : Définie, Globale

  • Rversion finale: Zurich
  • Mis à jour 31 juil. 2025
  • 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 par le biais de 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 le tableau 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
    Aucun
    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 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 pas de destinations 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 Workspace.

    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]