Mit dem Widget "Filtern" können Sie die Sichtbarkeit von Features in einem oder mehreren Layern auf die Features einschränken, die die Kriterien eines Ausdrucks erfüllen. Da sich die Änderungen, die in einem Widget vom Typ "Filtern" vorgenommen werden, auf die Daten in der gesamten App auswirken, werden auch weitere Widgets, die dieselben Layer verwenden, entsprechend gefiltert.
Beispiele
Verwenden Sie dieses Widget, um zum Beispiel die folgenden Anforderungen an das App-Design zu unterstützen:
- Sie haben ein umfangreiches Dataset und möchten verschiedenen Zielgruppen relevante Optionen zum Filtern der Daten nach den für sie wichtigen Kriterien bereitstellen.
- Sie möchten zulassen, dass Benutzer die Sichtbarkeit von Features in allen Widgets, die denselben Layer in Ihrer App verwenden, ändern können.
Verwendungshinweise
Das Widget "Filtern" setzt voraus, dass für jeden Filter, den Sie hinzufügen, eine Datenquelle festgelegt wurde. Damit ein Filter-Widget mit anderen Widgets interagieren kann, können Sie bestimmte Aktionen festlegen, wie zum Beispiel für das Zoomen auf das ausgewählte Feature auf einer Karte in einem Karten-Widget. Durch die Endbenutzer kann jeder Filter aktiviert oder deaktiviert werden, um die Sichtbarkeit von Features zu steuern. Wenn Sie mehrere Filter für dieses Widget konfigurieren, können Sie angeben, ob alle aktivierten Filter wahr sein müssen, damit die Daten angezeigt werden, oder ob ein beliebiger Filter wahr sein kann, damit die Daten angezeigt werden.
Einstellungen
Das Widget "Filtern" verfügt über folgende Einstellungen:
- Neuer Filter: Erstellen Sie einen Filter, indem Sie eine Datenquelle auswählen und Ausdrücke hinzufügen. Das Fenster Neuen Filter erstellen, das danach angezeigt wird, enthält die folgenden Eigenschaften:
- Daten: Wählen Sie die Daten aus, die gefiltert werden sollen. Sie können nur eine Datenquelle pro Filter auswählen. Feature-Layer, Feature-Layer in ausgewählten Webkarten, Datenansichten und Feature-Service-URLs werden unterstützt. Sie können verknüpfte Datenansichten auswählen, sofern welche in der Dropdown-Liste aufgeführt sind.
- Beschriftung: Geben Sie einen eigenen Namen für jeden Filter an.
- Symbol: Wählen Sie für jeden Filter ein anderes Symbol aus. Sie können Symbole aus den Galerien Allgemein und Pfeile auswählen oder ein eigenes 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.
- SQL-Ausdrücke: Erstellen Sie SQL-Ausdrücke zur Angabe der Filterkriterien. Der SQL-Ausdruck-Generator enthält mehrere Optionen zum Erstellen von komplexen und interaktiven Abfragen.
- Optionen: Für jeden Filter können Sie die folgenden Optionen aktivieren:
- Diesen Filter automatisch anwenden: Wenn Benutzer die App öffnen, wurde dieser Filter bereits auf die Daten angewendet. Benutzer können den Filter im Widget deaktivieren.
Hinweis:
Ist ein Filter-Widget in einem Widget-Controller geschachtelt, wird der Filter nicht automatisch auf die Daten angewendet, sondern erst dann, wenn das Widget-Fenster geöffnet wird (egal ob manuell oder per Konfiguration in den Widget-Controller-Einstellungen).
- Filterdetails (sofern vorhanden) automatisch ausblenden: Wenn der Filter so konfiguriert wurde, dass er Werte abfragen soll, muss der Benutzer mit einem Klick den Filter einblenden, damit die zusätzlichen Details angezeigt werden. (Wenn Sie viele Filter verwenden, dann sollten Sie aus Gründen der Übersichtlichkeit diese Option aktivieren.)
- Diesen Filter automatisch anwenden: Wenn Benutzer die App öffnen, wurde dieser Filter bereits auf die Daten angewendet. Benutzer können den Filter im Widget deaktivieren.
- Wenn Sie mehrere Filter hinzufügen, dann klicken Sie auf UND, um anzugeben, dass alle Filterkriterien erfüllt sein müssen, oder auf ODER, um anzugeben, dass es ausreicht, wenn ein beliebiges Filterkriterium erfüllt ist. Sie können die Filter auch ziehen, um sie zu verschieben und die Reihenfolge zu ändern.
- Anordnungs-Style: Wählen Sie die Option Vertikal, Horizontal oder Symbol aus, um den Style für die Filter in einem Widget nach Ihren Wünschen anzupassen.
- Aktivierungs-Style: Wählen Sie entweder den Style Umschaltfläche oder Schaltfläche zum Aktivieren bzw. Deaktivieren der jeweiligen Filter aus. (Der Standard-Style ist Umschaltfläche.)
- Aktivierungs-Styles für einzelne Klausel ausschließen: Wenn es in jedem Filter nur eine Klausel gibt, die Werte abfragt (oder eine Beschriftung anzeigt), können Sie mit dieser Option die Aktivierungs-Styles (zusammen mit der Beschriftung und dem Symbol) ausschließen sowie den Klauselinhalt direkt anzeigen und automatisch anwenden.
- Erweiterte Werkzeuge: Konfigurieren Sie erweiterte Werkzeuge.
- Alle Filter zurücksetzen: Nehmen Sie eine Schaltfläche auf, mit der Benutzer alle Filter auf den ursprünglich konfigurierten Zustand zurücksetzen können.
Tipp:
Das Filterwerkzeug des Listen-Widgets weist standardmäßig eine Schaltfläche zum Zurücksetzen auf.
- Alle Filter zurücksetzen: Nehmen Sie eine Schaltfläche auf, mit der Benutzer alle Filter auf den ursprünglich konfigurierten Zustand zurücksetzen können.
SQL-Ausdruck-Generator
Ein Filter durchsucht mithilfe logischer Ausdrücke einen Layer nach Features, basierend auf Attributwerten in seinen Daten. Das allgemeine Format für Ausdrücke lautet <Feldname> <Operator, der eine Bedingung angibt> <Wert oder Feld>. Beispiel: Die Kapazität von Notunterkünften ist größer als 200.
Um Ausdrücke im SQL-Ausdruck-Generator zu erstellen, klicken Sie auf Klausel hinzufügen oder Klauselsatz hinzufügen.
Der Ausdruck für jede Klausel enthält die folgenden Eingabefelder:
- Feld: Wählen Sie ein Feld der Datenquelle aus, nach dem gefiltert werden soll. Die drei Feldtypen sind Zahl, Zeichenfolge und Datum. Neben den Feldnamen werden repräsentative Symbole angezeigt.
- Operator: Wählen Sie einen Funktionsoperator zum Auswerten der Datenwerte für das ausgewählte Feld aus. Die Operatoren variieren je nach Feldtyp.
- Wert: Geben Sie einen Wert ein, oder wählen Sie ihn aus, um die Klausel zu vervollständigen. Klicken Sie auf die Schaltfläche Quellentyp auswählen , um einen Wert auszuwählen, beispielsweise "Benutzereingabe", "Feld", "Eindeutig", "Eindeutig (vordefiniert)", "Mehrere" und "Mehrere (vordefiniert)".
Hinweis:
Wenn Sie den Filter mit einer Ausgabedatenquelle verbinden, können Sie die Werte für den Filter nicht in den Einstellungen auswählen (mit Ausnahme codierter Werte). Die Liste der Werte wird zur Laufzeit dynamisch generiert, nachdem die Ausgabedaten durch das Quell-Widget erstellt wurden. Aus diesem Grund ist das Kontrollkästchen Werte abfragen standardmäßig aktiviert, und vordefinierte Werte können nur eingegeben werden.
Für jede Klausel können Sie die folgenden Optionen festlegen:
- Groß-/Kleinschreibung beachten: Um Filterkriterien zu erfüllen, muss die Verwendung der Klein- und Großschreibung in den Klauselwerten übereinstimmen. Diese Option kann nur auf Zeichenfolgenfelder in nicht gehosteten Layern angewendet werden (für gehostete Layer ist diese Schaltfläche nicht verfügbar).
- Keine Benutzereingabe: Die Klausel erfordert standardmäßig keine Benutzereingabe. Sie können die Option Beschriftung anzeigen aktivieren, um Benutzern nur die Standard- oder benutzerdefinierten Beschriftungen anzuzeigen.
- Werte abfragen: Benutzer können den Eingabe-Style anpassen, benutzerdefinierte Eingaben vornehmen und Filter zur Laufzeit ändern. Sie haben folgende Möglichkeiten:
- Wählen Sie einen Eingabe-Style aus (sofern mehrere Styles für den ausgewählten Wertequellentyp verfügbar sind).
- Passen Sie den Inhalt der Beschriftung an.
- Passen Sie die Beschriftungsposition an, und legen Sie fest, ob für die Eingabe ein Zeilenumbruch vorgenommen werden soll oder die Eingabe in derselben Zeile angezeigt werden soll.
- Geben Sie einen Hinweis oder eine Anweisung für den Benutzer an.
- Wählen Sie Kriterien für die Liste der Werte aus, die den Benutzern in den Filteroptionen angezeigt werden (die letztere Möglichkeit kann nur auf Quellen der Typen "Eindeutig" und "Mehrere" angewendet werden). Sie können alle Werte anzeigen, Werte basierend auf einem vorherigen Ausdruck filtern oder Werte basierend auf allen Ausdrücken filtern.
Hinweis:
Mit vordefinierten Werten ist das Filtern basierend auf einem Wert bzw. Werten möglich, den bzw. die Sie aus einer statischen Liste auswählen oder direkt eingeben. Standardmäßig ist Werte abfragen aktiviert, und für die Liste ist festgelegt, dass Werte basierend auf den vorherigen Ausdrücken angezeigt werden. Sie können die Werte auch ziehen, um sie zu verschieben und die Reihenfolge zu ändern.
- Duplizieren: Ermöglicht es Benutzern, eine einzelne Klausel oder einen ganzen Klauselsatz direkt zu duplizieren und das duplizierte Element der letzten Klausel in der Warteschlange im SQL-Ausdruck-Generator hinzuzufügen. Wenn sich die Klausel in einem Klauselsatz befindet, können Benutzer eine einzelne Klausel duplizieren und das Duplikat zur letzten Klausel dieses Klauselsatzes hinzufügen.
Wenn Sie dem Filter mehrere Klauseln oder Klauselsätze hinzufügen, dann klicken Sie auf UND, um anzugeben, dass alle Filterkriterien erfüllt sein müssen, oder auf ODER, um anzugeben, dass es ausreicht, wenn ein beliebiges Filterkriterium erfüllt ist. Diese Einstellung können Sie auch für die Klauseln in einem Klauselsatz konfigurieren.