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


---

# GlideSession - Dans le champ d'application

# GlideSession - Dans le champ d'application {#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 GlideSession , dont le champ d'application est délimité, fournit des méthodes pour trouver des informations sur la session en cours.

Il n'existe aucun constructeur pour créer une instance d'un objet GlideSession inclus dans le champ d'application. Au lieu de cela, utilisez la méthode getSession() de l'API GlideSystem incluse dans le champ d'application.

## GlideSession inclus dans le périmètre : getClientData(String paramName) {#ariaid-title2}

Récupère une valeur de client de session précédemment définie avec putClientData().
Utilisez cette méthode pour récupérer les valeurs de données qui ont été définies à l'aide de la méthode putClientData().
{#r_ScopedGlideSessionGetClientData_String__table_j24_fqk_ls__entry__3}

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

{#r_ScopedGlideSessionGetClientData_String__table_j24_fqk_ls} {#r_ScopedGlideSessionGetClientData_String__table_k24_fqk_ls__entry__2}

| Type | Description |
|-|-|
| Chaîne | Données du client. |
[Tableau 2. Renvoie]

{#r_ScopedGlideSessionGetClientData_String__table_k24_fqk_ls}  

    var session = gs.getSession();
    session.putClientData('test1', 'Harry');
    var clientData = session.getClientData('test1');
    gs.info(clientData);

Sortie :

    Harry

## GlideSession inclus dans le périmètre : getClientIP() {#ariaid-title3}

Renvoie l'adresse IP du client.
{#r_ScopedGlideSessionGetClientIP__table_gcx_wqk_ls__entry__3}

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

{#r_ScopedGlideSessionGetClientIP__table_gcx_wqk_ls} {#r_ScopedGlideSessionGetClientIP__table_hcx_wqk_ls__entry__2}

| Type | Description |
|-|-|
| Chaîne | Adresse IP. |
[Tableau 4. Renvoie]

{#r_ScopedGlideSessionGetClientIP__table_hcx_wqk_ls}  

    var session = gs.getSession();
    var addr = session.getClientIP();
    gs.info(addr);

Sortie :

    50.59.164.97

## GlideSession inclus dans le périmètre : getCurrentApplicationId() {#ariaid-title4}

Renvoie l'application actuellement sélectionnée dans le sélecteur d'application.
Cette méthode nécessite des privilèges d'administrateur.
{#r_ScopedGlideSessionGetCurrentApplicationId__table_br3_jrk_ls__entry__3}

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

{#r_ScopedGlideSessionGetCurrentApplicationId__table_br3_jrk_ls} {#r_ScopedGlideSessionGetCurrentApplicationId__table_cr3_jrk_ls__entry__2}

| Type | Description |
|-|-|
| Chaîne | Application actuellement sélectionnée. |
[Tableau 6. Renvoie]

{#r_ScopedGlideSessionGetCurrentApplicationId__table_cr3_jrk_ls}  

    var session = gs.getSession();
    var appID = session.getCurrentApplicationId();
    gs.info(appID);

Sortie :

    ce05b9f32b840200c5244f74b4da1501

## GlideSession inclus dans le champ d'application : getCurrentDomainID() {#ariaid-title5}

Renvoie la sys_id du domaine actuel pour la session utilisateur connectée.
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.
{#GSS-getCurrentDomainID__table_jcl_vvq_xnb__entry__3}

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

{#GSS-getCurrentDomainID__table_jcl_vvq_xnb} {#GSS-getCurrentDomainID__table_kcl_vvq_xnb__entry__2}

| Type | Description |
|-|-|
| Chaîne | Sys_id du domaine de session de l'utilisateur actuellement connecté. Il s'agit des mêmes informations qui apparaissent dans le sélecteur de domaine. |
[Tableau 8. Renvoie]

{#GSS-getCurrentDomainID__table_kcl_vvq_xnb}  
Cet exemple montre que le domaine de l'enregistrement de sys_email actuel est défini sur le domaine de session de l'utilisateur, si le domaine de l'utilisateur est global ou nul.

    // Set domain based on parent record's domain
    setDomain();

    // If the domain is global, set to user's domain
    if (current.sys_domain == 'global' || current.sys_domain.nil())
       current.sys_domain = gs.getSession().getCurrentDomainID();

    function setDomain() {
       if (current.target_table.nil())
          return;

       var d = new GlideRecord(current.target_table);
       if (!d.isValid())
          return;

       if (!d.get('sys_id', current.instance))
          return;

       if (typeof(d.sys_domain) == 'object')
          current.sys_domain = d.sys_domain;

## GlideSession inclus dans le champ d'application : getLanguage() {#ariaid-title6}

Renvoie le code de langue de la session.
{#r_ScopedGlideSessionGetLanguage__table_chb_wrk_ls__entry__3}

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

{#r_ScopedGlideSessionGetLanguage__table_chb_wrk_ls} {#r_ScopedGlideSessionGetLanguage__table_dhb_wrk_ls__entry__2}

| Type | Description |
|-|-|
| Chaîne | Code de langue de la session. |
[Tableau 10. Renvoie]

{#r_ScopedGlideSessionGetLanguage__table_dhb_wrk_ls}  

    var session = gs.getSession();
    var language = session.getLanguage();
    gs.info(language);

Sortie :

    en

## GlideSession inclus dans le champ d'application : getSessionToken() {#ariaid-title7}

Renvoie le jeton de session.
{#r_ScopedGlideSessionGetSessionToken__table_g2l_gsk_ls__entry__3}

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

{#r_ScopedGlideSessionGetSessionToken__table_g2l_gsk_ls} {#r_ScopedGlideSessionGetSessionToken__table_h2l_gsk_ls__entry__2}

| Type | Description |
|-|-|
| Chaîne | Jeton de session. |
[Tableau 12. Renvoie]

{#r_ScopedGlideSessionGetSessionToken__table_h2l_gsk_ls}  

    var session = gs.getSession();
    var token = session.getSessionToken();
    gs.info(token);

Sortie :

    4284b5372b840200c5244f74b4da15f2c3476cf7fcb6572afa4ef9d5e6d307a5fd9e1da7

## GlideSession inclus dans le périmètre : getTimeZoneName() {#ariaid-title8}

Renvoie le nom du fuseau horaire de la session.
{#r_ScopedGlideSessionGetTimeZoneName__table_tws_qsk_ls__entry__3}

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

{#r_ScopedGlideSessionGetTimeZoneName__table_tws_qsk_ls} {#r_ScopedGlideSessionGetTimeZoneName__table_uws_qsk_ls__entry__2}

| Type | Description |
|-|-|
| Chaîne | Nom du fuseau horaire de la session. |
[Tableau 14. Renvoie]

{#r_ScopedGlideSessionGetTimeZoneName__table_uws_qsk_ls}  

    var session = gs.getSession();
    var zoneName = session.getTimeZoneName();
    gs.info(zoneName);

Sortie :

    US/Pacific

## GlideSession inclus dans le champ d'application : getUrlOnStack() {#ariaid-title9}

Renvoie l'URL sur la pile. Renvoie null si la pile est vide.
{#r_ScopedGlideSessionGetUrlOnStack__table_qhx_ctk_ls__entry__3}

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

{#r_ScopedGlideSessionGetUrlOnStack__table_qhx_ctk_ls} {#r_ScopedGlideSessionGetUrlOnStack__table_rhx_ctk_ls__entry__2}

| Type | Description |
|-|-|
| Chaîne | URL sur la pile. Renvoie null si la pile est vide. |
[Tableau 16. Renvoie]

{#r_ScopedGlideSessionGetUrlOnStack__table_rhx_ctk_ls}  

    var session = gs.getSession();
    var URL = session.getUrlOnStack();
    gs.info(URL);

Sortie : des sauts de ligne ont été ajoutés pour plus de clarté.

    sys_app.do?sys_id=ce05b9f32b840200c5244f74b4da1501&sysparm_goto_url=sys_app.do
    %3Fsys_id%3Dce05b9f32b840200c5244f74b4da1501

## GlideSession inclus dans le champ d'application : isImpersonating() {#ariaid-title10}

Renvoie la valeur true si l'utilisateur emprunte l'identité d'un autre utilisateur.
{#r_SGSSN-isImpersonating__table_rhv_tj5_xw__entry__3}

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

{#r_SGSSN-isImpersonating__table_rhv_tj5_xw} {#r_SGSSN-isImpersonating__table_shv_tj5_xw__entry__2}

| Type | Description |
|-|-|
| Booléen | Marqueur qui indique que l'utilisateur emprunte l'identité d'un autre utilisateur. Valeurs possibles : * vrai : l'utilisateur emprunte une identité. * faux : l'utilisateur n'emprunte pas l'identité. |
[Tableau 18. Renvoie]

{#r_SGSSN-isImpersonating__table_shv_tj5_xw}  

    var isImpersonator = gs.getSession().isImpersonating();
    gs.info(isImpersonator);

## GlideSession inclus dans le champ d'application : isInteractive() {#ariaid-title11}

Renvoie la valeur true si la session est interactive.
Une session interactive implique qu'un utilisateur final interagisse avec une interface utilisateur qui récupère ensuite des informations à partir d'un serveur. Un exemple de ce type de session est lorsqu'un utilisateur se connecte à l'aide de l'écran de connexion ou utilise un formulaire pour interroger un magasin de données. Une session non interactive est une session qui implique uniquement une interaction programmatique avec un serveur, telle qu'une requête SOAP pour récupérer des données.
{#r_ScopedGlideSessionIsInteractive__table_fjc_dpk_ls__entry__3}

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

{#r_ScopedGlideSessionIsInteractive__table_fjc_dpk_ls} {#r_ScopedGlideSessionIsInteractive__table_gjc_dpk_ls__entry__2}

| Type | Description |
|-|-|
| Booléen | Marqueur indiquant si la session est interactive. Valeurs possibles : * true : la session est interactive. * faux : la session n'est pas interactive. |
[Tableau 20. Renvoie]

{#r_ScopedGlideSessionIsInteractive__table_gjc_dpk_ls}  

    var interActive = gs.getSession().isInteractive();
    gs.info(interActive);

## GlideSession inclus dans le périmètre : isLoggedIn() {#ariaid-title12}

Renvoie la valeur true si l'utilisateur est connecté.
{#r_ScopedGlideSessionIsLoggedIn__table_phb_qpk_ls__entry__3}

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

{#r_ScopedGlideSessionIsLoggedIn__table_phb_qpk_ls} {#r_ScopedGlideSessionIsLoggedIn__table_qhb_qpk_ls__entry__2}

| Type | Description |
|-|-|
| Booléen | Marqueur indiquant si l'utilisateur est connecté Valeurs possibles : * vrai : l'utilisateur est connecté. * false : l'utilisateur n'est pas connecté. |
[Tableau 22. Renvoie]

{#r_ScopedGlideSessionIsLoggedIn__table_qhb_qpk_ls}  

    var session = gs.getSession();
    var loggedIn = session.isLoggedIn();
    gs.info(loggedIn);

Sortie :

    true

## GlideSession inclus dans le périmètre : putClientData(String paramName, String paramValue) {#ariaid-title13}

Définit une valeur de client de session qui peut être récupérée avec getClientData(). Cette méthode est utilisée dans un script côté serveur qui s'exécute lorsqu'un formulaire est créé.
{#r_ScopedGlideSessionPutClientData_String_String__table_cgh_ytk_ls__entry__3}

| Nom | Type | Description |
|-|-|-|
| paramName | Chaîne | Nom des données client à définir. |
| paramValue | Chaîne | Valeur des données du client. |
[Tableau 23. Paramètres]

{#r_ScopedGlideSessionPutClientData_String_String__table_cgh_ytk_ls} {#r_ScopedGlideSessionPutClientData_String_String__table_dgh_ytk_ls__entry__2}

| Type | Description |
|-|-|
| nul |   |
[Tableau 24. Renvoie]

{#r_ScopedGlideSessionPutClientData_String_String__table_dgh_ytk_ls}  

    var session = gs.getSession();
    session.putClientData('test1', 'Harry');
    var clientData = session.getClientData('test1');
    gs.info(clientData);

Sortie :

    Harry