Hinzufügen von Aktions-Triggern zu Widgets

Beim Erstellen von dynamischen und interaktiven Apps mit Experience Builder können Sie die folgenden Aufgaben ausführen:

  • Verbinden von Widgets mit Daten und Konfigurieren dieser Widgets mit dynamischem Inhalt.
  • Konfigurieren von Interaktionen zwischen Widgets.

Experience Builder-Apps sind datenabhängig. Das bedeutet, die durch Widgets angezeigten Daten können bei einer Aktualisierung der zugrunde liegenden Daten entsprechend geändert werden. Sie können spezifischere Interaktionen zwischen Widgets definieren, indem Sie die Aktionen als Reaktion auf Trigger konfigurieren. Zum Beispiel können Sie Aktionen für ein Karten-Widget festlegen, das Inhaltsänderungen in Listen- und Feature-Info-Widgets auslöst. Sie können Listen-Widget-Datensätze so filtern, dass nur die Datensätze angezeigt werden, die in der aktuellen Ausdehnung eines Karten-Widgets angezeigt werden. Sie können auch die Ausdehnung zweier Karten-Widgets synchronisieren, wenn der Benutzer eines davon zoomt oder schwenkt.

Interaktionsstruktur

Interaktionen werden im Bereich Aktion des Quell-Widgets, das die Trigger bereitstellt, definiert und verwaltet. Interaktionen bestehen aus drei Teilen:

  • Trigger aus dem Quell-Widget
  • Ziele, die auf den Trigger reagieren, einschließlich Widgets und App-Framework
  • Aktionen aus dem Ziel entsprechend der vorgesehenen Verwendung

Der Trigger des Quell-Widgets kann nur einmal hinzugefügt werden. Für diesen Trigger können Sie jedoch mehrere Aktionen aus demselben oder einem anderen Ziel hinzufügen.

Trigger

Trigger sind Ereignisse, die durch das Quell-Widget generiert werden. Sobald ein Trigger auftritt, werden als Reaktion alle hinzugefügten Aktionen ausgeführt. In der folgenden Tabelle werden die zwei Trigger, die derzeit unterstützt werden, beschrieben:

TriggerBeschreibung

Änderungen der Ausdehnung

Ein Trigger tritt dann auf, wenn durch Schwenken, Zoomen, Größenänderung usw. die Ausdehnung der Karte geändert wird.

Änderungen der Datensatzauswahl

Ein Trigger tritt dann auf, wenn ein Datensatz ausgewählt oder ein ausgewählter Datensatz aus der Auswahl entfernt wird.

Um die verfügbaren Trigger eines Widgets anzuzeigen, öffnen Sie dessen Einstellungen und klicken auf Trigger hinzufügen auf der Registerkarte Aktion. Die folgende Tabelle enthält eine Liste der Quell-Widgets mit den von ihnen unterstützten Triggern:

Das Widget "Quelle"Änderungen der AusdehnungÄnderungen der Datensatzauswahl

Karte

Ja

Ja

Liste

Ja

Feature-Info

Ja

Ziele

Ziele führen die Aktionen aus. Ein Ziel kann ein Widget oder die Umgebung sein. Wenn Sie die Umgebung als Ziel auswählen, wird die Aktion global ausgeführt, das heißt, in allen relevanten Widgets und Seiten in der App.

Aktionen

Im Gegensatz zu den Triggern, die durch die Umgebung definiert werden, werden Aktionen durch Ziele (insbesondere Widgets) bereitgestellt, um eine bestimmte Geschäftslogik zu realisieren. Je nachdem, wie das Ziel die Meldung vom Trigger behandelt, kann bei bestimmten Aktionen eine zusätzliche Konfiguration erforderlich sein. Wenn Sie zum Beispiel eine Filteraktion für ein Listen-Widget konfigurieren und der Trigger auf anderen Daten basiert, können Sie die Liste filtern, indem Sie eine Attribut- oder räumliche Beziehung herstellen. Sie können auch SQL-Bedingungen festlegen.

Unterschiedliche Ziele stellen unterschiedliche Aktionen bereit, die unterschiedlichen Triggern entsprechen. Die verfügbaren Aktionen werden angezeigt, nachdem Sie einen Trigger hinzugefügt und das Ziel ausgewählt haben. Die folgende Tabelle enthält eine Liste der Ziele mit den entsprechenden Aktionen:

ZielAktion*Trigger: Änderungen der DatensatzauswahlTrigger: Änderungen der Ausdehnung

Framework

Datensätze filtern: Nach dem Filtern sind nur noch die Daten vorhanden, die die Bedingungen für die weitere Anzeige oder Verarbeitung in der App erfüllen.

Ja

Datensätze auswählen**: Die Datensätze werden als ausgewählt markiert.

Ja

Das Widget "Karte"

Schwenken auf: Den aktuellen Maßstab und Mittelpunkt an einer bestimmten Position beibehalten.

Ja

Ja

Zoomen auf: Auf eine angegebene Position zoomen.

Ja

Ja

Aufblinken lassen: Ein Feature auf der Karte aufblinken lassen.

Ja

Filter: Nach dem Filtern sind nur noch die Daten vorhanden, die die Bedingungen für die Anzeige im Widget erfüllen.

Ja

Das Widget "Liste"

Filter: Nach dem Filtern sind nur noch die Daten vorhanden, die die Bedingungen für die Anzeige im Widget erfüllen.

Ja

Ja

Das Widget "Feature-Info"

Feature anzeigen: Pop-up-Informationen für das ausgewählte Feature anzeigen.

Ja

*Framework-Aktionen wirken sich auf jedes Widget aus, das dieselben Daten verwendet, die in der Aktion konfiguriert sind. Widget-Aktionen wirken sich nur auf das Ziel-Widget aus.

**Der ausgewählte Status eines Datensatzes wird in der gesamten App synchronisiert. Widgets können eine andere Konfiguration für die Anzeige eines ausgewählten Datensatzes besitzen.

Konfigurieren und Verwalten von Interaktionen

Interaktionen werden auf der Registerkarte Aktion der Quell-Widgets (Widgets, die Trigger bereitstellen) konfiguriert. Dazu müssen Sie den Trigger hinzufügen und auswählen, das Ziel auswählen und die Aktionen hinzufügen und auswählen. Jeder Trigger kann nur einmal hinzugefügt werden. Für einen Trigger können Sie jedoch mehrere Aktionen hinzufügen, indem Sie auf Aktion hinzufügen klicken. Aktionen für denselben Trigger finden in sequenzieller Reihenfolge statt. Die Reihenfolge der unter einem Trigger gruppierten Aktionen können Sie durch Ziehen mit der Maus ändern.

Bei bestimmten Aktionen, wie zum Beispiel Filter, Aufblinken lassen und Datensätze auswählen, ist eine zusätzliche Konfiguration erforderlich. Wenn Sie die Aktion auswählen, wird die Option Einstellungen der Aktion angezeigt. Nach der Konfiguration können Sie die Einstellungen zu einem späteren Zeitpunkt ändern, indem Sie auf die Schaltfläche Einstellungen Einstellungen der Aktion klicken. Um nach dem Hinzufügen einer Aktion eine Aktion oder ein Ziel zu ändern, müssen Sie die Aktion löschen und eine neue Aktion hinzufügen. Beim Löschen eines Triggers werden auch alle ihm hinzugefügten Aktionen gelöscht.

Beispiel für die Verwendung

Fügen Sie Aktions-Trigger hinzu, um zum Beispiel die folgenden Anforderungen an das App-Design zu unterstützen:

  • Sie möchten eine App erstellen, die zwei Karten, zwei Szenen oder eine Karte und eine Szene vergleicht, damit die Ausdehnungen der zwei Karten-Widgets immer synchronisiert sind. Sie können einmal den Trigger Änderungen der Ausdehnung beiden Widgets hinzufügen, für jedes Widget das jeweils andere Widget als Ziel auswählen und dann die Aktion Schwenken auf oder Zoomen auf auswählen.
  • Sie fügen ein Listen-Widget neben einem Karten-Widget hinzu und möchten erreichen, dass in der Liste nur die Datensätze innerhalb der aktuellen Ausdehnung der Karte angezeigt werden. Sie können einmal den Trigger Änderungen der Ausdehnung dem Karten-Widget hinzufügen, die Aktion Filter des Listen-Widgets auswählen und dann die Aktion mit einer räumlichen Beziehung zur Ausdehnung konfigurieren.
  • Sie zeigen Features in einem Karten-Widget an und möchten erreichen, dass die Details eines ausgewählten Features in einem Feature-Info-Widget angezeigt werden. Sie können einmal den Trigger Änderungen der Datensatzauswahl dem Karten-Widget hinzufügen, das Feature-Info-Widget als Ziel auswählen und dann die Aktion Feature anzeigen auswählen.