Definieren Sie Kartenereignisse

Eine Ereigniszuordnung in UI Builder ist der Prozess, mit dem Sie die Nutzlast oder kontextbezogene Werte eines Ereignisses dem Objekt oder Handler zuordnen können, das bzw. den auf dieses Ereignis wirkt. 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, benötigen Sie diese Komponenten, um Aktionen für Benutzer auszuführen. Wenn Sie der Seite beispielsweise eine Schaltflächenkomponente hinzufügen, muss ein Ereignis, auf das auf die Schaltfläche geklickt wurde, einem Ereignis-Handler zugeordnet werden. Der Ereignishandler führt eine Aktion des Klicks auf eine Schaltfläche aus, wenn sie von einem Anwender ausgewählt wird. Ein Beispiel: Sie fügen eine Datenressource hinzu, z. B. ein Formular, und einen Ereignishandler, der den Benutzer benachrichtigt, wenn das Formular erfolgreich geladen wird.

Ereignistypen

Die verfügbaren Ereignistypen hängen von der Komponente ab. Beispielsweise sind deklarative Aktionsereignisse für bestimmte Komponenten verfügbar, z. B. die Komponenten Aktionsleiste und Liste.

Sie wählen einen Ereignistyp basierend darauf, welche Aktion Sie auf Ihrer Seite ausführen möchten. Wenn Sie beispielsweise eine Aktion an eine Komponente binden möchten, z. B. eine Schaltfläche zum Laden einer Webseite, verwenden Sie ein Komponentenereignis. Wenn Sie möchten, dass ein Ereignis auf die gesamte Seite angewendet wird, z. B. das Hinzufügen einer Warnungsbenachrichtigung zu einer Seite, verwenden Sie ein Seitenereignis. Die folgende Tabelle beschreibt jeden Ereignistyp, der in UI Builder verfügbar ist, und enthält einige Beispiele für die Verwendung der Ereignisse.

Tabelle : 1. Ereignistypen und Beschreibungen

Ereignistyp	Beschreibung
Komponentenereignisse	Aktion, die Sie für eine Komponente einrichten. Sie richten einen Ereignishandler ein, um diese Komponentenaktion zu konfigurieren. Fügen Sie beispielsweise einen Ereignishandler hinzu, um eine Aktion für eine Schaltfläche anzuwenden, z. B. das Wechseln zu 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: Zuordnungen von Seiten-Ereignissen Diese Ereigniszuordnungen werden im Seitendefinitionsdatensatz gespeichert, den Sie in der Tabelle [sys_ux_macroponent] finden. Die Quellereignisse für diese Ereigniszuordnungen sind „Seite bereit“ und „Seiteneigenschaft“. Sie sind für Ihre Seite definiert. Die verfügbaren Handler für diese Ereigniszuordnungen sind: Benutzersitzungs-Ereignisse Ereignisse auf Seitenebene Datenquelle für UXR-App-Shell Client-Skripts, die auf der Seite definiert sind Vorgänge aus lokalen und geerbten Datenressourcen Zuordnungen für Varianten-Ereignisse 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 „UXR-App-Shell“ und Vorgänge aus den geerbten Datenressourcen. Varianten-Ereigniszuordnungen werden als Relais verwendet, sodass die Ereignisse, die von Komponenten auf Ihrer Seite gesendet werden, an Ereignishandler der Benutzersitzung weitergeleitet werden können. Zuordnungen werden beim Speichern einer Seite automatisch erstellt, wenn Sie das gesendete Ereignis einer Komponente einem Benutzersitzungs-Handler zugeordnet haben. Wenn Sie beispielsweise ein Ereignis vom Typ „Schaltfläche angeklickt “ dem Ereignis „ Link zu Ziel “ auf Canvas-Ebene zuordnen, erstellt das Ereignis ein gesendetes Relaisereignis und eine Zuordnung des Variantenereignisses, 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 Zuordnungen von Varianten-Ereignissen. Sie können +Hinzufügen auswählen, um neue gesendete Ereignisse für Ihre Seite zu erstellen. Konfigurieren Sie die Ereignisbezeichnung, um die Felder für den Ereignisnamen und die Nutzlast für Ihr neues sys_ux_event automatisch auszufüllen. Diese Ereignisse werden verwendet, um Relais-Ereigniszuordnungen zu erstellen. Sie können einen übergeordneten Ereignis-Handler für das Ziel auswählen, um die Nutzlastfelder nach dem ausgewählten Ereignis zu modellieren. Sie können Nutzlastfelder für Ihr gesendetes Ereignis auch manuell 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 Seiten-Ereigniszuordnungen. Sie können +Hinzufügen auswählen, um neue gesendete Ereignisse für Ihre Seite zu erstellen. Behandelte Ereignisse werden nicht nach dem Vorbild übergeordneter Ereignishandler 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 bereitzustellen, wenn Daten abgerufen werden. Datenabruf initiiert. Wenn ein Datenressourcenereignis ausgelöst wird, führt der Ereignishandler 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 Builder, um einer deklarativen Aktion Ereignisaktionen hinzuzufügen. Eine Ereigniszuordnung für eine deklarative Aktion konfigurieren Sie in der Zuweisungstabelle der deklarativen Aktion Now Platform®. Navigieren Sie für ein Beispiel zu Filternavigator > sys_declarative_action_assignment.list und suchen und öffnen Sie dann eine vorhandene deklarative Aktion. In UI Builderbinden Sie ein Ereignis an die deklarative Aktion. Weitere Informationen zur Verwendung von deklarativen Aktionsereignissen finden Sie unter Ein Ereignis an eine deklarative Aktion binden.