Mit dem Abfrage-Widget können Sie Informationen aus Quelldaten abrufen, indem sie eine vordefinierte Abfrage ausführen. Die Datenquelle kann eine der folgenden sein:
- Feature-Layer in der aktuellen Karte
- Feature-Layer als Element im Portal
- Feature-Layer aus einem ArcGIS-Server-REST-Service
Tipp:
Ein Feature-Layer kann von einem Karten-Service oder einem Feature-Service stammen.
- Bilddaten-Layer aus Image-Service
- Zugehörige Tabelle
Das Abfrage-Widget dient während der Konfiguration als Abfrage-Generator, mit dem Sie die Abfrage definieren können, indem Sie die Quelldaten, einen Filterausdruck und die für die Abfrageergebnisse angezeigten Felder festlegen. Jede Abfrage arbeitet mit einem einzelnen Layer. Sie können jedoch für eine einzelne App mehrere Abfragen definieren, und die Daten-Layer können aus mehreren Quellen stammen.
Konfiguration des Abfrage-Widgets
Das Abfrage-Widget kann so eingestellt werden, dass es beim Starten der App automatisch geöffnet wird. Klicken Sie hierfür auf den gelben Punkt im Widget, der sich daraufhin grün färbt.
Die folgenden Schritte zeigen, wie Sie eine Abfrage erstellen: Wiederholen Sie diese Schritte, falls Sie mehrere Abfragen definieren müssen.
- Bewegen Sie den Mauszeiger über das Abfrage-Widget, und klicken Sie
auf das kleine Bearbeitungssymbol
.Das Konfigurationsfenster für das Widget wird geöffnet.
- Optional können Sie auf Widget-Symbol ändern klicken, wenn Sie das Standardsymbol für dieses Widget ändern möchten.
Ein Explorer-Fenster wird geöffnet, in dem Sie zu einer lokalen Bilddatei navigieren können, die Sie als Widget-Symbol verwenden möchten.
- Klicken Sie neben „Abfrage-Tasks“ auf Neu hinzufügen.
Das Fenster Datenquelle festlegen wird geöffnet. Standardmäßig ist Aus Karte auswählen ausgewählt, und darunter werden alle in der aktuellen Karte vorhandenen Feature-Layer aufgeführt.
Alternativ können auch folgende Quellen verwendet werden: Aus Portal auswählen bzw. Service-URL hinzufügen auswählen. Neben Layern können auch zugehörige Tabellen abgefragt werden.
- Aktivieren Sie die Optionsschaltfläche neben einer Datenquelle.
- Wählen Sie in der Liste einen Layer aus.
- Klicken Sie auf OK, um das Fenster „Datenquelle festlegen“ zu schließen und zum Fenster für die Abfragekonfiguration zurückzukehren.
Standardmäßig ist die Registerkarte Filterdefinition aktiv.
- Klicken Sie auf Filterausdruck hinzufügen, um den Ausdruck-Generator anzuzeigen.
- Wählen Sie ein Abfragefeld und einen Ausdruck aus, und geben Sie im Textfeld einen Wert an. Wählen Sie optional den Eintrag Eindeutig aus, um alle eindeutigen Werte für das Feld im Layer aufzulisten. Diese Option ist hilfreich, wenn es sich bei Ihrem ausgewählten Feld um eine Zeichenfolge oder eine Zahl handelt.
- Aktivieren Sie optional Werte abfragen.
- Sie haben außerdem die Option Eine Gruppe von Ausdrücken hinzufügen, mit der Sie zwei Filter definieren und auf eine einzelne Abfrage anwenden können. Je nachdem, ob in dieser Gruppe von Ausdrücken Alle oder Einige Ausdrücke wahr sein müssen, werden als Ergebnis Datensätze zurückgegeben, die alle oder einige Ausdrücke der Gruppe erfüllen.
- Klicken Sie auf die Registerkarte Ergebniseinstellung, um sie zu aktivieren. Auf dieser Registerkarte können Sie den angezeigten Titel konfigurieren und die Inhalte der Abfrageergebnisse sortieren. Die für die Anzeige verfügbaren Felder des Daten-Layers werden auf dieser Registerkarte angezeigt.
- Klicken Sie neben dem Textfeld Titel des Ergebniselements auf die Schaltfläche "Hinzufügen".
Die Liste der Felder im Layer wird angezeigt. Sie können darin jeweils eines auswählen. Werte aus dem ausgewählten Feld werden im Textfeld angezeigt und als Titel der Abfrageergebnisse verwendet. Wiederholen Sie diesen Schritt, um weitere Felder hinzuzufügen. Wenn mehrere Felder hinzugefügt werden, werden für den Ergebnistitel die Feldwerte verknüpft.
- Klicken Sie auf die Stiftschaltfläche neben Sortierung von Ergebniselementen, um die Felder zu konfigurieren, nach denen das Abfrageergebnis sortiert werden soll.
Die Services müssen die Paginierungsfunktion oder Sortierung für Abfrageergebnisse unterstützen.
- Aktivieren Sie unter Inhalt des Ergebniselements die Felder, die in den Ergebnissen angezeigt werden sollen. Mit der Spalte Besonderer Typ können Sie diese als Link oder Bild anzeigen. Sie können auch in der Spalte Aktionen auf die Pfeile klicken, um die Reihenfolge der Felder zu ändern.
- Klicken Sie auf das Symbol für die Abfrageergebnisse.
Das Vorschaufenster wird geöffnet, in dem Sie die Farbe und den Stil des Symbols für die Kennzeichnung der Ergebnisse auswählen können.
- Klicken Sie auf eine beliebige Stelle außerhalb des Symbolvorschaufensters, um es zu schließen.
- Klicken Sie auf OK, um das Abfragefenster zu schließen.
Die Abfragedefinition wird gespeichert, und das Fenster für die Abfragekonfiguration wird geschlossen.
- Bewegen Sie zum Neuanordnen der vorhandenen Aufgaben den Mauszeiger über dem Aufgabennamen, und klicken Sie auf den Pfeil Nach oben verschieben oder Nach unten verschieben. Zum Ändern eines Task-Namens klicken Sie auf den Task unter der Tasknamentabelle, aktivieren das Textfeld Task-Name, und klicken zum Bestätigen der Änderung auf eine andere Stelle im Fenster.
Bei dem Filterausdruck kann es sich um einen wertbasierten Vorgang oder einen Vorgang zwischen zwei Feldern handeln. Wenn Sie die Option Eindeutig auswählen, werden alle eindeutigen Werte für das ausgewählte Feld im Layer aufgeführt. Standardmäßig ist Wert ausgewählt.
Verwenden des Abfrage-Widgets
Wenn Sie in Ihrer App auf das Abfrage-Widget klicken, wird eine Liste der vordefinierten Abfragen angezeigt. Wenn Sie eine Abfrage auswählen, werden die Optionen für deren Ausführung angezeigt. Die folgenden Optionen sind verfügbar:
- Wenn bei der Konfiguration Werte abfragen festgelegt wurde, werden ein Textfeld und eine Aufforderung, einen neuen Wert für den Parameter einzugeben, angezeigt. Anfangs wird der Standardwert im Feld angezeigt. Wenn Einzelwerte festgelegt sind, sind sie alle im Textfeld aufgeführt.
- Räumlichen Filter verwenden – Der räumliche Filter wird am Anfang der Abfragedefinition angewendet.
- Aktuelle Kartenausdehnung verwenden – Es werden nur Features zurückgegeben, die in der aktuellen Kartenausdehnung liegen und die Abfragedefinition erfüllen.
- Eine Grafik auf der Karte darstellen – Es werden nur Features zurückgegeben, die innerhalb der Grafik liegen und die Abfragedefinition erfüllen.
- Ergebnis als operationalen Layer hinzufügen – Wenn diese Option aktiviert ist, bleiben die Abfrageergebnisse so lange auf der Karte sichtbar, bis auf die Schaltfläche Ergebnisse löschen geklickt wird.
Sie können keine oder mehrere Optionen auswählen. Klicken Sie auf Übernehmen, um die Abfrage auszuführen und die Ergebnisse anzuzeigen. Wenn der Layer über zugehörige Daten verfügt, werden die zugehörigen Datensätze ebenfalls in die Ergebnisse einbezogen. Von der Abfrage zurückgegebene Features werden auf der Karte durch das bei der Konfiguration festgelegte Symbol hervorgehoben.
Tipp:
Die maximale Anzahl an Features, die bei einer Abfrage zurückgegeben werden können, ist von der im Service festgelegten Eigenschaft maxRecordCount abhängig. Sie ist standardmäßig auf 1000 eingestellt. Wenn Sie beispielsweise den Standardwert verwenden und 1300 Features als Abfrageergebnis zurückerwarten, dann werden zunächst 1000 Features im Abfrageergebnisfenster angezeigt. Wenn Sie einen Bildlauf nach unten durchführen, sehen Sie die restlichen 300 Features.
Alternativ werden die zugehörigen Features in dem Ergebnis angezeigt, wenn die Abfrage für eine zugehörige Tabelle ausgeführt wird.