GlideSession : Bereichsbezogen

Die bereichsbezogene GlideSession -API bietet Methoden zum Suchen von Informationen über die aktuelle Sitzung.

Es gibt keine Konstruktoren zum Erstellen einer Instanz eines bereichsbezogenen GlideSession-Objekts. Verwenden Sie stattdessen die getSession()-Methode der bereichsbezogenen GlideSystem-API.

Scoped GlideSession – getClientData(String paramName)

Ruft einen Sitzungsclientwert ab, der zuvor mit putClientData() festgelegt wurde.

Verwenden Sie diese Methode, um Datenwerte abzurufen, die mit der Methode „putClientData()“ festgelegt wurden.

Tabelle : 1. Parameter

Name	Typ	Beschreibung
paramName	Zeichenfolge	Name der abzurufenden Client-Daten.

Tabelle : 2. Ergebnisse

Typ	Beschreibung
Zeichenfolge	Client-Daten.

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

Ausgabe:

Harry

Scoped GlideSession – getClientIP()

Gibt die Client-IP-Adresse zurück.

Tabelle : 3. Parameter

Name	Typ	Beschreibung
Keine

Tabelle : 4. Ergebnisse

Typ	Beschreibung
Zeichenfolge	IP-Adresse

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

Ausgabe:

50.59.164.97

Scoped GlideSession – getCurrentApplicationId()

Gibt die aktuell in der Anwendungsauswahl ausgewählte Anwendung zurück.

Diese Methode erfordert Administratorrechte.

Tabelle : 5. Parameter

Name	Typ	Beschreibung
Keine

Tabelle : 6. Ergebnisse

Typ	Beschreibung
Zeichenfolge	Derzeit ausgewählte Anwendung.

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

Ausgabe:

ce05b9f32b840200c5244f74b4da1501

Bereichsbezogene GlideSession – getCurrentDomainID()

Gibt die sys_id der aktuellen Domäne für die Sitzung des angemeldeten Anwenders zurück.

Der zurückgegebene Identifier hängt vom Domänentyp und der Instantiierung dieser Domäne ab.

• Wenn der Benutzer in der globalen Domäne konfiguriert ist und die Domänenauswahl nicht zum Wechseln von Domänen verwendet, gibt die Methode NULL zurück.
• Wenn der Benutzer die Domänenauswahl verwendet, um zur globalen Domäne zu wechseln, gibt die Methode die Zeichenfolge „global“ zurück .
• Bei allen anderen Domänen gibt die Methode die sys_id dieser Domäne zurück.

Tabelle : 7. Parameter

Name	Typ	Beschreibung
Keine

Tabelle : 8. Ergebnisse

Typ	Beschreibung
Zeichenfolge	Sys_id der Sitzungsdomäne des aktuell angemeldeten Benutzers. Dies sind die gleichen Informationen, die in der Domänenauswahl angezeigt werden.

Dieses Beispiel zeigt, wie die Domäne des aktuellen sys_email-Datensatzes auf die Sitzungsdomäne des Benutzers festgelegt wird, wenn die Benutzerdomäne global oder null ist.

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

Scoped GlideSession – getLanguage()

Gibt den Sprachcode der Sitzung zurück.

Tabelle : 9. Parameter

Name	Typ	Beschreibung
Keine

Tabelle : 10. Ergebnisse

Typ	Beschreibung
Zeichenfolge	Sprachcode der Sitzung.

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

Ausgabe:

en

Scoped GlideSession – getSessionToken()

Gibt das Sitzungstoken zurück.

Tabelle : 11. Parameter

Name	Typ	Beschreibung
Keine

Tabelle : 12. Ergebnisse

Typ	Beschreibung
Zeichenfolge	Sitzungstoken.

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

Ausgabe:

4284b5372b840200c5244f74b4da15f2c3476cf7fcb6572afa4ef9d5e6d307a5fd9e1da7

Scoped GlideSession – getTimeZoneName()

Gibt den Namen der Zeitzone der Sitzung zurück.

Tabelle : 13. Parameter

Name	Typ	Beschreibung
Keine

Tabelle : 14. Ergebnisse

Typ	Beschreibung
Zeichenfolge	Name der Zeitzone der Sitzung.

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

Ausgabe:

US/Pacific

Scoped GlideSession – getUrlOnStack()

Gibt die URL zum Stapel zurück. Gibt NULL zurück, wenn der Stapel leer ist.

Tabelle : 15. Parameter

Name	Typ	Beschreibung
Keine

Tabelle : 16. Ergebnisse

Typ	Beschreibung
Zeichenfolge	URL im Stapel. Gibt NULL zurück, wenn der Stapel leer ist.

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

Ausgabe: Zeilenumbrüche wurden zur besseren Übersicht hinzugefügt.

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

Scoped GlideSession – isImpersonating()

Gibt „true“ zurück, wenn der Benutzer die Identität eines anderen Benutzers annimmt.

Tabelle : 17. Parameter

Name	Typ	Beschreibung
Keine

Tabelle : 18. Ergebnisse

Typ	Beschreibung
Boolean	Kennzeichnung, die angibt, dass der Anwender die Identität eines anderen Anwenders annimmt. Mögliche Werte: wahr: Der Anwender nimmt die Identität an. false: Der Anwender nimmt die Identität nicht an.

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

Scoped GlideSession – isInteractive()

Gibt „true“ zurück, wenn die Sitzung interaktiv ist.

Bei einer interaktiven Sitzung handelt es sich um eine Sitzung, bei der ein Endbenutzer mit einer Benutzeroberfläche interagiert, die dann Informationen von einem Server abruft. Ein Beispiel dieses Sitzungstyps ist, wenn sich ein Benutzer über den Anmeldebildschirm anmeldet oder ein Formular verwendet, um einen Datenspeicher abzufragen. Eine nicht interaktive Sitzung ist eine Sitzung, die nur eine programmatische Interaktion mit einem Server beinhaltet, wie eine SOAP-Anforderung zum Abruf von Daten.

Tabelle : 19. Parameter

Name	Typ	Beschreibung
Keine

Tabelle : 20. Ergebnisse

Typ	Beschreibung
Boolean	Kennzeichnung, die angibt, ob die Sitzung interaktiv ist. Mögliche Werte: wahr: Sitzung ist interaktiv. false: Sitzung ist nicht interaktiv.

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

Scoped GlideSession – isLoggedIn()

Gibt „true“ zurück, wenn der Benutzer angemeldet ist.

Tabelle : 21. Parameter

Name	Typ	Beschreibung
Keine

Tabelle : 22. Ergebnisse

Typ	Beschreibung
Boolean	Kennzeichnung, die angibt, ob der Anwender angemeldet ist Mögliche Werte: wahr: Anwender ist angemeldet. false: Anwender ist nicht angemeldet.

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

Ausgabe:

true

Scoped GlideSession – putClientData(String paramName, String paramValue)

Legt einen Sitzungsclientwert fest, der mit getClientData() abgerufen werden kann. Diese Methode wird in einem serverseitigen Skript verwendet, das beim Erstellen eines Formulars ausgeführt wird.

Tabelle : 23. Parameter

Name	Typ	Beschreibung
paramName	Zeichenfolge	Name der festzulegenden Client-Daten.
paramValue	Zeichenfolge	Wet der Clientdaten.

Tabelle : 24. Ergebnisse

Typ	Beschreibung
void

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

Ausgabe:

Harry