GlideUser - Inclus dans l’étendue

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

    • L’API GlideUser incluse dans le champ d’application permet d’accéder à des informations sur l’utilisateur actuel et les rôles d’utilisateur actuels. L’utilisation de l’API GlideUser incluse dans le périmètre évite d’avoir à utiliser les requêtes GlideRecord plus lentes pour obtenir des informations utilisateur.

    GlideUser inclus dans l’étendue : getCompanyID()

    Renvoie le sys_id de l’entreprise 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 l’étendue : 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 l’étendue : 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 de messagerie de l’utilisateur 
    var currentUser = gs.getUser(); 
gs.info(currentUser.getEmail());

    GlideUser inclus dans l’étendue : 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 l’étendue : 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 l’étendue : 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 l’étendue : getName()

    Renvoie l’ID d’utilisateur, ou 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 
    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 Le nom de la préférence.
    Tableau 16. Renvoie
    Type Description
    Chaîne La valeur de préférence. 
    var currentUser = gs.getUser(); 
currentUser.savePreference(­'myPref','red'); 
gs.info(currentUser.getPreference(­'myPref'));

    GlideUser inclus dans l’étendue : 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 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 l’étendue : 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 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 l’étendue : hasRole(String role)

    Détermine si l’utilisateur actuel a 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 Vrai si l’utilisateur dispose du rôle. 
    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 Vrai si l’utilisateur est membre du groupe. 
    var currentUser = gs.getUser(); 
gs.info(currentUser.isMemberOf(­'Capacity Mgmt'));

    GlideUser inclus dans le périmètre : 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 à enregistrer.
    valide Chaîne La valeur de préférence.
    Tableau 26. Renvoie
    Type Description
    Néant 
    var currentUser = gs.getUser(); 
currentUser.savePreference('myPref','red'); 
gs.info(currentUser.getPreference('myPref'));