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

 Release :

    - xanadu

ft:locale :

    - de-DE

ft:publication_title :

    - Xanadu-API-Referenz

ft:clusterId :

    - crapiref

bundleId :

    - crapiref

workflow :

    - Creator


---

# UI-Skripts

# UI-Skripts {#ariaid-title1}

* Freigeben Version: Xanadu
* 
* Aktualisiert 1. August 2024
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 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 {#ariaid-title2}

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 {#ariaid-title3}

Mit UI-Skripts können Sie wiederverwendbaren clientseitigen JavaScript-Code definieren.

### Prozedur

Um UI-Skripts zu erstellen, navigieren Sie zu System-UIUI-Skripts und erstellen oder bearbeiten Sie einen Datensatz (Feldbeschreibungen finden Sie in der Tabelle).  
{#t_CreateAUIScript__table_zsc_z4z_sr__entry__2}

| 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 |
[Tabelle : 1. UI-Skripts]

{#t_CreateAUIScript__table_zsc_z4z_sr}

## UI-Skripts ausführen {#ariaid-title4}

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](https://www.servicenow.com/docs/access?context=t_CreateAFormatter&version=xanadu&pubname=xanadu-platform-administration&ft:locale=en-US). Fügen Sie im zugehörigen [UI-Makro](https://servicenow-prod.fluidtopics.net/NrXZOoqj922gpSmU24sA0Q#c_UIMacros "UI-Makros sind diskrete Skriptkomponenten, die Administratoren der Anwenderoberfläche hinzufügen können.")ein `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 {#r_RunUIScripts__section_o5w_npl_d2b}

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 {#r_RunUIScripts__section_bs1_rpl_d2b}

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](https://servicenow-prod.fluidtopics.net/cJBr~~Sd6rynHSLwNNW_Pg#GUIScriptsAPI "Die GlideUIScripts- API bietet Methoden für den Zugriff auf UI-Skripts aus clientseitigem Code.").  
Hinweis:  
Diese Klasse unterstützt keine UI-Skripts, bei denen das Feld Global aktiviert ist.