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


---

# Erweiterungspunkte verwenden, um die Anwendungsfunktionalität zu erweitern

# Erweiterungspunkte verwenden, um die Anwendungsfunktionalität zu erweitern {#ariaid-title1}

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

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.

## Erweiterungspunkte werden verwendet {#extension-points__section_blc_wft_pdb}

Durch die Verwendung von Erweiterungspunkten können Sie Anpassungen integrieren, ohne die Kernkomponenten im Anwendungscode tatsächlich zu ändern. Erweiterungspunkte können verhindern, dass Ihre anwenderdefinierten Codeinteraktionen unterbrochen werden, was häufig nach einem Upgrade auftritt, wenn Sie den anwenderdefinierten Code direkt in den Anwendungscode einbetten.

Erweiterungspunkte, die in den Anwendungscode eingebettet sind, fungieren als Ausgangspunkte, bei denen Daten an den anwenderdefinierten Code übergeben werden, und als Eingangspunkte, die die zurückgegebenen Ergebnisse verarbeiten. Beim Erstellen einer Anwendung müssen die zurückgegebenen Daten oder Objekte den Anforderungen entsprechen, die Sie für den Erweiterungspunkt definieren.  
Hinweis:  
Einige vorkonfigurierte CSM-Abfrageregeln können nicht geändert oder deaktiviert werden, da sie auch in Konstanten innerhalb einer Business-Regel verwendet werden.

## Typen von Erweiterungspunkten {#extension-points__section_zm3_dvf_kgb}

Sie können Erweiterungspunkte erstellen, um den anwenderdefinierten Code zu verarbeiten, der die folgenden Arten von Artefakten verwendet:

Geskriptete Erweiterungspunkte
:   Erweiterungspunkte in serverseitigen Skripteinbindungen, die JavaScript-Funktionen und -Objektklassen speichern. Informationen zu Skripteinbindungen und zur Implementierung geskripteter Erweiterungspunkte in der Anwendung und anwenderdefiniertem Code finden Sie unter:  
    * [Skripteinbindungen](https://servicenow-prod.fluidtopics.net/woSgnhab1HyA4QRWRrDd0g#c_ScriptIncludes "Skripteinbindungen werden verwendet, um JavaScript zu speichern, das auf dem Server ausgeführt wird.")
    * [Erstellen und Hinzufügen eines geskripteten Erweiterungspunkts](https://servicenow-prod.fluidtopics.net/Of__zcsSOBdu1afQnRSXbA "Erstellen Sie bei der Entwicklung einer Anwendung geskriptete Erweiterungspunkte, und fügen Sie sie den Skripteinbindungen im Anwendungscode hinzu. Verwenden Sie einen geskripteten Erweiterungspunkt, um den spezifischen Speicherort anzugeben, an dem Daten oder Objekte an eine registrierte anwenderdefinierte Skripteinbindung gesendet werden können und an dem zurückgegebene Ergebnisse verarbeitet werden.")
    * [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.")
    {#extension-points__ul_vr2_kyc_cgb}

UI-Erweiterungspunkte

:   Erweiterungspunkte, die in serverseitigen UI-Makros wie HTML-Erweiterungen verwendet werden. UI-Makros sind diskrete geskriptete Komponenten, die Sie der Anwenderoberfläche hinzufügen können. Sie verwenden sie, um einer UI-Seite anwenderdefinierte Inhalte hinzuzufügen, ohne die Seite direkt ändern zu müssen. Sie können beispielsweise UI-Makros verwenden, um dem Standard Kopf- und Fußzeilen hinzuzufügen Knowledge BaseZeigen Sie die UI-Seite (kb_View) an, auf der KB-Artikel angezeigt werden.

    Informationen zu UI-Makros und zur Implementierung von UI-Erweiterungspunkten in der Anwendung und dem anwenderdefinierten Code 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.")
    * [Erstellen und Hinzufügen eines UI-Erweiterungspunkts](https://servicenow-prod.fluidtopics.net/zYMzOywvKA48l6lcDtdarw#impl-ui-ext-pts-base-code "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.")
    * [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.")
    {#extension-points__ul_csp_ncd_cgb}

Client-Erweiterungspunkte

:   Erweiterungspunkte, die beim clientseitigen UI-Skripting verwendet werden, normalerweise zum Ändern von Formularen. UI-Skripts ermöglichen es Ihnen, clientseitiges JavaScript in ein wiederverwendbares Formular zu packen, das dem entspricht, wie das Skript das serverseitige JavaScript des Stores enthält. Sie können UI-Skripts erstellen und aus Client-Skripts, aus anderen clientseitigen Skriptobjekten und aus HTML-Code ausführen.

    Informationen zu UI-Skripts und zur Implementierung von Client-Erweiterungspunkten in Anwendungs- und anwenderdefiniertem Code finden Sie unter:

    * [UI-Skripts](https://servicenow-prod.fluidtopics.net/JAIPSOmpiPcSvhdjpqn22w#c_UIScripts "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.")
    * [Client-Erweiterungspunkt wird erstellt und hinzugefügt](https://servicenow-prod.fluidtopics.net/Yl6gF~Lpdsu3a2Py17jNfA "Erstellen Sie Client-Erweiterungspunkte, und fügen Sie sie den clientseitigen UI-Skripts im Basisanwendungscode hinzu.")
    * [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.")
    {#extension-points__ul_yvg_rcd_cgb}

Wenn Sie Erweiterungspunkte zum Verarbeiten von Anpassungen verwenden, erstellen Sie eine definierte Struktur für die Integration anwenderdefinierter Daten oder Funktionen in eine Anwendung. Anwenderdefinierte serverseitige Skripteinbindungen, UI-Makros wie HTML-Erweiterungen und clientseitige UI-Skripts sind alle außerhalb des Anwendungscodes und interagieren nur an den angegebenen Erweiterungspunkten mit ihm.

## Anwendungscode {#extension-points__section_a2j_wgy_xgb}

Die Bedingung Anwendungscode Bezieht sich auf:

Standardanwendungscode
:   Standard- oder Basis-Anwendungscode, der aus besteht Now Platform.  
    Vordefinierte Erweiterungspunkte sind bereits in bestimmte Anwendungen eingebettet, z. B. Kundenservice-ManagementUnd Außendienst-Management. Um mehr über zu erfahren Now PlatformAnwendungen, die vordefinierte Erweiterungspunkte enthalten, siehe Folgendes:{#extension-points__table_qqv_xzh_zgb__entry__2}

    | Anwendung | Erweiterungspunkthema |
    |-|-|
    | Coaching | [Coaching-Fehlerbehebung](https://www.servicenow.com/docs/access?context=coaching-troubleshooting&version=yokohama&pubname=yokohama-it-service-management&ft:locale=en-US) |
    | Management kontinuierlicher Verbesserungen | [Verbesserung mit anderen Anwendungen](https://www.servicenow.com/docs/access?context=cim-integration&version=yokohama&pubname=yokohama-it-service-management&ft:locale=en-US) |
    | Kundenservice-Management | [Erweiterungspunkte im Kundenservice-Management](https://www.servicenow.com/docs/access?context=extension-points-customer-service&version=yokohama&pubname=yokohama-customer-service-management&ft:locale=en-US) |
    | Kundenservice-Management | [Anwenderdefinierte Anwenderrollen werden erstellt](https://www.servicenow.com/docs/access?context=creating-custom-csm-user-roles&version=yokohama&pubname=yokohama-customer-service-management&ft:locale=en-US) |
    | Kundenservice-Management | [CSM-Integration mit Change-Management](https://www.servicenow.com/docs/access?context=csm-integration-sm-change&version=yokohama&pubname=yokohama-customer-service-management&ft:locale=en-US) |
    | Kundenservice-Management | [CSM-Integration mit Incident-Management](https://www.servicenow.com/docs/access?context=csm-integration-sm-incident&version=yokohama&pubname=yokohama-customer-service-management&ft:locale=en-US) |
    | Kundenservice-Management | [CSM-Integration mit Problem Management](https://www.servicenow.com/docs/access?context=csm-integration-sm-problem&version=yokohama&pubname=yokohama-customer-service-management&ft:locale=en-US) |
    | Kundenservice-Management | [CSM-Integration mit Anforderungsmanagement](https://www.servicenow.com/docs/access?context=csm-integration-sm-request&version=yokohama&pubname=yokohama-customer-service-management&ft:locale=en-US) |
    | Außendienst-Management | [Erweiterungspunkte im Außendienstmanagement](https://www.servicenow.com/docs/access?context=extension-points-field-service&version=yokohama&pubname=yokohama-field-service-management&ft:locale=en-US) |
    | Wissensmanagement | [Verwenden Sie Erweiterungspunkte für Wissensmanagement](https://www.servicenow.com/docs/access?context=extension-points-km-plugins&version=yokohama&pubname=yokohama-servicenow-platform&ft:locale=en-US) |
    | Orchestration | [Erweiterungsnetzwerk für Client-Softwareverteilung](https://www.servicenow.com/docs/access?context=c_CSDExtensionFramework&version=yokohama&pubname=yokohama-servicenow-platform&ft:locale=en-US) [Mit Client-Softwareverteilung installiert](https://www.servicenow.com/docs/access?context=r_IWClientSWDist&version=yokohama&pubname=yokohama-servicenow-platform&ft:locale=en-US) |
    | Passwortzurücksetzung | [Skripteinbindungen](https://www.servicenow.com/docs/access?context=c_InstalledPasswordResetScripts&version=yokohama&pubname=yokohama-servicenow-platform&ft:locale=en-US) |
    [ ]

    {#extension-points__table_qqv_xzh_zgb}

Intern entwickelte anwenderdefinierte Anwendungen für Ihr Unternehmen
:   Sie können Erweiterungspunkte hinzufügen, um die Registrierung von anwenderdefinierten Artefakten zu verarbeiten, die zum Ändern oder erweitern der Funktionalität einer Anwendung verwendet werden. Wenn Entwickler anwenderdefinierten Code erstellen, registrieren oder koppeln sie bestimmte anwenderdefinierte Artefakte mit bestimmten Erweiterungspunkten. Das Hinzufügen von Erweiterungspunkten ermöglicht die Integration zukünftiger Anpassungen, ohne Ihren Basiscode ändern zu müssen.

## Erweiterungspunkt im Anwendungscode wird erstellt {#extension-points__section_mf1_3pg_sdb}

Sie möchten sicherstellen, dass die intern entwickelten Anwendungen, die Sie für Ihr Unternehmen erstellen, nach Bedarf ordnungsgemäß angepasst, kombiniert und aktualisiert werden können. Mit Erweiterungspunkten können Sie die Funktionalität und die Anwenderoberfläche für eine Anwendung ändern, ohne die Kernkomponenten zu bearbeiten. Durch die Verwendung von Erweiterungspunkten wird auch eine hoch definierte Struktur für Funktionalitätserweiterungen erstellt.  
Wenn Sie einen Erweiterungspunkt erstellen, können Sie seine Verwendung auf den Anwendungsbereich beschränken, in dem er definiert ist, oder angeben, dass der Erweiterungspunkt in allen Bereichen global ausgeführt werden kann. Wenn der Anwendungsbereich eingeschränkt ist, können Anpassungen, die für den Erweiterungspunkt registriert sind, nur im angegebenen Anwendungsbereich ausgeführt werden. Bevor Sie eine Anwendung entwerfen und erstellen, die Erweiterungspunkte enthält, sollten Sie:

* Identifizieren Sie, wo Erweiterungspunkte im Anwendungscode platziert werden sollen, um anwenderdefinierte Skripteinbindungen, UI-Makros oder UI-Skripts aufzunehmen.
* Bestimmen 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.
{#extension-points__ul_mz5_1hj_vdb}  
Führen Sie die folgenden Aufgaben aus, um Erweiterungspunkte zu erstellen und in den Anwendungscode einzubetten:

1. Erstellen Sie einen Erweiterungspunkt, und definieren Sie seine anwenderdefinierte Schnittstelle. Dies ist ein Beispiel für einen geskripteten Erweiterungspunkt.

2. Geben Sie bestimmte Orte im Anwendungscode an, an die Daten oder Objekte an eine Anpassung gesendet werden können und an die Daten zurückgegeben werden.
3. Erstellen Sie ein Artefakt, z. B. eine Skripteinbindung, ein UI-Makro oder ein UI-Skript, das aufruft [GlideScriptedExtensionPoint -- Umfang](https://servicenow-prod.fluidtopics.net/DkG~2xwIitqs8E8xmEI7bw#GlideScriptedExtPtScopedAPI "Die GlideScriptedExtensionPoint Die API stellt eine Methode bereit, die die Erweiterungsinstanzen zurückgibt, die einem angegebenen Erweiterungspunkt zugeordnet sind.")Methode. Diese Methode identifiziert den Erweiterungspunkt, an dem registrierte anwenderdefinierte Artefakte im Anwendungscode ausgeführt werden.

{#extension-points__ol_ffm_c2g_pfb}

## Debugging und Protokollierung werden aktiviert {#extension-points__section_h5t_gty_xgb}

Wenn Sie einen Erweiterungspunkt erstellen, sollten Sie auch Debugging und Protokollierung aktivieren. Debugging und Protokollierung helfen Ihnen, Probleme im Zusammenhang mit der Verwendung anwenderdefinierter Artefakte mit einem Erweiterungspunkt zu identifizieren und zu beheben. Wenn Sie den Debugger aktivieren, können Sie Haltepunkte in Skripteinbindungen, UI-Makros oder UI-Skripts festlegen. Sie können die Protokolle überprüfen, um die folgenden Details anzuzeigen:

* Wenn ein Erweiterungspunkt aktive Erweiterungsinstanzen findet, einschließlich der Gesamtzahl der gefundenen Erweiterungsinstanzen und der Zeit, zu der jede Erweiterungsinstanz gefunden wurde.
* Wenn ein Erweiterungspunkt Erweiterungsinstanzen ausführt, einschließlich der Gesamtzahl der ausgeführten anwenderdefinierten Artefakte und der Zeit jeder Ausführung. Enthält auch die Gesamtzahl, die nicht ausgeführt werden konnte, und den Zeitpunkt, zu dem jede Erweiterungsinstanz fehlgeschlagen ist.

{#extension-points__ul_wj3_vmr_rdb}  
Hinweis:  
Weitere Informationen zum Aktivieren von Debugging und zur Funktionsweise finden Sie unter:

* [Script Debugger und Sitzungsprotokoll](https://servicenow-prod.fluidtopics.net/~xvml9mCmo7FSUz9gO2mQQ "Die Script DebuggerErmöglicht Anwendern mit der Rolle script_Debugger das Debuggen serverseitiger JavaScript. Anwender mit der Rolle log_Debugger können verwenden SitzungsprotokollZum Anzeigen und Herunterladen der erforderlichen Protokolle.")
* [Debugging von Anwendungen](https://servicenow-prod.fluidtopics.net/ozxNbODF_DCVp8CSs4gvzw#c_DebuggingApplications "Anwendungsentwickler können Debug-Nachrichten zu Konfigurationsdatensätzen anzeigen, um Probleme zu beheben. Das Modul „Umfänge debuggen“ bietet Informationen darüber, wie das System zwischen anwenderdefinierten Anwendungen wechselt, um serverseitige Skripts auszuführen.")
* [Schreiben in das Debug-Protokoll](https://servicenow-prod.fluidtopics.net/sn9aEnRRahUnIcLTpS__~g#c_WritingToTheDebugLog "Rufen Sie die globale Funktion auf, um in Ihrem clientseitigen JavaScript oder in UI-Richtlinien in das Debug-Protokoll zu schreiben Jslog() .")
{#extension-points__ul_rzj_psy_xgb}

## Ein anwenderdefiniertes Artefakt wird für einen Erweiterungspunkt registriert {#extension-points__section_up3_thj_vdb}

Wenn Sie eine Anwendung anpassen, erweitern Sie die Basisfunktionalität, indem Sie anwenderdefinierte Artefakte verwenden, z. B. serverseitige Skripteinbindungen, UI-Makros oder clientseitige UI-Skripts. Führen Sie die folgenden Aufgaben aus, um anwenderdefinierte Artefakte zu entwerfen und zu erstellen:  
1. Überprüfen Sie die Liste der verfügbaren Erweiterungspunkte, die dem spezifischen Typ des anwenderdefinierten Artefakts entsprechen, das Sie erstellen.
   * Diese Listen enthalten Erweiterungspunkte, die Sie erstellt haben, und alle vordefinierten Erweiterungspunkte, die in eingebettet sind Now PlatformFunktionen.
   * Jede Liste enthält Informationen zu einem Erweiterungspunkt im Anwendungscode, der ein anwenderdefiniertes Artefakt aufruft, und welche Daten oder Objekte an ihn zurückgegeben werden sollen.
   {#extension-points__ul_wsn_hxf_kgb}
2. Wählen Sie einen Erweiterungspunkt aus.
3. Legen Sie fest, wie das anwenderdefinierte Artefakt strukturiert werden soll. Die Struktur muss auf den Erweiterungspunktbeschreibungen basieren. Die Beschreibungen enthalten die Anforderungen für die Verwendung des Artefakts mit dem anwenderdefinierten Code und die Position des Artefakts im Basis-Anwendungscode.
4. Erstellen Sie das anwenderdefinierte Artefakt und den Code, wenn Sie es für den ausgewählten Erweiterungspunkt registrieren. Durch die Registrierung erstellen Sie einen Erweiterungsinstanzdatensatz, der die Erweiterungspunktdefinition mit ihrer Implementierung im anwenderdefinierten Artefakt verknüpft.
{#extension-points__ol_xxk_nfg_pfb}

## Wie registrierte anwenderdefinierte Artefakte verarbeitet werden {#extension-points__section_gnb_nqy_rdb}

Wenn der Anwendungscode ausgeführt wird und einen eingebetteten API-Aufruf findet, der einen Erweiterungspunkt enthält, geht er folgendermaßen vor:

1. Verwendet den Erweiterungspunkt im API-Aufruf, um zu bestimmen, welche anwenderdefinierten Artefakte dafür registriert sind.
2. Sendet die entsprechenden Daten oder Objekte an die registrierten anwenderdefinierten Artefakte.
3. Sammelt die zurückgegebene Ausgabe von jedem anwenderdefinierten Artefakt.
4. Verarbeitet die zurückgegebenen Ergebnisse und integriert sie in die Basisanwendung.
{#extension-points__ol_i1m_5vl_rdb}
* **[Geskriptete Erweiterungspunkte in serverseitigen Skripten verwenden](https://servicenow-prod.fluidtopics.net/d02gnxSwypD1n_4D8jjrOA)**   
  Verwenden Sie die geskripteten Erweiterungspunkte in den serverseitigen Skripteinbindungen, die JavaScript-Funktionen und -Objektklassen speichern. Durch die Verwendung von Erweiterungspunkten können Sie Anpassungen integrieren, ohne die Kernkomponenten im Anwendungscode tatsächlich zu ändern.
* **[UI-Erweiterungspunkte in serverseitigen UI-Makros verwenden](https://servicenow-prod.fluidtopics.net/fbkPTyz9NbAV2nUGRDiXMA)**   
  Verwenden Sie UI-Erweiterungspunkte in den serverseitigen UI-Makros, z. B. HTML-Erweiterungen, um einer UI-Seite anwenderdefinierte Inhalte hinzuzufügen, ohne die Seite direkt ändern zu müssen. Durch die Verwendung von UI-Erweiterungspunkten können Sie Anpassungen integrieren, ohne die Kernkomponenten im Anwendungscode tatsächlich zu ändern.
* **[Client-Erweiterungspunkte beim clientseitigen UI-Skripting verwenden](https://servicenow-prod.fluidtopics.net/4wdrluSF2tNR9AW3Km_AhQ)**   
  Verwenden Sie Client-Erweiterungspunkte beim clientseitigen UI-Skripting, um Formulare zu ändern, damit Sie das Formular nicht direkt ändern müssen. Durch die Verwendung von Client-Erweiterungspunkten können Sie Anpassungen integrieren, ohne die Kernkomponenten im Anwendungscode tatsächlich zu ändern.

