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


---

# Anwenderdefinierte UI-Makros werden für die UI-Erweiterungspunkte registriert

# Anwenderdefinierte UI-Makros werden für die UI-Erweiterungspunkte registriert {#ariaid-title1}

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

Registrieren Sie anwenderdefinierte UI-Makros für einen ausgewählten UI-Erweiterungspunkt im Anwendungscode.

Durch die Registrierung anwenderdefinierter UI-Makros erstellen Sie einen Erweiterungsinstanzdatensatz, der die UI-Erweiterungspunktdefinition mit ihrer Implementierung im anwenderdefinierten UI-Makro verknüpft.

## Registrieren Sie ein anwenderdefiniertes UI-Makro {#ariaid-title2}

Erstellen Sie ein anwenderdefiniertes UI-Makro und Code, wenn Sie es für einen ausgewählten UI-Erweiterungspunkt registrieren.

### Vorbereitungen

Erforderliche Rolle: Anwendungsspezifischer Entwickler, anwendungsspezifischer Administrator oder Administrator  
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. Navigieren zu AlleSystemerweiterungspunkteUI-Erweiterungspunktean.
2. Wählen Sie in der Tabelle „UI-Erweiterungspunkt" \[sys_ui_Extension-Point\] den Erweiterungspunkt aus, für den Sie ein anwenderdefiniertes UI-Makro registrieren möchten.  
   Hinweis:  
   Diese Liste enthält UI-Erweiterungspunkte, die Sie erstellt haben, und alle vordefinierten UI-Erweiterungspunkte, die in eingebettet sind Now PlatformFunktionen (z. B. Kundenservice-ManagementUnd Außendienst-Management).

   Weitere Informationen zu Funktionen, die vordefinierte Erweiterungspunkte enthalten, finden Sie unter zugehörige Themen in [Erweiterungspunkte verwenden, um die Anwendungsfunktionalität zu erweitern](https://servicenow-prod.fluidtopics.net/ndSXYeydZ33zccIfdcJLVA "Verwenden Sie Erweiterungspunkte, um die Funktionalität einer Anwendung zu erweitern, ohne den ursprünglichen Anwendungscode zu ändern. Sie können bereits vorhandene Erweiterungspunkte verwenden, die in ausgewählt verfügbar sind Now PlatformAnwendungen oder Sie können Erweiterungspunkte hinzufügen, wenn Sie anwenderdefinierte Anwendungen in Ihrer eigenen Instanz entwickeln.").
3. Klicken Sie im Datensatz „UI-Erweiterungspunkt" auf Erstellen Sie Eine Implementierung Zugehöriger Link zum Erstellen eines neuen anwenderdefinierten UI-Makros und zur Registrierung für den ausgewählten UI-Erweiterungspunkt.
4. Erstellen Sie im UI-Makro-Formular den anwenderdefinierten Code.  
   Weitere Informationen zum Erstellen von UI-Makros 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.").
5. Klicken Sie auf Aktualisieren.
{#register-custom-ui-macros-ui-ext-pt__steps_tkt_jtq_qfb}

### Ergebnisse

Das anwenderdefinierte UI-Makro wird erstellt und für den UI-Erweiterungspunkt registriert.

## Überprüfen Sie UI-Erweiterungsinstanzen {#ariaid-title3}

Überprüfen Sie die Liste der anwenderdefinierten UI-Makros, die für einen UI-Erweiterungspunkt registriert sind. Erweiterungsinstanzen geben den Anwendungsbereich an, in dem registrierte anwenderdefinierte UI-Makros verwendet werden, und stellen jeweils einen Link bereit. Sie können auch eine Erweiterungsinstanz aktivieren oder deaktivieren.

### 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).

### Prozedur

1. Navigieren zu AlleSystemerweiterungspunkteUI-Erweiterungspunktean.
2. Wählen Sie in der Tabelle UI-Erweiterungspunkt \[sys_ui_extension_point\] den UI-Erweiterungspunkt aus, für den Sie umfangreiche Instanzen anzeigen möchten.
3. Wählen Sie in der zugehörigen Liste „Implementierungen" des Datensatzes „UI-Erweiterungspunkt" eine UI-Erweiterungsinstanz aus.  
   Das System zeigt den Datensatz der UI-Erweiterungsinstanz an.{#review-ui-extension-instances__table_r32_ytq_qfb__entry__2}

   | Feld | Beschreibung |
   |-|-|
   | Punkt | Eindeutiger Name für den UI-Erweiterungspunkt. Der Name kann bis zu 100 alphanumerische Zeichen enthalten, einschließlich Sonderzeichen. |
   | Klasse | UI-Makro im Anwendungscode, in dem der UI-Erweiterungspunkt implementiert ist. |
   | 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). |
   | Aktiv | Aktiver Erweiterungspunkt in der aktuellen Instanz. Deaktivieren Sie das Kontrollkästchen, um einen Erweiterungspunkt zu deaktivieren. |
   [Tabelle : 1. UI-Erweiterungsinstanzdatensatz]

   {#review-ui-extension-instances__table_r32_ytq_qfb}
4. Klicken Sie auf Absenden.
{#review-ui-extension-instances__steps_q32_ytq_qfb}
**Zugehörige Konzepte**   

* [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.")
* [Erweiterungspunkte verwenden, um die Anwendungsfunktionalität zu erweitern](https://servicenow-prod.fluidtopics.net/ndSXYeydZ33zccIfdcJLVA "Verwenden Sie Erweiterungspunkte, um die Funktionalität einer Anwendung zu erweitern, ohne den ursprünglichen Anwendungscode zu ändern. Sie können bereits vorhandene Erweiterungspunkte verwenden, die in ausgewählt verfügbar sind Now PlatformAnwendungen oder Sie können Erweiterungspunkte hinzufügen, wenn Sie anwenderdefinierte Anwendungen in Ihrer eigenen Instanz entwickeln.")

