---
sourceDocument: Référence de l’API Xanadu
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/fr-FR/xanadu/api-reference

 Release :

    - xanadu

ft:locale :

    - fr-FR

ft:publication_title :

    - Référence de l’API Xanadu

ft:clusterId :

    - crapiref

bundleId :

    - crapiref

workflow :

    - Creator


---

# GlideUser : global

# GlideUser : global {#ariaid-title1}

* Rversion finale: Xanadu
* 
* Mis à jour 1 août 2024
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 7 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 : getCompanyID() {#ariaid-title2}

Renvoie les sys_id de la société de l'utilisateur actuel.
{#GUser-getCompanyID__table_vmc_n33_xz__entry__3}

| Nom | Type | Description |
|-|-|-|
| Aucun |   |   |
[Tableau 1. Paramètres]

{#GUser-getCompanyID__table_vmc_n33_xz} {#GUser-getCompanyID__table_wmc_n33_xz__entry__2}

| Type | Description |
|-|-|
| Chaîne | sys_id de l'entreprise |
[Tableau 2. Renvoie]

{#GUser-getCompanyID__table_wmc_n33_xz}  

    var currentUser = gs.getUser(); 
    gs.info(currentUser.getCompanyID());

### Équivalent dans le champ d'application {#GUser-getCompanyID__section_fzj_lyh_xz}

Pour utiliser la méthode getCompanyID() dans une application incluse dans le périmètre, utilisez la méthode délimitée correspondante : [getCompanyID().](https://servicenow-prod.fluidtopics.net/TYeZVaNju0lODPrOyxw4iw#r_ScopedGlideUserGetCompanyID "Renvoie les sys_id de la société de l’utilisateur actuel.")

## GlideUser : getDisplayName() {#ariaid-title3}

Renvoie le nom d'affichage de l'utilisateur actuel.
{#GUser-getDisplayName__table_qqh_mh3_xz__entry__3}

| Nom | Type | Description |
|-|-|-|
| Aucun |   |   |
[Tableau 3. Paramètres]

{#GUser-getDisplayName__table_qqh_mh3_xz} {#GUser-getDisplayName__table_rqh_mh3_xz__entry__2}

| Type | Description |
|-|-|
| Chaîne | Nom d'affichage de l'utilisateur |
[Tableau 4. Renvoie]

{#GUser-getDisplayName__table_rqh_mh3_xz}  

    var currentUser = gs.getUser(); 
    gs.info(currentUser.getDisplayName());

### Équivalent dans le champ d'application {#GUser-getDisplayName__section_fzj_lyh_xz}

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().](https://servicenow-prod.fluidtopics.net/TYeZVaNju0lODPrOyxw4iw#r_ScopedGlideUserGetDisplayName "Renvoie le nom d’affichage de l’utilisateur actuel.")

## GlideUser : getDomainDisplayValue() {#ariaid-title4}

Renvoie la valeur d'affichage du domaine de session de l'utilisateur.
{#GUser-getDomainDisplayValue__table_wrr_hlg_zz__entry__3}

| Nom | Type | Description |
|-|-|-|
| Aucun |   |   |
[Tableau 5. Paramètres]

{#GUser-getDomainDisplayValue__table_wrr_hlg_zz} {#GUser-getDomainDisplayValue__table_xrr_hlg_zz__entry__2}

| Type | Description |
|-|-|
| Chaîne | La valeur d'affichage du domaine de session de l'utilisateur. |
[Tableau 6. Renvoie]

{#GUser-getDomainDisplayValue__table_xrr_hlg_zz}  

    var currentUser = gs.getUser(); 
    gs.info(currentUser.getDomainDisplayValue());

### Équivalent dans le champ d'application {#GUser-getDomainDisplayValue__section_oy2_nts_mcb}

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

## GlideUser : getDomainID() {#ariaid-title5}

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.
{#GUser-getDomainID__ul_l4v_kc1_pfb}
{#GUser-getDomainID__table_trl_lzz_4fb__entry__3}

| Nom | Type | Description |
|-|-|-|
| Aucun |   |   |
[Tableau 7. Paramètres]

{#GUser-getDomainID__table_trl_lzz_4fb} {#GUser-getDomainID__table_url_lzz_4fb__entry__2}

| Type | Description |
|-|-|
| Chaîne | Identificateur de domaine. |
[Tableau 8. Renvoie]

{#GUser-getDomainID__table_url_lzz_4fb}  

    var domain = new GlideRecord('domain');
    domain.get(gs.getUser().getDomainID());
    gs.info(domain.name);

## GlideUser : getEmail() {#ariaid-title6}

Renvoie l'adresse e-mail de l'utilisateur.
{#GUser-getEmail__table_nxz_qg3_xz__entry__3}

| Nom | Type | Description |
|-|-|-|
| Aucun |   |   |
[Tableau 9. Paramètres]

{#GUser-getEmail__table_nxz_qg3_xz} {#GUser-getEmail__table_oxz_qg3_xz__entry__2}

| Type | Description |
|-|-|
| Chaîne | Adresse de messagerie de l'utilisateur |
[Tableau 10. Renvoie]

{#GUser-getEmail__table_oxz_qg3_xz}  

    var currentUser = gs.getUser(); 
    gs.info(currentUser.getEmail());

### Équivalent dans le champ d'application {#GUser-getEmail__section_fzj_lyh_xz}

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().](https://servicenow-prod.fluidtopics.net/TYeZVaNju0lODPrOyxw4iw#r_SGU-getEmail "Renvoie l’adresse e-mail de l’utilisateur.")

## GlideUser : getFirstName() {#ariaid-title7}

Renvoie le prénom de l'utilisateur.
{#GUser-getFirstName__table_mjs_zb3_xz__entry__3}

| Nom | Type | Description |
|-|-|-|
| Aucun |   |   |
[Tableau 11. Paramètres]

{#GUser-getFirstName__table_mjs_zb3_xz} {#GUser-getFirstName__table_njs_zb3_xz__entry__2}

| 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. |
[Tableau 12. Renvoie]

{#GUser-getFirstName__table_njs_zb3_xz}  

    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 {#GUser-getFirstName__section_fzj_lyh_xz}

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().](https://servicenow-prod.fluidtopics.net/TYeZVaNju0lODPrOyxw4iw#r_SGU-getFirstName "Renvoie le prénom de l’utilisateur.")

## GlideUser : getID {#ariaid-title8}

Renvoie l'sys_id de l'utilisateur actuel.
{#GUser-getID__table_vtq_4xh_xz__entry__3}

| Nom | Type | Description |
|-|-|-|
| Aucun |   |   |
[Tableau 13. Paramètres]

{#GUser-getID__table_vtq_4xh_xz} {#GUser-getID__table_wtq_4xh_xz__entry__2}

| Type | Description |
|-|-|
| Chaîne | sys_id de l'utilisateur |
[Tableau 14. Renvoie]

{#GUser-getID__table_wtq_4xh_xz}  

    var currentUser = gs.getUser(); 
    gs.info(currentUser.getID());

### Équivalent dans le champ d'application {#GUser-getID__section_fzj_lyh_xz}

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().](https://servicenow-prod.fluidtopics.net/TYeZVaNju0lODPrOyxw4iw#r_ScopedGlideUserGetID "Obtient les sys_id de l’utilisateur actuel.")

## GlideUser : getLastName() {#ariaid-title9}

Renvoie le nom de famille de l'utilisateur.
{#GUser-getLastName__table_agq_1g3_xz__entry__3}

| Nom | Type | Description |
|-|-|-|
| Aucun |   |   |
[Tableau 15. Paramètres]

{#GUser-getLastName__table_agq_1g3_xz} {#GUser-getLastName__table_bgq_1g3_xz__entry__2}

| 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. |
[Tableau 16. Renvoie]

{#GUser-getLastName__table_bgq_1g3_xz}  

    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 {#GUser-getLastName__section_fzj_lyh_xz}

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().](https://servicenow-prod.fluidtopics.net/TYeZVaNju0lODPrOyxw4iw#r_SGU-getLastName "Renvoie le nom de famille de l’utilisateur.")

## GlideUser : getMyGroups() {#ariaid-title10}

Renvoie un itérateur contenant la liste de tous les groupes auxquels l'utilisateur appartient. Seuls les groupes actifs sont renvoyés.
{#GUser-getMyGroups__table_llp_tc5_5bb__entry__3}

| Nom | Type | Description |
|-|-|-|
| Aucun |   |   |
[Tableau 17. Paramètres]

{#GUser-getMyGroups__table_llp_tc5_5bb} {#GUser-getMyGroups__table_mlp_tc5_5bb__entry__2}

| Type | Description |
|-|-|
| itérateur | Une liste de sys_ids pour les groupes actifs auxquels l'utilisateur appartient. |
[Tableau 18. Renvoie]

{#GUser-getMyGroups__table_mlp_tc5_5bb}  
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 {#GUser-getMyGroups__section_p31_wts_mcb}

Il n'existe pas d'équivalent dans le champ d'application pour cette méthode.

## GlideUser : getName() {#ariaid-title11}

Renvoie l'ID d'utilisateur, ou le nom de connexion, de l'utilisateur actuel.
{#GUser-getName__table_exc_w13_xz__entry__3}

| Nom | Type | Description |
|-|-|-|
| Aucun |   |   |
[Tableau 19. Paramètres]

{#GUser-getName__table_exc_w13_xz} {#GUser-getName__table_fxc_w13_xz__entry__2}

| Type | Description |
|-|-|
| Chaîne | ID d'utilisateur |
[Tableau 20. Renvoie]

{#GUser-getName__table_fxc_w13_xz}  

    var currentUser = gs.getUser(); 
    gs.info(currentUser.getName());

### Équivalent dans le champ d'application {#GUser-getName__section_fzj_lyh_xz}

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().](https://servicenow-prod.fluidtopics.net/TYeZVaNju0lODPrOyxw4iw#r_ScopedGlideUserGetName "Renvoie l’ID d’utilisateur, ou le nom de connexion, de l’utilisateur actuel.")

## GlideUser : getRoles() {#ariaid-title12}

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.
{#GUser-getRoles__table_ml5_q4m_xz__entry__3}

| Nom | Type | Description |
|-|-|-|
| Aucun |   |   |
[Tableau 21. Paramètres]

{#GUser-getRoles__table_ml5_q4m_xz} {#GUser-getRoles__table_nl5_q4m_xz__entry__2}

| Type | Description |
|-|-|
| Objet | Liste des rôles d'utilisateur séparés par des virgules. |
[Tableau 22. Renvoie]

{#GUser-getRoles__table_nl5_q4m_xz}  

    var currentUser = gs.getUser(); 
    gs.info(currentUser.getRoles());

Sortie :

    admin,hr_fulfiller,itsa_fulfiller,security_admin

### Équivalent dans le champ d'application {#GUser-getRoles__section_fzj_lyh_xz}

Pour utiliser la méthode getRoles() dans une application incluse dans le périmètre, utilisez la méthode délimitée correspondante : [getRoles().](https://servicenow-prod.fluidtopics.net/TYeZVaNju0lODPrOyxw4iw#r_SGU-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.")

## GlideUser : getUserByID (ID de chaîne) {#ariaid-title13}

Renvoie l'objet utilisateur associé à l'ID utilisateur transmis (sys_id dans sys_user) ou user_name.
{#GUser-getUserByID_S__table_wsx_qkr_h2b__entry__3}

| Nom | Type | Description |
|-|-|-|
| id | Chaîne | ID unique (sys_id) ou user_name de l'enregistrement de l'utilisateur souhaité. |
[Tableau 23. Paramètres]

{#GUser-getUserByID_S__table_wsx_qkr_h2b} {#GUser-getUserByID_S__table_xsx_qkr_h2b__entry__2}

| Type | Description |
|-|-|
| Objet | Objet utilisateur associé à l'sys_id ou au user_name spécifié. |
[Tableau 24. Renvoie]

{#GUser-getUserByID_S__table_xsx_qkr_h2b}  
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() {#ariaid-title14}

Renvoie la liste des rôles explicitement accordés à l'utilisateur.
{#GUser-getUserRoles__table_pkf_xnm_xz__entry__3}

| Nom | Type | Description |
|-|-|-|
| Aucun |   |   |
[Tableau 25. Paramètres]

{#GUser-getUserRoles__table_pkf_xnm_xz} {#GUser-getUserRoles__table_qkf_xnm_xz__entry__2}

| 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. |
[Tableau 26. Renvoie]

{#GUser-getUserRoles__table_qkf_xnm_xz}  

    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 {#GUser-getUserRoles__section_fzj_lyh_xz}

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().](https://servicenow-prod.fluidtopics.net/TYeZVaNju0lODPrOyxw4iw#r_SGU-getUserRoles "Renvoie la liste des rôles explicitement accordés à l’utilisateur.")

## GlideUser : hasRole(rôle de chaîne) {#ariaid-title15}

Détermine si l'utilisateur actuel possède le rôle spécifié.
{#GUser-hasRole_S__table_xmz_mmm_xz__entry__3}

| Nom | Type | Description |
|-|-|-|
| role | Chaîne | Rôle à vérifier |
[Tableau 27. Paramètres]

{#GUser-hasRole_S__table_xmz_mmm_xz} {#GUser-hasRole_S__table_ymz_mmm_xz__entry__2}

| Type | Description |
|-|-|
| Booléen | Vrai si l'utilisateur a le rôle. |
[Tableau 28. Renvoie]

{#GUser-hasRole_S__table_ymz_mmm_xz}  

    var currentUser = gs.getUser(); 
    gs.info(currentUser.hasRole('admin'));

### Équivalent dans le champ d'application {#GUser-hasRole_S__section_fzj_lyh_xz}

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().](https://servicenow-prod.fluidtopics.net/TYeZVaNju0lODPrOyxw4iw#r_ScopedGlideUserHasRole_String "Détermine si l’utilisateur actuel possède le rôle spécifié.")

## GlideUser : isExplicitMemberOf(groupe de chaînes) {#ariaid-title16}

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.
{#GUser-isExplicitMemberOf_S__table_l1q_4lm_xz__entry__3}

| Nom | Type | Description |
|-|-|-|
| groupe | Chaîne | Sys_id du groupe d'utilisateurs à vérifier. |
[Tableau 29. Paramètres]

{#GUser-isExplicitMemberOf_S__table_l1q_4lm_xz} {#GUser-isExplicitMemberOf_S__table_m1q_4lm_xz__entry__2}

| 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é. {#GUser-isExplicitMemberOf_S__ul_gvv_fqf_nsb} |
[Tableau 30. Renvoie]

{#GUser-isExplicitMemberOf_S__table_m1q_4lm_xz}  
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 {#GUser-isExplicitMemberOf_S__section_wxy_xpz_kwb}

Il n'existe pas d'équivalent dans le champ d'application pour cette méthode.

## GlideUser : isMemberOf(groupe de chaînes) {#ariaid-title17}

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.
{#GUser-isMemberOf_S__table_l1q_4lm_xz__entry__3}

| Nom | Type | Description |
|-|-|-|
| groupe | Chaîne | Sys_id du groupe d'utilisateurs à vérifier. |
[Tableau 31. Paramètres]

{#GUser-isMemberOf_S__table_l1q_4lm_xz} {#GUser-isMemberOf_S__table_m1q_4lm_xz__entry__2}

| 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é. {#GUser-isMemberOf_S__ul_gvv_fqf_nsb} |
[Tableau 32. Renvoie]

{#GUser-isMemberOf_S__table_m1q_4lm_xz}  
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 {#GUser-isMemberOf_S__section_fzj_lyh_xz}

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().](https://servicenow-prod.fluidtopics.net/TYeZVaNju0lODPrOyxw4iw#r_ScopedGlideUserIsMemberOf_String "Détermine si l’utilisateur actuel est membre du groupe spécifié.")