Eine Event-Zuordnung in UI Builder ist der Prozess, mit dem Sie die Nutzlast oder die kontextbezogenen Werte eines Events dem Objekt oder Handler zuordnen können, das bzw. der auf dieses Event 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, benötigen Sie diese Komponenten, um Aktionen für Benutzer auszuführen. Wenn Sie der Seite beispielsweise eine Schaltflächenkomponente hinzufügen, muss ein Schaltflächenklick-Event einem Event-Handler zugeordnet werden. Der Event Handler führt eine Aktion aus, auf die auf eine Schaltfläche geklickt wird, wenn er von einem Benutzer ausgewählt wird. Ein Beispiel ist, wenn Sie eine Datenressource hinzufügen, z. B. ein Formular, und einen Event Handler den Benutzer benachrichtigen lassen, wenn das Formular erfolgreich geladen wird.
Ereignistypen
Die verfügbaren Event-Typen basieren auf der Komponente. Beispielsweise sind deklarative Aktionsereignisse für bestimmte Komponenten verfügbar, z. B. die Aktionsleiste und Listenkomponenten.
Sie wählen einen Ereignistyp basierend darauf aus, 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, die eine Webseite lädt, verwenden Sie ein Komponenten-Event. Wenn Sie möchten, dass ein Event auf Ihre gesamte Seite angewendet wird, z. B. Hinzufügen einer Warnungsbenachrichtigung zu einer Seite, verwenden Sie ein Seiten-Event. Die folgende Tabelle beschreibt jeden Event-Typ, der in UI Builder verfügbar ist, und enthält einige Beispiele, wie Sie die Events verwenden können.
Tabelle : 1. Ereignistypen und -beschreibungen
| Ereignistyp |
Beschreibung |
| Komponentenereignisse |
Aktion, die Sie für eine Komponente einrichten. Sie richten einen Event Handler 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 Aufrufen einer Webseite. Weitere Informationen zum Binden von Events an Komponenten finden Sie unter Binden Sie ein Event an eine Komponente. |
| Seiten-Events |
Seiten-Event, das eine Aktion für die gesamte Seite ausführt. Sie können die folgenden Seiten-Events konfigurieren:
- Seitenereigniszuordnungen.
- Diese Event-Zuordnungen werden im Seitendefinitionsdatensatz gespeichert, der sich in der Tabelle [sys_ux_macroponent] befindet.
- Die Quell-Events für diese Event-Zuordnungen sind Seite bereit und Seiteneigenschaft. Sie sind für Ihre Seite definiert.
- Die verfügbaren Handler für diese Event-Zuordnungen sind:
- Benutzersitzungsereignisse
- Events auf Seitenebene
- Datenquelle für UXR-App-Shell
- Client-Skripts, die auf der Seite definiert sind
- Vorgänge aus lokalen und geerbten Datenressourcen
- Varianten-Event-Zuordnungen.
- Diese Event-Zuordnungen werden im Variantendatensatz gespeichert, den Sie in der Tabelle [sys_ux_screen] finden.
- Die Quell-Events für diese Event-Zuordnungen sind alle gesendeten Events, die für Ihre Seite definiert sind.
- Die verfügbaren Handler für diese Event-Zuordnungen sind Events auf Canvas-Ebene, die Datenquelle der UXR-App-Shell und Vorgänge aus den geerbten Datenressourcen.
- Varianten-Event-Zuordnungen werden als Relais verwendet, sodass die Events, die von Komponenten auf Ihrer Seite gesendet werden, an Event-Handler für Benutzersitzungen weitergeleitet werden können.
- Zuordnungen werden automatisch beim Speichern einer Seite erstellt, wenn Sie das gesendete Event einer Komponente einem Benutzersitzungs-Handler zugeordnet haben. Wenn Sie beispielsweise ein Event vom Typ „Schaltfläche angeklickt “ dem Event „ Link zu Ziel “ auf Canvas-Ebene zuordnen, erstellt das Event beim Speichern der Seite ein gesendetes Relais-Event und eine Varianten-Event-Zuordnung.
- Gesendete Events.
Diese Events werden in der Tabelle [sys_ux_event] gespeichert. Der Seitendefinitionsdatensatz enthält Verweise auf den Datensatz [sys_ux_event]. Diese Events dienen als Quell-Events für Varianten-Event-Zuordnungen. Sie können +Hinzufügen auswählen, um neue gesendete Events für Ihre Seite zu erstellen. Konfigurieren Sie die Event-Bezeichnung, um die Felder für den Event-Namen und die Nutzlast für Ihr neues sys_ux_event automatisch auszufüllen. Diese Events werden zum Erstellen von Relais-Event-Zuordnungen verwendet. Sie können einen übergeordneten Event-Handler für Ziel auswählen, um die Nutzlastfelder nach dem ausgewählten Event zu modellieren. Sie können Nutzlastfelder für Ihr gesendetes Event auch manuell erstellen.
- Behandelte Ereignisse.
Diese Events werden in der Tabelle [sys_ux_event] gespeichert. Der Seitendefinitionsdatensatz enthält Verweise auf den Datensatz [sys_ux_event]. Diese Events dienen als Quell-Events für Seiten-Event-Zuordnungen. Sie können +Hinzufügen auswählen, um neue gesendete Events für Ihre Seite zu erstellen. Behandelte Events werden nicht nach übergeordneten Event-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 Events an eine Seite finden Sie unter Binden Sie ein Event an eine Seite. |
| Datenressourcenereignisse |
Ereignisse, die Datenressourcen zugeordnet werden, um Benachrichtigungen bereitzustellen, wenn Daten abgerufen werden.
- Datenabruf initiiert. Wenn ein Datenressourcen-Event ausgelöst wird, führt der Event-Handler den Datenabrufprozess aus.
- Datenabruf erfolgreich. Wenn ein Datenressourcen-Event ausgelöst wird, führt der Event-Handler den Prozess aus, um einen Benutzer zu benachrichtigen, wenn der Datenabruf erfolgreich abgeschlossen wurde.
- Datenabruf fehlgeschlagen. Wenn ein Datenressourcen-Event ausgelöst wird, führt der Event-Handler den Prozess aus, um einen Benutzer zu benachrichtigen, wenn der Datenabruf nicht erfolgreich war.
Weitere Informationen zum Binden eines Events an eine Datenressource finden Sie unter Binden Sie ein Event an eine Datenressource. |
| Deklarative Aktionsereignisse |
Binden Sie Datenelemente innerhalb von UI Builder, um Ereignisaktionen zu einer deklarativen Aktion hinzuzufügen.
Sie konfigurieren eine Ereigniszuordnung für deklarative Aktionen in der Zuweisungstabelle für deklarative Aktionen Now Platform®. Navigieren Sie für ein Beispiel zu und dann nach einer vorhandenen deklarativen Aktion suchen und sie öffnen.
In UI Builderbinden Sie ein Event an die deklarative Aktion. Weitere Informationen zur Verwendung von deklarativen Aktionsereignissen finden Sie unter Ein Event an eine deklarative Aktion binden. |