---
sourceDocument: Xanadu-API-Referenz
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/de-DE/xanadu/api-reference

 Release :

    - xanadu

ft:locale :

    - de-DE

ft:publication_title :

    - Xanadu-API-Referenz

ft:clusterId :

    - crapiref

bundleId :

    - crapiref

workflow :

    - Creator


---

# GlideSession: Bereichsbezogen

# GlideSession: Bereichsbezogen {#ariaid-title1}

* Freigeben Version: Xanadu
* 
* Aktualisiert 1. August 2024
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 3 Minuten Lesedauer

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) {#ariaid-title2}

Ruft einen Sitzungsclientwert ab, der zuvor mit putClientData() festgelegt wurde.
Verwenden Sie diese Methode, um Datenwerte abzurufen, die mit der Methode „putClientData() " festgelegt wurden.
{#r_ScopedGlideSessionGetClientData_String__table_j24_fqk_ls__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| paramName | Zeichenfolge | Name der abzurufenden Client-Daten. |
[Tabelle : 1. Parameter]

{#r_ScopedGlideSessionGetClientData_String__table_j24_fqk_ls} {#r_ScopedGlideSessionGetClientData_String__table_k24_fqk_ls__entry__2}

| Typ | Beschreibung |
|-|-|
| Zeichenfolge | Client-Daten. |
[Tabelle : 2. Ergebnisse]

{#r_ScopedGlideSessionGetClientData_String__table_k24_fqk_ls}  

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

Ausgabe:

    Harry

## Scoped GlideSession -- getClientIP() {#ariaid-title3}

Gibt die Client-IP-Adresse zurück.
{#r_ScopedGlideSessionGetClientIP__table_gcx_wqk_ls__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| Keine |   |   |
[Tabelle : 3. Parameter]

{#r_ScopedGlideSessionGetClientIP__table_gcx_wqk_ls} {#r_ScopedGlideSessionGetClientIP__table_hcx_wqk_ls__entry__2}

| Typ | Beschreibung |
|-|-|
| Zeichenfolge | IP-Adresse |
[Tabelle : 4. Ergebnisse]

{#r_ScopedGlideSessionGetClientIP__table_hcx_wqk_ls}  

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

Ausgabe:

    50.59.164.97

## Scoped GlideSession -- getCurrentApplicationId() {#ariaid-title4}

Gibt die aktuell in der Anwendungsauswahl ausgewählte Anwendung zurück.
Diese Methode erfordert Administratorrechte.
{#r_ScopedGlideSessionGetCurrentApplicationId__table_br3_jrk_ls__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| Keine |   |   |
[Tabelle : 5. Parameter]

{#r_ScopedGlideSessionGetCurrentApplicationId__table_br3_jrk_ls} {#r_ScopedGlideSessionGetCurrentApplicationId__table_cr3_jrk_ls__entry__2}

| Typ | Beschreibung |
|-|-|
| Zeichenfolge | Derzeit ausgewählte Anwendung. |
[Tabelle : 6. Ergebnisse]

{#r_ScopedGlideSessionGetCurrentApplicationId__table_cr3_jrk_ls}  

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

Ausgabe:

    ce05b9f32b840200c5244f74b4da1501

## Bereichsbezogene GlideSession -- getCurrentDomainID() {#ariaid-title5}

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.
{#GSS-getCurrentDomainID__table_jcl_vvq_xnb__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| Keine |   |   |
[Tabelle : 7. Parameter]

{#GSS-getCurrentDomainID__table_jcl_vvq_xnb} {#GSS-getCurrentDomainID__table_kcl_vvq_xnb__entry__2}

| Typ | Beschreibung |
|-|-|
| Zeichenfolge | Sys_id der Sitzungsdomäne des aktuell angemeldeten Benutzers. Dies sind die gleichen Informationen, die in der Domänenauswahl angezeigt werden. |
[Tabelle : 8. Ergebnisse]

{#GSS-getCurrentDomainID__table_kcl_vvq_xnb}  
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() {#ariaid-title6}

Gibt den Sprachcode der Sitzung zurück.
{#r_ScopedGlideSessionGetLanguage__table_chb_wrk_ls__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| Keine |   |   |
[Tabelle : 9. Parameter]

{#r_ScopedGlideSessionGetLanguage__table_chb_wrk_ls} {#r_ScopedGlideSessionGetLanguage__table_dhb_wrk_ls__entry__2}

| Typ | Beschreibung |
|-|-|
| Zeichenfolge | Sprachcode der Sitzung. |
[Tabelle : 10. Ergebnisse]

{#r_ScopedGlideSessionGetLanguage__table_dhb_wrk_ls}  

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

Ausgabe:

    en

## Scoped GlideSession -- getSessionToken() {#ariaid-title7}

Gibt das Sitzungstoken zurück.
{#r_ScopedGlideSessionGetSessionToken__table_g2l_gsk_ls__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| Keine |   |   |
[Tabelle : 11. Parameter]

{#r_ScopedGlideSessionGetSessionToken__table_g2l_gsk_ls} {#r_ScopedGlideSessionGetSessionToken__table_h2l_gsk_ls__entry__2}

| Typ | Beschreibung |
|-|-|
| Zeichenfolge | Sitzungstoken. |
[Tabelle : 12. Ergebnisse]

{#r_ScopedGlideSessionGetSessionToken__table_h2l_gsk_ls}  

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

Ausgabe:

    4284b5372b840200c5244f74b4da15f2c3476cf7fcb6572afa4ef9d5e6d307a5fd9e1da7

## Scoped GlideSession -- getTimeZoneName() {#ariaid-title8}

Gibt den Namen der Zeitzone der Sitzung zurück.
{#r_ScopedGlideSessionGetTimeZoneName__table_tws_qsk_ls__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| Keine |   |   |
[Tabelle : 13. Parameter]

{#r_ScopedGlideSessionGetTimeZoneName__table_tws_qsk_ls} {#r_ScopedGlideSessionGetTimeZoneName__table_uws_qsk_ls__entry__2}

| Typ | Beschreibung |
|-|-|
| Zeichenfolge | Name der Zeitzone der Sitzung. |
[Tabelle : 14. Ergebnisse]

{#r_ScopedGlideSessionGetTimeZoneName__table_uws_qsk_ls}  

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

Ausgabe:

    US/Pacific

## Scoped GlideSession -- getUrlOnStack() {#ariaid-title9}

Gibt die URL zum Stapel zurück. Gibt NULL zurück, wenn der Stapel leer ist.
{#r_ScopedGlideSessionGetUrlOnStack__table_qhx_ctk_ls__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| Keine |   |   |
[Tabelle : 15. Parameter]

{#r_ScopedGlideSessionGetUrlOnStack__table_qhx_ctk_ls} {#r_ScopedGlideSessionGetUrlOnStack__table_rhx_ctk_ls__entry__2}

| Typ | Beschreibung |
|-|-|
| Zeichenfolge | URL im Stapel. Gibt NULL zurück, wenn der Stapel leer ist. |
[Tabelle : 16. Ergebnisse]

{#r_ScopedGlideSessionGetUrlOnStack__table_rhx_ctk_ls}  

    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() {#ariaid-title10}

Gibt „true" zurück, wenn der Benutzer die Identität eines anderen Benutzers annimmt.
{#r_SGSSN-isImpersonating__table_rhv_tj5_xw__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| Keine |   |   |
[Tabelle : 17. Parameter]

{#r_SGSSN-isImpersonating__table_rhv_tj5_xw} {#r_SGSSN-isImpersonating__table_shv_tj5_xw__entry__2}

| 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. |
[Tabelle : 18. Ergebnisse]

{#r_SGSSN-isImpersonating__table_shv_tj5_xw}  

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

## Scoped GlideSession -- isInteractive() {#ariaid-title11}

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.
{#r_ScopedGlideSessionIsInteractive__table_fjc_dpk_ls__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| Keine |   |   |
[Tabelle : 19. Parameter]

{#r_ScopedGlideSessionIsInteractive__table_fjc_dpk_ls} {#r_ScopedGlideSessionIsInteractive__table_gjc_dpk_ls__entry__2}

| Typ | Beschreibung |
|-|-|
| Boolean | Kennzeichnung, die angibt, ob die Sitzung interaktiv ist. Mögliche Werte: * wahr: Sitzung ist interaktiv. * false: Sitzung ist nicht interaktiv. |
[Tabelle : 20. Ergebnisse]

{#r_ScopedGlideSessionIsInteractive__table_gjc_dpk_ls}  

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

## Scoped GlideSession -- isLoggedIn() {#ariaid-title12}

Gibt „true" zurück, wenn der Benutzer angemeldet ist.
{#r_ScopedGlideSessionIsLoggedIn__table_phb_qpk_ls__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| Keine |   |   |
[Tabelle : 21. Parameter]

{#r_ScopedGlideSessionIsLoggedIn__table_phb_qpk_ls} {#r_ScopedGlideSessionIsLoggedIn__table_qhb_qpk_ls__entry__2}

| Typ | Beschreibung |
|-|-|
| Boolean | Kennzeichnung, die angibt, ob der Anwender angemeldet ist Mögliche Werte: * wahr: Anwender ist angemeldet. * false: Anwender ist nicht angemeldet. |
[Tabelle : 22. Ergebnisse]

{#r_ScopedGlideSessionIsLoggedIn__table_qhb_qpk_ls}  

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

Ausgabe:

    true

## Scoped GlideSession -- putClientData(String paramName, String paramValue) {#ariaid-title13}

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.
{#r_ScopedGlideSessionPutClientData_String_String__table_cgh_ytk_ls__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| paramName | Zeichenfolge | Name der festzulegenden Client-Daten. |
| paramValue | Zeichenfolge | Wet der Clientdaten. |
[Tabelle : 23. Parameter]

{#r_ScopedGlideSessionPutClientData_String_String__table_cgh_ytk_ls} {#r_ScopedGlideSessionPutClientData_String_String__table_dgh_ytk_ls__entry__2}

| Typ | Beschreibung |
|-|-|
| void |   |
[Tabelle : 24. Ergebnisse]

{#r_ScopedGlideSessionPutClientData_String_String__table_dgh_ytk_ls}  

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

Ausgabe:

    Harry