GlideUser : dans le champ d’application

  • Rversion finale: Yokohama
  • Mis à jour 30 janv. 2025
  • 3 minutes de lecture

    • L’API GlideUser fournit des méthodes pour accéder aux informations sur l’utilisateur actuel et les rôles d’utilisateur actuels.

    L’utilisation de l’API GlideUser évite d’avoir à utiliser les requêtes GlideRecord plus lentes pour obtenir des informations utilisateur.

    GlideUser inclus dans le champ d’application : getCompanyID()

    Renvoie le sys_id de société de l’utilisateur actuel.

    Tableau 1. Paramètres
    Nom Type Description
    Aucun
    Tableau 2. Renvoie
    Type Description
    Chaîne sys_id de l’entreprise. 
    var currentUser = gs.getUser(); 
gs.info(currentUser.getCompanyID());

    GlideUser inclus dans le champ d’application : getDisplayName()

    Renvoie le nom d’affichage de l’utilisateur actuel.

    Tableau 3. Paramètres
    Nom Type Description
    Aucun
    Tableau 4. Renvoie
    Type Description
    Chaîne Nom d’affichage de l’utilisateur 
    var currentUser = gs.getUser(); 
gs.info(currentUser.getDisplayName());

    GlideUser inclus dans le champ d’application : getEmail()

    Renvoie l’adresse e-mail de l’utilisateur.

    Tableau 5. Paramètres
    Nom Type Description
    Aucun
    Tableau 6. Renvoie
    Type Description
    Chaîne Adresse e-mail de l’utilisateur. 
    var currentUser = gs.getUser(); 
gs.info(currentUser.getEmail());

    GlideUser inclus dans le champ d’application : getFirstName()

    Renvoie le prénom de l’utilisateur.

    Tableau 7. Paramètres
    Nom Type Description
    Aucun
    Tableau 8. Renvoie
    Type Description
    Chaîne Prénom de l’utilisateur. 
    var currentUser = gs.getUser(); 
gs.info(currentUser.getFirstName());

    GlideUser inclus dans le champ d’application : getID()

    Obtient le sys_id de l’utilisateur actuel.

    Tableau 9. Paramètres
    Nom Type Description
    Aucun
    Tableau 10. Renvoie
    Type Description
    Chaîne sys_id de l’utilisateur. 
    var currentUser = gs.getUser(); 
gs.info(currentUser.getID());

    GlideUser inclus dans le champ d’application : getLastName()

    Renvoie le nom de famille de l’utilisateur.

    Tableau 11. Paramètres
    Nom Type Description
    Aucun
    Tableau 12. Renvoie
    Type Description
    Chaîne Nom de famille de l’utilisateur. 
    var currentUser = gs.getUser(); 
gs.info(currentUser.getLastName());

    GlideUser inclus dans le champ d’application : getName()

    Renvoie l’ID d’utilisateur, ou le nom de connexion, de l’utilisateur actuel.

    Tableau 13. Paramètres
    Nom Type Description
    Aucun
    Tableau 14. Renvoie
    Type Description
    Chaîne ID d’utilisateur ou nom de connexion. 
    var currentUser = gs.getUser(); 
gs.info(currentUser.getName());

    GlideUser inclus dans le champ d’application : getPreference(nom de chaîne)

    Obtient la valeur de préférence utilisateur spécifiée pour l’utilisateur actuel.

    Tableau 15. Paramètres
    Nom Type Description
    nom Chaîne Nom de la préférence.
    Tableau 16. Renvoie
    Type Description
    Chaîne Valeur de préférence. 
    var currentUser = gs.getUser(); 
currentUser.savePreference(­'myPref','red'); 
gs.info(currentUser.getPreference(­'myPref'));

    GlideUser inclus dans le champ d’application : getRoles()

    Renvoie une liste de rôles qui inclut les rôles explicitement accordés, les rôles hérités et les rôles acquis par appartenance à un groupe.

    Tableau 17. Paramètres
    Nom Type Description
    Aucun
    Tableau 18. Renvoie
    Type Description
    Tableau Liste de tous les rôles disponibles pour l’utilisateur 
    var currentUser = gs.getUser(); 
gs.info(currentUser.getRoles());

    GlideUser dans le champ d’application : getTimeZoneLabel()

    Renvoie l’étiquette du fuseau horaire de l’utilisateur actuel dans la langue préférée de l’utilisateur actuel.

    Pour plus d’informations sur la définition de la langue préférée d’un utilisateur, reportez-vous à la section User specific language.

    Tableau 19. Paramètres
    Nom Type Description
    Aucun
    Tableau 20. Renvoie
    Type Description
    Chaîne L’étiquette du fuseau horaire de l’utilisateur actuel.

    Cet exemple montre comment renvoyer l’étiquette du fuseau horaire de l’utilisateur actuel dans sa langue préférée.

    gs.info(gs.getUser().getTimeZoneLabel());

    Sortie :

    Europe/Dublin

    GlideUser inclus dans le champ d’application : getTimeZoneLabelLang(String language)

    Renvoie l’étiquette de fuseau horaire de l’utilisateur actuel dans la langue spécifiée.

    Tableau 21. Paramètres
    Nom Type Description
    language Chaîne Langue à utiliser pour l’étiquette de fuseau horaire. Situé dans la colonne ID de la table Langue [sys_language].

    Si aucune langue valide n’est fournie, l’étiquette de fuseau horaire est renvoyée en anglais.
    Tableau 22. Renvoie
    Type Description
    Chaîne L’étiquette du fuseau horaire de l’utilisateur actuel.

    Cet exemple montre comment renvoyer l’étiquette de fuseau horaire de l’utilisateur actuel dans une langue spécifiée.

    gs.info(gs.getUser().getTimeZoneLabelLang("es")); //Spanish
gs.info(gs.getUser().getTimeZoneLabelLang("ja")); //Japanese
gs.info(gs.getUser().getTimeZoneLabelLang("jksjsjks")); //invalid

    Sortie :

    Europa/Dublín
ヨーロッパ/ダブリン
Europe/Dublin

    GlideUser inclus dans le champ d’application : getUserRoles()

    Renvoie la liste des rôles explicitement accordés à l’utilisateur.

    Contrairement à la méthode getRoles(), cette méthode ne renvoie pas les rôles dont l’utilisateur hérite ou les rôles acquis à partir de l’appartenance à un groupe.

    Tableau 23. Paramètres
    Nom Type Description
    Aucun
    Tableau 24. Renvoie
    Type Description
    Tableau Liste des rôles explicitement affectés à l’utilisateur. 
    var currentUser = gs.getUser(); 
gs.info(currentUser.getUserRoles());

    GlideUser inclus dans le champ d’application : hasRole(String role)

    Détermine si l’utilisateur actuel dispose du rôle spécifié.

    Tableau 25. Paramètres
    Nom Type Description
    rôle Chaîne Rôle à vérifier.
    Tableau 26. Renvoie
    Type Description
    Booléen Marqueur indiquant si l’utilisateur possède le rôle spécifié.
    Valeurs possibles :
    • vrai : l’utilisateur dispose du rôle spécifié.
    • faux : l’utilisateur ne possède pas le rôle spécifié.
    		 
    var currentUser = gs.getUser(); 
gs.info(currentUser.hasRole('admin'));

    GlideUser inclus dans le champ d’application : isMemberOf(groupe de chaînes)

    Détermine si l’utilisateur actuel est membre du groupe spécifié.

    Tableau 27. Paramètres
    Nom Type Description
    groupe Chaîne Sys_id ou nom du groupe à vérifier.
    Tableau 28. Renvoie
    Type Description
    Booléen Marqueur indiquant si l’utilisateur est membre du groupe spécifié.
    Valeurs possibles :
    • vrai : l’utilisateur est membre du groupe.
    • faux : l’utilisateur n’est pas membre du groupe.

    L’exemple suivant vérifie si l’utilisateur actuel est membre du groupe de gestion de capacité.

    var currentUser = gs.getUser(); 
gs.info(currentUser.isMemberOf('Capacity Mgmt'));

    Sortie :

    false

    GlideUser inclus dans le champ d’application : savePpreference (nom de chaîne, valeur de chaîne)

    Enregistre une valeur de préférence utilisateur dans la base de données.

    Tableau 29. Paramètres
    Nom Type Description
    nom Chaîne Préférence pour enregistrer.
    valide Chaîne Valeur de préférence.
    Tableau 30. Renvoie
    Type Description
    Néant 
    var currentUser = gs.getUser(); 
currentUser.savePreference('myPref','red'); 
gs.info(currentUser.getPreference('myPref'));