Das Widget "Gruppenfilter" ermöglicht Ihnen die Anwendung eines Filters auf die Karte basierend auf einem oder mehreren Layern in der Karte. Verschiedene Layer sind in einem logischen Filtersatz gruppiert. Jeder Satz kann einen vordefinierten Wert aufweisen, um die Benutzerinteraktion zu vereinfachen. Dieses Widget verfügt über zwei Modi: den Normalmodus, der die Erstellung komplexer Filter während der Laufzeit ermöglicht, und einen einfachen Modus, der nur einen anzuwendenden Filter zulässt.
Konfigurieren des Widgets "Gruppenfilter"
Dieses Widget kann so eingestellt werden, dass es beim Starten der App automatisch geöffnet wird. Klicken Sie auf die Schaltfläche Dieses Widget beim Starten der App nicht öffnen 
auf dem Widget, um die Option zum automatischen Öffnen des Widgets zu aktivieren. (Für Widgets, die Sie zuerst zur App hinzufügen müssen, können Sie diese Einstellung nach dem Konfigurieren des Widgets vornehmen.)
Die folgenden Schritte zeigen, wie Sie einen Filtersatz erstellen: Wiederholen Sie diese Schritte, falls Sie zusätzliche Filtersätze definieren müssen.
- Zeigen Sie mit der Maus auf das Widget, und klicken Sie auf die Schaltfläche Dieses Widget konfigurieren
, um das Konfigurationsfenster zu öffnen.Hinweis:
Wenn Sie das Widget zuerst zur App hinzufügen möchten, klicken Sie auf einen Widget-Platzhalter auf der Registerkarte Widget. Wählen Sie das Widget im daraufhin angezeigten Fenster Widgets auswählen aus, und klicken Sie auf OK.
- Klicken Sie optional auf Widget-Symbol ändern, wenn Sie das Standardsymbol für dieses Widget ersetzen möchten.Ein Explorer-Fenster wird angezeigt, in dem Sie eine lokale Bilddatei auswählen können, die Sie als Widget-Symbol verwenden möchten.
Die Konfiguration zeigt eine Gruppe an, die geändert werden kann.
- Definieren Sie einen Filtersatznamen.
Dies ist der Name, aus dem ein Benutzer auswählt. Sie können auch eine Beschreibung mit näheren Informationen dazu bereitzustellen, was mit dieser Gruppe gefiltert wird.
- Verwenden Sie optional Voreingestellter Operator und Voreingestellter Wert, um einen Wert für diesen Filter zu definieren, sodass diese Kriterien nicht während der Laufzeit von den Benutzern angegeben werden müssen. Für Voreingestellter Wert können Sie einen Wert eingeben oder auf die Suchschaltfläche klicken, um einen Wert aus einem vorhandenen Layer auszuwählen.
- Wenn Sie nach verschiedenen Feldern im selben Layer filtern, können Sie steuern, wie diese Felder verbunden werden. Legen Sie dazu im Parameter Wenn ein Layer mehrmals aufgelistet ist fest, ob alle Ausdrücke übereinstimmen müssen oder ein beliebiger Ausdruck.
- Aktivieren Sie für Suche durchführen, bei der Groß- und Kleinschreibung berücksichtigt wird das Kästchen, wenn nur Features zurückgegeben werden sollen, deren Attributwerte genau mit der Sucheingabe – inklusive Groß- und Kleinschreibung – übereinstimmen.
- Wählen Sie aus der angezeigten Tabelle mit den Layern des Filtersatzes (inklusive einem Satz, der standardmäßig mit einem zufällig ausgewählten Layer der Karte gefüllt wird) den Layer und das Feld aus, auf die Sie einen Filter anwenden möchten.
- Wählen Sie die Schaltfläche Wert verwenden aus, die es Ihnen ermöglicht, festzulegen, ob eine Dropdown-Liste mit Werten angezeigt werden soll, in der der Benutzer einen Wert suchen kann. Wenn die Option nicht ausgewählt ist, wird stattdessen eine einfache Textdatei angezeigt.
Hinweis:
Diese Schaltfläche ist optional.
- Um dieser Liste einen anderen Layer hinzuzufügen, klicken Sie auf die Schaltfläche Layer hinzufügen.
- Um einen anderen Filtersatz hinzuzufügen, klicken Sie auf die Schaltfläche Eine neue Gruppe hinzufügen. Dabei wird eine andere Filtersatzgruppierung erstellt. Wiederholen Sie bei Bedarf die Schritte 3 bis 7.
- Geben Sie den benutzerdefinierten Kopfzeilentext in das Textfeld Text für die Anzeige über der Filterauswahl eingeben ein.
- Mit den folgenden sechs Kontrollkästchen wird das Verhalten des Widgets gesteuert:
- Mit In einfacher Ansicht starten wird festgelegt, wie das Widget Endbenutzern angezeigt wird. Durch die Aktivierung dieses Feldes werden die Dropdown-Liste "Operator" und die Schaltfläche Kriterien hinzufügen von der Benutzeroberfläche entfernt, sodass sie ein einfacheres Aussehen erhält.
- Mit Widget-Optionen ausblenden wird festgelegt, ob ein Symbol für die Bereitstellung zusätzlicher Widget-Einstellungen angezeigt werden soll. Diese Einstellungen umfassen das Speichern und Laden definierter Filter, das Anhängen an eine vorhandene Filterdefinition in der Karte, falls vorhanden, und das Beibehalten des Filters, auch nachdem das Widget geschlossen wurde.
- Wenn auf die Webkarte ein vorhandener vordefinierter Filter angewendet wurde, können Sie mit Alle/Einige Ausdrücke an vorhandenen Kartenfilter anhängen Filter, die in diesem Widget erstellt wurden, an den vorhandenen Webkartenfilter anhängen. Durch diese Einstellung werden Filter für mehrere Gruppen beibehalten. Wenn sie nicht aktiviert ist, wird der Webkartenfilter standardmäßig von diesem Widget überschrieben.
- Beliebig ist eine additive Option: Der konfigurierte Filter wird dem Webkartenfilter hinzugefügt.
- Alle ist eine exklusive Option: Es werden nur Features angezeigt, die sowohl den Bedingungen des konfigurierten Filters als auch des Webkartenfilters entsprechen.
- Zoomen auf legt fest, ob auf die Karte auf die Ausdehnung der gefilterten Daten gezoomt werden soll. Die Karte hält die aktuelle Ausdehnung standardmäßig bei.
- Mit Nach dem Schließen des Widgets beibehalten können Sie den Filter beibehalten, wenn das Widget geschlossen wurde.
Auswahl für Kopfzeile und Filter ausblenden, wenn nur 1 Gruppe konfiguriert ist ermöglicht das Ausblenden der Kopfzeile und des Dropdown-Menüs, wenn nur eine Gruppe konfiguriert ist.
Verwenden des Widgets "Gruppenfilter"
- Durch Klicken auf das Widget Gruppenfilter wird eine Auswahl vordefinierter Filtersätze angezeigt.
Unter der Linientrennung werden zwei Listen angezeigt: Operatoren und Werte. In diesem Beispiel ist die Karte ausschließlich nach Beschwerden zu zurückgelassenen Fahrzeugen gefiltert.
Hinweis:
Je nachdem, wie die Layer im Widget konfiguriert sind, wird eine Liste mit Werten wie in diesem Beispiel, ein Textfeld für die Benutzereingabe oder eine Datumsauswahl angezeigt.
- Klicken Sie auf Übernehmen, um den Filter auf die Karte anzuwenden.
Sie können optional Filter anwenden, indem Sie der App-URL URL-Parameter hinzufügen. Die URL muss im folgenden Format vorliegen – ersetzen Sie die Variablen in spitzen Klammern durch die Werte in der folgenden Liste:
https://<URL Ihres Portals>/apps/webappviewer/index.html?id=<Element-ID>&groupfilter={"<Name des Filtersatzes>":["<value>","<value>",...]}- Element-ID: Die eindeutige ID der App
- Filtersatzname: Der für die Filtergruppe definierte Name. Bei diesem Wert muss die Groß-/Kleinschreibung berücksichtigt werden.
- Wert: Der Wert, den der Filter für die Ausführung verwendet. Verwenden Sie zum Filtern auf Basis von Domänen den Domänencode.
Um beispielsweise den Filter im vorhergehenden Bild anzuwenden, verwenden Sie eine URL wie im folgenden Beispiel:
https://<your portal URL>/apps/webappviewer/index.html?id=6815e148ff1c4aee8dc7159816380a4d&groupfilter={"Group A":["Abandoned Motor Vehicle"]}Hinweis:
Wenn das Widget "Gruppenfilter" nicht so konfiguriert ist, dass es automatisch beim Starten der App geöffnet wird, wird der in der URL definierte Filter erst beim Öffnen des Widgets angewendet.
- Klicken Sie auf Zurücksetzen, um den Filter zu entfernen und die Karte in ihren ursprünglichen Zustand zurückzusetzen. (Beim Schließen des Widgets wird standardmäßig auch der Filter entfernt.)
- Das Widget ermöglicht es Ihnen, zusätzliche Filterkriterien während der Laufzeit hinzuzufügen. Klicken Sie auf Kriterien hinzufügen, um eine andere Klausel hinzuzufügen. Beachten Sie, dass die beiden Kriterien mit einer Konjunktion verbunden werden. Sie können mit ODER oder UND verbunden werden.
Ihre URL-Parameter zum Ausführen des in diesem Beispiel angezeigten Filters sehen wie im folgenden Beispiel aus:
https://<your portal URL>/apps/webappviewer/index.html?id=6815e148ff1c4aee8dc7159816380a4d&groupfilter={"Group A":["Abandoned Motor Vehicle","Auto Theft"]} - Das Widget verfügt über eine Speicheroption, um diese definierten Kriterieneinstellungen für die zukünftige Verwendung zu speichern. Klicken Sie auf die Schaltfläche "Einstellungen", um auf den Optionsbereich zuzugreifen.
- Klicken Sie auf Speichern, um die definierten Kriterien lokal als JSON-Textdatei zu speichern.
- Verwenden Sie Gespeicherte Datei hochladen, um eine zuvor gespeicherte Datei zu laden und alle darin definierten Kriterien wiederherzustellen.
- Wenn Sie die gefilterte Karte in anderen Widgets verwenden müssen, aktivieren Sie die Option Nach dem Schließen des Widgets beibehalten. Andernfalls werden beim Schließen des Widgets die Filter entfernt und der ursprüngliche Zustand der Karte wiederhergestellt.