Hinzufügen von Aktions-Triggern zu Widgets

Beim Erstellen von dynamischen und interaktiven Apps mit Experience Builder stehen Ihnen folgende Möglichkeiten zur Verfügung:

  • Verbinden von Widgets mit Daten und Konfigurieren dieser Widgets mit dynamischem Inhalt
  • Konfigurieren von Interaktionen zwischen einem Widget und dem Framework (Datenquelle)
  • 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 Interaktionen zwischen einem Widget und den Daten definieren, indem Sie die Aktionen als Reaktion auf Trigger konfigurieren. So ist es z. B. möglich, eine Interaktion so zu erstellen, dass bei einer Änderung der Ausdehnung des Karten-Widgets die anderen Widgets, z. B. der Listen-Widget, so gefiltert werden, dass nur Features in der aktuellen Ausdehnung angezeigt werden. Legen Sie hierzu die Änderungen der Ausdehnung im Karten-Widget als Trigger und den Filterdatensatz in der Datenansicht für das Listen-Widget als Aktion fest. Da die Widgets datenabhängig sind, ist die Filteraktion auf Umgebungs- und Datenebene anzuwenden, sodass jedes Widget, das dieselbe Datenansicht verwendet, automatisch synchronisiert wird. Sie können auch Interaktionen zwischen Widgets definieren. Aktionen, die von einem Widget bereitgestellt werden, werden nur innerhalb dieses Widgets wirksam. Sie können z. B. die Ausdehnung zweier Karten-Widgets synchronisieren, wenn der Benutzer eines davon zoomt oder schwenkt. Legen Sie hierzu die Änderungen der Ausdehnung eines Karten-Widgets als Trigger und die des anderen Karten-Widgets als Aktion fest.

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:

Quell-WidgetÄnderungen der AusdehnungÄnderungen der Datensatzauswahl

Karte

Ja

Ja

Feature-Info

Ja

Liste

Ja

Tabelle

Ja

Ziele

Ziele führen die Aktionen aus. Ein Ziel kann ein Widget oder das Framework sein. Wenn Sie das Framework 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 das Framework 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 eine Datenansicht konfigurieren und der Trigger auf anderen Daten basiert, können Sie die Zieldatenansicht 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 Datensätze in der Datenansicht vorhanden, die die Bedingungen für die weitere Anzeige oder Verarbeitung in der App erfüllen.

Ja

Ja

Datensätze auswählen**: Die Datensätze werden als ausgewählt markiert und der Ansicht Ausgewählte Features hinzugefügt.

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 Features vorhanden, die die Bedingungen für die Anzeige im Widget "Karte" erfüllen.

Ja

*Bei Verwendung der Aktionsdaten als Standardansicht wirkt sich die Framework-Aktion auf alle Widgets aus, die die Daten und ihre Ansichten verwenden. Wenn die Aktionsdaten eine festgelegte Ansicht darstellen, wirkt sich die Aktion nur auf die Widgets aus, die diese Ansicht verwenden. Widget-Aktionen werden nur für das Ziel-Widget ausgeführt. (So filtert die Kartenfilteraktion z. B. nur die Datensätze in der Karte und wirkt sich nicht auf die anderen Widgets aus, die denselben Layer verwenden).

**Der ausgewählte Status eines Datensatzes wird in der gesamten App synchronisiert, und die ausgewählten Datensätze werden in der Datenansicht Ausgewählte Features gespeichert. 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 den Trigger Änderungen der Ausdehnung dem Karten-Widget hinzufügen, die Aktion Datensätze filtern des Framework auswählen und dann die Aktion mit einer räumlichen Beziehung zur Ausdehnung konfigurieren.