GlideSession : dans le champ d’application

  • Rversion finale: Yokohama
  • Mis à jour 30 janv. 2025
  • 4 minutes de lecture

    • L’API GlideSession incluse dans le champ d’application fournit des méthodes pour trouver des informations sur la session en cours.

    Il n’existe aucun constructeur permettant de créer une instance d’un objet GlideSession inclus dans le champ d’application. Utilisez plutôt la méthode getSession() de l’API GlideSystem incluse dans le champ d’application.

    GlideSession dans le champ d’application : getClientData(String paramName)

    Récupère une valeur 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( ).

    Tableau 1. Paramètres
    Nom Type Description
    nom de param. Chaîne Nom des données client à récupérer.
    Tableau 2. Renvoie
    Type Description
    Chaîne Données client. 
    var session = gs.getSession();
session.putClientData('test1', 'Harry');
var clientData = session.getClientData('test1');
gs.info(clientData);

    Sortie :

    Harry

    GlideSession dans le champ d’application : getClientIP()

    Renvoie l’adresse IP du client.

    Tableau 3. Paramètres
    Nom Type Description
    Aucun
    Tableau 4. Renvoie
    Type Description
    Chaîne Adresse IP. 
    var session = gs.getSession();
var addr = session.getClientIP();
gs.info(addr);

    Sortie :

    50.59.164.97

    GlideSession dans le champ d’application : getCurrentApplicationId()

    Renvoie l’application actuellement sélectionnée dans le sélecteur d’application.

    Cette méthode nécessite des privilèges d’administrateur.

    Tableau 5. Paramètres
    Nom Type Description
    Aucun
    Tableau 6. Renvoie
    Type Description
    Chaîne Application actuellement sélectionnée. 
    var session = gs.getSession();
var appID = session.getCurrentApplicationId();
gs.info(appID);

    Sortie :

    ce05b9f32b840200c5244f74b4da1501

    GlideSession dans le champ d’application : getCurrentDomainID()

    Renvoie l’sys_id du domaine actuel pour la session d’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 le sys_id de ce domaine.
    Tableau 7. Paramètres
    Nom Type Description
    Aucun
    Tableau 8. Renvoie
    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.

    Cet exemple montre le domaine de l’enregistrement de sys_email actuel 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 dans le champ d’application : getLanguage()

    Renvoie le code de langue de la session.

    Tableau 9. Paramètres
    Nom Type Description
    Aucun
    Tableau 10. Renvoie
    Type Description
    Chaîne Code de langue de la session. 
    var session = gs.getSession();
var language = session.getLanguage();
gs.info(language);

    Sortie :

    en

    GlideSession dans le champ d’application : getSessionToken()

    Renvoie le jeton de session.

    Tableau 11. Paramètres
    Nom Type Description
    Aucun
    Tableau 12. Renvoie
    Type Description
    Chaîne Jeton de session. 
    var session = gs.getSession();
var token = session.getSessionToken();
gs.info(token);

    Sortie :

    4284b5372b840200c5244f74b4da15f2c3476cf7fcb6572afa4ef9d5e6d307a5fd9e1da7

    GlideSession dans le champ d’application : getTimeZoneName()

    Renvoie le nom du fuseau horaire de la session.

    Tableau 13. Paramètres
    Nom Type Description
    Aucun
    Tableau 14. Renvoie
    Type Description
    Chaîne Nom du fuseau horaire de la session. 
    var session = gs.getSession();
var zoneName = session.getTimeZoneName();
gs.info(zoneName);

    Sortie :

    US/Pacific

    GlideSession dans le champ d’application : getUrlOnStack()

    Renvoie l’URL sur la pile. Renvoie null si la pile est vide.

    Tableau 15. Paramètres
    Nom Type Description
    Aucun
    Tableau 16. Renvoie
    Type Description
    Chaîne URL sur la pile. Renvoie null si la pile est vide. 
    var session = gs.getSession();
var URL = session.getUrlOnStack();
gs.info(URL);

    Sortie : sauts de ligne 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()

    Renvoie la valeur vrai si l’utilisateur emprunte l’identité d’un autre utilisateur.

    Tableau 17. Paramètres
    Nom Type Description
    Aucun
    Tableau 18. Renvoie
    Type Description
    Booléen Marqueur qui indique que l’utilisateur emprunte l’identité d’un autre utilisateur.
    Valeurs possibles :
    • vrai : l’utilisateur emprunte l’identité.
    • faux : l’utilisateur n’emprunte pas l’identité.
    		 
    var isImpersonator = gs.getSession().isImpersonating();
gs.info(isImpersonator);

    GlideSession dans le champ d’application : isInteractive()

    Renvoie la valeur vrai si la session est interactive.

    Une session interactive implique l’interaction d’un utilisateur final 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 implique uniquement une interaction programmatique avec un serveur, telle qu’une requête SOAP, pour récupérer des données.

    Tableau 19. Paramètres
    Nom Type Description
    Aucun
    Tableau 20. Renvoie
    Type Description
    Booléen Marqueur indiquant si la session est interactive.
    Valeurs possibles :
    • vrai : la session est interactive.
    • false : La session n’est pas interactive.
    		 
    var interActive = gs.getSession().isInteractive();
gs.info(interActive);

    GlideSession dans le champ d’application : isLoggedIn()

    Renvoie la valeur vrai si l’utilisateur est connecté.

    Tableau 21. Paramètres
    Nom Type Description
    Aucun
    Tableau 22. Renvoie
    Type Description
    Booléen Marqueur indiquant si l’utilisateur est connecté
    Valeurs possibles :
    • vrai : l’utilisateur est connecté.
    • faux : l’utilisateur n’est pas connecté.
    		 
    var session = gs.getSession();
var loggedIn = session.isLoggedIn();
gs.info(loggedIn);

    Sortie :

    true

    GlideSession dans le champ d’application : putClientData(String paramName, String paramValue)

    Définit une valeur 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éé.

    Tableau 23. Paramètres
    Nom Type Description
    nom de param. Chaîne Nom des données client à définir.
    valeur paramValue Chaîne Valeur des données client.
    Tableau 24. Renvoie
    Type Description
    nul 
    var session = gs.getSession();
session.putClientData('test1', 'Harry');
var clientData = session.getClientData('test1');
gs.info(clientData);

    Sortie :

    Harry