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


---

# UI-Skripts

# UI-Skripts {#ariaid-title1}

* Freigeben Version: Yokohama
* 
* Aktualisiert 30. Januar 2025
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 2 Minuten Lesedauer

UI-Skripts bieten eine Möglichkeit, clientseitiges JavaScript in ein wiederverwendbares Formular zu packen, ähnlich wie das Skript das serverseitige JavaScript des Stores enthält. Administratoren können UI-Skripts erstellen und aus Client-Skripts und anderen clientseitigen Skriptobjekten sowie aus HTML-Code ausführen.

UI-Skripts werden für Mobilgeräte nicht unterstützt.

## Globale UI-Skripts {#ariaid-title2}

Sie können ein UI-Skript erstellen und als global festlegen, wodurch das Skript in jedem Formular im System verfügbar gemacht wird. Sie können kein globales UI-Skript in einer bereichsbezogenen Anwendung erstellen.

Sie können ein UI-Skript als global markieren, um es in jedem Formular im System verfügbar zu machen. Sie können beispielsweise ein UI-Skript mit einer Funktion erstellen HelloWorld() , Und hat Global Feld aktiviert:  

    function helloWorld() {
      alert('Hi');
    }

Nachdem Sie dieses globale UI-Skript erstellt haben, können Sie aufrufen HelloWorld() Funktion aus einem beliebigen Client-Skript oder UI-Richtlinie, die Sie schreiben.

## Erstellen Sie ein UI-Skript {#ariaid-title3}

Erstellen Sie ein UI-Skript, um wiederverwendbaren clientseitigen JavaScript-Code zu definieren.

### Prozedur

Navigieren Sie zum Erstellen von UI-Skripts 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 auf Ihrem System eindeutig ist. |
| API-Name | Der API-Name des UI-Skripts, einschließlich Umfang und Skriptname (z. B. x_custom_App.HelloWorld). |
| Anwendung | Anwendung, die das UI-Skript enthält. |
| Aktiv | Indikator, der angibt, ob das UI-Skript aktiv ist. Nur aktive UI-Skripts können ausgeführt werden. |
| Global | Indikator, der angibt, ob das Skript auf jeder Seite im System geladen wird. Hinweis: Seien Sie beim Erstellen globaler UI-Skripts vorsichtig, da sie sich auf die Leistung auswirken können. Sie können kein globales UI-Skript in einer bereichsbezogenen Anwendung erstellen. |
| Beschreibung | Zusammenfassung des Zwecks des Skripts. |
| Skript | Clientseitiges Skript, das ausgeführt werden soll, wenn es von anderen Skripts aufgerufen wird. |
[Tabelle : 1. UI-Skripts]

{#t_CreateAUIScript__table_zsc_z4z_sr}

## Führen Sie UI-Skripts aus {#ariaid-title4}

Befolgen Sie diese Richtlinien, wenn Sie UI-Skripts ausführen.

### Führen Sie ein UI-Skript aus einem Formular aus

So führen Sie ein UI-Skript für ein Formular aus: [Erstellen Sie einen Formatierer, und fügen Sie ihn einem Formular hinzu](https://www.servicenow.com/docs/access?context=t_CreateAFormatter&version=yokohama&pubname=yokohama-platform-administration&ft:locale=en-US). In der zugeordneten [UI-Makro](https://servicenow-prod.fluidtopics.net/cdEYvL3KqvdQxs8BZ~Krxw#c_UIMacros "UI-Makros sind diskrete Skriptkomponenten, die Administratoren der Anwenderoberfläche hinzufügen können."), Einbeziehen Sie ein `G:erfordert `Tag und geben Sie an name=Parameter als Name des UI-Skripts gefolgt von der Erweiterung .jsdbx. Fügen Sie der Formularansicht den Formatierer 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>

### Rufen Sie ein UI-Skript in HTML auf {#r_RunUIScripts__section_o5w_npl_d2b}

Verwenden Sie zum Ausführen eines UI-Skripts aus HTML-Code `]]>`Tag und geben Sie an `src= `Argument als API-Name des UI-Skripts gefolgt von der Erweiterung .jsdbx. Fügen Sie beispielsweise das UI-Skript mit dem Namen ein Kühltakt Mit diesem Code:  

    <script language="javascript" src="CoolClock.jsdbx" />

### Rufen Sie ein UI-Skript über den clientseitigen Code auf {#r_RunUIScripts__section_bs1_rpl_d2b}

Greifen Sie über den clientseitigen Code mit auf UI-Skripts zu G_ui_scripts Globales Objekt. Weitere Informationen finden Sie unter [GlideUISSkripts -- Client](https://servicenow-prod.fluidtopics.net/bFLxU77Bx2dqOV550pNZAg#GUIScriptsAPI "Die GlideUISSkripts Die API bietet Methoden für den Zugriff auf UI-Skripts innerhalb des clientseitigen Codes.")an.  
Hinweis:  
Diese Klasse unterstützt keine UI-Skripts mit Global Feld auf „wahr" festgelegt.

