GlideSession – Umfang

  • Freigeben Version: Yokohama
  • Aktualisiert 30. Januar 2025
  • 3 Minuten Lesedauer

    • Der Umfang ist festgelegt GlideSession Die API stellt Methoden bereit, um Informationen zur aktuellen Sitzung zu finden.

    Es gibt keine Konstruktoren zum Erstellen einer Instanz eines bereichsbezogenen GlideSession-Objekts. Verwenden Sie stattdessen GetSession() Methode des Umfangs GlideSystem API.

    Bereichsbezogene GlideSession – getClientData (Zeichenfolge paramName)

    Ruft einen Sitzungs-Client-Wert ab, der zuvor mit festgelegt wurde PutClientData() .

    Verwenden Sie diese Methode, um Datenwerte abzurufen, die mit festgelegt wurden PutClientData() Methode.

    Tabelle : 1. Parameter
    Name Typ Beschreibung
    Parametername Zeichenfolge Name der abzurufenden Clientdaten.
    Tabelle : 2. Rückgaben
    Typ Beschreibung
    Zeichenfolge Client-Daten. 
    var session = gs.getSession();
session.putClientData('test1', 'Harry');
var clientData = session.getClientData('test1');
gs.info(clientData);

    Ausgabe:

    Harry

    Bereichsbezogene GlideSession – getClientIP()

    Gibt die Client-IP-Adresse zurück.

    Tabelle : 3. Parameter
    Name Typ Beschreibung
    Keine
    Tabelle : 4. Rückgaben
    Typ Beschreibung
    Zeichenfolge IP-Adresse. 
    var session = gs.getSession();
var addr = session.getClientIP();
gs.info(addr);

    Ausgabe:

    50.59.164.97

    Bereichsbezogene GlideSession – getCurrentApplicationId()

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

    Diese Methode erfordert Administratorrechte.

    Tabelle : 5. Parameter
    Name Typ Beschreibung
    Keine
    Tabelle : 6. Rückgaben
    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 angemeldete Anwendersitzung zurück.

    Der zurückgegebene Bezeichner hängt vom Domänentyp und der Instanziierung dieser Domäne ab.
    • Wenn der Anwender 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 Anwender die Domänenauswahl verwendet, um zur globalen Domäne zu wechseln, gibt die Methode die Zeichenfolge „global“ zurück.
    • Für alle anderen Domänen gibt die Methode die sys_ID dieser Domäne zurück.
    Tabelle : 7. Parameter
    Name Typ Beschreibung
    Keine
    Tabelle : 8. Rückgaben
    Typ Beschreibung
    Zeichenfolge SYS_ID der Sitzungsdomäne des aktuell angemeldeten Anwenders. 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 Anwenders festgelegt wird, wenn die Anwenderdomä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;

    Bereichsbezogene GlideSession – getLanguage()

    Gibt den Sprachcode der Sitzung zurück.

    Tabelle : 9. Parameter
    Name Typ Beschreibung
    Keine
    Tabelle : 10. Rückgaben
    Typ Beschreibung
    Zeichenfolge Sprachcode der Sitzung. 
    var session = gs.getSession();
var language = session.getLanguage();
gs.info(language);

    Ausgabe:

    en

    Bereichsbezogene GlideSession – getSessionToken()

    Gibt das Sitzungstoken zurück.

    Tabelle : 11. Parameter
    Name Typ Beschreibung
    Keine
    Tabelle : 12. Rückgaben
    Typ Beschreibung
    Zeichenfolge Sitzungstoken. 
    var session = gs.getSession();
var token = session.getSessionToken();
gs.info(token);

    Ausgabe:

    4284b5372b840200c5244f74b4da15f2c3476cf7fcb6572afa4ef9d5e6d307a5fd9e1da7

    Bereichsbezogene GlideSession – getTimeZoneName()

    Gibt den Namen der Zeitzone der Sitzung zurück.

    Tabelle : 13. Parameter
    Name Typ Beschreibung
    Keine
    Tabelle : 14. Rückgaben
    Typ Beschreibung
    Zeichenfolge Name der Zeitzone der Sitzung. 
    var session = gs.getSession();
var zoneName = session.getTimeZoneName();
gs.info(zoneName);

    Ausgabe:

    US/Pacific

    Bereichsbezogene GlideSession – getUrlOnStack()

    Gibt die URL auf dem Stapel zurück. Gibt Null zurück, wenn der Stapel leer ist.

    Tabelle : 15. Parameter
    Name Typ Beschreibung
    Keine
    Tabelle : 16. Rückgaben
    Typ Beschreibung
    Zeichenfolge URL auf dem Stapel. Gibt Null zurück, wenn der Stapel leer ist. 
    var session = gs.getSession();
var URL = session.getUrlOnStack();
gs.info(URL);

    Ausgabe: Zeilenumbrüche zur Übersichtlichkeit hinzugefügt.

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

    Bereichsbezogene GlideSession – isImpersonating()

    Gibt „wahr“ zurück, wenn der Anwender die Identität eines anderen Anwenders annimmt.

    Tabelle : 17. Parameter
    Name Typ Beschreibung
    Keine
    Tabelle : 18. Rückgaben
    Typ Beschreibung
    Boolean Kennzeichnung, die angibt, dass der Anwender die Identität eines anderen Anwenders annimmt.
    Mögliche Werte:
    • Wahr: Identität des Anwenders wird angenommen.
    • Falsch: Identität des Anwenders wird nicht angenommen.
    		 
    var isImpersonator = gs.getSession().isImpersonating();
gs.info(isImpersonator);

    Bereichsbezogene GlideSession – isInteractive()

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

    Eine interaktive Sitzung ist eine Sitzung, bei der ein Endanwender mit einer Anwenderoberfläche interagiert, die dann Informationen von einem Server abruft. Ein Beispiel für diesen Sitzungstyp ist, wenn sich ein Anwender über den Anmeldebildschirm anmeldet oder ein Formular zum Abfragen eines Datenspeichers verwendet. Eine nicht interaktive Sitzung ist eine Sitzung, die nur eine programmatische Interaktion mit einem Server wie einer SOAP-Anforderung zum Abrufen von Daten beinhaltet.

    Tabelle : 19. Parameter
    Name Typ Beschreibung
    Keine
    Tabelle : 20. Rückgaben
    Typ Beschreibung
    Boolean Kennzeichnung, die angibt, ob die Sitzung interaktiv ist.
    Mögliche Werte:
    • Wahr: Sitzung ist interaktiv.
    • Falsch: Sitzung ist nicht interaktiv.
    		 
    var interActive = gs.getSession().isInteractive();
gs.info(interActive);

    Bereichsbezogene GlideSession – isLoggedIn()

    Gibt „wahr“ zurück, wenn der Anwender angemeldet ist.

    Tabelle : 21. Parameter
    Name Typ Beschreibung
    Keine
    Tabelle : 22. Rückgaben
    Typ Beschreibung
    Boolean Kennzeichnung, die angibt, ob der Anwender angemeldet ist
    Mögliche Werte:
    • Wahr: Anwender ist angemeldet.
    • Falsch: Anwender ist nicht angemeldet.
    		 
    var session = gs.getSession();
var loggedIn = session.isLoggedIn();
gs.info(loggedIn);

    Ausgabe:

    true

    Bereichsbezogene GlideSession – putClientData (Zeichenfolge paramName, ZeichenfolgenparamValue)

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

    Tabelle : 23. Parameter
    Name Typ Beschreibung
    Parametername Zeichenfolge Name der festzulegenden Clientdaten.
    Parameterwert Zeichenfolge Wert der Clientdaten.
    Tabelle : 24. Rückgaben
    Typ Beschreibung
    Ungültig 
    var session = gs.getSession();
session.putClientData('test1', 'Harry');
var clientData = session.getClientData('test1');
gs.info(clientData);

    Ausgabe:

    Harry