Binden Sie ein Event an eine Seite

  • Freigeben Version: Washingtondc
  • Aktualisiert 1. Februar 2024
  • 4 Minuten Lesedauer
  • Verwenden Sie Seiten-Event-Zuordnungen, um Datenelemente in UI Builder zu binden, damit Sie Ihrer Seite Event-Aktionen hinzufügen können.

    Vorbereitungen

    Erforderliche Rolle: ui_builder_admin

    Warum und wann dieser Vorgang ausgeführt wird

    Sie können ein Event an eine Seite binden, indem Sie die folgenden Event-Typen verwenden:
    • Seitenereigniszuordnungen. Fügen Sie Warnungsbenachrichtigungen auf Ihrer Seite hinzu, entfernen oder löschen Sie sie.
    • Varianten-Event-Zuordnungen. Fügen Sie Warnungsbenachrichtigungen in Ihrer Seitenvariante hinzu, entfernen oder löschen Sie sie.
    • Gesendete Events. Erstellen Sie gesendete Events für Ihre Seite, um Relais-Event-Zuordnungen zu erstellen, die Events nach einem übergeordneten Event Handler modellieren. Wählen Sie einen übergeordneten Ziel-Event-Handler aus, um die Nutzlastfelder nach ihm zu modellieren.
    • Behandelte Ereignisse. Ein behandeltes Event ist ein Event, das anderen Benutzern zur Verfügung steht und von diesen verwendet werden kann. Nachdem Sie ein behandeltes Event erstellt haben, ist es unter Page event mappings für andere Benutzer verfügbar. Sie können auch Nutzlastfelder einrichten, die Sie manuell erstellen, oder eine Vorlage für Ihr behandeltes Ereignis auswählen, z. B. ein modales Dialogfeld öffnen oder schließen.

    Prozedur

    1. Navigieren zu Alle > Now-Experience-Framework > UI Builder.
    2. Öffnen Sie eine Experience, um in zu arbeiten, oder erstellen Sie eine Experience, indem Sie + Erstellenwählen.
    3. Öffnen oder erstellen Sie eine Seite.
      Weitere Informationen zum Erstellen einer Seite in UI Builderfinden Sie unter Seiten in UI Builder erstellen.
    4. Markieren Sie den Seitentext in der Inhaltsstruktur.

      Der Textkörper ist die oberste Zeile der Inhaltsstruktur. Wenn Sie die gesamte Seite markieren, können Sie Events auf Seitenebene hinzufügen.

      Pfeil, der auf die Textkörperoption in der Inhaltsstruktur zeigt.
    5. Wählen Sie im Konfigurationsbereich die Registerkarte Events aus.
      Konfigurationsbereich mit der Registerkarte „Events“.
    6. Fügen Sie einen Event-Handler auf eine der folgenden Arten hinzu.
      So fügen Sie diesen Event-Handler hinzuVorgehensweise
      Zuordnungen für Seiten-Ereignisse Page ready Quell-Event:
      1. Wählen Sie Event Handler hinzufügen aus.
      2. Um Warnungsbenachrichtigungen auf der Seite hinzuzufügen, zu entfernen oder zu löschen, wählen Sie einen Event Handler aus Page-level event handlersaus. Sie können Warnungsbenachrichtigungen auf Ihrer Seite hinzufügen, entfernen oder löschen.
      3. Um den Event-Handler zu Ihrer Seite hinzuzufügen, wählen Sie Hinzufügen.
      Page property changed Quell-Event:
      1. Wählen Sie Neuen Event Handler hinzufügen aus.
      2. Wählen Sie einen Event Handler aus Page-level event handlersaus. Sie können Warnungsbenachrichtigungen auf Ihrer Seite hinzufügen, entfernen oder löschen. Sie können auch Ladestatus festlegen auswählen, um das Wort Wird geladen auf Ihrer Seite anzuzeigen, damit Benutzer sehen können, dass die Seite geladen wird. Sie können auch Client-Statusparameter aktualisieren auswählen, um den Client -Statusnamen zu ändern.
      3. Um den Event-Handler zu Ihrer Seite hinzuzufügen, klicken Sie auf Hinzufügen.
      Zuordnungen für Varianten-Ereignisse Zuordnungen für Varianten-Ereignisse

      Sie benötigen eine Variantenseite, um eine Varianten-Event-Zuordnung durchzuführen. Die verfügbaren Varianten-Event-Zuordnungen hängen von der Variantenseite ab. Wenn die Variantenseite eine Liste enthält, fügen Sie Event Handler für Dinge wie angeklickte Zeile, Navigationselement usw. hinzu. Wenn die Variante über einen Viewport verfügt, müssen Sie möglicherweise verschiedene Ereignishandler einrichten.

      1. Wählen Sie Event-Zuordnungen hinzufügen aus. Sie können beispielsweise einen neuen Event-Handler für „ Zeile angeklickt“ hinzufügen.
      2. Wählen Sie einen Event-Handler aus der Liste der verfügbaren geerbten Event-Handler oder lokalen Event-Handler wie die Datenquelle der UXR-App-Shell aus.
      3. Um den Event Handler zu Ihrer Variante hinzuzufügen, wählen Sie Hinzufügen.

      Optionen für Variant-Ereignishandler.

      • Diese Event-Zuordnungen befinden sich im Variantendatensatz in der Tabelle „sys_ux_screen“.
      • 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 geerbten Datenressourcen.
      • Diese Event-Zuordnungen werden als Relais verwendet, sodass Events, die von Komponenten auf Ihrer Seite gesendet werden, an die Benutzersitzungs-Handler weitergeleitet werden.
      • Diese Zuordnungen werden automatisch beim Speichern einer Seite erstellt, wenn Sie das gesendete Event einer Komponente einem anderen Event zugeordnet haben. Wenn Sie beispielsweise ein Button clicked -Event dem Link to destination -Event zuordnen, erstellt das Event ein gesendetes Relais-Event und eine Varianten-Event-Zuordnung, nachdem Sie die Seite gespeichert haben.
      Gesendete Ereignisse
      1. Wählen Sie Gesendete Events aus.
      2. Wählen Sie +Symbol hinzufügen aus..
      3. Führen Sie im Bildschirm Event erstellen die folgenden Aktionen aus:
        • Geben Sie eine Bezeichnung für Ihr Event ein.
        • Wählen Sie einen übergeordneten Event-Handler als Ziel aus.
      4. Um den Event Handler zu Ihren gesendeten Events hinzuzufügen, wählen Sie Hinzufügen.

        Dialogfeld „Event erstellen“.

      5. Der neue Event Handler, den Sie erstellt haben, wird in Gesendete Eventsangezeigt. Das folgende Beispiel zeigt, wie ein Ereignishandler Link to destination hinzugefügt wird.

        Event Handler zu gesendeten Events hinzugefügt.

      • Diese Events befinden sich in der Tabelle [sys_ux_event]. Der Seitendefinitionsdatensatz enthält Verweise auf den Datensatz [sys_ux_event].

      • Diese Events dienen als Quell-Events für Varianten-Event-Zuordnungen.

      • Um neue gesendete Events für Ihre Seite zu erstellen, wählen Sie das Symbol +Hinzufügen aus.. 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 häufig zum Erstellen von Relais-Event-Zuordnungen verwendet. Sie können einen Target parent event handler 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.

      • Um neue gesendete Events für Ihre Seite zu erstellen, wählen Sie das Symbol +Hinzufügen aus.. Diese Events sind 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.

    7. Wählen Sie Speichern.
    8. Um eine Vorschau Ihrer Seite anzuzeigen und das von Ihnen eingerichtete Datenressourcenereignis zu testen, klicken Sie auf die Schaltfläche Vorschau..