Widget "Suchen"

Mit dem Widget "Suchen" können Sie ein Suchwerkzeug konfigurieren, um Features, Datensätze oder Standorte basierend auf bestimmten Layern und Locators zu finden. Außerdem können Sie definieren, wie Suchergebnisse angezeigt werden. Wenn Sie dem Widget mehrere Suchquellen hinzufügen, können Benutzer wählen, welche Quellen durchsucht werden sollen. Die Suche mit einer Layer-Quelle bezieht sich auf Daten in Ihrer gesamten App, sodass andere Widgets, die denselben Layer verwenden, gefiltert werden, um das entsprechende Suchergebnis anzuzeigen. Wenn Suchergebnisse ausgewählt werden sollen, können Sie eine Aktion festlegen. Wenn Features ohne Filterung der Daten ausgewählt werden sollen, erstellen Sie eine Datenansicht für die Datenquelle, die Sie als Layer-Quelle verwenden können. Durch die Suche mit einer Locator-Quelle wird eine Ausgabedatenquelle generiert, die von anderen Widgets verwendet werden kann.

Benutzer geben für die Suche ein Wort oder einen Ausdruck in das Suchfeld ein und drücken die EINGABETASTE, klicken auf die Suchschaltfläche oder wählen aus einer Liste von Vorschlägen, die auf der Grundlage passender Datensätze angezeigt werden. (Die Vorschlagsliste zeigt jeden übereinstimmenden Wert als ein Element an. Wenn ein Datensatz zwei Felder enthält, die mit dem Suchbegriff übereinstimmen, wird dieser Datensatz zweimal angezeigt.) Benutzer können mit den Tasten NACH OBEN und NACH UNTEN die Vorschlagsliste durchsuchen. Wenn Sie auf einen Vorschlag klicken, wird der Suchbegriff durch den Inhalt des vorgeschlagenen Elements ersetzt. Die Suche wird daraufhin mit dem neuen Wert durchgeführt, und entsprechende Daten werden in einem Ergebnisfenster angezeigt. Diesen Vorgang können Sie durch Aktivieren einer Einstellung optimieren, mit der automatisch das erste Suchergebnis ausgewählt wird. Sie können das Widget auch so konfigurieren, dass eine andere Seite in Ihrer App geöffnet wird, um das Ergebnis in einem anderen Widget anzuzeigen.

Beispiele

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

• Sie möchten in Ihrer App eine Suchoption konfigurieren, die mehr Flexibilität bietet als das Suchwerkzeug der Widgets "Karte", "Liste" und "Tabelle". Insbesondere möchten Sie begrenzte Felder für bestimmte Layer in der Karte durchsuchen, eindeutige Hinweistexte im Suchfeld angeben und Werte für bestimmte Datenfelder im Ergebnisfenster anzeigen.
• Benutzer sollen zu ihrer Suche Informationen aus verschiedenen Quellen finden.
• Die Suchergebnisse sollen in anderen Widgets auf einer anderen Seite in Ihrer App angezeigt werden.

Verwendungshinweise

Das Widget "Suchen" unterstützt zwei Arten von Suchquellen: Layer und Locators. Um eine Locator-Quelle zu verwenden, fügen Sie einen Locator-Service hinzu. Sie können Locators verwenden, die in den Organisationseinstellungen angegeben sind oder die Sie im Fenster Dienstprogramm auswählen hinzugefügt haben. Um Layer zu durchsuchen, wählen Sie Feature-Layer und Szenen-Layer, die Ihrer App als Daten hinzugefügt wurden.

Wenn Sie mehrere Suchquellen konfigurieren, können Benutzer zur Laufzeit das Dropdown-Menü verwenden, um einzelne Quellen zu aktivieren bzw. zu deaktivieren, oder das Kontrollkästchen Alle verwenden, um alle Quellen zu aktivieren bzw. zu deaktivieren.

Sie können Aktionen festlegen, um automatische Interaktionen zwischen dem Widget "Suchen" und anderen Widgets herzustellen. Sie können z. B. eine Karte auf das ausgewählte Ergebnis zoomen lassen oder Suchergebnisse aus einer Locator-Quelle auf einer Karte anzeigen.

Wenn Sie ein Such- und ein Karten-Widget mit demselben Feature-Layer verbinden und in den Einstellungen des Karten-Widgets die Einstellung Pop-up bei Auswahl eines Features anzeigen aktivieren, werden Pop-ups angezeigt, wenn Sie Datensätze in den Suchergebnissen auswählen.

Suchmethoden

Das Widget "Suchen" verwendet verschiedene Methoden zum Abrufen von Suchvorschlägen und Suchergebnissen.

Das Widget nutzt die Volltextsuche, um Suchvorschläge für Layer-Quellen zu generieren. Die Volltextsuche ist eine effiziente Suchmethode, bei der Volltext-Feldindizes verwendet werden, die Datensätze in kleine Einheiten, z. B. einzelne Wörter, unterteilen. Stellen Sie sich zum Beispiel vor, Sie haben einen Layer mit Postämtern in den Vereinigten Staaten, der ein Namensfeld mit den Namen aller Postämter enthält. Der Index unterteilt den Namen "Highland Station Baltimore Post Office" in fünf einzeln suchbare Wörter: Highland, Station, Baltimore, Post und Office. Wenn Sie einen Suchausdruck eingeben, der aus einer beliebigen Kombination dieser Wörter besteht (oder nur aus dem ersten Teil dieser Wörter), z. B. Baltimore Office, Highland Baltimore oder Stat Balt Office, erhalten Sie dieses Postamt in den Suchvorschlägen.

Volltextfeldindizes werden automatisch für gehostete Feature-Layer generiert, wenn Sie diese als Suchfelder für das Widget "Suchen", "Liste" oder "Tabelle" auswählen, sofern Sie der Besitzer des gehosteten Feature-Layers oder ein Organisationsadministrator sind. Sie können auch manuell Indizes zu Attributfeldern auf der Seite mit Layer-Elementdetails hinzufügen.. Wenn Sie über Layer ohne Indizes verfügen und nicht berechtigt sind, die Layer zu bearbeiten, sucht das Widget "Suchen" nach Vorschlägen mithilfe von START WITH abc%, d. h. das Widget sucht nach Datensätzen, die mit dem Suchausdruck beginnen. Dies ist eine weniger effiziente Suchmethode.

Zum Abrufen von Suchergebnissen verwendet das Widget CONTAIN %abc%, d. h. der Suchausdruck kann an beliebiger Stelle im Datensatz stehen. Sie können z. B. nach alt suchen, um "Baltimore", "Salt Lake City" und "Alton" als Suchergebnisse zu erhalten.

Vorsicht:

Die Volltextsuche ist neu in der Experience Builder-Version von Oktober 2023 und ist eine grundlegende Änderung. Vor dieser Version wurde im Widget CONTAIN %abc% verwendet, um sowohl Vorschläge als auch Ergebnisse abzurufen. Bei der Volltextsuche werden jedoch keine Suchausdrücke mitten in Wörtern gefunden, anders als bei CONTAIN %abc%-Abfragen. Im obigen Beispiel wird bei der Suche nach altimor oder ighlan nicht das erwartete Postamt in den Suchvorschlägen angezeigt. Erfahren Sie mehr über das Suchen nach Features in Karten und Apps.

Einstellungen

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

• Neue Suchquelle: Fügen Sie Quellen zum Durchsuchen von Inhalten hinzu. Wählen Sie Layer-Quelle oder Locator-Quelle, und legen Sie jeweils die folgenden Einstellungen fest:
  • Daten: Wählen Sie ggf. die Datenquelle für den Feature-Layer aus, die Benutzer durchsuchen sollen. In den Einstellungen der Datenansicht können Sie die Daten filtern, um den Suchbereich zu beschränken, oder die Daten sortieren, um Suchergebnisse in einer bestimmten Reihenfolge anzuzeigen.
  • Locator-URL: Verbinden Sie einen Locator-Utility-Service. Im Fenster Dienstprogramm auswählen werden die Locators angezeigt, die in den Organisationseinstellungen angegeben sind oder die Sie im Fenster Utility-Service hinzugefügt haben.
  • Beschriftung: Geben Sie einen Namen für die Suchquelle ein. Der Name wird im Suchmenü, in der Vorschlagsliste und im Ergebnisfenster angezeigt.
  • Symbol: Wählen Sie ein Symbol für die Quelle. Das Symbol wird in der Vorschlagsliste und im Fenster mit den Suchergebnissen angezeigt. 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.

  • Suchoptionen: Sie können die folgenden zusätzlichen Optionen festlegen:
    • Suchfelder auswählen (nur Layer-Quellen): Wählen Sie mindestens ein Feld im Layer aus, das durchsucht werden soll.
    • Exakte Übereinstimmung (nur Layer-Quellen): Beschränkt die Suchergebnisse auf die Datensätze, die genau mit dem Suchausdruck übereinstimmen.
    • Felder anzeigen: Wählen Sie mindestens ein Feld aus, das im Suchergebnisfenster angezeigt werden soll. Sie können ausgewählte Felder durch Ziehen neu anordnen.
    • Hinweis: Geben Sie den Hinweistext ein, der im Suchfeld angezeigt wird, wenn Benutzer nur diese Quelle zum Durchsuchen auswählen.
• Filtern bei der Suche nach Layer-Quellen aktivieren: Wenn diese Einstellung bei der Suche aktiviert ist, filtert das Widget die verbundenen Layer-Quellen nach den angegebenen Suchkriterien.
• Allgemeine Suchoptionen: Sie können die folgenden allgemeinen Suchoptionen festlegen:
  • Hinweis zu mehreren Suchquellen: Passen Sie den Hinweistext an, der im Suchfeld angezeigt wird, wenn Benutzer in mehreren Quellen suchen.
  • Suchvorschlag: Definieren Sie die maximale Anzahl von Vorschlägen, die für jede Suchquelle angezeigt werden sollen. Sie können auch folgende Optionen konfigurieren:
    • Aktuelle Position verwenden: Fügen Sie eine Vorschlagsoption hinzu, um bei der Suche den Standort des Benutzers zu berücksichtigen.
    • Letzte Suchvorgänge: Zeigen Sie im Vorschlagsfeld den Suchverlauf basierend auf einer festgelegten Anzahl kürzlicher Suchvorgänge an. (Benutzer können den Suchverlauf löschen.)

    Tipp:

    Legen Sie Maximale Anzahl von Vorschlägen pro Quelle auf 0 fest, um Vorschläge für Suchquellen zu deaktivieren.

• Suchergebnis: Zeigen Sie ein Suchergebnisfenster oder einen Link zu einer Seite in Ihrer App an, um die Ergebnisse in einem anderen Widget darzustellen.
  • Ergebnisfenster: Zeigen Sie die Suchergebnisse in einem Fenster unter dem Suchfeld an. Sie können festlegen, wie viele Suchergebnisse pro Suchquelle maximal angezeigt werden. Außerdem können Sie angeben, dass das erste Ergebnis automatisch ausgewählt wird.
  • Link festlegen: Fügen Sie einen Link hinzu, über den eine bestimmte Seite, ein bestimmtes Fenster oder eine bestimmte Abschnittsansicht in der App geöffnet werden oder ein Bildlauf zu einem bestimmten Block oder zum Seitenanfang durchgeführt werden kann, um relevante Suchergebnisse in einem entsprechenden Widget anzuzeigen. Diese Einstellung wird angezeigt, wenn die Option Ergebnisfenster deaktiviert ist.
  • Style: Wählen Sie einen Style für die Oberfläche des Ergebnisfensters aus: Klassisch oder Kompakt. Beim Style Kompakt ist die Schaltfläche "Ausblenden" im unteren Fensterbereich kleiner.
• Anordnungs-Style: Wählen Sie eine Bedienoberfläche für das Widget aus, entweder Quadratisch, Kurve oder Linear

Optionen für Interaktionen

Wenn Sie für das Widget "Suchen" Meldungsaktionen konfigurieren, können Sie abhängig von der Suchquelle aus den folgenden Triggern auswählen:

Trigger	Layer-Quelle	Locator-Quelle
Änderungen der Datensatzauswahl
Datensätze erstellt
Änderungen der Datenfilterung

In der Konfiguration mit einer Locator-Quelle generiert das Widget "Suchen" 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 Suchergebnisse anzeigen und auf die Features zoomen. Fügen Sie in den Einstellungen des Widgets "Suchen" 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.

Um ein Feature auf einer Karte auszuwählen, das einem ausgewählten Suchergebnis entspricht, fügen Sie den Trigger Änderungen der Datensatzauswahl für das Widget "Suchen" hinzu (wenn das Ergebnisfenster konfiguriert ist). 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. Zusätzlich können Sie die Aktion Zoomen auf hinzufügen, um die Karte auf das Feature zu zoomen.

Wenn eine Layer-Quelle konfiguriert ist und die Karte auf das ausgewählte Suchergebnis gezoomt oder geschwenkt werden soll, fügen Sie den Trigger Änderungen der Datenfilterung hinzu, wählen Sie die Zielkarte aus, und fügen Sie die Aktionen Schwenken auf und Zoomen auf hinzu.

Um den Zoomfaktor für die Aktion Zoomen auf anzupassen, ändern Sie den Zoom-Maßstab in Benutzerdefiniert, und geben Sie den gewünschten Maßstab an.

Tipp:

Wenn das Feature im Widget "Suchen" ohne Filterung der Daten ausgewählt werden soll, erstellen Sie eine Datenansicht für die Datenquelle, die Sie als Layer-Quelle verwenden können.

URL-Parameter

In den folgenden Unterabschnitten werden suchbezogene URL-Parameter beschrieben. Sie können die Einstellungen unter URL-Status verwalten verwenden, damit diese Parameter in der URL angezeigt werden, wenn der Benutzer eine Suche durchführt. Die Parameter des Widgets "Suche" folgen auf Hash-Zeichen (#).

Anzeigen der Sucheingabe

Der Parameter searchText zeigt an, welchen Text der Benutzer eingegeben hat, um eine Suche durchzuführen. Beispiel für eine URL mit dem Parameter searchText:

https://experience.arcgis.com/experience/<AppId>#<searchWidgetID>=search_status:%7B"searchText"%3A"<text>"%7D

Anzeigen der Suchquelle

Wenn der Benutzer eine Suche durchführt und dabei nur einige der verfügbaren Suchquellen verwendet, wird einer der beiden folgenden Parameter in der URL angezeigt:

• Wenn mindestens eine Suchquelle im Dropdown-Menü des Widgets zur Laufzeit nicht aktiviert ist, wird der Parameter serviceEnabledList angezeigt, der definiert, welche Suchquellen aktiviert sind. Dieser Parameter ist ausgeblendet, wenn alle Suchquellen aktiviert sind. Beispiel für eine entsprechend codierte URL:

  https://experience.arcgis.com/experience/<AppId>#<searchWidgetID>=search_status:%7B"serviceEnabledList"%3A%5B"<SourceID1>"%2C"<SourceID2>"%5D%7D

• Wenn der Benutzer auf einen Suchvorschlag klickt, um eine Suche anzuwenden, wird der Parameter "status":{"configId":"<SourceID>"} angezeigt. Er definiert die eindeutige Suchquelle, die bei der aktuellen Suche verwendet wird. Sowohl die Sucheingabe als auch die Suchquelle werden in der URL angezeigt. Beispiel für eine entsprechend codierte URL:

  https://experience.arcgis.com/experience/<AppId>#<searchWidgetID>=search_status:%7B"searchText"%3A"<text>"%2C"status"%3A%7B"configId"%3A"<SourceID>"%7D%7D

Wenn der Benutzer auf einen Suchvorschlag aus einer Locator-Quelle klickt, wird in der URL die mit dem Vorschlag verknüpfte magicKey angezeigt. Eine magicKey ist eine eindeutige ID, die einen Vorschlag mit einer bestimmten Adresse oder einem bestimmten Ort verknüpft. Beispiel für Sucheigenschaften und -parameter im JSON-Format:

{
	"searchText": "<text>",
	"status":{
		"configId": "<SourceID>",
		"magicKey": "<key>"
	}
}

Beispiel für dieselben Eigenschaften und Parameter wie oben in einer codierten URL:

https://experience.arcgis.com/experience/<AppId>#<searchWidgetID>=search_status:%7B"searchText"%3A"<text>"%2C"status"%3A%7B"configId"%3A"<SourceID>"%2C"magicKey"%3A"<key>"%7D%7D