---
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 : client

# GlideUser : client {#ariaid-title1}

* Rversion finale: Xanadu
* 
* Mis à jour 1 août 2024
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 4 minutes de lecture

L'API GlideUser fournit des méthodes qui permettent d'accéder aux informations relatives à l'utilisateur actuel et aux rôles d'utilisateur actuels. L'utilisation de cette API évite d'avoir à utiliser les requêtes GlideRecord plus lentes pour obtenir des informations sur l'utilisateur.

Les méthodes et propriétés GlideUser sont accessibles via un objet global (`g_user`) qui n'est disponible que dans les scripts clients.  
Cette API :

* Contient des informations sur le nom et le rôle de l'utilisateur actuel.
* est généralement utilisé dans les scripts clients et les politiques d'interface utilisateur, mais se trouve également dans les actions d'interface utilisateur qui s'exécutent sur le client.
* ne peut pas être utilisé dans les règles métier ou les actions d'interface utilisateur qui s'exécutent sur le serveur.
{#c_GlideUserAPI__ul_bqz_wch_vs}

Les informations de session relatives à l'utilisateur actuel et aux rôles d'utilisateur actuels sont contenues dans le client (navigateur Web). Toutes les méthodes GlideUser , à l'exception de getClientData(), accèdent aux informations de session qui sont disponibles par défaut. La méthode getClientData() nécessite une configuration sur le serveur et l'utilisation de la méthode putClientData() pour rendre les informations de session disponibles.

Pour plus d'informations sur l'utilisation des scripts côté client, voir [Présentation des scripts côté client](https://developer.servicenow.com/dev.do#!/learn/courses/sandiego/app_store_learnv2_scripting_rome_scripting_in_servicenow/app_store_learnv2_scripting_rome_client_side_scripting/app_store_learnv2_scripting_rome_introduction_to_client_side_scripting).

## GlideUser : firstName {#ariaid-title2}

Prénom de l'utilisateur actuel.
{#r_GlideUserFirstName__table_yrj_5fh_vs__entry__3}

| Nom | Type | Description |
|-|-|-|
| prénom | Chaîne | Prénom de l'utilisateur actuel. |
[Tableau 1. Champ]

{#r_GlideUserFirstName__table_yrj_5fh_vs}  

    alert('first name = ' + g_user.firstName);

## GlideUser : getClientData(clé de chaîne) {#ariaid-title3}

Renvoie une valeur du client définie à l'aide de setClientData() ou GlideSession -- putClientData().
Les données client de session sont un ensemble de chaînes nommées qui peuvent être configurées sur le serveur à l'aide de [GlideSession -- putClientData()](https://servicenow-prod.fluidtopics.net/n4FyIMJJSdE8tjbcTccH~g#c_GlideSessionScopedAPI "L’API GlideSession , dont le champ d’application est délimité, fournit des méthodes pour trouver des informations sur la session en cours."). Vous pouvez utiliser getClientData() pendant le temps de chargement du formulaire pour obtenir les informations dont le script client a besoin pour prendre des décisions concernant le formulaire. Par exemple, pour identifier les champs qui doivent être visibles.

Voir aussi [GlideForm](https://servicenow-prod.fluidtopics.net/FV1LOFCrzjZpjKOQxBQJ5Q#c_GlideFormAPI "L’API GlideForm fournit des méthodes pour personnaliser les formulaires.").
{#r_GlideUser-getClientData_string__table_nv5_3k3_ws__entry__3}

| Nom | Type | Description |
|-|-|-|
| key | Chaîne | Nom des données client à récupérer. |
[Tableau 2. Paramètres]

{#r_GlideUser-getClientData_string__table_nv5_3k3_ws} {#r_GlideUser-getClientData_string__table_ov5_3k3_ws__entry__2}

| Type | Description |
|-|-|
| Chaîne | Valeur des données du client. |
[Tableau 3. Renvoie]

{#r_GlideUser-getClientData_string__table_ov5_3k3_ws}  

    var loginLanguage = g_user.getClientData("loginlanguage");

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

Renvoie le prénom et le nom de l'utilisateur actuel.
{#r_GlideUser-getFullName__table_pvh_cm3_ws__entry__3}

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

{#r_GlideUser-getFullName__table_pvh_cm3_ws} {#r_GlideUser-getFullName__table_qvh_cm3_ws__entry__2}

| Type | Description |
|-|-|
| Chaîne | Nom complet de l'utilisateur actuel. |
[Tableau 5. Renvoie]

{#r_GlideUser-getFullName__table_qvh_cm3_ws}  

    var formalName = g_user.getFullName();

## GlideUser : hasRole(Rôle de chaîne, booléen includeDefaults) {#ariaid-title5}

Renvoie la valeur true si l'utilisateur actuel a le rôle spécifié ou le rôle admin.
{#r_GlideUser-hasRole_String__table_p1w_4m3_ws__entry__3}

| Nom | Type | Description |
|-|-|-|
| role | Chaîne | Rôle à vérifier. |
| includeDefaults (includeDefaults) | Booléen | Facultatif. Marqueur indiquant s'il faut inclure les rôles par défaut, tels que snc_internal et snc_external, dans la demande. Pour en savoir plus sur les rôles, reportez-vous à [Exploring user administration](https://www.servicenow.com/docs/access?context=exploring-user-administration&version=xanadu&pubname=xanadu-platform-administration&ft:locale=en-US). Valeur par défaut : false |
[Tableau 6. Paramètres]

{#r_GlideUser-hasRole_String__table_p1w_4m3_ws} {#r_GlideUser-hasRole_String__table_q1w_4m3_ws__entry__2}

| Type | Description |
|-|-|
| Booléen | Renvoie la valeur true si l'utilisateur actuel a le rôle spécifié ou le rôle admin ; sinon, renvoie la valeur faux. |
[Tableau 7. Renvoie]

{#r_GlideUser-hasRole_String__table_q1w_4m3_ws}  

    var isInternal = g_user.hasRole('snc_internal', true);

    var isItil = g_user.hasRole('itil');

## GlideUser : hasRoleExactly(rôle de chaîne, booléen includeDefaults) {#ariaid-title6}

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

| Nom | Type | Description |
|-|-|-|
| includeDefaults (includeDefaults) | Booléen | Facultatif. Marqueur indiquant s'il faut inclure les rôles par défaut, tels que snc_internal et snc_external, dans la demande. Pour en savoir plus sur les rôles, consultez [Rôles explicites](https://www.servicenow.com/docs/access?context=explicit-roles&version=xanadu&pubname=xanadu-platform-security&ft:locale=en-US). Valeur par défaut : false |
| role | Chaîne | Rôle à vérifier. |
[Tableau 8. Paramètres]

{#r_GlideUser-hasRoleExactly_String__table_r53_hn3_ws} {#r_GlideUser-hasRoleExactly_String__table_s53_hn3_ws__entry__2}

| Type | Description |
|-|-|
| Booléen | Renvoie la valeur true si l'utilisateur actuel possède le rôle spécifié. |
[Tableau 9. Renvoie]

{#r_GlideUser-hasRoleExactly_String__table_s53_hn3_ws}  

    var isInternal = g_user.hasRoleExactly('snc_internal', true);

    var isItil = g_user.hasRoleExactly('itil');

## GlideUser : hasRoleFromList(Rôles de chaîne, booléen includeDefaults) {#ariaid-title7}

Renvoie la valeur true si l'utilisateur actuel a au moins un des rôles spécifiés ou s'il a le rôle administrateur.
{#r_GlideUser-hasRoleFromList_String__table_oxf_wn3_ws__entry__3}

| Nom | Type | Description |
|-|-|-|
| roles | Chaîne | Liste de rôles séparés par des virgules à vérifier |
| includeDefaults (includeDefaults) | Booléen | Facultatif. Marqueur indiquant s'il faut inclure les rôles par défaut, tels que snc_internal et snc_external, dans la demande. Pour en savoir plus sur les rôles, reportez-vous à [Exploring user administration](https://www.servicenow.com/docs/access?context=exploring-user-administration&version=xanadu&pubname=xanadu-platform-administration&ft:locale=en-US). Valeur par défaut : false |
[Tableau 10. Paramètres]

{#r_GlideUser-hasRoleFromList_String__table_oxf_wn3_ws} {#r_GlideUser-hasRoleFromList_String__table_pxf_wn3_ws__entry__2}

| Type | Description |
|-|-|
| Booléen | Renvoie la valeur true si l'utilisateur actuel a un rôle dans la liste ou le rôle administrateur. |
[Tableau 11. Renvoie]

{#r_GlideUser-hasRoleFromList_String__table_pxf_wn3_ws}  

    var isOK = g_user.hasRoleFromList("itil, maint");

    var isOK = g_user.hasRoleFromList("itil, maint, snc_internal", true);

## GlideUser : hasRoles(Boolean includeDefaults) {#ariaid-title8}

Renvoie la valeur true si l'utilisateur actuel dispose d'un rôle.
{#r_GlideUser-hasRoles__table_ups_k43_ws__entry__3}

| Nom | Type | Description |
|-|-|-|
| includeDefaults (includeDefaults) | Booléen | Facultatif. Marqueur indiquant s'il faut inclure les rôles par défaut, tels que snc_internal et snc_external, dans la demande. Pour en savoir plus sur les rôles, reportez-vous à [Exploring user administration](https://www.servicenow.com/docs/access?context=exploring-user-administration&version=xanadu&pubname=xanadu-platform-administration&ft:locale=en-US). Valeur par défaut : false |
[Tableau 12. Paramètres]

{#r_GlideUser-hasRoles__table_ups_k43_ws} {#r_GlideUser-hasRoles__table_vps_k43_ws__entry__2}

| Type | Description |
|-|-|
| Booléen | Renvoie la valeur true si l'utilisateur actuel a au moins un rôle. |
[Tableau 13. Renvoie]

{#r_GlideUser-hasRoles__table_vps_k43_ws}  

    var yesRole = g_user.hasRoles();

    var yesRole = g_user.hasRoles(true);

## GlideUser : lastName {#ariaid-title9}

Nom de famille de l'utilisateur actuel.
{#r_GlideUserLastName__table_g2n_dgh_vs__entry__3}

| Nom | Type | Description |
|-|-|-|
| nom de famille | Chaîne | Nom de famille de l'utilisateur actuel. |
[Tableau 14. Champ]

{#r_GlideUserLastName__table_g2n_dgh_vs}  

    alert('last name = ' + g_user.lastName);

## GlideUser : setClientData(clé de chaîne, valeur de chaîne) {#ariaid-title10}

Définit une valeur client que vous pouvez récupérer à l'aide de getClientData().
Voir aussi [GlideForm](https://servicenow-prod.fluidtopics.net/FV1LOFCrzjZpjKOQxBQJ5Q#c_GlideFormAPI "L’API GlideForm fournit des méthodes pour personnaliser les formulaires.").
{#r_GlideUser-setClientData_S_S__table_nv5_3k3_ws__entry__3}

| Nom | Type | Description |
|-|-|-|
| key | Chaîne | Nom des données client à stocker en tant que clé. |
| valide | Numéro | Valeur à affecter à la clé. |
[Tableau 15. Paramètres]

{#r_GlideUser-setClientData_S_S__table_nv5_3k3_ws} {#r_GlideUser-setClientData_S_S__table_ov5_3k3_ws__entry__2}

| Type | Description |
|-|-|
| Aucun |   |
[Tableau 16. Renvoie]

{#r_GlideUser-setClientData_S_S__table_ov5_3k3_ws}  

    function onSubmit() {
    	
    	if (!g_user.getClientData('keyName')) {
    		var now_GR = new GlideRecord('incident');
    		now_GR.addActiveQuery();
    		now_GR.setLimit(1);
    		now_GR.query(cb);
    		return false;
    	}
    	return true;
    }

    function cb(now_GR) {
    	// <insert glide operation >
    	g_user.setClientData('keyName', now_GR.getValue('<number>'));
    	g_form.submit();	
    }

## GlideUser : userName {#ariaid-title11}

Le nom d'utilisateur de l'utilisateur actuel, par exemple gsmith02. Ce n'est pas le nom de l'utilisateur, par exemple George Smith.
{#r_GlideUserUserName__table_sf4_t2h_vs__entry__3}

| Nom | Type | Description |
|-|-|-|
| userName | Chaîne | Nom d'utilisateur de l'utilisateur actuel. |
[Tableau 17. Champ]

{#r_GlideUserUserName__table_sf4_t2h_vs}  

    var userName = g_user.userName;
       alert('Current user = ' + userName);

## GlideUser : userID {#ariaid-title12}

Renvoie l'sys_id de l'utilisateur actuel.
{#r_GlideUserUserID__table_fhb_3fh_vs__entry__3}

| Nom | Type | Description |
|-|-|-|
| userID | Chaîne | Sys_id de l'utilisateur actuel. |
[Tableau 18. Champ]

{#r_GlideUserUserID__table_fhb_3fh_vs}  

    var userID = g_user.userID;
       alert('Current user ID = ' + userID);