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 Dokumenten im Assets-Browser verfügbar sind (beim Bearbeiten einer Seite).

  • 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 Asset-Browser verfügbar sind (beim Bearbeiten einer Seite).

  • Sites-Admin-Suchschiene:

    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-Suchschiene:

    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 bei der Suche nach kommerziellen Produkten zur Verfügung stehen.

  • Projekt-Admin-Suchschiene:

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

Prädikate und ihre Einstellungen

Eigenschaften

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

Eigenschaft Zweck Einstellungen
Analytics Such-/Filterfunktionen im Sites-Browser, wenn Analytics-basierte Daten angezeigt werden. Analysen-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 Sucheigenschaft für Volltextsuchen.
  • Feldbezeichnung
  • Platzhalter
  • Eigenschaftsname
  • Beschreibung
Ausgeblendeter 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.

See Adding an Options Predicate for more information.

  • Feldbezeichnung
  • JSON-Pfad
  • Eigenschaftsname*
  • Einzelauswahl
  • Optionspfad
  • Beschreibung
Options-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
  • Suchpfad hinzufügen
  • Beschreibung
Eigenschaft Suchen Sie nach einer angegebenen Eigenschaft. none
Veröffentlichungsstatus Suchen von Assets nach ihrem Veröffentlichungsstatus
  • Feldbezeichnung
  • Eigenschaftsname*
  • Beschreibung
Bereich Suchen Sie 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
Bereichsoptionen 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 Eine allgemeine Suche sagt voraus, dass die Erweiterung des Bereichs mit der Schiebereglerfunktion vorhergesagt wird. 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 anhand von Tags.
  • Platzhalter
  • Eigenschaftsname*
  • Beschreibung
Hinweis
  • Die allgemeinen Suchvorausschätzungen werden wie folgt 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.

This information is for reference only, you must not make changes to /libs.

Prädikateinstellungen

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

  • Feldbezeichnung

    Die Beschriftung, die als reduzierbare Kopfzeile oder als Feldbeschriftung der Vorhersage angezeigt wird.

  • Beschreibung

    Beschreibende Details für den Benutzer.

  • Platzhalter

    Leerer Text oder Platzhalter für die Vorhersage, falls kein Filtertext eingegeben wird.

  • Eigenschaftsname

    Die Eigenschaft, nach der gesucht werden soll. It uses a relative path and the wildcards */*/* specify the depth of the property relative to the jcr:content node (each asterisk represents one node level).

    If you want to search only on a first level child node of the resource that has the x property on the jcr:content node use */jcr:content/x

  • Eigenschaftstiefe

    Die maximale Tiefe, mit der nach dieser Eigenschaft in den Ressourcen gesucht wird. 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

    The property value as an absolute string or as an expression language; for example, cq:Page or

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

  • Bereichstext

    The label of the range field in the Date Range predicate.

  • Optionspfad

    Der Benutzer kann den Pfad mithilfe des Pfadbrowsers auf der Registerkarte "Voreinstellung"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 vom Benutzer erstellte Inhaltsknoten mit der folgenden Struktur:

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

  • Optionsknotenpfad Praktisch dasselbe wie der Optionspfad, mit dem Unterschied, dass dieser Pfad sich im gemeinsamen Prädikatsfeld befindet, während der andere Pfad nur für Assets gilt.

  • 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 der Vorhersage wird die Registerkarte Einstellungen geöffnet und zeigt die Eigenschaften an, die definiert werden können.

    • Sie möchten eine vorhandene Vorhersage aktualisieren:

      Wählen Sie das Feld "Vorhersage"(rechts) und öffnen Sie dann die Registerkarte " Einstellungen ".
      Beispiel: die Einstellungen für das Datumsbereichprä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, die 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 Suchschiene angezeigt werden soll
    • value – der Eigenschaftswert, nach dem gesucht werden soll

    chlimage_1-379

    Hinweis

    You must not change anything in the /libs path.

    This is because the content of /libs is overwritten the next time you upgrade your instance (and may well be overwritten when you apply either a hotfix or feature pack).

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

    1. Recreate the required item, as it exists in /libs, under /apps. In diesem Fall im folgenden Verzeichnis:
    2. /libs/cq/gui/content/common/options/predicates
    3. Make any changes within /apps.
  2. Öffnen Sie die Suchformulare-Konsole und wählen Sie die Konfiguration aus, die Sie aktualisieren möchten. Beispiel: Sites-Admin-Suchschiene.

    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

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

      jcr:content/cq:template

    • Optionsknotenpfad

      Wählen Sie den Pfad, zu dem Ihre Optionen gehalten werden. 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

Anwenderberechtigungen

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 Lesen, Schreibberechtigungen für den /apps Knoten.
Löschen Read, Write, Delete permissions on the /apps node
Vorschau Read, Write, Delete permissions on the /var/dam/content node.
Lesen, Schreibberechtigungen für den /apps Knoten.

Auf dieser Seite