Schnellsuch-Komponente quick-search-component

Die Schnellsuch-Komponente bietet Suchfunktionen für eine Website und zeigt Suchergebnisse an, damit Besucher mühelos übereinstimmende Inhalte finden und Ergebnisse anzeigen können.

TIP
Haben Sie schon Edge Delivery Services für AEM in Betracht gezogen?
Sie können die in diesem Dokument beschriebenen Methoden für bestehende Projekte weiter verwenden. Für neue Projekte empfiehlt Adobe jedoch die Verwendung von Edge Delivery Services.

Nutzung usage

Die Schnellsuch-Komponente bietet Site-Besuchern die Möglichkeit, nach Inhalten zu suchen, die Ergebnisse unmittelbar anzuzeigen und leicht zu den passenden Seiten zu navigieren. Neue Ergebnisse werden dynamisch abgerufen, wenn der Benutzer die Suchergebnisse durchblättert.

Mit ​ Dialogfeld „Bearbeiten kann der Inhaltsautor definieren, wo in der Inhaltsstruktur die Suche beginnen soll, und optional den Umschalter Semantische Suche ausblenden. Mit dem Design- kann der Vorlagenautor den Standardwert festlegen, an dem in der Inhaltsstruktur die Suche beginnen soll, die maximale Ergebnissatzgröße, die minimale Suchbegrifflänge und ob der Umschalter für die semantische Suche standardmäßig für Besuchende angezeigt wird.

Version und Kompatibilität version-and-compatibility

Die aktuelle Version der Schnellsuch-Komponente ist v3, die mit Version 2.32.0 der Kernkomponenten eingeführt wurde, wobei ein optionaler Umschalter für die semantische Suche hinzugefügt wurde, und in diesem Dokument beschrieben wird.

Die folgende Tabelle enthält alle unterstützten Versionen der Komponente, die AEM-Versionen, mit denen die Versionen der Komponente kompatibel sind, sowie Links zur Dokumentation für frühere Versionen.

Komponentenversion
AEM 6.4
AEM 6.5
AEM 6.5 LTS
AEM as a Cloud Service
v3
Kompatibel*
Kompatibel*
Kompatibel
v2
Kompatibel
Kompatibel
Kompatibel
v1
Kompatibel mit
Version 2.17.4 und vorherigen
Kompatibel
Kompatibel

*Der Umschalter Semantische Suche ist nur bei AEM as a Cloud Service verfügbar.

Weitere Informationen zu Kernkomponentenversionen und -freigaben finden Sie im Dokument Kernkomponentenversionen.

Musterkomponentenausgabe sample-component-output

Um die Schnellsuch-Komponente kennenzulernen und Beispiele für die Konfigurationsoptionen sowie die HTML- und JSON-Ausgabe zu sehen, besuchen Sie die Komponentenbibliothek.

Technische Details technical-details

NOTE
Der Schutz der Suchkomponente oder einer beliebigen AEM-basierten Anwendung gegen DOS-Angriffe sollte auf höherer Ebene implementiert werden, z. B. durch Verwendung von mod_security auf dem Dispatcher.

Die aktuelle technische Dokumentation zur Schnellsuch-Komponente finden Sie auf GitHub.

Weitere Informationen zur Entwicklung von Kernkomponenten finden Sie in der Dokumentation zu Kernkomponenten für Entwickler.

Dialogfeld „Bearbeiten“ edit-dialog

Im Dialogfeld „Bearbeiten“ kann der Inhaltsautor definieren, wo in der Inhaltsstruktur die Suche beginnen soll, und optional den Umschalter Semantische Suche ausblenden.

Dialogfeld „Bearbeiten“ der Schnellsuch-Komponente

Suchstamm - Die Stammseite, von der aus die Suche gestartet werden soll. Der Suchstamm kann ein Blueprint-Master, ein Sprachen-Master oder eine normale Seite sein.

  • ID – Diese Option dient zur Kontrolle der eindeutigen Kennung der Komponente in der HTML-Datei und in der Datenschicht.

    • Wenn Sie das Feld leer lassen, wird automatisch eine eindeutige ID generiert, die Sie über die resultierende Seite finden.
    • Sofern eine ID angegeben wird, ist vom Autor bzw. der Autorin sicherzustellen, dass diese eindeutig ist.
    • Änderungen der ID können sich auf das CSS-, JS- und Datenschicht-Tracking auswirken.
  • Umschalter für die semantische Suche in dieser Instanz ausblenden - Wenn diese Option aktiviert ist, wird der Umschalter für die semantische Suche ausgeblendet, unabhängig davon, wie ​ Dialogfeld „Design konfiguriert ist, um es anzuzeigen.

    • Deaktivieren Sie diese Option, um die Standardeinstellung der Vorlage zu verwenden.
    • Diese Option kann den Umschalter nicht zwingen, auf einer Platzierung anzuzeigen, auf der das Dialogfeld „Design“ ihn ausblendet.
NOTE
Wenn der Suchstamm nicht konfiguriert ist oder nicht aufgelöst werden kann, sucht die Schnellsuche standardmäßig unterhalb der aktuellen Seite.
NOTE
Der Umschalter für die semantische Suche gibt nur dann KI-gestützte Ergebnisse zurück, wenn die Umgebung mit AEM Content AI konfiguriert ist. In AEM 6.5- und AEM 6.5 LTS-Umgebungen, die nicht mit Content-KI konfiguriert sind, blenden Sie den Umschalter mithilfe des Design-) aus, damit Besuchenden kein Suchmodus angeboten wird, der nicht funktioniert.

Dialogfeld „Design“ design-dialog

Im Dialogfeld „Design“ kann der Vorlagenautor den Standardwert festlegen, an dem die Suche in der Inhaltsstruktur beginnen soll, sowie eine maximale Ergebnissatzgröße, minimale Suchbegriffslänge und ob der Umschalter für die semantische Suche standardmäßig Besuchern angezeigt wird.

Registerkarte „Eigenschaften“ properties-tab

Design-Dialog der Schnellsuch-Komponente

  • Suchstamm - Der Standardwert des Suchstamms, wenn ein Inhaltsautor die Schnellsuch-Komponente auf einer Inhaltsseite platziert

  • Ergebnisgröße - Die maximale Anzahl der Ergebnisse, die von einer Suchanfrage abgerufen werden

  • Mindestlänge des Suchbegriffs - Mindestlänge des Suchbegriffs, um die Suche zu starten

  • Umschalter für semantische Suche ausblenden - Wenn diese Option aktiviert ist, wird der Umschalter Semantische Suche, der unter Verwendung beschrieben ist, Website-Besuchern nicht standardmäßig angezeigt, und die Komponente verhält sich wie die v2-Komponente (nur Volltextsuche).

NOTE
Der Umschalter für die semantische Suche gibt nur dann KI-gestützte Ergebnisse zurück, wenn die Umgebung mit AEM Content AI konfiguriert ist. In AEM 6.5- und AEM 6.5 LTS-Umgebungen, die nicht mit Content-KI konfiguriert sind, blenden Sie den Umschalter mithilfe des Design-Dialogfelds aus, damit Besuchenden kein Suchmodus angeboten wird, der nicht funktioniert.
NOTE
Die Größe der Ergebnisse und die Minimale Länge für Suchbegriff können nur im Designmodus festgelegt werden und daher nur auf Vorlagenebene, d. h. Inhaltsautoren können diese Werte nicht ändern.
CAUTION
Die Größe der Ergebnisse und die Minimale Länge für Suchbegriff können Auswirkungen auf die Leistung haben, wenn sie zu hoch oder zu niedrig eingestellt sind.

Registerkarte „Arten“ styles-tab

Die Komponente „Schnellsuche“ unterstützt das AEM-Stilsystem.

recommendation-more-help
experience-manager-core-components-help-main-toc