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
Sie können zwei Arten von Aktionen zu Widgets hinzufügen: Meldungsaktionen und Datenaktionen. Meldungsaktionen überwachen Trigger und führen automatisch Aktionen aus, beispielsweise Filtern einer Liste, sodass nur Datensätze innerhalb der aktuellen Ausdehnung einer Karte angezeigt werden. Für Datenaktionen wird eine Schaltfläche Aktionen bereitgestellt, auf die Endbenutzer in Widgets zur Laufzeit klicken können, um dann in einer Liste Aktionen auszuwählen, die ausgeführt werden sollen, beispielsweise Exportieren von Datensätzen in eine Datei.
Meldungsaktionen
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 Meldungsaktionen konfigurieren, die als Reaktionen auf Trigger ausgegeben werden. Sie können zum Beispiel folgende Interaktion erstellen: Wenn sich die Ausdehnung des Karten-Widgets ändert, werden die anderen Widgets (beispielsweise eine Liste) gefiltert und zeigen nur Features innerhalb der aktuellen Ausdehnung an. Dazu legen Sie als Trigger Änderungen der Ausdehnung im Karten-Widget fest und filtern als Aktion Datensätze in der von der Liste verwendeten Datenansicht. Da die Widgets datenabhängig sind, wird die Filteraktion auf Umgebungs- und Datenebene angewendet und jedes Widget, das dieselbe Datenansicht verwendet, wird automatisch synchronisiert. 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.
Diese Interaktionen werden im Bereich Aktion des Quell-Widgets, das die Trigger bereitstellt, definiert und verwaltet. Die Konfigurationen für Meldungsaktionen 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:
| Trigger | Beschreibung |
|---|---|
Ä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. |
Datensätze erstellt | Ein Trigger tritt auf, wenn Ergebnisdatensätze im Quell-Widget geladen werden. |
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 | Datensätze erstellt |
|---|---|---|---|
Diagramm |
| ||
Feature-Info |
| ||
Liste |
| ||
Karte |
|
| |
Abfrage |
|
| |
Tabelle |
|
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:
| Ziel | Aktion* | Trigger: Änderungen der Datensatzauswahl | Trigger: Änderungen der Ausdehnung | Trigger: Datensätze erstellt |
|---|---|---|---|---|
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. |
|
| |
Datensätze auswählen**: Die Datensätze werden als ausgewählt markiert und der Ansicht Ausgewählte Features hinzugefügt. |
| |||
Karten-Widget | Schwenken auf: Den aktuellen Maßstab und Mittelpunkt an einer bestimmten Position beibehalten. |
|
|
|
Zoomen auf: Auf eine angegebene Position zoomen. |
|
|
|
|
Aufblinken lassen: Ein Feature auf der Karte aufblinken lassen. |
| |||
Filter: Nach dem Filtern sind nur noch die Features vorhanden, die die Bedingungen für die Anzeige im Karten-Widget erfüllen. |
| |||
Auf Karte zeigen: Die erstellten Datensätze als neuen Layer auf der Karte anzeigen. |
|
*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.
Datenaktionen
Sie können Datenaktionen konfigurieren, mit denen Endbenutzer zur Laufzeit Daten in der App verarbeiten können. Sie können in Quell-Widgets auf die Schaltfläche Aktionen klicken und auswählen, dass ein Dataset einem bestimmten Widget (beispielsweise zum Anzeigen von Abfrageergebnissen in einer Tabelle) oder dem App-Framework (zum Exportieren von Daten) übergeben wird.
Diese Interaktionen werden im Fenster Aktion des Quell-Widgets, das das Runtime-Dataset bereitstellt, definiert und verwaltet. Die Konfigurationen für Datenaktionen bestehen aus zwei Teilen:
- Ziele, die das Dataset empfangen (Widgets und das App-Framework)
- Datenaktionen, die vom Ziel bereitgestellt werden und nur ausgeführt werden, wenn Endbenutzer eine entsprechende Auswahl treffen
Das dem Ziel übergebene Dataset variiert abhängig vom Quell-Widget. Beispielsweise kann das Listen-Widget dem Tabellen-Widget nur ausgewählte Datensätze übergeben, und das Diagramm-Widget übergibt dem Tabellen-Widget alle Statistikdaten, unabhängig davon, ob etwas ausgewählt ist. In der folgenden Tabelle finden Sie die verfügbaren Quell-Widgets, Ziele und unterstützten Datenaktionen (Ziel: Datenaktion) sowie jeweils das Dataset, das die einzelnen Quell-Widgets für jede zutreffende Aktion übergeben.
| Quell-Widget | Framework: Exportieren | Karte: Zoomen auf | Karte: Schwenken auf | Karte: Auf Karte zeigen | Tabelle: In Tabelle anzeigen |
|---|---|---|---|---|---|
Diagramm | Alle Datensätze (Statistikdaten) | N. z. | N. z. | N. z. | Alle Datensätze (Statistikdaten) |
Feature-Info | Auswahl | Auswahl | Auswahl | Auswahl | Auswahl |
Liste | Alle oder ausgewählte Datensätze | Auswahl | Auswahl | Auswahl | Auswahl |
Abfrage | Alle Datensätze (Abfrageergebnis) | Alle Datensätze (Abfrageergebnis) | Alle Datensätze (Abfrageergebnis) | Alle Datensätze (Abfrageergebnis) | Alle Datensätze (Abfrageergebnis) |
Tabelle | Alle oder ausgewählte Datensätze | Auswahl | Auswahl | Auswahl | N. z. |
Wenn eine Datenaktion für ein Ziel-Widget ausgeführt wird, enthält das Ziel-Widget eine Schaltfläche zum Löschen seines Inhalts. Wenn zum Beispiel Endbenutzer Daten in einem Listen-Widget auswählen und dann auswählen, dass die Auswahl in einem Tabellen-Widget angezeigt werden soll, wird neben dem neuen Tabellenblatt eine Schaltfläche angezeigt, über die sie das Tabellenblatt aus der Tabelle entfernen können. Entsprechend wird bei Auswahl der Datenaktion Auf Karte zeigen in der Karte eine Schaltfläche zum Löschen der Daten in der Karte angezeigt. (Beim Aktualisieren der Seite werden alle Ergebnisse. der Datenaktion gelöscht.)
Konfigurieren von Interaktionen
Sie können Meldungsaktionen und Datenaktionen im Fenster Aktion der Quell-Widgets konfigurieren.
Konfigurieren von Meldungsaktionen
Meldungsaktionen werden in den Einstellungen der Quell-Widgets (der Widgets, die Trigger bereitstellen) konfiguriert.
- Klicken Sie im Fenster Aktion auf der Registerkarte Meldungsaktion auf Trigger hinzufügen.
- Dazu müssen Sie den Trigger auswählen, das Ziel auswählen und die Aktionen hinzufügen und auswählen.
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. Jeder Trigger kann nur einmal hinzugefügt werden.
- Um mehrere Aktionen für denselben Trigger hinzuzufügen, klicken Sie auf Aktion hinzufügen.
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.
- Um diese konfigurierten Einstellungen später zu ändern, klicken Sie auf die Schaltfläche Einstellungen
der Aktion. - Um nach dem Hinzufügen einer Aktion eine Aktion oder ein Ziel zu ändern, löschen Sie die Aktion und fügen Sie eine neue hinzu.
Beim Löschen eines Triggers werden auch alle ihm hinzugefügten Aktionen gelöscht.
Konfigurieren von Datenaktionen
Datenaktionen werden in den Einstellungen der Quell-Widgets konfiguriert, mit Ausnahme der Aktion Exportieren, die im Fenster Daten für die Datenquelle konfiguriert wird. Datenaktionen sind standardmäßig aktiviert, und die Schaltfläche Aktionen des Widgets enthält automatisch alle verfügbaren Datenaktionen.
- Aktivieren oder deaktivieren Sie im Fenster Aktion auf der Registerkarte Datenaktion die Kontrollkästchen der Datenaktionen, um die Optionen für das Aktionsmenü des Widgets anzugeben. Deaktivieren Sie anderenfalls die Option Datenaktion aktivieren, um die Schaltfläche Aktionen vom Widget auszuschließen.
- Wählen Sie für jede aktivierte Datenaktion Ziel-Widgets aus, mit denen das Quell-Widget, beispielsweise ein Karten-Widget, interagieren soll.
Sie können nur Ziel-Widgets auswählen, die sich auf der gleichen Seite wie das Quell-Widget befinden.
Hinweis:
Wenn Sie einer Seite ein Ziel-Widget hinzufügen, werden dessen entsprechende Datenaktionen automatisch verfügbaren Quell-Widgets auf der gleichen Seite hinzugefügt.
Tipp:
Die besten Ergebnisse erzielen Sie, wenn Sie das Quell-Widget neben dem Ziel-Widget positionieren, da Datenaktionen nicht an die Zielposition in der Karte springen.
- Um die Datenaktion Exportieren auszuschließen, wechseln Sie zum Fenster Daten und deaktivieren Export zulassen für die Datenquelle.
Beispiel für die Verwendung
Fügen Sie Meldungsaktionen 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 der Umgebung auswählen, die Aktionsdaten als die im Listen-Widget konfigurierte Datenansicht auswählen und die Aktion mit einer räumlichen Beziehung zur Ausdehnung konfigurieren.
Verwenden Sie Datenaktionen, um zum Beispiel die folgenden Anforderungen an das App-Design zu unterstützen:
- Sie fügen ein Diagramm-Widget hinzu, das eine Reihe numerischer oder qualitativer Daten als Diagramm darstellen soll, und Sie möchten Endbenutzern die Möglichkeit geben, durch das Diagramm generierte statistische Daten in einem Tabellen-Widget anzuzeigen. Wenn Sie ein Tabellen-Widget neben dem Diagramm-Widget hinzufügen, wird dem Diagramm-Widget automatisch die Datenaktion In Tabelle anzeigen hinzugefügt. Zur Laufzeit können die Endbenutzer im Diagramm-Widget auf die Schaltfläche Aktionen klicken und Anzeigen in Tabelle auswählen, um die statistischen Daten im Tabellen-Widget anzuzeigen.
- Sie fügen ein Listen-Widget hinzu, um einen Datensatz anzuzeigen und ein Karten-Widget, um einen anderen Datensatz anzuzeigen. Sie möchten Endbenutzern die Möglichkeit geben, ein Feature in der Karte anzuzeigen, das einem in der Liste ausgewählten Datensatz entspricht, um verschiedene Daten in einer Karte zu vergleichen. Zur Laufzeit können die Endbenutzer im Listen-Widget auf die Schaltfläche Aktionen klicken und Auf Karte zeigen auswählen.
- Sie zeigen Datensätze in einem Tabellen-Widget an, und möchten Endbenutzern die Möglichkeit geben, die Daten zu exportieren. Wenn Export zulassen für die Datenquelle aktiviert ist, können sie im Tabellen-Widget auf die Schaltfläche Aktionen klicken und auswählen, dass ausgewählte Datensätze oder alle Datensätze (max. 5.000) exportiert werden sollen.