Widget "Abfrage"

Mit dem Widget "Abfrage" können Sie Informationen aus einer Datenquelle abrufen, indem Sie eine Attributabfrage oder eine Abfrage mit einem räumlichen Filter ausführen. Aus den Ergebnissen einer Abfrage wird eine Ausgabedatenquelle generiert, die von anderen Widgets verwendet werden kann.

Beispiele

Verwenden Sie dieses Widget, um zum Beispiel die folgenden Anforderungen an das App-Design zu unterstützen:

  • Sie möchten Benutzern das Suchen von Features basierend auf einem Abfrageausdruck ermöglichen.
  • Sie möchten es Benutzern ermöglichen, auf einer Karte eine Form zu zeichnen und Features zurückzugeben, die sich mit dem gezeichneten Shape überschneiden.
  • Sie möchten Benutzern das Suchen von Features ermöglichen, die eine bestimmte räumliche Beziehung (wie "Überschneiden" oder "Überlappen") zu den Formen ausgewählter Features aus anderen Widgets haben.
  • Sie möchten die Ergebnisse der Abfrage verwenden, um Features für andere Widgets zu erstellen.

Verwendungshinweise

Sie müssen für jede dem Abfrage-Widget hinzugefügte Abfrage eine Datenquelle festlegen. Jede Abfrage funktioniert mit einem einzigen Layer, und Sie können mehrere Attributfilter und räumliche Filter definieren. Sie können auch mehrere Abfragen erstellen und Layer aus verschiedenen Datenquellen verwenden. Eine Abfrage kann mit oder ohne Karte konfiguriert werden. Um die von einer Abfrage in einem Karten-Widget zurückgegebenen Features anzuzeigen, können Sie entweder eine Aktion festlegen, damit die Features automatisch angezeigt werden, oder eine Datenaktion verwenden, die Benutzern das Klicken auf eine Schaltfläche ermöglicht. Zurzeit muss bei Verwendung eines Szenen-Layers stattdessen der Trigger Änderungen der Datensatzauswahl hinzugefügt werden, damit Benutzer auf ein Abfrageergebnis klicken können, um es auf der Karte hervorzuheben.

Vorsicht:

Durch den Versuch, eine räumliche Abfrage für ein sehr komplexes Feature (z. B. ein Polygon-Feature mit einer großen Anzahl von Stützpunkten) durchzuführen, kann das Widget überlastet werden, sodass keine Ergebnisse zurückgegeben werden. In diesem Fall können Sie versuchen, das Feature zu generalisieren.. Stellen Sie Compliance mit den maximalen Ressourcenbegrenzungen des Servers sicher.

Einstellungen

Das Widget "Abfrage" verfügt über folgende Einstellungen:

  • Neue Abfrage: Erstellen Sie eine Abfrage, und geben Sie im Fenster Abfrage festlegen die folgenden Einstellungen an:
    • Daten: Wählen Sie die Daten aus, die Sie abfragen möchten. Sie können nur eine Datenquelle pro Abfrage auswählen. Feature-Layer, Feature-Layer in ausgewählten Webkarten und Webszenen, Datenansichten, Ausgabedatenquellen und Feature-Service-URLs werden unterstützt.
    • Beschriftung: Geben Sie einen eigenen Namen für jede Abfrage an. Wenn ein Widget eine einzige Abfrage enthält, können Sie die Anzeigebeschriftung für die Anordnungs-Styles "Vertikal" und "Symbol" deaktivieren.
    • Symbol: Wählen Sie für jede im Widget angezeigte Abfrage und die Liste der Abfragen im Fenster "Inhalt" ein Symbol aus. Sie können Symbole aus den Galerien Allgemein und Pfeile auswählen oder ein Symbol aus einer Datei hinzufügen. Klicken Sie auf die Schaltfläche Löschen, um nicht verwendete hochgeladene Symbole zu entfernen.
      Hinweis:

      Sie können folgende Bildformate hochladen: PNG, GIF, JPG, JPEG und BMP. Um die optimale Performance zu gewährleisten, gilt ein Größenlimit von 10 MB pro Upload.

    • Attributfilter: Erstellen Sie SQL-Ausdrücke zur Angabe der Attributfilterkriterien. Der SQL-Ausdruck-Generator wird geöffnet. Er enthält mehrere Optionen zum Erstellen von komplexen und interaktiven Abfragen.
      • Beschriftung: Passen Sie die Beschriftung für den Abschnitt mit den Attributfiltern an.
      • Beschreibung: Stellen Sie Anweisungen für eine bestimmte Zielgruppe (z. B. neue Benutzer) bereit, die als Hovertext auf einem Informationssymbol angezeigt werden.
    • Räumlicher Filter: Wählen Sie aus, welche räumlichen Filter verfügbar sein sollen, und wählen Sie optional ein Karten-Widget aus.
      • Beschriftung: Passen Sie die Beschriftung für den Abschnitt mit den räumlichen Filtern an.
      • Ausgewählte Features aus Datenquelle: Geben Sie nur Features zurück, die eine räumliche Beziehung mit Features in einem anderen Layer aufweisen. Optional kann eine Entfernung auf die Geometrien der Features im zugehörigen Layer angewendet werden.
        • Regeln für räumliche Beziehungen: Wählen Sie, welche der folgenden räumlichen Beziehungen Benutzern zur Verfügung stehen sollen:
          • Überschneiden: Ein Teil eines Features aus dem Quell-Layer ist in einem Feature aus dem Filter-Layer enthalten.
          • Enthalten: Das Feature aus dem Quell-Layer ist vollständig von dem Feature aus dem Filter-Layer eingeschlossen.
          • Kreuzen: Das Feature aus dem Quell-Layer kreuzt ein Feature aus dem Filter-Layer.
          • Envelope-Überschneidung: Der Envelope des Quell-Layers überschneidet den Envelope des Filter-Layers.
          • Index-Überschneidung: Der Envelope des Abfrage-Layers überschneidet den Index-Eintrag des Filter-Layers.
          • Überlappen: Features aus dem Quell-Layer überlappen Features im Filter-Layer.
          • Berühren: Das Feature aus dem Quell-Layer berührt die Grenze eines Features aus dem Filter-Layer.
          • Innerhalb: Das Feature aus dem Filter-Layer ist vollständig von dem Feature aus dem Quell-Layer eingeschlossen.
        • Puffer aktivieren: Fügen Sie eine Suchentfernung hinzu. Sie können die Standard-Entfernung und die Einheit definieren.
      • Geometrien aus einer Karte: Geben Sie Features zurück, die sich in der aktuellen Kartenausdehnung befinden oder die eine auf der Karte gezeichnete Form überschneiden. Sie können die Zeichenwerkzeuge aktivieren bzw. deaktivieren, um die Verfügbarkeit der Werkzeuge im Widget zu steuern.
      • Beschreibung: Stellen Sie Anweisungen für eine bestimmte Zielgruppe (z. B. neue Benutzer) bereit, die als Hovertext auf einem Informationssymbol angezeigt werden.
    • Ergebnisse: Definieren Sie, wie die Abfrageergebnisse im Widget angezeigt werden.
      • Beschriftung: Passen Sie die Beschriftung für die Ergebnisliste an.
      • Auswahlmodus: Legen Sie fest, wie viele Datensätze Benutzer in der Ergebnisliste auswählen können.
        • Einzeln: Benutzer können jeweils nur einen Datensatz auswählen.
        • Mehrere: Benutzer können mehrere Datensätze auswählen.
      • Jeden Datensatz konfigurieren: Berücksichtigen Sie die Einstellungen aus den Quelldaten, oder passen Sie die Ergebnisse an, indem Sie festlegen, welche Felder aus dem Layer angezeigt werden sollen, und indem Sie eine aussagekräftige Überschrift verwenden. Wenn Sie Anpassen auswählen, werden nur die Felder, die Sie als Anzeigefelder festlegen oder in die Überschrift aufnehmen, exportiert, wenn der Benutzer den Export in JSON, CSV, GeoJSON oder ein ArcGIS-Element durchführt.
      • Standardmäßig erweitern: Aktivieren Sie dieses Kontrollkästchen, um alle Ergebnisknoten standardmäßig zu erweitern.
      • Sortieren von Datensätzen: Konfigurieren Sie, nach welchen Feldern die Ergebnisliste sortiert werden soll.
  • Anordnungs-Style: Wählen Sie die Option Vertikal, Horizontal oder Symbol aus, um den Style für Abfragen in dem Widget anzupassen.
  • Ergebnis-Style: Organisieren Sie Abfrageergebnisse horizontal oder vertikal sowie auf einer Einzelseite oder auf mehreren Seiten.
    • Datensätze pro Seite (verfügbar, wenn Sie Multipage als Paging-Style auswählen): Hiermit definieren Sie die Anzahl der Datensätze, die pro Seite angezeigt werden. Diese Zahl muss mindestens 10 sein und darf bei maximal 1.000 liegen. Zur Laufzeit können die Benutzer jetzt über ein Dropdown-Menü oder durch Eingabe einer Zahl auswählen, wie viele Ergebnisse pro Seite angezeigt werden sollen. Das Dropdown-Menü wird mit Werten gefüllt, die 100 Prozent, 50 Prozent und 33 Prozent der von Ihnen definierten Zahl entsprechen.

Optionen für Interaktionen

Das Widget "Abfrage" generiert eine Ausgabedatenquelle, die in anderen Widgets verwendet werden kann. Interaktionen mit zusätzlichen Widgets, in denen die gleiche Ausgabedatenquelle verwendet wird, werden durch Hinzufügen von Aktionen erreicht. Beispielsweise kann die Karte automatisch die Abfrageergebnisse anzeigen und auf die Features zoomen. Fügen Sie in den Einstellungen des Widgets "Abfrage" auf der Registerkarte Aktion den Trigger Datensätze erstellt hinzu, wählen Sie die Zielkarte aus, und fügen Sie Aktionen für Auf Karte zeigen und Zoomen auf hinzu.

Die Abfrageergebnisse werden in einer Liste angezeigt. Um das Element in der Liste und das entsprechende Feature auf der Karte auszuwählen, fügen Sie den Trigger Änderungen der Datensatzauswahl für das Abfrage-Widget hinzu. Wählen Sie das Ziel-Framework aus, fügen Sie die Aktion Datensätze auswählen hinzu, und konfigurieren Sie sie mit dem Feature-Layer für die Karte und den Feldern zum Binden der Verbindung zwischen den Trigger- und Aktionsdaten. Sie können auch die Aktion Zoomen auf hinzufügen, um die Karte auf das ausgewählte Feature zu zoomen.