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


---

# Erstellen und Hinzufügen eines UI-Erweiterungspunkts

# Erstellen und Hinzufügen eines UI-Erweiterungspunkts {#ariaid-title1}

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

Erstellen Sie bei der Entwicklung einer Anwendung UI-Erweiterungspunkte, und fügen Sie sie den serverseitigen UI-Makros, z. B. HTML-Erweiterungen, oder den UI-Seiten im Basisanwendungscode hinzu.

Verwenden Sie einen UI-Erweiterungspunkt, um den spezifischen Speicherort anzugeben, an dem Daten oder Objekte an ein registriertes anwenderdefiniertes UI-Makro gesendet werden können und an dem zurückgegebene Ergebnisse verarbeitet werden.

## Erstellen Sie einen UI-Erweiterungspunkt {#ariaid-title2}

Erstellen Sie einen UI-Erweiterungspunkt, den Sie in den UI-Makros, z. B. HTML-Erweiterungen, im Anwendungscode platzieren können. Indem Sie den UI-Erweiterungspunkt platzieren, legen Sie den spezifischen Speicherort im Anwendungscode fest, an dem Daten oder Objekte an eine Anpassung gesendet werden können und an den Daten zurückgegeben werden.

### Vorbereitungen

Erforderliche Rolle: administrator oder die spezifische Rolle für den Entwickler oder Administrator der Anwendung  
Hinweis:  
Informationen zu anwendungsspezifischen Administratorrollen und der delegierten Entwicklung finden Sie unter [Zugriffssteuerungsregeln in Anwendungsverwaltungs-Apps](https://www.servicenow.com/docs/access?context=ACL-access-checks&version=yokohama&pubname=yokohama-application-development&ft:locale=en-US)Und [Delegierte Entwicklung und Bereitstellung](https://www.servicenow.com/docs/access?context=c_DelegatedDevelopment&version=yokohama&pubname=yokohama-application-development&ft:locale=en-US).

### Warum und wann dieser Vorgang ausgeführt wird

Definieren Der Inhalt und die Struktur für einen Erweiterungspunkt. Diese Definition sollte beschreiben, wie eine Anpassung strukturiert sein soll, wie sie mit dem Anwendungscode interagiert und wie die Daten verarbeitet werden, die von einer Anpassung am Erweiterungspunkt zurückgegeben werden.

Durch Erstellen einer guten Definition stellen Sie eine Struktur für die Funktionalität der Erweiterungen bereit.

### Prozedur

1. Navigieren zu AlleSystemerweiterungspunkteUI-Erweiterungspunktean.
2. Klicken Sie auf Neu.
3. Füllen Sie im Formular die Felder aus.  
   {#create-ui-ext-pt__table_tqn_cfv_s1b__entry__2}

   | Feld | Beschreibung |
   |-|-|
   | Name | Eindeutiger Name für den Erweiterungspunkt. Der Name kann bis zu 100 alphanumerische Zeichen umfassen, einschließlich Sonderzeichen. |
   | API-Name | Name der Erweiterungspunkt-API, der dem Anwendungsbereich vorangestellt ist, für den sie gilt. Dies ist ein vom System zugewiesener Name und kann nicht geändert werden. |
   | Anwendung | Anwendungsbereich, für den der Erweiterungspunkt zugewiesen ist. Dies ist vom System zugewiesen und kann nicht geändert werden. Weitere Informationen zu den Schutzmaßnahmen, die durch die Verwendung der Umfangsdefinition angeboten werden, finden Sie unter [Application scope](https://www.servicenow.com/docs/access?context=c_ApplicationScope&version=yokohama&pubname=yokohama-application-development&ft:locale=en-US). |
   | Auf diesen Umfang beschränken | Option zum Einschränken des Erweiterungspunkts auf den Anwendungsbereich. |
   | Zugriff über AJAX/REST zulassen | Option zum Aktivieren oder Deaktivieren des Zugriffs auf den UI-Erweiterungspunkt über AJAX oder REST. Weitere Informationen zu diesen Entwicklungsarchitekturen und -Techniken finden Sie unter [AJAX](https://servicenow-prod.fluidtopics.net/glsD0FgTRqYpTV_MR~KxMg#p_AJAX "AJAX (asynchrones JavaScript und XML) ist eine Gruppe von miteinander verbundenen, clientseitigen Entwicklungstechniken, die zum Erstellen asynchroner Webanwendungen verwendet werden.")Und [REST APIs](https://servicenow-prod.fluidtopics.net/ai2El07oZMsuDDSV75uftQ "REST (repräsentative Statusübertragung) ist eine einfache statuslose Architektur, die Standards zwischen Computersystemen im Web bereitstellt, wodurch sie leichter miteinander kommunizieren können."). |
   | Beschreibung | Anforderungen für den anwenderdefinierten UI-Makro, Z. B. wie das UI-Skript strukturiert sein soll und wie es mit dem Anwendungscode funktionieren soll. |
   | Beispiel | Beispiel für ein anwenderdefiniertes UI-Makro Der mit diesem Erweiterungspunkt interagiert, sollte so strukturiert sein, dass er mit dem Anwendungscode funktioniert. |
   [Tabelle : 1. Formular „UI-Erweiterungspunkt"]

   {#create-ui-ext-pt__table_tqn_cfv_s1b}
4. Klicken Sie auf Absenden.
{#create-ui-ext-pt__steps_mfs_mgn_pdb}

## Fügen Sie dem Basis-Anwendungscode einen UI-Erweiterungspunkt hinzu {#ariaid-title3}

Fügen Sie den UI-Erweiterungspunkt einem UI-Makro oder einer HTML-Erweiterung im Basis-Anwendungscode hinzu. Um den Erweiterungspunkt hinzuzufügen, tätigen Sie einen API-Aufruf, der den Standort identifiziert, an dem registrierte anwenderdefinierte Artefakte ausgeführt werden.

### Vorbereitungen

Erforderliche Rolle: administrator oder die spezifische Rolle für den Entwickler oder Administrator der Anwendung

Sie müssen zuerst einen UI-Erweiterungspunkt erstellen, bevor Sie ihn einem UI-Makro oder einer UI-Seite im Anwendungscode hinzufügen können.  
Hinweis:  
Informationen zu anwendungsspezifischen Administratorrollen und der delegierten Entwicklung finden Sie unter [Zugriffssteuerungsregeln in Anwendungsverwaltungs-Apps](https://www.servicenow.com/docs/access?context=ACL-access-checks&version=yokohama&pubname=yokohama-application-development&ft:locale=en-US)Und [Delegierte Entwicklung und Bereitstellung](https://www.servicenow.com/docs/access?context=c_DelegatedDevelopment&version=yokohama&pubname=yokohama-application-development&ft:locale=en-US).

### Prozedur

1. Greifen Sie im Anwendungscode auf das vorhandene UI-Makro zu, dem Sie einen geskripteten Erweiterungspunkt hinzufügen möchten, oder erstellen Sie einen neuen.  
   Weitere Informationen zum Erstellen von UI-Makros mit Jelly-Tags finden Sie unter [UI-Makros](https://servicenow-prod.fluidtopics.net/cdEYvL3KqvdQxs8BZ~Krxw#c_UIMacros "UI-Makros sind diskrete Skriptkomponenten, die Administratoren der Anwenderoberfläche hinzufügen können.")Und [Jelly-Tags](https://servicenow-prod.fluidtopics.net/ZhzPHbhVFSUPp4wyqX~Guw "Verwenden Sie Jelly, um XML in HTML umzuwandeln.").
2. Fügen Sie im UI-Makro ein Jelly-Tag mit einer Codezeile an der Stelle hinzu, an der Sie die anwenderdefinierte UI-Makroausgabe erfassen und verarbeiten möchten.  
   Normalerweise enthält diese Codezeile:
   * A `Call_Extension `Befehl, der den Namen des UI-Erweiterungspunkts identifiziert (z. B. `Extension="global.KMArticle.ViewHeader" `), für die die anwenderdefinierten UI-Makros registriert sind.
   * Argumente, die beim Rendern an das UI-Makro übergeben werden. Beispiel: Für Knowledge Baseartikel, `Knowledgerecord=„${knowledgeRecord}" `Besteht im aktuellen Wissensdatensatz.{#add-ui-ext-pt-base-ui-macro__li_fpg_bw2_ygb}
   {#add-ui-ext-pt-base-ui-macro__li_fpg_bw2_ygb}
   * (Optional) wenn mehrere Implementierungen dieses Erweiterungspunkts vorhanden sind, verwenden Sie einen `Grenzwert `Befehl gibt an, dass x-Anzahl von Implementierungen zurückgegeben werden soll (z. B. `Limit="1" `). Diese Abbildung zeigt ein UI-Makro, das diese Befehle enthält.

   {#add-ui-ext-pt-base-ui-macro__ul_gxz_4zv_bgb}

{#add-ui-ext-pt-base-ui-macro__steps_mfs_mgn_pdb}

