UI-Skripts
UI-Skripts ermöglichen es Ihnen, clientseitigen JavaScript-Code in wiederverwendbare Formulare zu integrieren. Dies funktioniert ähnlich wie bei Skripteinbindungen, die serverseitigen JavaScript-Code speichern. Administratoren können UI-Skripts erstellen und über Client-Skripts, andere clientseitige Skriptobjekte oder HTML-Code ausführen.
UI-Skripts werden auf der Mobilplattform nicht unterstützt.
Globale UI-Skripts
Wenn Sie ein UI-Skript erstellen und als global kennzeichnen, ist das Skript in jedem Formular im System verfügbar. In Anwendungen mit Bereich können keine globalen UI-Skripts erstellt werden.
Sie können UI-Skripts als „Global“ kennzeichnen, um sie in jedem Formular im System verfügbar zu machen. Beispielsweise können Sie ein UI-Skript mit der Funktion helloWorld() erstellen und dessen Feld Global aktivieren:
function helloWorld() {
alert('Hi');
}Nachdem Sie dieses globale UI-Skript erstellt haben, können Sie die Funktion helloWorld() aus jedem Client-Skript und jeder UI-Richtlinie aufrufen, die Sie schreiben.
UI-Skripts erstellen
Mit UI-Skripts können Sie wiederverwendbaren clientseitigen JavaScript-Code definieren.
Prozedur
| Feld | Beschreibung |
|---|---|
| Skriptname | Name des UI-Skripts. Stellen Sie sicher, dass der Name im System eindeutig ist. |
| API-Name | API-Name des UI-Skripts, einschließlich des Bereichs und des Skriptnamens (z. B. „x_custom_app.HelloWorld“) |
| Anwendung | Anwendung, die das UI-Skript enthält |
| Aktiv | Gibt an, ob das UI-Skript aktiv ist. Nur aktive UI-Skripts können ausgeführt werden. |
| Global | Gibt an, ob das Skript auf jeder Seite im System geladen wird. Hinweis: Erstellen Sie globale UI-Skripts mit Bedacht. Sie können sich negativ auf die Leistung auswirken. In Anwendungen mit Bereich können keine globalen UI-Skripts erstellt werden. |
| Beschreibung | Zusammenfassung des Zwecks des Skripts |
| Skript | Clientseitiges Skript, das ausgeführt wird, sobald es von anderen Skripts aufgerufen wird |
UI-Skripts ausführen
Beachten Sie die folgenden Richtlinien, wenn Sie UI-Skripts ausführen.
UI-Skripts über Formulare ausführen
Um ein UI-Skript in einem Formular auszuführen, erstellen Sie einen Formatierer, und fügen Sie ihn einem Formular hinzu. Fügen Sie im zugehörigen UI-Makroein g:requires -Tag ein, und geben Sie den Parameter name= als Namen des UI-Skripts gefolgt von der Erweiterung „.jsdbx“ an. Fügen Sie dann den Formatierer der Formularansicht hinzu.
Dieser Code stellt sicher, dass die Definitionen und Ergebnisse des UI-Skripts sofort im Browser verfügbar sind.
<?xml version="1.0" encoding="utf-8" ?>
<j:jelly trim="false" xmlns:j="jelly:core" xmlns:g="glide" xmlns:j2="null" xmlns:g2="null">
<g2:evaluate var="jvar_stamp">
var now_GR = new GlideRecord('sys_ui_script');
gr.orderByDesc('sys_updated_on');
gr.query();
gr.next();
gr.getValue('sys_updated_on');
</g2:evaluate>
<g:requires name="<UI SCRIPT NAME>.jsdbx" params="cache=$[jvar_stamp]" />
</j:jelly>UI-Skripts über HTML aufrufen
Um ein UI-Skript aus HTML-Code auszuführen, verwenden Sie <![CDATA[<script> ]]> Tag, und geben Sie das Argument src= als API-Namen des UI-Skripts gefolgt von der Erweiterung „.jsdbx“ an. Mit folgendem Code können Sie beispielsweise das UI-Skript CoolClock einfügen:
<script language="javascript" src="CoolClock.jsdbx" />UI-Skripts über clientseitigen Code aufrufen
Wenn Sie über clientseitigen Code auf UI-Skripts zugreifen möchten, verwenden Sie das globale Objekt g_ui_scripts. Weitere Informationen finden Sie unter GlideUIScripts -Client.