GlideUser : inclus dans le champ d’application

  • Rversion finale: Xanadu
  • Mis à jour 1 août 2024
  • 3 minutes de lecture

    • L’API GlideUser fournit des méthodes permettant d’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 sur l’utilisateur.

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

    Renvoie les sys_id de la 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 périmètre : 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 les 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 incluant les rôles explicitement accordés, les rôles hérités et les rôles acquis par appartenance au 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 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 au groupe.

    Tableau 19. Paramètres
    Nom Type Description
    Aucun
    Tableau 20. 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(rôle de chaîne)

    Détermine si l’utilisateur actuel possède le rôle spécifié.

    Tableau 21. Paramètres
    Nom Type Description
    role Chaîne Rôle à vérifier.
    Tableau 22. Renvoie
    Type Description
    Booléen Marqueur indiquant si l’utilisateur possède le rôle spécifié.
    Valeurs possibles :
    • true : l’utilisateur a le rôle spécifié.
    • false : 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 23. Paramètres
    Nom Type Description
    groupe Chaîne Groupe à vérifier.
    Tableau 24. 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 spécifié.
    • false : l’utilisateur n’est pas membre du groupe spécifié.
    		 
    var currentUser = gs.getUser(); 
gs.info(currentUser.isMemberOf(­'Capacity Mgmt'));

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

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

    Tableau 25. Paramètres
    Nom Type Description
    nom Chaîne Préférence d’enregistrement.
    valide Chaîne Valeur de préférence.
    Tableau 26. Renvoie
    Type Description
    Aucun 
    var currentUser = gs.getUser(); 
currentUser.savePreference('myPref','red'); 
gs.info(currentUser.getPreference('myPref'));