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


---

# Clientseitiges Skripting -- Design und Verarbeitung

# Clientseitiges Skripting -- Design und Verarbeitung {#ariaid-title1}

* Freigeben Version: Yokohama
* 
* Aktualisiert 25. Juni 2026
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 11 Minuten Lesedauer

Gut konzipierte Client-Skripts können die Zeit reduzieren, die Anwender zum Ausfüllen eines Formulars benötigen.

Die ordnungsgemäße clientseitige Verarbeitung hängt davon ab, ob das Formular zuerst geladen wird. Das Vornehmen von Datensatzaktualisierungen vor dem Laden des Formulars kann zu unerwarteten Ergebnissen führen, die die clientseitige Verarbeitung umgehen.  
Wenn Sie Client-Skripts erstellen, um Feldwerte in einem Formular zu steuern, müssen Sie eine andere Methode verwenden, um diese Feldwerte in einer Liste zu steuern. Sie können:

* Deaktivieren Sie die Listenbearbeitung für die Tabelle.
* Erstellen Sie geeignete Business-Regeln oder Zugriffssteuerungen für die Listenbearbeitung.
* Erstellen Sie Datenrichtlinien.
* Erstellen Sie ein separates onCellEdit-Client-Skript.
{#client-script-best-practices__ul_sph_x1r_n4}

## Listenbearbeitung einschränken {#ariaid-title2}

Wenn Sie UI-Richtlinien oder Client-Skripts für Felder in einem Formular erstellen, müssen Sie eine andere Methode verwenden, um sicherzustellen, dass Daten in diesen Feldern in einer Liste ähnlich gesteuert werden.  
Mit Ausnahme von onCellEdit-Client-Skripts gelten UI-Richtlinien und Client-Skripts nur für Formulare. Verwenden Sie die folgenden Methoden, um die Listenbearbeitung bei Verwendung von Client-Skripts einzuschränken:

* Deaktivieren Sie die Listenbearbeitung für die Tabelle.
* Erstellen Sie geeignete Business-Regeln oder Zugriffssteuerungen für die Listenbearbeitung.
* Erstellen Sie Datenrichtlinien.
* Erstellen Sie ein separates onCellEdit-Client-Skript.
{#c_RestrictListEditing__ul_rrf_wjc_sv}

## Serversuchen minimieren {#ariaid-title3}

Verwenden Sie Client-Daten so weit wie möglich, um zeitaufwändige Serversuchen zu vermeiden.

Client-Skripting verwendet entweder Daten, die auf dem Client verfügbar sind, oder Daten, die vom Server abgerufen werden. Die wichtigsten Möglichkeiten, Informationen vom Server abzurufen, sind „g_Scratchpad" und die asynchrone GlideAjax-Suche.

Der primäre Unterschied zwischen diesen Methoden besteht darin, dass g_Scratchpad einmal gesendet wird, wenn ein Formular geladen wird (Informationen werden vom Server an den Client übertragen), während GlideAjax dynamisch ausgelöst wird, wenn der Client Informationen vom Server anfordert.  
Hinweis:  
GlideRecord und g_Form.getReference() sind auch zum Abrufen von Serverinformationen verfügbar. Diese Methoden werden jedoch aufgrund ihrer Leistungsauswirkungen nicht mehr empfohlen. Beide Methoden rufen alle Felder im angeforderten GlideRecord ab, wenn die meisten Fälle nur ein Feld erfordern.  

### Ruft Serverdaten mit g_Scratchpad ab

Das Objekt „g_Scratchpad" übergibt Informationen vom Server an den Client, z. B. wenn der Client Informationen benötigt, die im Formular nicht verfügbar sind.

Wenn Sie beispielsweise ein Client-Skript haben, das auf das Feld u_Retrieve zugreifen muss und sich das Feld nicht im Formular befindet, sind die Daten für das Client-Skript nicht verfügbar. Eine typische Lösung für diese Situation besteht darin, das Feld im Formular zu platzieren und es dann immer mit einem Client-Skript oder einer UI-Richtlinie auszublenden. Diese Lösung kann zwar schneller konfiguriert werden, die Ausführung ist jedoch langsamer.

Wenn Sie wissen, welche Informationen der Client vom Server benötigt, bevor das Formular geladen wird, kann eine Anzeige-Business-Regel g_Scratchpad-Eigenschaften erstellen, die diese Informationen enthalten. Theg_Scratchpad wird an den Client gesendet, wenn das Formular angefordert wird, sodass es für alle clientseitigen Skripting-Methoden verfügbar ist. Dies ist eine sehr effiziente Möglichkeit, Informationen vom Server an den Client zu senden. Sie können Daten jedoch nur auf diese Weise laden, wenn das Formular geladen wird. Die Business-Regel kann nicht dynamisch ausgelöst werden. Verwenden Sie in diesen Fällen einen asynchronen GlideAjax-Aufruf.  
Angenommen, Sie öffnen einen Incident und müssen diese Informationen an den Client übergeben:

* Der Wert der Systemeigenschaft „css.Base.color"
* Gibt an, ob der aktuelle Datensatz Anhänge enthält
* Der Name des Managers des Anrufers
{#c_MinimizeServerLookups__ul_rdr_lkc_sv}  
Eine Anzeige-Business-Regel sendet diese Informationen mithilfe des folgenden Skripts an den Client:

    g_scratchpad.css = gs.getProperty('css.base.color');
    g_scratchpad.hasAttachments = current.hasAttachments();
    g_scratchpad.managerName = current.caller_id.manager.getDisplayValue();

So greifen Sie mit einem Clientskript auf Scratchpad-Daten zu:

    // Check if the form has attachments
    if (g_scratchpad.hasAttachments)
        // do something interesting here
    else
        alert('You need to attach a form signed by ' + g_scratchpad.managerName);

### Rufen Sie Serverdaten mit asynchronem GlideAjax ab

Mit dem asynchronen GlideAjax können Sie dynamisch Informationen vom Server anfordern.  
Dieses Skript vergleicht die Supportgruppe des CI und die Zuweisungsgruppe des Incidents anhand des Namens:

    //Alert if the assignment groups name matches the support group
    function onChange(control, oldValue, newValue, isLoading) {
     
        if (isLoading)
            return;
     
        var ga = new GlideAjax('ciCheck');
     
        ga.addParam('sysparm_name', 'getCiSupportGroup');
        ga.addParam('sysparm_ci', g_form.getValue('cmdb_ci'));
        ga.addParam('sysparm_ag', g_form.getValue('assignment_group'));
        ga.getXML(doAlert); // Always try to use asynchronous (getXML) calls rather than synchronous (getXMLWait)
    }
     
    // Callback function to process the response returned from the server
    function doAlert(response) {
     
        var answer = response.responseXML.documentElement.getAttribute("answer");
     
        alert(answer);
    }

Dieses Skript basiert auf der zugehörigen Skripteinbindung:

    var ciCheck = Class.create();
     
    ciCheck.prototype = Object.extendsObject(AbstractAjaxProcessor, {
     
        getCiSupportGroup: function() {
     
            var retVal = ''; // Return value
            var ciID   = this.getParameter('sysparm_ci');
            var agID   = this.getParameter('sysparm_ag');		
            var ciRec  = new GlideRecord('cmdb_ci');
     
            // If we can read the record, check if the sys_ids match
            if (ciRec.get(ciID)) {
                if (ciRec.getValue('support_group') == agID)
                    retVal = 'CI support group and assignment group match';
                else
                    retVal = 'CI support group and assignment group do not match';
     
                // Can't read the CI, then they don't match
            } else {
                retVal = 'CI support group and assignment group do not match';
            }
     
            return retVal;
        }
     
    });

## Verwenden Sie den Parameter setValue() DisplayValue für Referenzfelder {#ariaid-title4}

Wenn setValue() für ein Referenzfeld verwendet wird, fügen Sie den Parameter DisplayValue hinzu, um zusätzliche Serveraufrufe zu vermeiden.

Bei Verwendung SetWert() Achten Sie in einem Referenzfeld darauf, den Anzeigewert des Referenzfelds als dritten Parameter einzubeziehen. Wenn Sie den Wert ohne DisplayValue festlegen, führt die Instanz einen synchronen Aufruf durch, um den Anzeigewert für den von Ihnen angegebenen Datensatz abzurufen. Dieser zusätzliche Roundtrip zum Server kann sich auf die Leistung auswirken.  
Dieses Beispiel demonstriert die falsche Art, „setValue" aufzurufen:

    var id = '5137153cc611227c000bbd1bd8cd2005';
     
    g_form.setValue('assigned_to', id); // Client needs to go back to the server to
                                        // fetch the name that goes with this ID

Fügen Sie stattdessen den Anzeigewert als optionalen Parameter in ein SetWert() :

    var id = '5137153cc611227c000bbd1bd8cd2005';
    var name = 'Fred Luddy';
     
    g_form.setValue('assigned_to', id, name); // No server call required

## Verwenden Sie UI-Richtlinie anstelle eines Client-Skripts {#ariaid-title5}

Wenn möglich, sollten Sie eine UI-Richtlinie anstelle eines Client-Skripts verwenden.  
UI-Richtlinien bieten diese Vorteile gegenüber Client-Skripts:

* UI-Richtlinien haben einen Reihenfolge Feld, um die vollständige Kontrolle über die Reihenfolge zu ermöglichen, in der clientseitige Vorgänge stattfinden.
* UI-Richtlinien erfordern kein Skripting, um ein Feld obligatorisch, schreibgeschützt oder sichtbar zu machen.

{#c_UseUIPolicy__ul_vd4_2nc_sv}  
Hinweis:  
UI-Richtlinien gelten nach Client-Skripts.

## Validieren der Eingabe mithilfe eines Client-Skripts {#ariaid-title6}

Eine ausgezeichnete Verwendung für ein Client-Skript besteht darin, die Eingabe des Anwenders zu validieren.

Diese Validierung verbessert die Anwender-Experience, da der Anwender vor dem Senden der Informationen herausfindet, ob Datenprobleme vorliegen.  
Ein Beispiel für die Validierung besteht darin, zu überprüfen, ob Auswirkung Feldwert ist gültig mit Priorität Feldwert. In diesem Beispiel ist „geringe Auswirkung" mit hoher Priorität nicht zulässig.

    if (g_form.getValue('impact') == '3' && g_form.getValue('priority') == '1')
       g_form.showFieldMsg('impact', getMessage('Low impact now allowed with High priority'), 'error');

## Legen Sie die Reihenfolge des Client-Skripts fest {#ariaid-title7}

Steuern Sie die Ausführungsreihenfolge für Ihre Client-Skripts mithilfe des Felds „Reihenfolge". Um zu vermeiden, dass zwei oder mehr Client-Skripts gleichzeitig ausgeführt werden und dann in Konflikt stehen, können Sie eine Reihenfolge hinzufügen, in der die Skripts ausgeführt werden sollen.

### Vorbereitungen

Erforderliche Rolle: Administrator

### Warum und wann dieser Vorgang ausgeführt wird

Durch das Hinzufügen einer Reihenfolge zum Client-Skript wird eine Verarbeitungssequenz erstellt, die von der niedrigsten zur höchsten Zahl sortiert ist. Wenn zwei Skripts in Konflikt stehen, wird zuerst das Client-Skript mit der niedrigeren Zahl ausgeführt.

### Prozedur

1. Navigieren zu AlleSystemdefinitionClient-Skript Und öffnen Sie ein vorhandenes Client-Skript, oder klicken Sie auf Neu .
2. [Konfigurieren des Formularlayouts](https://www.servicenow.com/docs/access?context=configure-form-layout&version=yokohama&pubname=yokohama-platform-administration&ft:locale=en-US)Um einzubeziehen Reihenfolge Feld.
3. Fügen Sie dem Feld „Reihenfolge" eine Zahl hinzu, die darauf basiert, in welcher Reihenfolge es in Bezug auf andere Client-Skripts ausgeführt werden soll.  
   Wählen Sie eine niedrigere Zahl für das Skript aus, das Sie zuerst ausführen möchten.
{#set-client-script-order__steps_kzb_xrw_l1b}

## Vermeiden Sie DOM-Manipulationen {#ariaid-title8}

Manipulation des Dokumentobjektmodells (DOM) nach Möglichkeit vermeiden. Dies kann zu einem Wartbarkeitsproblem führen, wenn Browser aktualisiert werden.
Verwenden Sie stattdessen die GlideForm-API, oder ziehen Sie einen anderen Ansatz für die Lösung in Betracht. Im Allgemeinen müssen Sie bei Verwendung von DOM-Manipulationsmethoden auf ein Element im DOM anhand der ID oder mithilfe einer CSS-Auswahl verweisen. Beim Verweis auf sofort einsatzbereite DOM-Elemente besteht das Risiko, dass sich die Element-ID oder die Platzierung im DOM ändern kann, was dazu führt, dass der Code nicht mehr funktioniert und/oder Fehler generiert. Verwenden Sie Voraussicht, Vorsicht, und haben Sie ein vollständiges Verständnis des Risikos, dem Sie ausgesetzt sind. Überprüfen Sie diese Objekte, und reduzieren Sie die Verwendung von DOM-Manipulationsmethoden so weit wie möglich.

## Vermeiden Sie globale Client-Skripts {#ariaid-title9}

Ein globales Clientskript ist ein beliebiges Clientskript, bei dem die ausgewählte Tabelle global ist. Globale Client-Skripts haben keine Tabellenbeschränkungen. Daher werden sie auf jeder Seite im System geladen, wodurch der Prozess mit einer Verzögerung beim Laden des Browsers einhergeht.
Das Laden dieser Art von Skripts auf jeder Seite hat keinen Vorteil.

Als Alternative und für einen modulareren und skalierbaren Ansatz sollten Sie Client-Skripts in eine Basistabelle verschieben (z. B. Aufgabe\[Aufgabe\] oder Konfigurationselement\[cmdb_ci\]), die für alle untergeordneten/erweiterten Tabellen abgeleitet werden kann. Dadurch wird verhindert, dass das System die Skripts auf jedem Formular in der Anwenderoberfläche lädt, z. B. Homepages oder Servicekatalog, wo sie selten (falls überhaupt) benötigt werden.

## Schließen Sie Code in Funktionen ein {#ariaid-title10}

Schließen Sie den Code in ein Client-Skript in einer Funktion ein.
Client-Skripts ohne Funktion verursachen Probleme mit dem Variablenbereich. Wenn Code nicht in einer Funktion eingeschlossen ist, sind Variablen und andere Objekte verfügbar und für alle anderen clientseitigen Skripts freigegeben. Wenn Sie dieselben Variablennamen verwenden, können sie kollidieren. Dies kann zu unerwarteten Konsequenzen führen, die schwer zu beheben sind.  
Betrachten Sie dieses Beispiel:

    var state = "6";
     
    function onSubmit() {
     
       if(g_form.getValue('incident_state') == state) {
       		alert("This incident is Resolved");
       }
    }

Weil <var class="keyword varname">status </var>Variable ist nicht in einer Funktion eingeschlossen, alle clientseitigen Skripts haben Zugriff darauf. Andere Skripts können auch den allgemeinen Variablennamen verwenden <var class="keyword varname">status </var>. Die doppelten Namen können Konflikte verursachen und zu unerwarteten Ergebnissen führen. Diese Probleme sind schwierig zu isolieren und zu beheben. Um dieses Problem zu vermeiden, stellen Sie sicher, dass der gesamte Code in eine Funktion eingeschlossen ist:

    function onSubmit() {
     
       var state = "6";
     
       if(g_form.getValue('incident_state') == state) {
       		alert("This incident is Resolved");
       }
    }

Diese Lösung ist aufgrund des Umfangs der Variable viel sicherer <var class="keyword varname">status </var>Ist auf die Funktion onSubmit() beschränkt. Daher wird <var class="keyword varname">status </var>Variable steht nicht in Konflikt mit <var class="keyword varname">status </var>Variablen in anderen clientseitigen Skripts.

## Führen Sie nur erforderliche Skripts aus {#ariaid-title11}

Um zu vermeiden, dass zeitaufwändige Skripts unnötig ausgeführt werden, stellen Sie sicher, dass Client-Skripts nur die erforderlichen Aufgaben ausführen.

Die folgenden Beispiele demonstrieren Verbesserungen am ersten Codebeispiel. Jedes Beispiel demonstriert eine bestimmte Erweiterung des Skripts, um die Leistung zu verbessern und unnötige Aufrufe zu vermeiden.  
Denken Sie daran, dass Client-Skripts keine haben Bedingung Feld. Dies bedeutet, dass onLoad() und onChange()-Skripts bei jedem Laden des entsprechenden Formulars vollständig ausgeführt werden. Dieses Beispiel ist ein ineffizienter onChange()-Client-Skriptsatz, der ausgeführt werden soll, wenn Konfigurationselement Feldänderungen.

    //Set Assignment Group to CI's support group if assignment group is empty
    function onChange(control, oldValue, newValue, isLoading) {
     
        var ciSupportGroup = g_form.getReference('cmdb_ci').support_group;
     
        if (ciSupportGroup != '' && g_form.getValue('assignment_group) != '')
            g_form.setValue('assignment_group', ciRec.support_group.sys_id);
    }

Dieses Beispiel verbessert sich gegenüber dem ersten, indem die Suche „getReference()" oder „GlideRecord" durch einen asynchronen GlideAjax-Aufruf ersetzt wird.

    //Set Assignment Group to support group if assignment group is empty
    function onChange(control, oldValue, newValue, isLoading) {
     
        var ga = new GlideAjax('ciCheck');
     
        ga.addParam('sysparm_name', 'getSupportGroup');
        ga.addParam('sysparm_ci', g_form.getValue('cmdb_ci'));
        ga.getXML(setAssignmentGroup);
    }
     
    function setAssignmentGroup(response) {
     
        var answer = response.responseXML.documentElement.getAttribute("answer");
     
        g_form.setValue('assignment_group', answer);
    }

Die isLoadingDie Kennzeichnung ist die einfachste Möglichkeit, zu verhindern, dass unnötiger Code in onChange-Skripts Browserzeit beansprucht. Die isLoadingDie Kennzeichnung sollte am Anfang eines Skripts verwendet werden, das beim Laden des Formulars nicht ausgeführt werden muss. Dieses Skript muss nicht beim Laden eines Formulars ausgeführt werden, da die Logik bereits ausgeführt wurde, als das Feld zuletzt geändert wurde. Hinzufügen von isLoadingDurch Überprüfen des Skripts wird verhindert, dass bei jedem Laden des Formulars eine cmdb_ci-Suche durchgeführt wird.

Die isTemplateKennzeichnung gibt an, dass eine Vorlage geladen wird.

    //Set Assignment Group to CI's support group if assignment group is empty
    function onChange(control, oldValue, newValue, isLoading, isTemplate) {
     
        if (isLoading)
            return;
     
        var ga = new GlideAjax('ciCheck');
     
        ga.addParam('sysparm_name', 'getSupportGroup');
        ga.addParam('sysparm_ci', g_form.getValue('cmdb_ci'));
        ga.getXML(setAssignmentGroup);
    }
     
    function setAssignmentGroup(response) {
     
        var answer = response.responseXML.documentElement.getAttribute("answer");
     
        g_form.setValue('assignment_group', answer);
    }

Wenn das onChange-Skript während des Ladevorgangs ausgeführt werden soll, verwenden Sie die folgende Konvention:

    function onChange(control, oldValue, newValue, isLoading, isTemplate) {
     
        if (isLoading) {}; // run during loading
     
        // rest of script here
     
    }

Die Prüfung newValue weist dieses Skript an, nur fortzusetzen, wenn im entsprechenden Feld ein gültiger Wert vorhanden ist. Dadurch wird verhindert, dass das Skript ausgeführt wird, wenn der Feldwert entfernt oder entfernt wird. Dadurch wird auch sichergestellt, dass immer ein gültiger Wert verfügbar ist, wenn der Rest des Skripts ausgeführt wird.

    //Set Assignment Group to CI's support group if assignment group is empty
    function onChange(control, oldValue, newValue, isLoading, isTemplate) {
     
        if (isLoading)
            return;
     
        if (newValue) {
            var ga = new GlideAjax('ciCheck');
     
            ga.addParam('sysparm_name', 'getSupportGroup');
            ga.addParam('sysparm_ci', g_form.getValue('cmdb_ci'));
            ga.getXML(setAssignmentGroup);
        }
    }
     
    function setAssignmentGroup(response) {
     
       var answer = response.responseXML.documentElement.getAttribute("answer");
     
       g_form.setValue('assignment_group', answer);
    }

Damit das Skript auf einen Wert reagiert, der sich nach dem Laden des Formulars ändert, verwenden Sie die Prüfung newValue != oldValue.  
Hinweis:  
In diesem Beispiel werden Anwender nicht erfasst, einen Wert zu ändern und ihn dann wieder auf den ursprünglichen Wert zurückzusetzen.

    //Set Assignment Group to CI's support group if assignment group is empty
    function onChange(control, oldValue, newValue, isLoading, isTemplate) {
     
        if (isLoading)
            return;
     
        if (newValue) {
            if (newValue != oldValue) {
                var ga = new GlideAjax('ciCheck');
     
                ga.addParam('sysparm_name', 'getSupportGroup');
                ga.addParam('sysparm_ci', g_form.getValue('cmdb_ci'));
                ga.getXML(setAssignmentGroup);
            }
        }
    }
     
    function setAssignmentGroup(response) {
     
       var answer = response.responseXML.documentElement.getAttribute("answer");
     
       g_form.setValue('assignment_group', answer);
    }

In diesem Beispiel wird der GlideAjax-Aufruf eine Ebene tiefer vergraben, indem das Skript neu angeordnet wird, um so viele Dinge wie möglich für den Client verfügbar zu überprüfen, bevor die Serveraufrufe ausgeführt werden. Das Skript überprüft die Zuweisung, bevor der GlideAjax-Aufruf ausgeführt wird. Dadurch wird die Serversuche verhindert, wenn Zuweisungsgruppe Feld ist bereits festgelegt.

    //Set Assignment Group to CI's support group if assignment group is empty
    function onChange(control, oldValue, newValue, isLoading, isTemplate) {
     
        if (isLoading)
           return;
     
        if (newValue) {
            if (newValue != oldValue) {
                if (g_form.getValue('assignment_group') == '') {
                    var ga = new GlideAjax('ciCheck');
     
                    ga.addParam('sysparm_name', 'getSupportGroup');
                    ga.addParam('sysparm_ci', g_form.getValue('cmdb_ci'));
                    ga.getXML(setAssignmentGroup);
                }
            }
        }
    }
     
    function setAssignmentGroup(response) {
     
       var answer = response.responseXML.documentElement.getAttribute("answer");
     
       g_form.setValue('assignment_group', answer);
    }


