Hinzufügen von Aktionen 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

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 die 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 oder als ArcGIS-Element.

Meldungsaktionen

Experience Builder-Apps sind datengesteuert. 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 ein Listen-Widget) 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 vom Listen-Widget verwendeten Datenansicht fest. Da die Widgets datengesteuert sind, wird die Filteraktion auf die Daten auf Framework-Ebene angewendet und alle Widgets, die dieselbe Datenansicht verwenden, werden automatisch synchronisiert. Sie können auch Interaktionen zwischen Widgets definieren. Aktionen, die von einem Widget bereitgestellt werden, werden nur in diesem Widget 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
Klick auf die Schaltfläche	Ein Trigger wird ausgelöst, wenn auf das Widget "Schaltfläche" geklickt wird.
Änderungen der Datenfilterung	Ein Trigger tritt auf, wenn ein Filter auf die Datenquelle angewendet werden.
Änderungen der Ausdehnung	Ein Trigger tritt 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:

Widget "Quelle"	Klick auf die Schaltfläche	Daten wurden hinzugefügt	Änderungen der Datenfilterung	Änderungen der Ausdehnung	Änderungen der Datensatzauswahl	Datensätze erstellt
Daten hinzufügen
Schaltfläche
Diagramm
Feature-Info
Filter
Liste
Karte
Umkreissuche
Abfrage
Suchen
Tabelle
Versorgungsnetz-Verfolgung

Vorsicht:

Die Auswahl vieler Features mit dem Widget "Diagramm" oder "Karte" kann zu einer Überlastung des Triggers Änderungen der Datensatzauswahl führen, sodass in Experience Builder nicht die erwartete Aktion ausgeführt wird.

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 auf die Meldung vom Trigger reagiert, 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.

Wenn Sie eine Attributbeziehung zwischen einem Trigger-Feld und einem Aktionsfeld herstellen möchten, müssen die Datensätze im Trigger-Feld genau mit den Datensätzen im Aktionsfeld übereinstimmen, also auch die Groß- und Kleinschreibung.

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:

Tipp:

Über die Links in der Spalte Aktion unten finden Sie Beispiele für jede Aktion.

Ziel	Aktion^1	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. Beispiel: United Kingdom potential homebuilding sites
	Datensätze auswählen^2: Die Datensätze werden als ausgewählt markiert und der Ansicht "Ausgewählte Features" hinzugefügt. Beispiel: US states, counties, and census tracts
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. Beispiel: National Park Service-Trails
Widget "Karte"	Zur Karte hinzufügen: Der Webkarte oder -szene werden Daten als Layer hinzugefügt. Beispiel: Daten-Viewer
	Schwenken auf^3: Den aktuellen Maßstab und Mittelpunkt an einer bestimmten Position beibehalten. Beispiel: Birding in Boston
	Zoomen auf^4: Auf eine angegebene Position zoomen. Beispiel: Portland 2D and 3D
	Aufblinken lassen: Ein Feature auf der Karte aufblinken lassen. Beispiel: Explore New England
	Filter: Nach dem Filtern sind nur noch die Features vorhanden, die die Bedingungen für die Anzeige im Karten-Widget erfüllen. Beispiel: Places to see in Washington, D.C.
	Auf Karte zeigen^5: Die erstellten Datensätze als neuen Layer auf der Karte anzeigen. Beispiel: ArcGIS World Geocoding Service
Widget "Umkreissuche"	Position festlegen: Die Suchposition definieren und nahe gelegene Features suchen.

¹Bei Verwendung der Standardansicht als Aktionsdaten 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.

³Wenn ein Karten-Widget mit den beiden Aktionen Zoomen auf und Schwenken auf konfiguriert ist, hat die Aktion Zoomen auf Vorrang. Das heißt, wenn der Benutzer die Karte gleichzeitig schwenkt und zoomt, wird die Aktion Schwenken auf ignoriert.

⁴Wenn 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.

⁵Wenn 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.

Schaltflächenaktionen

Sie können mit dem Widget "Schaltfläche" Aktionen in anderen Widgets auslösen. Der Trigger Klick auf die Schaltfläche unterstützt derzeit die folgende Aktion.

Ziel	Aktion
Widget "Seitenleiste"	Seitenleiste umschalten: Die Seitenleiste wird geöffnet oder geschlossen.

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 ein Dataset einem bestimmten Widget übergeben (beispielsweise zum Anzeigen von Abfrageergebnissen in einer Tabelle) oder dem App-Framework übergeben (zum Exportieren von Daten).

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 Aktion angeben

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 eine Auswahl besteht.

In der folgenden Tabelle finden Sie die verfügbaren Quell-Widgets, Ziele und unterstützten Datenaktionen (Ziel: Datenaktion):

Widget "Quelle"	Framework: Exportieren	Framework: Filter festlegen	Framework: Statistiken	Wegbeschreibung: Wegbeschreibung von	Wegbeschreibung: Wegbeschreibung zu	Höhenprofil: Höhenprofil anzeigen	Karte: Schwenken auf	Karte: Auf Karte zeigen^1	Karte: Zoomen auf	Karte: Zur Karte hinzufügen^2	Umkreissuche: Position festlegen	Tabelle: Zur Tabelle hinzufügen	Tabelle: In Tabelle anzeigen^3
Analyse
Daten hinzufügen
Diagramm
Feature-Info
Liste
Karte
Karten-Layer
Umkreissuche
Abfrage
Auswählen
Tabelle

¹Wenn Sie die Aktion Auf Karte zeigen hinzufügen, können Sie die Symbole für erstellte Datensätze anpassen.

²Sie können einer Karte nicht mehrmals denselben Layer aus dem Widget "Daten hinzufügen" hinzufügen. Sobald Sie die Datenaktion Zur Karte hinzufügen mit dem Widget "Tabelle" oder "Daten hinzufügen" verwenden, verschwindet sie als Option für diesen Layer in beiden Widgets. Wenn Sie das Widget "Analyse" so konfigurieren, dass Ergebnis-Layer automatisch der Karte hinzugefügt werden, ist Zur Karte hinzufügen für diese Ergebnisse nicht als Datenaktion verfügbar.

³ Sie 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 Zur Tabelle hinzufügen 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.)

Hinweis:

Ab der im Februar 2024 veröffentlichten Version lädt Experience Builder nur benötigte Felder, um die Performance zu verbessern. Wenn ein Widget beispielsweise so konfiguriert ist, dass bestimmte Felder aus einer Datenquelle verwendet werden, lädt Experience Builder nur diese Felder. Aus diesem Grund werden nicht geladene Felder möglicherweise nicht angezeigt, wenn Sie die Datenaktion Statistiken ausführen. Wenn Sie Statistiken für weitere Felder einsehen möchten, können Sie die Datenaktion In Tabelle anzeigen oder Zur Tabelle hinzufügen verwenden. Damit zeigen Sie zur Laufzeit Daten in einem Tabellen-Widget an und nutzen die Datenaktion Statistiken des Tabellen-Widgets.

Datenaktionsebenen

Datenaktionen können sich auf bestimmte oder alle Daten eines Quell-Widgets auswirken. Datenaktionen, die sich auf alle Datensätze in einer Datenquelle auswirken, werden Aktionen auf Datenquellenebene genannt. Datenaktionen, die sich nur auf ausgewählte Datensätze, geladene Datensätze oder den aktuellen Datensatz auswirken, werden Aktionen auf Datensatzebene genannt.

Die folgende Tabelle enthält eine Liste der Quell-Widgets mit den jeweils unterstützten Datenaktionsebenen:

Widget "Quelle"	Datenquellenebene	Datensatzebene
	Alle Datensätze	Ausgewählte Datensätze	Geladene Datensätze	Aktueller Datensatz
Daten hinzufügen
Diagramm
Feature-Info
Liste
Karte
Karten-Layer
Umkreissuche
Abfrage
Auswählen
Tabelle

Die folgende Tabelle enthält eine Liste aller möglichen Ziele mit den von ihnen unterstützten Datenaktionsebenen:

Ziel	Aktion	Datenquellenebene	Datensatzebene
Höhenprofil	Höhenprofil anzeigen
Wegbeschreibung	Wegbeschreibung von
	Wegbeschreibung zu
Framework	Exportieren
	Filter festlegen
	Statistiken
Karte	Zoomen auf
	Schwenken auf
	Auf Karte zeigen
	Zur Karte hinzufügen
Umkreissuche	Position festlegen
Tabelle	Zur Tabelle hinzufügen
	In Tabelle anzeigen

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.

Führen Sie die folgenden Schritte aus, um Meldungsaktionen zu konfigurieren:

1. Klicken Sie im Fenster Aktion auf der Registerkarte Meldungsaktion auf Trigger hinzufügen.
2. 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.

3. 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.

4. Die Reihenfolge der unter einem Trigger gruppierten Aktionen können Sie durch Ziehen mit der Maus ändern.
5. Um diese konfigurierten Einstellungen später zu ändern, klicken Sie auf die Schaltfläche Einstellungen der Aktion.
6. 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.

Führen Sie die folgenden Schritte aus, um Datenaktionen zu konfigurieren:

1. 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.
2. 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.

3. 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 zur Unterstützung von Anforderungen an das App-Design Meldungsaktionen hinzu, wie zum Beispiel in den folgenden Szenarien:

• 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 Framework-Aktion Datensätze filtern auswählen, als Aktionsdaten die im Widget "Liste" konfigurierte Datenansicht festlegen und die Aktion mit einer räumlichen Beziehung zur Ausdehnung konfigurieren.

Nutzen Sie zur Unterstützung von Anforderungen an das App-Design Datenaktionen, wie zum Beispiel in den folgenden Szenarien:

• 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 Statistikdaten 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.

  Tipp:

  Wenn sich das Ziel-Widget, bei dem es sich in diesem Beispiel um das Widget "Tabelle" handelt, im Widget "Widget-Controller" befindet, wird das Ziel-Widget automatisch im Widget-Controller geöffnet, sobald der Benutzer die Datenaktion aktiviert.

• 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 ausgewählte Datensätze oder alle Datensätze exportieren.