Préférences - Champ d’application, Global

  • Rversion finale: Washingtondc
  • Mis à jour 1 févr. 2024
  • 1 minute de lecture

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

    Une destination de notification se trouve à un endroit où une notification peut être transmise, 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 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 : getDestinations()

    Renvoie les destinations de notification d’un utilisateur.

    Tableau 1. Paramètres
    Nom Type Description
    Aucun
    Tableau 2. 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 3. Paramètres
    Nom Type Description
    canal GlideRecord GlideRecord à partir de la table Canal de notification [sys_notification_channel] pour le canal sur lequel vous souhaitez filtrer.
    Tableau 4. 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]

    Préférences : préférences (destinataire GlideRecord)

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

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

    Cet exemple instancie un objet Preferences pour l’utilisateur Abel Tuter.

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