--- 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 --- # Benutzerdefinierte UI-Makros für die UI-Erweiterungspunkte registrieren # Benutzerdefinierte UI-Makros für die UI-Erweiterungspunkte registrieren {#ariaid-title1} * Freigeben Version: Xanadu * * Aktualisiert 1. August 2024 * * ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 2 Minuten Lesedauer Registrieren Sie benutzerdefinierte UI-Makros für einen ausgewählten UI-Erweiterungspunkt im Anwendungscode. Durch das Registrieren von benutzerdefinierten UI-Makros erstellen Sie einen Erweiterungsinstanzdatensatz, der die UI-Erweiterungspunktdefinition mit ihrer Implementierung im benutzerdefinierten 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: application-specific developer, application-specific admin oder admin Hinweis: Weitere Informationen zu anwendungsspezifischen Administratorrollen und delegierter Entwicklung finden Sie unter [Zugriffssteuerungsregeln in Apps zur Anwendungsverwaltung](https://www.servicenow.com/docs/access?context=ACL-access-checks&version=xanadu&pubname=xanadu-application-development&ft:locale=en-US) und [Delegierte Entwicklung und Bereitstellung](https://www.servicenow.com/docs/access?context=c_DelegatedDevelopment&version=xanadu&pubname=xanadu-application-development&ft:locale=en-US). ### Prozedur 1. Navigieren zu AlleSystemerweiterungspunkteUI-Erweiterungspunkte. 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 von Ihnen erstellte UI-Erweiterungspunkte und alle vordefinierten UI-Erweiterungspunkte, die in Now Platform -Funktionen eingebettet sind (z. B. Kundenservice-Management und Außendienst-Management). Weitere Informationen zu Funktionen, die vordefinierte Erweiterungspunkte enthalten, finden Sie unter den Links zu zugehörigen Themen in [Erweiterungspunkte verwenden, um die Anwendungsfunktionalität zu erweitern](https://servicenow-prod.fluidtopics.net/C8oDBWontT9macwvClUiUQ "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ählten Now Platform-Anwendungen verfügbar sind, oder Sie können Erweiterungspunkte hinzufügen, wenn Sie benutzerdefinierte Anwendungen in Ihrer eigenen Instanz entwickeln."). 3. Klicken Sie im UI-Erweiterungspunkt-Datensatz auf den zugehörigen Link Implementierung erstellen, um ein neues anwenderdefiniertes UI-Makro zu erstellen und es für den ausgewählten UI-Erweiterungspunkt zu registrieren. 4. Erstellen Sie im UI-Makro-Formular den benutzerdefinierten Code. Weitere Informationen zum Erstellen von UI-Makros finden Sie unter [UI-Makros](https://servicenow-prod.fluidtopics.net/NrXZOoqj922gpSmU24sA0Q#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 benutzerdefinierte UI-Makro wird erstellt und für den UI-Erweiterungspunkt registriert. ## UI-Erweiterungsinstanzen überprüfen {#ariaid-title3} Überprüfen Sie die Auflistung der benutzerdefinierten 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 die Erweiterungsinstanz aktivieren oder deaktivieren. ### Vorbereitungen Erforderliche Rolle: admin oder die spezifische Rolle für den Entwickler oder Administrator der Anwendung Hinweis: Weitere Informationen zu anwendungsspezifischen Administratorrollen und delegierter Entwicklung finden Sie unter [Zugriffssteuerungsregeln in Apps zur Anwendungsverwaltung](https://www.servicenow.com/docs/access?context=ACL-access-checks&version=xanadu&pubname=xanadu-application-development&ft:locale=en-US) und [Delegierte Entwicklung und Bereitstellung](https://www.servicenow.com/docs/access?context=c_DelegatedDevelopment&version=xanadu&pubname=xanadu-application-development&ft:locale=en-US). ### Prozedur 1. Navigieren zu AlleSystemerweiterungspunkteUI-Erweiterungspunkte. 2. Wählen Sie in der Tabelle „UI-Erweiterungspunkt" \[sys_ui_extension_point\] den UI-Erweiterungspunkt, für den Sie Erweiterungsintanzen anzeigen möchten. 3. Wählen Sie in der zugehörigen Liste „Implementierungen" des UI-Erweiterungspunktdatensatzes eine UI-Erweiterungsinstanz aus. Das System zeigt den UI-Erweiterungsinstanz-Datensatz 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 wird. Dieser wird vom System zugewiesen und kann nicht geändert werden. Weitere Informationen über den Schutz, den das Festlegen von Bereichen bietet, finden Sie unter [Application scope](https://www.servicenow.com/docs/access?context=c_ApplicationScope&version=xanadu&pubname=xanadu-application-development&ft:locale=en-US). | | Aktiv | Aktiver Erweiterungspunkt in der aktuellen Instanz. Um einen Erweiterungspunkt zu deaktivieren, deaktivieren Sie die Checkbox. | [Tabelle : 1. UI-Erweiterungsinstanz-Datensatz] {#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/NrXZOoqj922gpSmU24sA0Q#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/C8oDBWontT9macwvClUiUQ "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ählten Now Platform-Anwendungen verfügbar sind, oder Sie können Erweiterungspunkte hinzufügen, wenn Sie benutzerdefinierte Anwendungen in Ihrer eigenen Instanz entwickeln.")