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 Benutzer zur Laufzeit in Widgets klicken können, um dann aus einer Liste Aktionen auszuwählen, die ausgeführt werden sollen, wie beispielsweise das 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. Legen Sie dazu als Trigger Änderungen der Ausdehnung im Karten-Widget und als Aktion Datensätze filtern in der von der Liste verwendeten Datenansicht fest. Da die Widgets datenabhängig sind, wird die Filteraktion auf die Daten auf Umgebungsebene 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 Fenster 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 fünf Trigger beschrieben, die derzeit unterstützt werden:
| Trigger | Beschreibung |
|---|---|
Änderungen der Datenfilterung | Ein Trigger tritt auf, wenn ein Filter auf die Datenquelle angewendet werden. |
Ä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. |
Daten wurden hinzugefügt | Ein Trigger tritt auf, wenn mit dem Widget Daten hinzufügen eine Datenquelle hinzugefügt 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 | Daten wurden hinzugefügt | Änderungen der Datenfilterung | Änderungen der Ausdehnung | Änderungen der Datensatzauswahl | Datensätze erstellt |
|---|---|---|---|---|---|
Daten hinzufügen |
| ||||
Diagramm |
| ||||
Feature-Info |
| ||||
Filter |
| ||||
Liste |
| ||||
Karte |
|
| |||
Abfrage |
|
| |||
Suchen |
|
|
| ||
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 | Aktion1 | Trigger: Daten wurden hinzugefügt | Trigger: Änderungen der Datenfilterung | 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ählen2: Die Datensätze werden als ausgewählt markiert und der Ansicht "Ausgewählte Features" hinzugefügt. |
| |||||
Das Widget "Business Analyst" | Feature auswählen: Das Feature wird als ausgewählt markiert. |
| ||||
Widget "Höhenprofil" | Linie auswählen: Das Linien-Feature wird als ausgewählt markiert und es wird ein Höhenprofil generiert. |
| ||||
Widget "Karte" | Zur Karte hinzufügen: Der Webkarte oder -szene werden Daten als Layer hinzugefügt. |
| ||||
Schwenken auf3: Den aktuellen Maßstab und Mittelpunkt an einer bestimmten Position beibehalten. |
|
|
|
|
| |
Zoomen auf4: 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 zeigen5: Die erstellten Datensätze als neuen Layer auf der Karte anzeigen. |
|
1Bei 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).
2Der 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.
3Wenn ein Karten-Widget mit den beiden Aktionen Zoomen auf und Schwenken auf konfiguriert ist, dann hat die Aktion Zoomen auf Vorrang. Das heißt, wenn der Benutzer die Karte gleichzeitig schwenkt und zoomt, wird die Aktion Schwenken auf ignoriert.
4Wenn Sie die Aktion Zoomen auf hinzufügen, können Sie die Einstellungen für Zoom-Maßstab im Fenster Einstellungen der Aktion ändern. Wählen Sie Benutzerdefiniert aus, um den Zoomfaktor der Karte anzupassen, oder Automatisch, um den Standardmaßstab der Karte zu verwenden. Die Aktion Zoomen auf ermöglicht das Drehen von Webkarten und Webszenen und das Neigen von Webszenen.
5Wenn Sie die Aktion Auf Karte zeigen hinzufügen, können Sie die Symbole für erstellte Datensätze anpassen. Wählen Sie Benutzerdefiniertes Symbol verwenden aus, um Füllung, Umriss, Transparenz usw. für Punkte, Linien und Polygone anzupassen. Wählen Sie Im Layer definierte Symbole verwenden aus, um Symbole aus den Layern zu verwenden, die mit der aktuellen Aktion im Quell-Widget verknüpft sind.
Datenaktionen
Sie können Datenaktionen konfigurieren, mit denen Benutzer 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 Benutzer eine entsprechende Auswahl treffen
Das dem Ziel übergebene Dataset variiert abhängig vom Quell-Widget. Beispielsweise übergibt das Diagramm-Widget 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 | Framework: Filter festlegen | Karte: Schwenken auf | Karte: Auf Karte zeigen1 | Karte: Zoomen auf | Karte: Zur Karte hinzufügen | Tabelle: In Tabelle anzeigen |
|---|---|---|---|---|---|---|---|
Daten hinzufügen | Alle Datensätze | Alle Datensätze | Alle Datensätze | Alle Datensätze | Alle Datensätze | Alle Datensätze2 | |
Diagramm | Alle oder ausgewählte Datensätze (Statistikdaten) | Alle oder ausgewählte Datensätze (Statistikdaten) | |||||
Feature-Info | Alle oder ausgewählte Datensätze | Ausgewählte Datensätze | Ausgewählte Datensätze | Ausgewählte Datensätze | Ausgewählte Datensätze | ||
Liste | Alle oder ausgewählte Datensätze | Alle oder ausgewählte Datensätze | Ausgewählte Datensätze | Alle oder ausgewählte Datensätze | Alle oder ausgewählte Datensätze | ||
Karten-Layer | Alle Datensätze | Alle Datensätze | |||||
Abfrage | Alle oder ausgewählte Datensätze (Abfrageergebnis) | Alle oder ausgewählte Datensätze (Abfrageergebnis) | Alle oder ausgewählte Datensätze (Abfrageergebnis) | Alle oder ausgewählte Datensätze (Abfrageergebnis) | Alle oder ausgewählte Datensätze (Abfrageergebnis) | ||
Tabelle | Alle oder ausgewählte Datensätze | Alle oder ausgewählte Datensätze | Ausgewählte Datensätze | Alle oder ausgewählte Datensätze |
1Wenn Sie die Aktion Auf Karte zeigen hinzufügen, können Sie die Symbole für erstellte Datensätze anpassen.
2Sie können mit dem Widget "Daten hinzufügen" viele Datentypen hinzufügen, aber nur Datentypen, die von dem Widget "Tabelle" unterstützt werden (Feature-Layer und Szenen-Layer mit verknüpften Feature-Layern) können die Datenaktion In Tabelle anzeigen auslösen.
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 Benutzer 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 Widget "Liste" 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 Benutzern 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 Benutzer im Diagramm-Widget auf die Schaltfläche Aktionen klicken und In Tabelle anzeigen 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 Benutzern 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 Benutzer 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 Benutzern die Möglichkeit geben, die Daten zu exportieren. Wenn Export zulassen für die Datenquelle aktiviert ist, können sie im Widget "Tabelle" auf die Schaltfläche Aktionen klicken und auswählen, dass ausgewählte Datensätze oder alle Datensätze exportiert werden.