Ereignisnutzlasten in UI Builder

  • Freigeben Version: Yokohama
  • Aktualisiert 30. Januar 2025
  • 2 Minuten Lesedauer

    • Verwenden Sie Ereignisnutzlasten, um Daten mit einer Aktion zu verknüpfen.

    Ereignisnutzlasten sind Datenelemente, die von einer Komponente gesendet werden, wenn ein ausgewähltes Ereignis ausgelöst wird. Die von einem Ereignis gesendeten Daten können den Ereignistyp, Zeitstempel, Benutzeraktionen oder Ressourcendaten wie eine SysID enthalten. Sie können Ereignisnutzlasten in UI Builder verwenden, um Informationen zwischen Komponenten auf einer Seite freizugeben.

    Sie können diese Nutzlastdaten verwenden, wenn Sie einen Ereignishandler konfigurieren, damit die resultierende Interaktion mit den ausgegebenen Daten verknüpft werden kann. Beispielsweise kann eine SysID an andere Komponenten auf einer Seite übergeben werden, um Informationen zu einem angegebenen Datensatz anzuzeigen.

    Rotes Feld mit den verfügbaren Ereignisnutzlasten für die ausgewählte Komponente.

    Jede Komponente und jedes Ereignis verfügt über einen eindeutigen Satz von Nutzlastoptionen. Ereignisnutzlasten sind möglicherweise nicht für jede Komponente ordnungsgemäß definiert. Definieren Sie in diesem Fall ein Client-Skript, damit die Konsole Nutzlasten protokolliert, z. B. „console.log(event.payload)“.

    Erstellen Sie ein Ereignis mit Nutzlasten, um Informationen zwischen Komponenten freizugeben

    Verwenden Sie Ereignisnutzlasten in UI Builder, um Informationen zwischen Komponenten auf einer Seite freizugeben.

    Vorbereitungen

    Erforderliche Rolle: ui_builder_admin

    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.
      Weitere Informationen finden Sie unter Konfigurieren Sie, wie Benutzer in mit Ihren Anwendungen interagieren UI Builder.
    3. Erstellen oder öffnen Sie eine Seite.
      Weitere Informationen zum Erstellen einer Seite in UI Builderfinden Sie unter Seite in UI Builder erstellen.
    4. Fügen Sie eine Komponente mit Ereignissen hinzu, z. B. die Datenvisualisierungskomponente.
      Weitere Informationen zum Hinzufügen von Komponenten zu einer Seite finden Sie unter Komponenten hinzufügen und konfigurieren.
    5. Um Ihrer Komponente einen Ereignishandler hinzuzufügen, wählen Sie die Registerkarte Ereignisse.
      Weitere Informationen zum Hinzufügen von Ereignishandlern zu Ihrer Komponente finden Sie unter Verwalten Sie -Aktionen auf UI Builder-Seiten.
      1. Um den Prozess zum Einrichten eines Ereignishandlers für Ihre Komponente zu starten, klicken Sie auf Ereigniszuordnung hinzufügen.
        Pfeil zum Hinzufügen einer Ereigniszuordnungsoption.
      2. Wählen Sie aus der Liste die Ereigniszuordnung aus, die Sie konfigurieren möchten.
        Liste der verfügbaren Ereigniszuordnungen für die Datenvisualisierungskomponente.
      3. Wählen Sie Fortsetzen.
      4. Wählen Sie im Abschnitt Ereignis-Handler-Vorschau einen Ereignis-Handler aus, der an Ihre Komponente gebunden werden soll.
        Löschen Sie Warnbenachrichtigungen, wenn in einer Liste auf eine Zeile geklickt wird. Aktualisiert den in der Liste ausgewählten Client-Statusparameter-Handler.
      5. Wählen Sie Fortsetzen.
      6. Wählen Sie Neuen Client-Statusparameter erstellen aus der Dropdownliste Clientstatus-Parametername aus.
      7. Geben Sie einen Namen in das Feld Name ein.
      8. Wählen Sie in der Dropdown- Liste Typ den Typ des Client-Statusparameters aus.
      9. Geben Sie einen Wert in das Feld Anfänglicher Wert ein.
      10. Wählen Sie das Symbol „Daten binden“ im Feld Wert, der nach dem Auslösen des Ereignisse verwendet werden soll aus.
        Pfeil, der auf das Symbol „Daten binden“ im Feld „Wert, der nach dem Auslösen des Ereignisse verwendet werden soll“ zeigt.
      11. Wählen Sie den Wert aus, den Sie an das ausgelöste Ereignis binden möchten.
        Modal zum Binden von Daten
      12. Wählen Sie Übernehmen.
      13. Wählen Sie Hinzufügen.
        Der Datenhandler wird unter der Ereigniszuordnung auf der Registerkarte „Ereignisse“ angezeigt.

        Pfeil, der auf den konfigurierten Ereignishandler für die Datenvisualisierungskomponente zeigt.

    6. Wählen Sie die Komponente aus, an die Sie den Client-Statusparameter binden möchten. In diesem Beispiel verwenden wir eine Überschriftenkomponente.
    7. Wählen Sie in dem Feld, an das Sie den Client-Statusparameter binden möchten, das Symbol „Daten binden“ aus.
      Pfeil, der auf das Symbol „Daten binden“ im Bezeichnungsfeld der Überschriftenkomponente zeigt.
    8. Wählen Sie Clientstatusaus.
    9. Wählen Sie den Pfeil neben dem Client-Statusparameter aus, den Sie binden möchten.
      Pfeil, der auf den Pfeil zeigt, der einen Client-Statusparameter an das Bezeichnungsfeld bindet.
    10. Wählen Sie Übernehmen.
    11. Wählen Sie Speichern.
    12. Wählen Sie Vorschau aus, um das soeben konfigurierte Ereignis zu testen.