GlideSession - Global

L’API GlideSession fournit des méthodes pour trouver des informations sur la session en cours.

GlideSession : clearClientData(String paramName)

Efface une valeur du client de session précédemment définie avec putClientData().

Cette méthode est utilisée dans un script client pour effacer les valeurs de données qui ont été définies par un script serveur à l’aide de la méthode putClientData().

Tableau 1. Paramètres

Nom	Type	Description
paramName	Chaîne	Nom des données client à effacer.

Tableau 2. Renvoie

Type	Description
nul

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

Sortie :

Harry
 
null

GlideSession : getClientData(String paramName)

Renvoie une valeur du client de session précédemment définie avec putClientData().

Cette méthode est utilisée dans un script client pour récupérer les valeurs de données qui ont été définies par un script serveur utilisant la méthode putClientData().

Tableau 3. Paramètres

Nom	Type	Description
paramName	Chaîne	Nom des données client à récupérer.

Tableau 4. Renvoie

Type	Description
Chaîne	Les données client sous forme de chaîne.

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

Sortie :

Harry

Équivalent dans le champ d’application

Pour utiliser la méthode getClientData() dans une application incluse dans le périmètre, utilisez la méthode incluse dans le périmètre correspondante : getClientData().

GlideSession : getLanguage()

Obtient le code de langue de la session.

Tableau 5. Paramètres

Nom	Type	Description
Aucun

Tableau 6. Renvoie

Type	Description
Chaîne	Code de langue de la session.

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

Sortie :

en

Équivalent dans le champ d’application

Pour utiliser la méthode getLanguage() dans une application incluse dans le périmètre, utilisez la méthode correspondante délimitée : getLanguage().

GlideSession : getRoles()

Obtient une liste de rôles pour l’utilisateur actuel.

La liste des rôles ne reflète pas les changements apportés au cours de la session utilisateur actuelle. Pour obtenir la liste des rôles mise à jour, l’utilisateur doit se déconnecter et se reconnecter.

Tableau 7. Paramètres

Nom	Type	Description
Aucun

Tableau 8. Renvoie

Type	Description
Chaîne	Liste de rôles séparés par des virgules.

gs.info(gs.getSession().getRoles());

Sortie :

admin,hr_fulfiller,itsa_fulfiller,security_admin

GlideSession : getTimeZoneName()

Obtient le nom du fuseau horaire de la session.

Tableau 9. Paramètres

Nom	Type	Description
Aucun

Tableau 10. 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

Équivalent dans le champ d’application

Pour utiliser la méthode getTimeZoneName() dans une application incluse dans le périmètre, utilisez la méthode délimitée correspondante : getTimeZoneName().

GlideSession : isInteractive()

Détermine si la session en cours 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.

Tableau 11. Paramètres

Nom	Type	Description
Aucun

Tableau 12. Renvoie

Type	Description
Booléen	Vrai si la session est interactive.

Remarque :

La méthode isInteractive() renverra toujours une valeur false pour toutes les sessions utilisateur utilisant les applications mobiles classiques ou actuelles.

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

Sortie :

false

Équivalent dans le champ d’application

Pour utiliser la méthode isInteractive() dans une application incluse dans le périmètre, utilisez la méthode incluse dans le périmètre correspondante : isInteractive().

GlideSession : isLoggedIn()

Détermine si l’utilisateur actuel est actuellement connecté.

Tableau 13. Paramètres

Nom	Type	Description
Aucun

Tableau 14. Renvoie

Type	Description
Booléen	Vrai si l’utilisateur actuel est connecté.

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

Sortie :

true

Équivalent dans le champ d’application

Pour utiliser la méthode isLoggedIn() dans une application incluse dans le périmètre, utilisez la méthode délimitée correspondante : isLoggedIn().

GlideSession : putClientData(String paramName, String paramValue)

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

Tableau 15. Paramètres

Nom	Type	Description
paramName	Chaîne	Nom du paramètre client à définir.
paramValue	Chaîne	Valeur du paramètre.

Tableau 16. Renvoie

Type	Description
nul

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

Sortie :

Harry

Équivalent dans le champ d’application

Pour utiliser la méthode putClientData() dans une application incluse dans le périmètre, utilisez la méthode délimitée correspondante : putClientData().