Konfigurieren von Suchformularen

Mit Suchformularen können Sie die Auswahl der Suchprädikate anpassen, die in den Suchbereichen der verschiedenen AEM-Konsolen und/oder in den Suchbereichen der Autorenumgebung verwendet werden. Auf diese Weise können Sie die Suchfunktion genau auf Ihre speziellen Anforderungen ausrichten.

Eine Reihe an Prädikaten ist vorkonfiguriert verfügbar. Sie können mehrere Eigenschaften hinzufügen, darunter das Volltextprädikat für Volltextsuchen, das Eigenschaftsprädikat für die Suche nach Assets, die mit einer einzigen von Ihnen festgelegten Eigenschaft übereinstimmen, oder das Optionsprädikat für die Suche nach Assets, die mit mindestens einem Wert übereinstimmen, den Sie für eine bestimmte Eigenschaft festgelegt haben.

Sie können die Suchformulare konfigurieren, die in den unterschiedlichen Konsolen und im Asset-Browser (bei der Bearbeitung von Seiten) genutzt werden. Die Dialogfelder für die Konfiguration dieser Formulare finden Sie unter:

  • Tools

    • Allgemein

      • Suchformulare

Wenn Sie zum ersten Mal auf diese Konsole zugreifen, weisen alle Konfigurationen ein Vorhängeschlosssymbol auf. Dieses Symbol bedeutet, dass die richtige Konfiguration die Standardkonfiguration (vorkonfiguriert) ist und nicht gelöscht werden kann. Wenn Sie die Konfiguration angepasst haben, wird das Schlosssymbol nicht mehr angezeigt – es sei denn, Sie löschen die benutzerdefinierte Konfiguration; dann wird das Standardsymbol wieder aktiviert und das Vorhängeschloss angezeigt.

chlimage_1-374

Konfigurationen

Die verfügbaren Standardkonfigurationen sind:

  • Seiten-Editor (Dokumentensuche):

    Diese Konfiguration definiert die Optionen, die beim Suchen nach Dokument im Assets-Browser (beim Bearbeiten einer Seite) verfügbar sind.

  • Seiten-Editor (Bildsuche):

    Diese Konfiguration definiert die Optionen, die beim Suchen nach Bildern im Asset-Browser (beim Bearbeiten einer Seite) verfügbar sind.

  • Seiten-Editor (Manuskriptsuche):

    Diese Konfiguration definiert die Optionen, die bei der Suche nach Manuskripten im Assets-Browser verfügbar sind (beim Bearbeiten einer Seite).

  • Seiten-Editor (Seitensuche):

    Diese Konfiguration definiert die Optionen, die beim Suchen nach Seiten im Asset-Browser verfügbar sind (beim Bearbeiten einer Seite).

  • Seiten-Editor (Absatzsuche):

    Diese Konfiguration definiert die Optionen, die beim Suchen nach Absätzen im Assets-Browser verfügbar sind (beim Bearbeiten einer Seite).

  • Seiten-Editor (Produktsuche):

    Diese Konfiguration definiert die Optionen, die beim Suchen nach Produkten im Asset-Browser verfügbar sind (beim Bearbeiten einer Seite).

  • Seiten-Editor (Scene7-Suche):

    Diese Konfiguration definiert die Optionen, die beim Suchen nach Scene7-Ressourcen im Assets-Browser verfügbar sind (beim Bearbeiten einer Seite).

  • Sites-Admin-Suchleiste:

    Diese Konfiguration definiert die Suchoptionen, die dem Benutzer bei Verwendung der Suchleiste der Site-Konsole zur Verfügung stehen.

  • Seiten-Editor (Videosuche):

    Diese Konfiguration definiert die Optionen, die beim Suchen nach Videos im Assets-Browser verfügbar sind (beim Bearbeiten einer Seite).

  • Asset-Admin-Suchleiste:

    Diese Konfiguration definiert die Suchoptionen, die dem Benutzer bei Verwendung der Assets-Konsole zur Verfügung stehen.

  • Katalog-Admin-Suchschiene:

    Diese Konfiguration definiert die Suchoptionen, die dem Benutzer beim Durchsuchen eines Commerce-Katalogs zur Verfügung stehen.

  • Auftrags-Admin-Suchschiene:

    Diese Konfiguration definiert die Suchoptionen, die dem Benutzer beim Durchsuchen von Commerce-Bestellungen zur Verfügung stehen.

  • Admin-Suchleiste für Produktsammlungen:

    Diese Konfiguration definiert die Suchoptionen, die dem Benutzer beim Durchsuchen von Commerce-Produktsammlungen zur Verfügung stehen.

  • Produkt-Admin-Suchschiene:

    Diese Konfiguration definiert die Suchoptionen, die dem Benutzer beim Durchsuchen von Commerce-Produkten zur Verfügung stehen.

  • Projekt-Admin-Suchleiste:

    Diese Konfiguration definiert die Suchoptionen, die dem Benutzer beim Durchsuchen von Projekten zur Verfügung stehen.

Prädikate und ihre Einstellungen

Prädikate

Die folgenden Prädikate stehen je nach Konfiguration zur Verfügung:

Prädikat Zweck Einstellungen
Analyse Such-/Filterfunktionen im Sites-Browser, wenn analysebasierte Daten angezeigt werden. Analyse-Suchfilter werden geladen, um die zugeordneten angepassten Analysespalten abzugleichen.
  • Feldbezeichnung
  • Beschreibung
Asset zuletzt geändert Datum der letzten Änderung des Assets.
Eine benutzerdefinierte Prognose, die auf der Date Predicate basiert.
Komponenten Ermöglicht es einem Autor, nach Seiten zu suchen/zu filtern, die eine bestimmte Komponente enthalten. Beispiel: eine Bildergalerie.
  • Feldbezeichnung
  • Platzhalter
  • Eigenschaftsname*
  • Eigenschaftstiefe
  • Beschreibung
Datum Slider-basierte Suche von Assets basierend auf einer Datumseigenschaft.
  • Feldbezeichnung
  • Eigenschaftsname*
  • Beschreibung
Datum Bereich Suchen Sie Assets, die innerhalb eines angegebenen Bereichs für eine Datumseigenschaft erstellt wurden. Im Suchbereich können Sie das Start- und das Enddatum angeben.
  • Feldbezeichnung
  • Platzhalter
  • Eigenschaftsname*
  • Textbereich (von)*
  • Textbereich (bis)*
  • Beschreibung
Gültigkeitsstatus Suchen Sie Assets nach dem Ablaufstatus.
  • Feldbezeichnung
  • Eigenschaftsname*
  • Beschreibung
Dateigröße Suchen Sie Assets nach ihrer Größe.
  • Feldbezeichnung
  • Eigenschaftsname*
  • Optionspfad
  • Beschreibung
Volltext Suchprädikat für Volltextsuchen.
  • Feldbezeichnung
  • Platzhalter
  • Eigenschaftsname
  • Beschreibung
Ausgeblendet Filter Ein Filter für Eigenschaft und Wert, der für den Benutzer nicht sichtbar ist.
  • Eigenschaftsname
  • Eigenschaftswert
  • Beschreibung
Optionen

Die Optionen sind vom Benutzer erstellte Inhaltsknoten.

Weitere Informationen finden Sie unter Hinzufügen eines Optionsprädikats.

  • Feldbezeichnung
  • JSON-Pfad
  • Eigenschaftsname*
  • Einzelauswahl
  • Optionspfad
  • Beschreibung
Optionen Eigenschaft Suchen Sie nach einer Eigenschaft der Option.
  • Feldbezeichnung
  • Eigenschaftsname*
  • Optionsknotenpfad
  • Einzelauswahl
  • Beschreibung
Seite Status Suchseiten nach ihrem Status.
  • Feldbezeichnung
  • Veröffentlichungs-Eigenschaftsname
  • LiveCopy-Eigenschaftsname
  • Beschreibung
Pfad Suchen Sie Assets, die sich unter einem bestimmten Pfad befinden.
  • Feldbezeichnung
  • Hinzufügen Suchpfad
  • Beschreibung
Eigenschaft Suche nach einer angegebenen Eigenschaft. none
Veröffentlichungsstatus Suchen von Assets nach ihrem Veröffentlichungsstatus
  • Feldbezeichnung
  • Eigenschaftsname*
  • Beschreibung
Bereich Suche nach Ressourcen, die innerhalb eines bestimmten Bereichs liegen. Im Suchbereich können Sie den Mindest- und den Höchstwert für den Bereich angeben.
  • Feldbezeichnung
  • Eigenschaftsname
  • Beschreibung
Bereich Optionen Eine bestimmte Suche sagt für Assets voraus und entspricht der allgemeinen Slider Predicate. Ist aufgrund von Problemen mit der Abwärtskompatibilität noch verfügbar.
  • Feldbezeichnung
  • Eigenschaftsname*
  • Optionspfad
  • Beschreibung
Bewertung Suchen Sie Assets nach ihrer Bewertung.
  • Feldbezeichnung
  • Eigenschaftsname*
  • Optionspfad
  • Beschreibung
Relatives Datum Search assets based on the relative date of their creation
  • Feldbezeichnung
  • Eigenschaftsname*
  • Relatives Datum
  • Beschreibung
Reglerbereich Ein allgemeines Suchprädikat, das das Bereichprädikat mit der Reglerfunktion erweitert. Der Wert der gesuchten Eigenschaft muss zwischen den Grenzen des Reglers liegen.
  • Feldbezeichnung
  • Eigenschaftsname*
  • Beschreibung
Tag Suchen Sie Assets anhand von Tags. Sie können die Pfadeigenschaft konfigurieren, um verschiedene Tags in der Tag-Liste zu füllen.
  • Feldbezeichnung
  • Eigenschaftsname*
  • Optionspfad
  • Beschreibung
Tags Suche basierend auf Tags.
  • Platzhalter
  • Eigenschaftsname*
  • Beschreibung
Hinweis
  • Die allgemeinen Suchprädikate sind hier definiert:
    /libs/cq/gui/components/common/admin/customsearch/searchpredicates

  • Suchvorhersagen, die sich nur auf SiteAdmin (klassische Benutzeroberfläche) beziehen, befinden sich unter:
    /libs/cq/gui/components/siteadmin/admin/searchpanel/searchpredicates

  • Diese werden nicht mehr unterstützt und stehen nur zur Abwärtskompatibilität zur Verfügung.

Diese Angaben dienen nur als Referenz. Sie dürfen /libs nicht verändern.

Prädikateinstellungen

Je nach Prädikat stehen mehrere Einstellungen für die Konfiguration zur Verfügung:

  • Feldbezeichnung

    Die Bezeichnung, die als ausblendbare Kopfzeile oder als Feldbezeichnung des Prädikats angezeigt wird.

  • Beschreibung

    Beschreibende Informationen für die Benutzer.

  • Platzhalter

    Leerer Text oder der Platzhalter des Prädikats, der angezeigt wird, wenn kein Filtertext eingegeben wird.

  • Eigenschaftsname

    Die Eigenschaft, nach der gesucht werden soll. Sie nutzt einen relativen Pfad und die Platzhaltersymbole */*/* geben die Tiefe der Eigenschaft in Relation zum jcr:content-Knoten an (jeder Asterisk steht für eine Knotenebene).

    Wenn Sie nur nach dem untergeordneten Knoten der ersten Ebene der Ressource suchen möchten, die die Eigenschaft x auf dem Knoten jcr:content aufweist, nutzen Sie */jcr:content/x.

  • Eigenschaftstiefe

    Die maximale Tiefe, die bei der Suche nach dieser Eigenschaft innerhalb der Ressourcen berücksichtigt werden soll. So können Sie eine Suche nach dieser Eigenschaft auf einer Ressource und rekursiven untergeordneten Elementen durchführen, bis die Ebene der untergeordneten Elemente der festgelegten Tiefe entspricht.

  • Eigenschaftswert

    Der Eigenschaftswert als absolute Zeichenfolge oder als Ausdruckssprache, zum Beispiel cq:Page oder

    ${empty requestPathInfo.suffix ? "/content" : requestPathInfo.suffix}.

  • Bereichstext

    Die Bezeichnung des Bereichsfelds im Prädikat Datumsbereich.

  • Optionspfad

    Die Benutzer können den Pfad mit dem Pfad-Browser auf der Registerkarte mit den Prädikatseinstellungen auswählen. Nach dem Auswählen können Sie mit dem Plussymbol (+) die Auswahl zur Liste der gültigen Optionen hinzufügen. (Entfernen lässt sich die Auswahl mit dem Minussymbol (-), falls erforderlich.)

    Die Optionen sind Inhaltsknoten, die von Benutzern erstellt werden, und weisen die folgende Struktur auf:

    (jcr:primaryType = nt:unstructured, value (String), jcr:title (String))

  • Options-Knotenpfad
    Identisch mit dem
    Optionspfad, nur dass dieser sich im Feld „Allgemeine Vorhersage“ befindet, der andere ist spezifisch für Assets.

  • Einzelauswahl Wenn diese Option aktiviert ist, werden die Optionen als Kontrollkästchen gerendert, die nur eine Einzelauswahl zulassen. Wenn die Option versehentlich ausgewählt wurde, kann sie per Kontrollkästchen deaktiviert werden.

  • Veröffentlichungs- und Live Copy-Eigenschaftsname(n) Die Bezeichnungen für die Veröffentlichungs- und Live Copy-Kontrollkästchen für das Sites-spezifische Prädikat.

  • The * on the field labels in the Settings tab means the fields are required and if left blank an error message will appear

Konfigurieren Ihrer Suchformulare

Erstellen/Öffnen einer benutzerdefinierten Konfiguration

  1. Navigieren Sie zu Tools > Vorgänge > Suchformulare.

  2. Wählen Sie die Konfiguration aus, die Sie anpassen möchten.

  3. Über das Symbol Bearbeiten können Sie die Konfiguration für die Aktualisierung öffnen.

  4. Bei einer neuen Anpassung möchten Sie vermutlich neue Prädikatfelder hinzufügen und die Einstellungen wie erforderlich festlegen. Bei einer vorhandenen Anpassung können Sie ein vorhandenes Feld auswählen und die Einstellungen aktualisieren.

  5. Wählen Sie Fertig aus, um die Konfiguration zu speichern.

    Hinweis

    Die angepassten Konfigurationen werden (wie jeweils angemessen) unter folgendem Pfad gespeichert:

    • /apps/cq/gui/content/facets/<option>
    • /apps/commerce/gui/content/facets/<option>

Hinzufügen/Bearbeiten eines Prädikatfelds und Definieren der Feldeinstellungen

Sie können Felder hinzufügen oder bearbeiten und ihre Einstellungen definieren/aktualisieren:

  1. Öffnen Sie die angepasste Konfiguration für die Aktualisierung.

  2. Um ein neues Feld hinzuzufügen, öffnen Sie die Registerkarte Eigenschaft auswählen und ziehen Sie das benötigte Prädikat an den erforderlichen Ort. Beispiel: das Datumsbereichsprädikat:

    chlimage_1-375

  3. Der nächste Schritt hängt davon ab, was Sie tun möchten:

    • Sie fügen ein neues Feld hinzu:

      Nach dem Hinzufügen des Prädikats öffnet sich die Registerkarte Einstellungen. Dort werden die Eigenschaften angezeigt, die definiert werden können.

    • Sie aktualisieren ein vorhandenes Prädikat:

      Wählen Sie das Prädikatsfeld aus (rechts) und öffnen Sie dann die Registerkarte Einstellungen.
      Beispiel: die Einstellungen für das Datumsbereichsprädikat:

    chlimage_1-376

  4. Nehmen Sie die erforderlichen Änderungen vor und bestätigen Sie sie mit Fertig.

Anzeigen einer Vorschau der Suchkonfiguration

  1. Wählen Sie das Vorschausymbol aus:

  2. Daraufhin werden die Suchformulare so angezeigt, wie sie in der Suchspalte der jeweiligen Konsole (vollständig eingeblendet) zu sehen sein werden.

    chlimage_1-377

  3. Schließen Sie die Vorschau, um zur Konfiguration zurückzukehren und sie fertigzustellen.

Löschen eines Prädikatfelds

  1. Öffnen Sie die angepasste Konfiguration für die Aktualisierung.

  2. Wählen Sie das Prädikatsfeld (rechts) aus, öffnen Sie die Registerkarte Einstellungen und wählen Sie dann das Symbol Löschen (unten links) aus.

  3. In einem Dialogfeld werden Sie dazu aufgefordert, die Löschaktion zu bestätigen.

  4. Bestätigen Sie diese und andere Änderungen mit Fertig.

Löschen einer Konfiguration (zur erneuten Aktivierung des Standards)

Wenn Sie eine Konfiguration angepasst haben, werden die Standardwerte überschrieben. Sie können die Standardkonfiguration erneut aktivieren, indem Sie die angepasste Konfiguration löschen.

Hinweis

Sie können die beiden Standardkonfigurationen nicht löschen.

Das Löschen einer angepassten Konfiguration erfolgt über die Konsole:

  1. Wählen Sie die benötigte Konfiguration (z. B. Seiten-Editor (Absatzsuche)) und anschließend das Symbol Löschen in der Symbolleiste aus:

    chlimage_1-378

  2. Die angepasste Konfiguration wird gelöscht und die Standardkonfiguration wird erneut aktiviert. (Sie erkennen dies am Vorhängeschlosssymbol, das wieder in der Konsole angezeigt wird.)

Hinzufügen von Optionsprädikaten

Mit Optionsprädikaten (Optionen, Optionseigenschaft) können Sie ein Element konfigurieren, nach dem gesucht werden soll. Sie werden normalerweise genutzt, um etwas direkt unter der Seite zu suchen, z. B. eine Eigenschaft auf dem Seitenknoten.

Das folgende Beispiel (Suche entsprechend der Vorlage, mit der eine Seite erstellt wird) verdeutlicht die einzelnen Schritte:

  1. Erstellen Sie den Knoten, der die zu suchende Eigenschaft enthält.

    Sie benötigen einen Stammknoten, der die Definitionen der einzelnen Optionen umfasst, die für Benutzer verfügbar sein sollen.

    Die Knoten für die einzelnen Optionen müssen die folgenden Eigenschaften aufweisen:

    • jcr:title – die Feldbezeichnung, die in der Suchleiste angezeigt werden soll
    • value – der Eigenschaftswert, nach dem gesucht werden soll

    chlimage_1-379

    Hinweis

    Sie dürfen keinerlei Änderungen im Pfad /libs vornehmen,

    da der Inhalt von /libs überschrieben wird, wenn Sie die Instanz das nächste Mal aktualisieren. (Außerdem kann der Inhalt auch durch Anwenden von Hotfixes oder Feature Packs überschrieben werden.)

    Die empfohlene Methode zur Konfiguration und für andere Änderungen sieht wie folgt aus:

    1. Aktivieren Sie das benötigte Element erneut so, wie es in /libs unter /apps vorhanden ist. In diesem Fall im folgenden Verzeichnis:
    2. /libs/cq/gui/content/common/options/predicates
    3. Nehmen Sie die gewünschten Änderungen in /apps. vor.
  2. Öffnen Sie die Suchformulare-Konsole und wählen Sie die Konfiguration aus, die Sie aktualisieren möchten. Beispiel: Sites-Admin-Suchleiste.

    Klicken/tippen Sie anschließend auf das Symbol Suchformulare bearbeiten.

  3. Fügen Sie je nach Konfiguration Optionen oder eine Optionseigenschaft zur Konfiguration hinzu.

  4. Aktualisieren Sie die Felder, vor allem:

    • Eigenschaftsname

      Geben Sie die Knoteneigenschaft an, nach der auf den Zielknoten gesucht werden soll. Beispiel:

      jcr:content/cq:template

    • Optionsknotenpfad

      Wählen Sie den Pfad des Speicherorts der Optionen aus. Beispiel:

      /apps/cq/gui/content/common/options/predicates/templatetype
      chlimage_1-380

  5. Wählen Sie Fertig aus, um die Konfiguration zu speichern.

  6. Navigieren Sie zur entsprechenden Konsole (in diesem Beispiel: Sites) und öffnen Sie die Suchschiene. Die neu definierten Suchformulare werden zusammen mit den verschiedenen Optionen angezeigt. Wählen Sie die benötigte Option aus, um die Suchergebnisse anzuzeigen:

    chlimage_1-381

Benutzerberechtigungen

In der folgenden Tabelle sind die Berechtigungen aufgeführt, die Benutzer benötigen, um Suchformulare zu bearbeiten, zu löschen und Vorschauen anzuzeigen.

Aktion Berechtigungen
Bearbeiten Lese- und Schreibberechtigungen für den Knoten /apps .
Löschen Lese-, Schreib- und Löschberechtigungen für den Knoten /apps.
Vorschau Lese-, Schreib- und Löschberechtigungen für den Knoten /var/dam/content.
Lese- und Schreibberechtigungen für den Knoten /apps.

Auf dieser Seite