Préférences - Inclus, Global

  • Rversion finale: Xanadu
  • Mis à jour 1 août 2024
  • 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 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 des 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 destinations, 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 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]