Binden Sie ein Ereignis an eine Seite

  • Freigeben Version: Xanadu
  • Aktualisiert 1. August 2024
  • 4 Minuten Lesedauer
  • Verwenden Sie Zuordnungen für Seitenereignisse, um Datenelemente in UI Builder zu binden, damit Sie Ihrer Seite Ereignisaktionen hinzufügen können.

    Vorbereitungen

    Erforderliche Rolle: ui_builder_admin

    Warum und wann dieser Vorgang ausgeführt wird

    Sie können ein Ereignis mithilfe der folgenden Ereignistypen an eine Seite binden:
    • Zuordnungen von Seiten-Ereignissen Fügen Sie auf Ihrer Seite Warnungsbenachrichtigungen hinzu, entfernen oder löschen Sie sie.
    • Zuordnungen für Varianten-Ereignisse Fügen Sie Ihrer Seitenvariante Warnungsbenachrichtigungen hinzu, entfernen oder löschen Sie sie.
    • Gesendete Ereignisse. Erstellen Sie gesendete Ereignisse für Ihre Seite, um weitergeleitete Ereigniszuordnungen zu erstellen, die Ereignisse nach einem übergeordneten Ereignishandler modellieren. Wählen Sie einen übergeordneten Ereignishandler des Ziels aus, um die Nutzlastfelder danach zu modellieren.
    • Behandelte Ereignisse. Ein behandeltes Ereignis ist ein Ereignis, das anderen Anwendern zur Verfügung steht und zur Verwendung durch sie zur Verfügung steht. Nachdem Sie ein behandeltes Ereignis erstellt haben, steht es anderen Benutzern unter Page event mappings zur Verfügung. Sie können auch manuell erstellte Nutzlastfelder einrichten oder eine Vorlage für Ihr behandeltes Ereignis auswählen, z. B. das Öffnen oder Schließen eines modalen Dialogfelds.

    Prozedur

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

      Der Textkörper ist die Zeile der obersten Ebene der Inhaltsstruktur. Wenn Sie die gesamte Seite hervorheben, können Sie Ereignisse auf Seitenebene hinzufügen.

      Pfeil, der auf die Option für den Textkörper in der Inhaltsstruktur zeigt.
    5. Wählen Sie im Konfigurationsbereich die Registerkarte Ereignisse aus.
      Konfigurationsbereich mit der Registerkarte Ereignisse.
    6. Fügen Sie einen Ereignishandler auf eine der folgenden Arten hinzu.
      Dient zum Hinzufügen dieses Ereignis-HandlersDiese Aktion ausführen
      Zuordnungen für Seiten-Ereignisse Page ready Quellereignis:
      1. Wählen Sie Ereignis-Handler hinzufügen.
      2. Um auf der Seite Warnungsbenachrichtigungen hinzuzufügen, zu entfernen oder zu löschen, wählen Sie einen Ereignishandler aus Page-level event handlersaus. Sie können auf Ihrer Seite Warnungsbenachrichtigungen hinzufügen, entfernen oder löschen.
      3. Um den Ereignishandler zu Ihrer Seite hinzuzufügen, wählen Sie Hinzufügen.
      Page property changed Quellereignis:
      1. Wählen Sie Neuen Ereignis-Handler hinzufügen.
      2. Wählen Sie einen Ereignishandler aus Page-level event handlersaus. Sie können auf Ihrer Seite Warnungsbenachrichtigungen hinzufügen, entfernen oder löschen. Sie können auch Ladestatus festlegen wählen, um das Wort Wird geladen auf Ihrer Seite anzuzeigen, damit Anwender sehen können, dass die Seite geladen wird. Sie können auch Client- Statusparameter aktualisieren auswählen, um den Namen des Clientstatus zu ändern.
      3. Um den Ereignishandler zu Ihrer Seite hinzuzufügen, klicken Sie auf Hinzufügen.
      Zuordnungen für Varianten-Ereignisse Zuordnungen für Varianten-Ereignisse

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

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

      Optionen für Varianten-Ereignishandler.

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

        Dialogfeld „Ereignis erstellen“.

      5. Der von Ihnen neu erstellte Ereignis-Handler wird unter Gesendete Ereignisseangezeigt. Das folgende Beispiel zeigt, wie Sie einen Link to destination -Ereignishandler hinzufügen.

        Ereignis-Handler zu gesendeten Ereignissen hinzugefügt.

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

      • Diese Ereignisse dienen als Quellereignisse für Zuordnungen von Varianten-Ereignissen.

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

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

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