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

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.

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.

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.