Definieren Sie Zuordnungsereignisse

Eine Ereigniszuordnung in UI BuilderIst der Prozess, mit dem Sie die Nutzlast oder Kontextwerte eines Ereignisses dem Objekt oder Handler zuordnen können, das bzw. der auf dieses Ereignis reagiert. Die vier Ereignistypen sind: Komponente, Seite, Datenressource und deklarative Aktion.

Die Event-Zuordnung ist in UI Builder ein wichtiger Prozess. Wenn Sie Seiten mit Komponenten erstellen, müssen diese Komponenten ausgeführt werden AktionenFür Anwender. Wenn Sie der Seite beispielsweise eine Schaltflächenkomponente hinzufügen, muss ein Ereignis mit angeklickter Schaltfläche einem Ereignis-Handler zugeordnet werden. Der Ereignis-Handler führt eine Aktion durch, auf die eine Schaltfläche geklickt wird, wenn er von einem Anwender ausgewählt wird. Ein Beispiel ist, wenn Sie eine Datenressource wie ein Formular hinzufügen und einen Ereignis-Handler den Anwender benachrichtigen lassen, wenn das Formular erfolgreich geladen wird.

Ereignistypen

Die verfügbaren Ereignistypen basieren auf der Komponente. Beispielsweise sind deklarative Aktionsereignisse für bestimmte Komponenten verfügbar, z. B. die Aktionsleiste und die Listenkomponenten.

Sie wählen eine Art von Ereignis basierend auf der Aktion aus, die Sie auf Ihrer Seite ausführen möchten. Wenn Sie beispielsweise eine Aktion an eine Komponente binden möchten, z. B. eine Schaltfläche, die eine Webseite lädt, verwenden Sie ein Komponentenereignis. Wenn ein Ereignis auf Ihre gesamte Seite angewendet werden soll, z. B. das Hinzufügen einer Warnungsbenachrichtigung zu einer Seite, verwenden Sie ein Seitenereignis. Die folgende Tabelle beschreibt jeden Ereignistyp, der in verfügbar ist UI BuilderUnd bietet einige Beispiele für die Verwendung der Ereignisse.

Tabelle : 1. Ereignistypen und Beschreibungen

Ereignistyp	Beschreibung
Komponentenereignisse	Aktion, die Sie für eine Komponente eingerichtet haben. Sie richten einen Ereignis-Handler ein, um diese Komponentenaktion zu konfigurieren. Fügen Sie beispielsweise einen Ereignis-Handler hinzu, um eine Aktion auf eine Schaltfläche anzuwenden, z. B. zum Aufrufen einer Webseite. Weitere Informationen zum Binden von Ereignissen an Komponenten finden Sie unter Binden Sie ein Ereignis an eine Komponente.
Seitenereignisse	Seitenereignis, das eine Aktion für die gesamte Seite ausführt. Sie können die folgenden Seitenereignisse konfigurieren: Seitenereigniszuordnungen. Diese Ereigniszuordnungen werden im Seitendefinitionsdatensatz gespeichert, der in der Tabelle [sys_ux_macroponent] zu finden ist. Die Quellereignisse für diese Ereigniszuordnungen sind die Eigenschaft „Seite bereit“ und „Seite“. Sie sind für Ihre Seite definiert. Die verfügbaren Handler für diese Ereigniszuordnungen sind: Anwendersitzungsereignisse Ereignisse auf Seitenebene Datenquelle für UXR-App-Shell Client-Skripts, die auf der Seite definiert sind Vorgänge aus lokalen und geerbten Datenressourcen Variantenereigniszuordnungen. Diese Ereigniszuordnungen werden im Variantendatensatz gespeichert, den Sie in der Tabelle [sys_ux_screen] finden. Die Quellereignisse für diese Ereigniszuordnungen sind alle gesendeten Ereignisse, die für Ihre Seite definiert sind. Die verfügbaren Handler für diese Ereigniszuordnungen sind Ereignisse auf Canvas-Ebene, die Datenquelle der UXR-App-Shell und Vorgänge aus den geerbten Datenressourcen. Variantenereigniszuordnungen werden als Relais verwendet, damit die Ereignisse, die von Komponenten auf Ihrer Seite gesendet werden, an Anwendersitzungsereignishandler weitergeleitet werden können. Zuordnungen werden automatisch auf einer gespeicherten Seite erstellt, wenn Sie das gesendete Ereignis einer Komponente einem Anwendersitzungs-Handler zugeordnet haben. Beispiel: Durch Zuordnung von Schaltfläche angeklickt Ereignis auf Canvas-Ebene Link zum Ziel Ereignis: Das Ereignis erstellt ein gesendetes Relais-Ereignis und eine Variantenereigniszuordnung, wenn die Seite gespeichert wird. Gesendete Ereignisse. Diese Ereignisse werden in der Tabelle [sys_ux_event] gespeichert. Der Seitendefinitionsdatensatz enthält Verweise auf den Datensatz [sys_ux_event]. Diese Ereignisse dienen als Quellereignisse für Variantenereigniszuordnungen. Sie können auswählen +Hinzufügen Um neue gesendete Ereignisse für Ihre Seite zu erstellen. Konfigurieren Sie die Ereignisbezeichnung, um die Felder „Ereignisname“ und „Nutzlast“ für Ihren neuen automatisch auszufüllen sys_ux_Event . Diese Ereignisse werden verwendet, um Relais-Ereigniszuordnungen zu erstellen. Sie können auswählen Übergeordneter Zielereignis-Handler Dient zum Modellieren der Nutzlastfelder nach dem ausgewählten Ereignis. Sie können Nutzlastfelder auch manuell für Ihr gesendetes Ereignis erstellen. Behandelte Ereignisse. Diese Ereignisse werden in der Tabelle [sys_ux_event] gespeichert. Der Seitendefinitionsdatensatz enthält Verweise auf den Datensatz [sys_ux_event]. Diese Ereignisse dienen als Quellereignisse für Seitenereigniszuordnungen. Sie können auswählen +Hinzufügen Um neue gesendete Ereignisse für Ihre Seite zu erstellen. Behandelte Ereignisse werden nicht nach übergeordneten Ereignis-Handlern modelliert. Nutzlastfelder für behandelte Ereignisse werden manuell erstellt. Um die Nutzlastfelder eines vorhandenen Handlers als Vorlage zu verwenden, wählen Sie eine Vorlage aus, und bearbeiten Sie die Felder nach Bedarf. Weitere Informationen zum Binden eines Ereignisses an eine Seite finden Sie unter Binden Sie ein Ereignis an eine Seite.
Datenressourcenereignisse	Ereignisse, die Datenressourcen zugeordnet sind, um Benachrichtigungen darüber bereitzustellen, wann Daten abgerufen werden. Datenabruf Initiiert. Wenn ein Datenressourcenereignis ausgelöst wird, führt der Ereignis-Handler den Datenabrufprozess aus. Datenabruf Erfolgreich. Wenn ein Datenressourcenereignis ausgelöst wird, führt der Ereignishandler den Prozess aus, um einen Anwender zu benachrichtigen, wenn der Datenabruf erfolgreich abgeschlossen wurde. Datenabruf Fehlgeschlagen. Wenn ein Datenressourcenereignis ausgelöst wird, führt der Ereignishandler den Prozess aus, um einen Anwender zu benachrichtigen, wenn der Datenabruf nicht erfolgreich war. Weitere Informationen zum Binden eines Ereignisses an eine Datenressource finden Sie unter Binden Sie ein Ereignis an eine Datenressource.
Deklarative Aktionsereignisse	Binden Sie Datenelemente in UI BuilderDient zum Hinzufügen von Ereignisaktionen zu einer deklarativen Aktion. Sie konfigurieren eine Ereigniszuordnung für deklarative Aktionen in ServiceNow AI Platform®Tabelle für deklarative Aktionszuweisung. Navigieren Sie beispielsweise zu Filternavigator > sys_deklarative_action_assignment.list Und suchen und öffnen Sie dann nach einer vorhandenen deklarativen Aktion. In UI Builder, Sie binden ein Ereignis an die deklarative Aktion. Weitere Informationen zur Verwendung deklarativer Aktionsereignisse finden Sie unter Ein Ereignis an eine deklarative Aktion binden.