GlideUser : global

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

É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 délimitée 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 incluse dans le périmètre : 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 les 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 de messagerie 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 correspondante incluse dans le périmètre : 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 pour 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 correspondante dans le périmètre : getFirstName().

GlideUser : getID

Renvoie l’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 correspondante incluse dans le périmètre : 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 pour 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 incluse dans le périmètre : 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	Une liste de sys_ids pour les 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’existe pas d’équivalent dans le champ d’application pour 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 appartenance au 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 délimitée correspondante : getRoles().

GlideUser : getUserByID (ID de chaîne)

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

Tableau 23. Paramètres

Nom	Type	Description
id	Chaîne	ID unique (sys_id) ou user_name de l’enregistrement de l’utilisateur souhaité.

Tableau 24. Renvoie

Type	Description
Objet	Objet utilisateur associé à l’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 25. Paramètres

Nom	Type	Description
Aucun

Tableau 26. 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 pour 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 possède le rôle spécifié.

Tableau 27. Paramètres

Nom	Type	Description
role	Chaîne	Rôle à vérifier

Tableau 28. 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 dans le périmètre : 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 true pour un groupe parent si l’utilisateur est membre du groupe enfant. Utilisez cette méthode si vous souhaitez uniquement renvoyer la valeur vrai pour les groupes parents.

Tableau 29. Paramètres

Nom	Type	Description
groupe	Chaîne	Sys_id du groupe d’utilisateurs à vérifier.

Tableau 30. 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é. false : 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’existe pas d’équivalent dans le champ d’application pour 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 voulez seulement renvoyer la valeur vrai pour les groupes parents.

Tableau 31. Paramètres

Nom	Type	Description
groupe	Chaîne	Sys_id du groupe d’utilisateurs à vérifier.

Tableau 32. Renvoie

Type	Description
Booléen	Marqueur indiquant si l’utilisateur actuel est membre du groupe spécifié. Valeurs valides : vrai : l’utilisateur actuel est membre du groupe spécifié. faux : l’utilisateur actuel n’est pas membre du groupe spécifié.

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

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

É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().