GlideUser : global

  • Rversion finale: Yokohama
  • Mis à jour 30 janv. 2025
  • 7 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 : 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 la société 
    var currentUser = gs.getUser(); 
gs.info(currentUser.getCompanyID());

    Équivalent dans le champ d’application

    Pour utiliser la méthode getCompanyID() dans une application incluse dans le périmètre, utilisez la méthode incluse dans le périmètre correspondante : getCompanyID().

    GlideUser : 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());

    Équivalent dans le champ d’application

    Pour utiliser la méthode getDisplayName() dans une application incluse dans le périmètre, utilisez la méthode correspondante dans le champ d’application : getDisplayName().

    GlideUser : getDomainDisplayValue()

    Renvoie la valeur d’affichage du domaine de session de l’utilisateur.

    Tableau 5. Paramètres
    Nom Type Description
    Aucun
    Tableau 6. Renvoie
    Type Description
    Chaîne La valeur d’affichage du domaine de session de l’utilisateur. 
    var currentUser = gs.getUser(); 
gs.info(currentUser.getDomainDisplayValue());

    Équivalent dans le champ d’application

    Il n’existe aucune solution de contournement pour les applications incluses dans le périmètre.

    GlideUser : getDomainID()

    Renvoie l’identificateur du domaine de la session en cours de l’utilisateur.

    L’identificateur renvoyé dépend du type de domaine et de l’instanciation de ce domaine.

    • Si l’utilisateur est configuré dans le domaine global et n’utilise pas le sélecteur de domaine pour changer de domaine, la méthode renvoie null.
    • Si l’utilisateur utilise le sélecteur de domaine pour passer au domaine global, la méthode renvoie la chaîne « global ».
    • Pour tous les autres domaines, la méthode renvoie le sys_id de ce domaine.
    Tableau 7. Paramètres
    Nom Type Description
    Aucun
    Tableau 8. Renvoie
    Type Description
    Chaîne Identificateur de domaine. 
    var domain = new GlideRecord('domain');
domain.get(gs.getUser().getDomainID());
gs.info(domain.name);

    GlideUser : getEmail()

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

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

    Équivalent dans le champ d’application

    Pour utiliser la méthode getEmail() dans une application incluse dans le périmètre, utilisez la méthode incluse dans le périmètre correspondante : getEmail().

    GlideUser : getFirstName()

    Renvoie le prénom de l’utilisateur.

    Tableau 11. Paramètres
    Nom Type Description
    Aucun
    Tableau 12. Renvoie
    Type Description
    Objet/Chaîne Prénom de l’utilisateur.
    Remarque :
    Le type de données de la valeur renvoyée est objet, mais les informations sont renvoyées sous forme de chaîne.
    		 
    var currentUser = gs.getUser(); 
var userName = currentUser.getFirstName();
gs.info('User First Name: + userName);
gs.info('Data type: ' + typeof userName);
    *** Script: User First Name: John
*** Script: Data type: object

    Équivalent dans le champ d’application

    Pour utiliser la méthode getFirstName() dans une application incluse dans le périmètre, utilisez la méthode incluse dans le périmètre correspondante : getFirstName().

    GlideUser : getID

    Renvoie le sys_id de l’utilisateur actuel.

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

    Équivalent dans le champ d’application

    Pour utiliser la méthode getID() dans une application incluse dans le périmètre, utilisez la méthode incluse dans le périmètre correspondante : getID().

    GlideUser : getLastName()

    Renvoie le nom de famille de l’utilisateur.

    Tableau 15. Paramètres
    Nom Type Description
    Aucun
    Tableau 16. Renvoie
    Type Description
    Objet/Chaîne Nom de famille de l’utilisateur.
    Remarque :
    Le type de données de la valeur renvoyée est objet, mais les informations sont renvoyées sous forme de chaîne.
    		 
    var currentUser = gs.getUser(); 
var userName = currentUser.getLastName();
gs.info('User Last Name: + userName);
gs.info('Data type: ' + typeof userName);
    *** Script: User Last Name: Smith
*** Script: Data type: object

    Équivalent dans le champ d’application

    Pour utiliser la méthode getLastName() dans une application incluse dans le périmètre, utilisez la méthode correspondante dans le champ d’application : getLastName().

    GlideUser : getMyGroups()

    Renvoie un itérateur contenant la liste de tous les groupes auxquels l’utilisateur appartient. Seuls les groupes actifs sont renvoyés.

    Tableau 17. Paramètres
    Nom Type Description
    Aucun
    Tableau 18. Renvoie
    Type Description
    itérateur Liste des sys_ids des groupes actifs auxquels l’utilisateur appartient.

    L’exemple suivant montre comment renvoyer une liste de groupes auxquels l’utilisateur appartient.

    var groupsArray = gs.getUser().getMyGroups().toArray();
gs.info(groupsArray[0]);
    Sortie :
    cfcbad03d711110050f5edcb9e61038f

    Équivalent dans le champ d’application

    Il n’y a pas d’équivalent dans le champ d’application de cette méthode.

    GlideUser : getName()

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

    Tableau 19. Paramètres
    Nom Type Description
    Aucun
    Tableau 20. Renvoie
    Type Description
    Chaîne ID d'utilisateur 
    var currentUser = gs.getUser(); 
gs.info(currentUser.getName());

    Équivalent dans le champ d’application

    Pour utiliser la méthode getName() dans une application incluse dans le périmètre, utilisez la méthode incluse dans le périmètre correspondante : getName().

    GlideUser : getRoles()

    Renvoie une liste des rôles associés à l’utilisateur. Inclut les rôles explicitement accordés, les rôles hérités et les rôles acquis par l’appartenance à un groupe.

    Tableau 21. Paramètres
    Nom Type Description
    Aucun
    Tableau 22. Renvoie
    Type Description
    Objet Liste des rôles d’utilisateur séparés par des virgules. 
    var currentUser = gs.getUser(); 
gs.info(currentUser.getRoles());

    Sortie :

    admin,hr_fulfiller,itsa_fulfiller,security_admin

    Équivalent dans le champ d’application

    Pour utiliser la méthode getRoles() dans une application incluse dans le périmètre, utilisez la méthode incluse dans le périmètre correspondante : getRoles().

    GlideUser : 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 23. Paramètres
    Nom Type Description
    Aucun
    Tableau 24. 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 : getTimeZoneLabelLang(String language)

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

    Tableau 25. 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 26. 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 : getUserByID (ID de chaîne)

    Renvoie l’objet utilisateur associé à l’ID d’utilisateur transmis (sys_id dans sys_user) ou user_name.

    Tableau 27. Paramètres
    Nom Type Description
    id Chaîne ID unique (sys_id) ou user_name de l’enregistrement de l’utilisateur souhaité.
    Tableau 28. Renvoie
    Type Description
    Objet Objet utilisateur associé au sys_id ou au user_name spécifié.

    Exemple utilisant le nom d’utilisateur (user_name).

    var currentUser = gs.getUser();
gs.info(currentUser.getFirstName()); // print the first name of the logged in user
var newUser = currentUser.getUserByID('abel.tuter'); // fetch a different user using the user_name field
gs.info(newUser.getFirstName()); // print the first name of the Abel Tuter user

    Exemple utilisant l’ID d’utilisateur (sys_id).

    var currentUser = gs.getUser();
gs.info(currentUser.getFirstName()); // print the first name of the logged in user
var newUser = currentUser.getUserByID('62826bf03710200044e0bfc8bcbe5df1'); // fetch Abel Tuter user using sys_id from sys_user record
gs.info(newUser.getFirstName()); // print the first name of the Abel Tuter user

    GlideUser : getUserRoles()

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

    Tableau 29. Paramètres
    Nom Type Description
    Aucun
    Tableau 30. Renvoie
    Type Description
    Objet/Chaîne Liste des rôles séparés par des virgules explicitement affectés à l’utilisateur.
    Remarque :
    Le type de données de la valeur renvoyée est objet, mais les informations sont renvoyées sous forme de chaîne.
    		 
    var currentUser = gs.getUser(); 
var userRoles = currentUser.getUserRoles();
gs.info('User Roles: ' + userRoles);
gs.info('Data type: ' + typeof userRoles);
    *** Script: User Roles: ,admin,security_admin
*** Script: Data type: object

    Équivalent dans le champ d’application

    Pour utiliser la méthode getUserRoles() dans une application incluse dans le périmètre, utilisez la méthode incluse dans le périmètre correspondante : getUserRoles().

    GlideUser : hasRole(rôle de chaîne)

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

    Tableau 31. Paramètres
    Nom Type Description
    rôle Chaîne Rôle de vérification
    Tableau 32. Renvoie
    Type Description
    Booléen Vrai si l’utilisateur a le rôle. 
    var currentUser = gs.getUser(); 
gs.info(currentUser.hasRole('admin'));

    Équivalent dans le champ d’application

    Pour utiliser la méthode hasRole() dans une application incluse dans le périmètre, utilisez la méthode correspondante : hasRole().

    GlideUser : isExplicitMemberOf(groupe de chaînes)

    Détermine si l’utilisateur actuel est un membre explicite du groupe spécifié. Seuls les groupes actifs sont évalués par cette méthode.

    La méthode isMemberOf() renvoie la valeur vrai pour un groupe parent si l’utilisateur est membre du groupe enfant. Utilisez cette méthode si vous souhaitez uniquement retourner la valeur vrai pour les groupes parents.

    Tableau 33. Paramètres
    Nom Type Description
    groupe Chaîne Sys_id du groupe d’utilisateurs à vérifier.
    Tableau 34. Renvoie
    Type Description
    Booléen

    Marqueur indiquant si l’utilisateur actuel est un membre explicite du groupe spécifié.

    Valeurs valides :
    • vrai : l’utilisateur actuel est un membre explicite du groupe spécifié.
    • faux : l’utilisateur actuel n’est pas un membre explicite du groupe spécifié.

    L’exemple suivant montre comment vérifier si l’utilisateur actuel est un membre explicite du groupe spécifié.

    var isExplMem = gs.getUser().isExplicitMemberOf('b8ef24616fc331003b3c498f5d3ee434');
gs.info(isExplMem);

    Sortie :

    false

    Équivalent dans le champ d’application

    Il n’y a pas d’équivalent dans le champ d’application de cette méthode.

    GlideUser : isMemberOf(groupe de chaînes)

    Détermine si l’utilisateur actuel est membre du groupe spécifié. Seuls les groupes actifs sont évalués par cette méthode.

    Cette méthode renvoie la valeur vrai pour un groupe parent si l’utilisateur est membre du groupe enfant. Utilisez isExplicitMemberOf() si vous souhaitez uniquement renvoyer la valeur vrai pour les groupes parents.

    Tableau 35. Paramètres
    Nom Type Description
    groupe Chaîne Sys_id ou nom du groupe à vérifier.
    Tableau 36. 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

    Équivalent dans le champ d’application

    Pour utiliser la méthode isMemberOf() dans une application incluse dans le périmètre, utilisez la méthode incluse dans le périmètre correspondante : isMemberOf().