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 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
nom de param.	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 de 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 qui utilisait la méthode putClientData( ).

Tableau 3. Paramètres

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

Tableau 4. Renvoie

Type	Description
Chaîne	Les données du 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 incluse dans le périmètre correspondante : getLanguage().

GlideSession : getRoles()

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

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

Tableau 7. Paramètres

Nom	Type	Description
Aucun

Tableau 8. Renvoie

Type	Description
Chaîne	Une 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()

Récupère le nom du fuseau horaire de la session.

Tableau 9. Paramètres

Nom	Type	Description
Aucun

Tableau 10. Renvoie

Type	Description
Chaîne	Le 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 incluse dans le périmètre correspondante : getTimeZoneName().

GlideSession : isInteractive()

Détermine si la session actuelle 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 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 fausse 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 incluse dans le périmètre correspondante : isLoggedIn().

GlideSession : 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 15. Paramètres

Nom	Type	Description
nom de param.	Chaîne	Nom du paramètre client à définir.
valeur 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 incluse dans le périmètre correspondante : putClientData().