UI-Skripts

  • Freigeben Version: Zurich
  • Aktualisiert 31. Juli 2025
  • 2 Minuten Lesedauer
  • 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

    Navigieren Sie zum Erstellen von UI-Skripts zu System-UI > UI-Skripts Und erstellen oder bearbeiten Sie einen Datensatz (Feldbeschreibungen finden Sie in der Tabelle).
    Tabelle : 1. UI-Skripts
    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

    So führen Sie ein UI-Skript für ein Formular aus: Erstellen Sie einen Formatierer, und fügen Sie ihn einem Formular hinzu . In der zugeordneten UI-Makro , Enthalten Sie ein G:erforderlich Tag und geben Sie an name=Parameter als Name des UI-Skripts gefolgt von der Erweiterung .jsdbx. 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 ]]>Tag und geben Sie an src= Argument als API-Name des UI-Skripts gefolgt von der Erweiterung .jsdbx. 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 – Clientan.

    Hinweis:
    Diese Klasse unterstützt keine UI-Skripts, bei denen das Feld Global aktiviert ist.