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

 Release :

    - yokohama

ft:locale :

    - de-DE

ft:publication_title :

    - Yokohama-API-Referenz

ft:clusterId :

    - crapiref

bundleId :

    - crapiref

workflow :

    - Creator


---

# GlideAgentWorkspace (g_aw) -- Client

# GlideAgentWorkspace (g_aw) -- Client {#ariaid-title1}

* Freigeben Version: Yokohama
* 
* Aktualisiert 30. Januar 2025
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 9 Minuten Lesedauer

Die G_aw Die API stellt Methoden bereit, mit denen eine UI-Aktion oder ein Client-Skript einen angegebenen Datensatz in öffnen kann MitarbeiterbereichRegisterkarte.

Für diese Klasse ist kein Konstruktor vorhanden. Zugriff GlideAgentWorkspace Methoden, die verwenden `G_aw `Globales Objekt.

## GlideAgentWorkspace -- closeRecord() {#ariaid-title2}

Schließt den derzeit geöffneten Datensatz, z. B. ein Formular, auf einer Unterregisterkarte in Mitarbeiterbereich.
{#gaw-closeRecord__table_mkp_zc3_smb__entry__3}

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

{#gaw-closeRecord__table_mkp_zc3_smb} {#gaw-closeRecord__table_nkp_zc3_smb__entry__2}

| Typ | Beschreibung |
|-|-|
| Keine |   |
[Tabelle : 2. Rückgaben]

{#gaw-closeRecord__table_nkp_zc3_smb}  
Im folgenden Beispiel wird der Inhalt der Registerkarte gespeichert und dann geschlossen.

```
Funktion onClick(g_Form) {
```

    function onClick(g_form) {
      g_form.save().then(function(){
        g_aw.closeRecord();
      });
    }

Das folgende Beispielskript verwendet `G_aw.closeRecord() `Methode zum Schließen eines Datensatzes, wenn auf eine Schaltfläche geklickt wird Mitarbeiterbereich. Sie können dieses Skript wie folgt verwenden:

1. Fügen Sie dieses Skript einer UI-Aktion (Schaltfläche) hinzu, die für konfiguriert ist Mitarbeiterbereich.
2. Wenn auf die Schaltfläche geklickt wird, wird versucht, den aktuellen Datensatz zu schließen.
3. Grundlegende Protokollierung zeigt Erfolg oder Fehler an.
{#gaw-closeRecord__ol_acm_vbv_g2c}

    functioncloseCurrentRecord() {
        if (typeof g_aw !== 'undefined' && g_aw.closeRecord) {
            g_aw.closeRecord().then(function(response) {
                console.log(response.success ? 'Record closed successfully.' : 'Failed to close the record.');
            }).catch(function(error) {
                console.error('Error closing the record:', error);
            });
        }
    }

In einem komplexeren Beispiel: CloseRecord() Die Methode wird in einem Client-Skript angewendet, in dem ein Support-Mitarbeiter einen Incident-Datensatz automatisch schließen möchte MitarbeiterbereichNachdem Sie eine bestimmte Aktion ausgeführt haben, z. B. die Lösung des Incidents. Die wichtigsten Aktionen dieses Skripts lauten wie folgt:

* Auslöserbedingung: Das Skript überprüft, ob der Status des Incidents auf „gelöst" festgelegt ist ( `status = 6 `).
* Validierung des Arbeitsbereichs: Stellt sicher, dass der Code nur innerhalb von ausgeführt wird MitarbeiterbereichWird verwendet `Typ von g_aw !== „nicht definiert" `.
* Verarbeitung Von Zusagen: Verwendet .Then() Und .Catch() Zur Verarbeitung der asynchronen Natur von CloseRecord() .
* Fehlerbehandlung: Bietet detaillierte Protokollierung für erfolgreiche und fehlgeschlagene Versuche.
{#gaw-closeRecord__ul_iyb_cbv_g2c}

    (function executeRule(current, gForm, gUser, gSNC) {
        // Check if the incident state is 'Resolved' (state = 6 in default ServiceNow setup)
        if (current.state == 6) {
            // Ensure we're in Agent Workspace
            if (typeof g_aw !== 'undefined' && g_aw.closeRecord) {
                g_aw.closeRecord().then(function(response) {
                    if (response.success) {
                        console.log('Incident record closed successfully in Agent Workspace.');
                    } else {
                        console.error('Failed to close the record:', response.errorMessage);
                    }
                }).catch(function(error) {
                    console.error('An error occurred while closing the record:', error);
                });
            }
        }
    })(current, gForm, gUser, gSNC);

## GlideAgentWorkspace -- openRecord (Zeichenfolgentabelle, SYS-ID der Zeichenfolge, Objektparameter) {#ariaid-title3}

Öffnet einen angegebenen Datensatz, z. B. ein Formular, auf einer Unterregisterkarte in Mitarbeiterbereich.
Hinweis:  
Diese Methode ist nur in verfügbar MitarbeiterbereichClient-Skriptumgebung oder in einer UI-Aktion im Feld „Client-Skript des Arbeitsbereichs".
{#gaw-openRecord_S_S_O__table_lhq_mph_bhb__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| table | Zeichenfolge | Name der Tabelle, die den zu öffnenden Datensatz enthält. |
| Sys-ID | Zeichenfolge | SYS-ID des zu öffnenden Datensatzes. |
| params | Objekt | Optional. Name/Wert-Paare der Parameter, die an den Datensatz übergeben werden sollen. "params": { "readOnlyForm": Boolean; "defaultTab": "String"; "hideDetails": Boolean } |
| Parameter.readOnlyFormular | Boolean | Kennzeichnung, die angibt, ob alle Felder im geöffneten Datensatz schreibgeschützt sind, unabhängig von der UI-Richtlinie und den ACLs. * Wahr: Alle Felder sind schreibgeschützt. * Falsch: Felder entsprechen der zugehörigen UI-Richtlinie und ACLs. {#gaw-openRecord_S_S_O__ul_py1_mrw_bhb} Standard: Falsch |
| params.defaultTab | Zeichenfolge | Name der anfänglichen Registerkarte, die im Arbeitsbereich angezeigt werden soll. Sie können nur zugehörige Elemente oder zugehörige Listen angeben. Wenn nicht angegeben, wird die Registerkarte „Details" angezeigt, es sei denn hideDetailsIst auf „wahr" festgelegt. Weitere Informationen zur Methode zum Abrufen eines zugehörigen Listennamens finden Sie unter [GetRelatedListNames()](https://servicenow-prod.fluidtopics.net/r2cLte7W6F4aFOeny2J1kA#c_GlideFormAPI "Die GlideForm Die API stellt Methoden zum Anpassen von Formularen bereit."). |
| Parameter.hideDetails | Boolean | Kennzeichnung, die angibt, ob die Registerkarte „Details" und die UI-Aktionen ausgeblendet werden sollen. * Wahr: Nur der Formularheader, alle anderen Registerkarten und die erste verfügbare Registerkarte werden im Formular angezeigt. * Falsch: Registerkarte „Details" und UI-Aktionen werden im Formular angezeigt. {#gaw-openRecord_S_S_O__ul_zxb_xsw_bhb} Standard: Falsch |
[Tabelle : 3. Parameter]

{#gaw-openRecord_S_S_O__table_lhq_mph_bhb} {#gaw-openRecord_S_S_O__table_mhq_mph_bhb__entry__2}

| Typ | Beschreibung |
|-|-|
| Keine |   |
[Tabelle : 4. Rückgaben]

{#gaw-openRecord_S_S_O__table_mhq_mph_bhb}  
Öffnen Sie einen sys_user-Datensatz in einer Unterregisterkarte.

    g_aw.openRecord('sys_user', '62826bf03710200044e0bfc8bcbe5df1'); 

Öffnen Sie einen Datensatz auf einer Unterregisterkarte, auf der alle Felder schreibgeschützt sind.

    g_aw.openRecord('sys_user', '62826bf03710200044e0bfc8bcbe5df1', {readOnlyForm: true}); 

Öffnen Sie einen Datensatz auf einer Unterregisterkarte, und wechseln Sie direkt zur zugehörigen Liste „Gruppen".

    g_aw.openRecord('sys_user', '62826bf03710200044e0bfc8bcbe5df1', {defaultTab: "sys_user_grmember.user"});  

Öffnen Sie einen Datensatz auf einer Unterregisterkarte, zeigen Sie aber nur den Formularheader und andere Registerkarten an.

    g_aw.openRecord('sys_user', '62826bf03710200044e0bfc8bcbe5df1', {hideDetails: true}); 

Das folgende Beispielskript zeigt, wie ein Service Desk-Mitarbeiter einem Incident eine Schaltfläche hinzufügen kann, die eine zugehörige Change-Anforderung auf einer neuen Registerkarte in öffnet Mitarbeiterbereich. Die wichtigsten Aktionen dieses Skripts lauten wie folgt:

* Dynamische Datensatzöffnung: Das Skript ruft die sys_ID der zugehörigen Change-Anforderung aus dem aktuellen Incident ab.
* Kontext des Mitarbeiterbereichs: Überprüft, ob `G_aw `Ist verfügbar, um zu bestätigen, dass das Skript in ausgeführt wird Mitarbeiterbereich.
* Anwenderdefinierte Parameter:
  * `Ansicht: „Agent" `Öffnet den Datensatz in einer bestimmten Ansicht (optional).
  * `Schreibgeschützt: Wahr `Öffnet den Datensatz im schreibgeschützten Modus (optional).
  {#gaw-openRecord_S_S_O__ul_yz5_3dv_g2c}
* Fehlerbehandlung: Verwendet .Then() Und .Catch() Für die Verarbeitung von Antworten und Fehlern.
{#gaw-openRecord_S_S_O__ul_m2h_zcv_g2c}

    function openRelatedChangeRequest() {
        // Get the sys_id of the related Change Request from the current incident
        var changeRequestSysId = g_form.getValue('change_request'); // Assuming 'change_request' is the field name

        if (changeRequestSysId && typeof g_aw !== 'undefined' && g_aw.openRecord) {
            g_aw.openRecord('change_request', changeRequestSysId, {
                view: 'agent', // Optional: Specify a custom view
                readOnly: true // Optional: Open the record in read-only mode
            }).then(function(response) {
                if (response.success) {
                    console.log('Change Request opened successfully.');
                } else {
                    console.error('Failed to open Change Request:', response.errorMessage);
                }
            }).catch(function(error) {
                console.error('Error opening Change Request:', error);
            });
        } else {
            console.warn('No related Change Request found or Agent Workspace is not available.');
        }
    }

Hinweis:  
Sie können dieses Skript in Ihrer eigenen Instanz verwenden, indem Sie dieses Skript an eine UI-Aktion (Schaltfläche) im Incident-Formular in anhängen Mitarbeiterbereich. Wenn Sie auf die Schaltfläche klicken, wird die zugehörige Change-Anforderung auf einer neuen Registerkarte geöffnet, was den Workflow des Service Desk-Mitarbeiters verbessert.

## GlideAgentWorkspace -- setSectionExpanded(Zeichenfolge section_Name, boolescher Wert erweitert) {#ariaid-title4}

Legt einen Formularabschnitt auf den Status erweitert oder reduziert fest.
Einen Anwendungsfall finden Sie unter .
{#gaw-setSectionExpanded_S_B__table_lhq_mph_bhb__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| Abschnittsname | Zeichenfolge | Name eines Formularabschnitts in Mitarbeiterbereich. |
| Erweitert | Boolean | Kennzeichnung, die angibt, ob ein Abschnitt standardmäßig erweitert oder reduziert werden soll. * Wahr: Der Abschnitt ist standardmäßig erweitert. * Falsch: Der Abschnitt ist standardmäßig reduziert. {#gaw-setSectionExpanded_S_B__ul_py1_mrw_bhb} |
[Tabelle : 5. Parameter]

{#gaw-setSectionExpanded_S_B__table_lhq_mph_bhb} {#gaw-setSectionExpanded_S_B__table_mhq_mph_bhb__entry__2}

| Typ | Beschreibung |
|-|-|
| Keine |   |
[Tabelle : 6. Rückgaben]

{#gaw-setSectionExpanded_S_B__table_mhq_mph_bhb}  
Das folgende Beispiel zeigt, wie ein Formularabschnitt mit dem Namen festgelegt wird `Related_Records `Zum standardmäßigen Reduzieren.

    function onLoad() {
       g_aw.setSectionExpanded('related_records', false);
    }

Das folgende Beispielskript demonstriert, wie ein Service Desk-Mitarbeiter verwenden kann SetSectionExpanded Methode zum Öffnen eines Incidents, bei der der Abschnitt „Arbeitsnotizen" automatisch erweitert werden soll, wenn der Incident eine hohe Priorität hat (z. B. Priorität 1 oder 2). Bei niedrigeren Prioritäten bleibt der Abschnitt reduziert, um visuelle Übersichtlichkeit zu reduzieren.  
Die wichtigsten Aktionen dieses Skripts lauten wie folgt:

* Prioritätsbasierte Logik: Das Skript überprüft die Priorität des Incidents mit `G_Form.getValue('Priorität') `.
* Dynamische Abschnittssteuerung: Erweitert den Abschnitt „Arbeitsnotizen", wenn die Priorität 1 (Kritisch) oder 2 (hoch) ist. Reduziert sie für niedrigere Prioritäten, um eine bereinigte UI beizubehalten.
* Überprüfung des Mitarbeiterbereichs: Stellt sicher, dass das Skript nur in ausgeführt wird Mitarbeiterbereich.
{#gaw-setSectionExpanded_S_B__ul_p14_22v_g2c}

    javascriptCopyEdit(functiontoggleWorkNotesSection() {
        // Check if we're in Agent Workspace and the method is availableif (typeof g_aw !== 'undefined' && g_aw.setSectionExpanded) {
            // Get the incident priority from the formvar priority = g_form.getValue('priority');

            // Automatically expand the "Work Notes" section for high-priority incidents (1 or 2)var shouldExpand = (priority == '1' || priority == '2');

            // Expand or collapse the section based on priority
            g_aw.setSectionExpanded('Work Notes', shouldExpand);
        }
    })();

Sie können dieses Beispiel als Client-Skript mit dem Typ „onLoad" für Incidents in hinzufügen Mitarbeiterbereich. Stellen Sie sicher, dass der Abschnittsname genau so übereinstimmt, wie er im Formularlayout angezeigt wird (z. B. „Arbeitsnotizen").

## GlideAgentWorkspace -- domainScopeProvider() {#ariaid-title5}

Ruft die Domänenbereichsdetails ab.
Die DomainScopeProvider() Die Methode greift auf vier Funktionen zu, um Informationen zum Domänenbereich zurückzugeben. Informationen hierzu finden Sie unter [Domain scope](https://www.servicenow.com/docs/access?context=c_DomainScope&version=yokohama&pubname=yokohama-platform-security&ft:locale=en-US).

Erforderliche Rolle -- Domain_expand_scope.
{#gaw-domainScopeProvider__table_lhq_mph_bhb__entry__3}

| Funktionsname | Rückgabetyp | Beschreibung |
|-|-|-|
| GetDomainScope() | Zeichenfolge | Ruft den Domänenbereich ab. Mögliche Werte: * Falsch: Gibt grundlegende Domäneninformationen zurück und enthält keine Informationen zu übergeordneten Domänen, geerbten Eigenschaften oder Domänenhierarchie. * Wahr: Gibt detaillierte Domänenbereichsinformationen zum aktuellen Datensatz oder Arbeitsbereichskontext zurück. {#gaw-domainScopeProvider__ul_zjy_nsk_kcc} Standard: Falsch |
| HasDomainChanged() | Boolean | Kennzeichnung, die angibt, ob sich die Domäne für den aktuellen Datensatz im Vergleich zur ursprünglichen Domäne geändert hat. Gültige Werte: * Wahr: Domäne hat sich geändert. * Falsch: Domäne hat sich nicht geändert. Gibt grundlegende Domäneninformationen zurück, ohne zu bewerten, ob sich die Domäne geändert hat. {#gaw-domainScopeProvider__ul_utq_msk_kcc} Standard: Falsch |
| IsDomainEnabledRecord() | Boolean | Kennzeichnung, die angibt, ob die Methode überprüfen soll, ob der aktuelle Datensatz domänengetrennt ist (domänengetrennt). Gültige Werte: * Wahr: Datensatz ist domänenfähig (z. B. gilt Domänentrennung für ihn). * Falsch: Datensatz ist nicht domänenfähig (z. B. ist er global ohne domänenspezifische Einschränkungen vorhanden). {#gaw-domainScopeProvider__ul_xs5_nsk_kcc} Standard: Falsch |
| Umschaltbarer DomainScope() | Boolean | Kennzeichnung, die angibt, ob der Domänenbereichskontext für einen Datensatz aktiviert oder deaktiviert werden soll. Gültige Werte: * Wahr: Zeigt alle verfügbaren Daten basierend auf der Domäne und den untergeordneten Domänen des Anwenders an. * Falsch: Zeigt nur Daten an, die der Domäne des aktuellen Datensatzes entsprechen. {#gaw-domainScopeProvider__ul_gt5_nsk_kcc} Standard: Wahr |
[Tabelle : 7. Funktionen]

{#gaw-domainScopeProvider__table_lhq_mph_bhb} {#gaw-domainScopeProvider__table_mhq_mph_bhb__entry__2}

| Typ | Beschreibung |
|-|-|
| Keine |   |
[Tabelle : 8. Rückgaben]

{#gaw-domainScopeProvider__table_mhq_mph_bhb}  

### Beispiel

Das folgende Beispiel zeigt, wie der Domänenbereich zwischen der Anwendersitzung und dem Datensatz als erweitert (Sitzungsumfang) oder reduziert (Datensatzumfang) in einem UI-Aktion Arbeitsplatz-Client-Skript umgeschaltet wird.

    function onClick(g_form) {
        var provider = g_aw.domainScopeProvider();
        
        provider.toggleDomainScope();

        var domainScopeNow = provider.getDomainScope();

        if (domainScopeNow === 'SESSION')
            g_form.addInfoMessage(getMessage("Domain Scope Expanded"));
        else if (domainScopeNow === 'RECORD')
            g_form.addInfoMessage(getMessage("Domain Scope Collapsed"));
    }

    function onSubmit() {
          if (typeof g_aw === 'undefined' || !g_aw.domainScopeProvider || typeof g_scratchpad === 'undefined') return true;
          if (g_scratchpad._domainConfirmationPassed ||
              g_scratchpad._domainCheckErrorBypass || g_scratchpad._domainCheckPassed) return true;
          var provider = g_aw.domainScopeProvider();
          if (!provider || !provider.isDomainEnabledRecord || !provider.isDomainEnabledRecord()) return true;
      // if you change these messages, please change them in the above messages field var title = getMessage("Change Domain"); var message = getMessage("You are about to change the domain of this record which may result in data
          loss.We will copy the information we can but you may need to replace the lost data.Do you want to proceed ? ");
          var gFormRef = g_form;
          var popModalConfirm = function() {  g_modal.confirm(title, message , function(response) {
          if (response) {
              g_scratchpad._domainConfirmationPassed = true;
              gFormRef.submit(gFormRef.getActionName());
          }
      });
      return false;
      };

      var proceedWithSubmit = function() {
          gFormRef.submit(gFormRef.getActionName());
      };

      var hasDomainChanged = provider.hasDomainChanged();
      if (hasDomainChanged === false) return true;
      if (hasDomainChanged === true) return popModalConfirm();
      else {
          hasDomainChanged.then(function(isChanged) {
              if (isChanged)
                  return popModalConfirm();
              else {
                  g_scratchpad._domainCheckPassed = true;
                  proceedWithSubmit();
              }
          }, function(error) {
              g_scratchpad._domainCheckErrorBypass = true;
              proceedWithSubmit();
          });
          return false;
      }
    }

Das folgende Beispielskript zeigt, wie ein Service Desk-Mitarbeiter überprüfen kann, in welcher Domäne er arbeitet, wenn er Datensätze in verarbeitet Mitarbeiterbereich. Die wichtigsten Aktionen dieses Skripts lauten wie folgt:

* Grundlegende Prüfungen: `Typ von g_aw !=='nicht definiert' `Stellt sicher, dass das Skript nur in ausgeführt wird Mitarbeiterbereich. `G_aw.domainScopeProvider `Überprüft, ob die Methode vorhanden ist.
* Einfache Asynchrone Verarbeitung: Verwendet `.Then() `Dient zur Verarbeitung des Ergebnisses, wenn die Domäneninformationen verfügbar sind. Verwendet `.Catch() `Zur Behandlung von Fehlern (z. B. wenn beim Abrufen der Domäne ein Fehler auftritt).
* Anwenderfreundliche Warnung: Zeigt eine Warnung mit dem Domänennamen ( `Warnung('Sie arbeiten in der Domäne: ...') `), die einfach und leicht zu verstehen ist. Wenn keine Domäneninformationen gefunden werden, wird der Anwender mit „ `Domäneninformationen sind nicht verfügbar. `„
* Fehlerbehandlung: Fehler werden mit in der Konsole protokolliert `Console.error() `Für grundlegende Problembehandlung.
{#gaw-domainScopeProvider__ul_lrm_3fv_g2c}

    (function showDomainAlert() {
        // Check if we're in Agent Workspace and the domainScopeProvider is available
        if (typeof g_aw !== 'undefined' && g_aw.domainScopeProvider) {
            // Get the current domain information
            g_aw.domainScopeProvider().then(function(domainInfo) {
                if (domainInfo && domainInfo.name) {
                    // Show an alert with the current domain name
                    alert('You are working in the domain: ' + domainInfo.name);
                } else {
                    alert('Domain information is not available.');
                }
            }).catch(function(error) {
                console.error('Error getting domain scope:', error);
            });
        }
    })();

Sie können dieses Skript als „onLoad"-Clientskript in hinzufügen Mitarbeiterbereich. Wenn ein Service Desk-Mitarbeiter einen Datensatz öffnet, wird eine Warnung mit dem aktuellen Domänennamen angezeigt.

