Client-Skripts

Client-Skripts ermöglichen es dem System, JavaScript auf dem Client (Webbrowser) auszuführen, wenn clientbasierte Ereignisse auftreten, z. B. wenn ein Formular geladen wird, nach der Formularübermittlung oder wenn ein Feld den Wert ändert.

Verwenden Sie Client-Skripts, um Formulare, Formularfelder und Feldwerte zu konfigurieren, während der Anwender das Formular verwendet. Client-Skripts können:

• Felder ausgeblendet oder sichtbar machen
• Felder als schreibgeschützt oder schreibgeschützt festlegen
• Legen Sie Felder basierend auf der Rolle des Anwenders als optional oder obligatorisch fest
• Legen Sie den Wert in einem Feld basierend auf dem Wert in anderen Feldern fest
• Ändern Sie die Optionen in einer Auswahlliste basierend auf der Rolle eines Anwenders
• Zeigen Sie Nachrichten basierend auf einem Wert in einem Feld an

Warnung:

Client-Skripts sollen die Anwender-Experience in einem Formular optimieren. Client-Skripts sind nicht dazu gedacht, unerwünschten Zugriff auf Daten zu schützen.

Um unerwünschten Zugriff auf Daten zu verhindern, stellen Sie sicher, dass vertrauliche Felder über ACLs oder Datenrichtlinien ausgeblendet oder schreibgeschützt sind.

Weitere Informationen finden Sie unter Access Control List Rules oder Data policy.

Wo Client-Skripts ausgeführt werden

Mit Ausnahme von OnCellEdit() Client-Skripts und Client-Skripts gelten nur für Formulare und Suchseiten. Wenn Sie ein Clientskript erstellen, um Feldwerte in einem Formular zu steuern, müssen Sie eine dieser anderen Methoden verwenden, um Feldwerte zu steuern, wenn sie sich in einer Liste befinden.

• Erstellen Sie eine Zugriffssteuerung, um einzuschränken, wer Feldwerte bearbeiten kann.
• Erstellen Sie eine Business-Regel, um Inhalte zu validieren.
• Erstellen Sie eine Datenrichtlinie, um Inhalte zu validieren.
• Erstellen Sie einen OnCellEdit() Client-Skript zum Validieren von Inhalten.
• Deaktivieren Sie die Listenbearbeitung für die Tabelle.

Hinweis:

Client-Skripts werden auf nicht unterstützt ServiceNow MobileAnwendungen.

Client-Skriptformular

Feld	Beschreibung
Name	Name des Client-Skripts.
Tabelle	Tabelle, für die das Client-Skript gilt.
UI-Typ	Zielanwenderoberfläche, für die das Client-Skript gilt.
Typ	ONLOAD() – Wird ausgeführt, wenn das System das Formular zuerst rendert und bevor Anwender Daten eingeben können. Normalerweise ONLOAD() Client-Skripts führen clientseitige Manipulationen des aktuellen Formulars durch oder legen Standarddatensatzwerte fest. OnSubmit() – Wird ausgeführt, wenn ein Formular übermittelt wird. Normalerweise OnSubmit() Skripts validieren Elemente im Formular und stellen sicher, dass die Übermittlung sinnvoll ist. Ein OnSubmit() Das Client-Skript kann die Formularübermittlung abbrechen, indem der Wert „falsch“ zurückgegeben wird. OnChange() – Wird ausgeführt, wenn sich ein bestimmter Feldwert im Formular ändert. Die OnChange() Client-Skript muss diese Parameter angeben. control: Das DHTML-Widget, dessen Wert sich geändert hat. Hinweis: control Ist in Mobilgeräten und Serviceportal nicht zugänglich. oldValue: Der Wert, den das Widget beim Laden des Datensatzes hatte. Hinweis: Alte Werte werden für den HTML-Feldtyp nicht zurückgegeben. newValue: Der Wert, den das Widget nach der Änderung hat. isLoading: Gibt an, ob der Change als Teil eines Formularladens erfolgt. isTemplate: Gibt an, ob der Change als Teil des Ladens einer Vorlage erfolgt. OnCellEdit() – Wird ausgeführt, wenn der Listeneditor einen Zellenwert ändert. Die OnCellEdit() Client-Skript muss diese Parameter angeben. sysIDs: Ein Array der sys_IDs für alle Elemente, die bearbeitet werden. table: Die Tabelle der Elemente, die bearbeitet werden. oldValues: Die alten Werte der Zellen, die bearbeitet werden. newValue: Der neue Wert für die zu bearbeitenden Zellen. callback: Ein Rückruf, der die Ausführung anderer zugehöriger Zellenbearbeitungsskripts fortsetzt. Wenn Wahr Wird als Parameter übergeben, die anderen Skripts werden ausgeführt, oder die Änderung wird bestätigt, wenn keine weiteren Skripts vorhanden sind. Wenn Falsch Wird als Parameter übergeben, alle weiteren Skripts werden nicht ausgeführt, und die Änderung wird nicht bestätigt.
Feldname	Name des Felds, für das das Skript gilt. Nur verfügbar, wenn das Skript auf eine Änderung des Feldwerts reagiert (Skripttypen onChange oder onCellEdit).
Anwendung	Anwendung, in der sich dieses Clientskript befindet.
Aktiv	Aktiviert das Client-Skript, wenn ausgewählt. Deaktivieren Sie dieses Feld, um das Client-Skript zu deaktivieren.
Geerbt	Gibt an, ob das Client-Skript für erweiterte Tabellen gilt.
Global	Bei „wahr“ wird das Clientskript für alle Ansichten der Tabelle ausgeführt.
Ansicht	Nur sichtbar, wenn Global Ist deaktiviert. Ansichten, für die das Client-Skript ausgeführt wird.
Beschreibung	Inhalt, der die Funktionalität und den Zweck des Client-Skripts beschreibt.
Nachrichten	Textzeichenfolge (eine pro Zeile), die für das Client-Skript als lokalisierte Nachrichten mit verfügbar ist Getmessage(„[message]“) . Weitere Informationen finden Sie unter Übersetzen Sie eine Client-Skriptnachricht .
Skript	Enthält das Client-Skript.
Skript isolieren	Neue Client-Skripts werden im strikten Modus ausgeführt, wobei der direkte DOM-Zugriff deaktiviert ist. Der Zugriff auf jQuery, Prototyp und das Fensterobjekt ist ebenfalls deaktiviert. Um dies pro Skript zu deaktivieren, konfigurieren Sie dieses Formular, und wählen Sie aus Skript isolieren Kontrollkästchen. Um diese Funktion für alle neuen global umfassten clientseitigen Skripts zu deaktivieren, legen Sie die Systemeigenschaft „Glide.script.Block.Client.globals“ auf „falsch“ fest.