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 (unter anderem) das Eigenschaftsprädikat für die Suche nach Assets, die mit einer von Ihnen angegebenen Eigenschaft übereinstimmen, oder das Options-Prädikat für die Suche nach Assets, die mit einem oder mehreren Werten übereinstimmen, die Sie für eine bestimmte Eigenschaft angeben.

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 bei der Suche nach einem Dokument im Asset-Browser (beim Bearbeiten einer Seite) verfügbar sind.

  • Seiten-Editor (Bildsuche):

    Diese Konfiguration definiert die Optionen, die bei der Suche 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 Asset-Browser (beim Bearbeiten einer Seite) verfügbar sind.

  • Seiten-Editor (Seitensuche):

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

  • Seiten-Editor (Absatzsuche):

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

  • Seiten-Editor (Produktsuche):

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

  • Seiten-Editor (Dynamic Media Classic [früher Scene7] -Suche):

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

  • Sites-Admin-Suchleiste:

    Diese Konfiguration definiert die Suchoptionen, die Benutzern bei der Verwendung der Suchleiste der Sites-Konsole zur Verfügung stehen.

  • Seiten-Editor (Videosuche):

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

  • Asset-Admin-Suchleiste:

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

  • Katalog-Admin-Suchschiene:

    Diese Konfiguration definiert die Suchoptionen, die dem Benutzer bei der Suche nach einem Commerce-Katalog zur Verfügung stehen.

  • Auftrags-Admin-Suchschiene:

    Diese Konfiguration definiert die Suchoptionen, die dem Benutzer bei der Suche nach Commerce-Bestellungen zur Verfügung stehen.

  • Admin-Suchleiste für Produktsammlungen:

    Diese Konfiguration definiert die Suchoptionen, die dem Benutzer bei der Suche nach Commerce-Produktsammlungen zur Verfügung stehen.

  • Produkt-Admin-Suchschiene:

    Diese Konfiguration definiert die Suchoptionen, die dem Benutzer bei der Suche nach Commerce-Produkten zur Verfügung stehen.

  • Projekt-Admin-Suchleiste:

    Diese Konfiguration definiert die Suchoptionen, die dem Benutzer bei der Projektsuche 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.
Ein benutzerdefiniertes Prädikat, das auf der Datumseigenschaft 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 Reglerbasierte Suche nach Assets basierend auf einer Datumseigenschaft.
  • Feldbezeichnung
  • Eigenschaftsname*
  • Beschreibung
Datum Bereich Suchen Sie Assets, die innerhalb eines bestimmten 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 nach Assets basierend auf dem Ablaufstatus.
  • Feldbezeichnung
  • Eigenschaftsname*
  • Beschreibung
Dateigröße Suchen Sie nach Assets basierend auf ihrer Größe.
  • Feldbezeichnung
  • Eigenschaftsname*
  • Optionspfad
  • 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 nach Assets, die sich unter einem bestimmten Pfad befinden.
  • Feldbezeichnung
  • Suchpfad hinzufügen
  • Beschreibung
Eigenschaft Suche nach einer angegebenen Eigenschaft. keine
Veröffentlichungsstatus Suchen nach Assets basierend auf 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 Ein spezifisches Suchprädikat für Assets und dasselbe wie das allgemeine Reglerprädikat. 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 Suchen nach Assets basierend auf dem relativen Datum ihrer Erstellung
  • 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 Suche nach Assets basierend auf 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

  • Sucheigenschaften, die nur mit siteadmin (klassische Benutzeroberfläche) verbunden sind, befinden sich unter:
    /libs/cq/gui/components/siteadmin/admin/searchpanel/searchpredicates

  • Diese sind veraltet und nur aus Gründen der Abwärtskompatibilität verfügbar.

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.

  • * auf den Feldbezeichnungen auf der Registerkarte Einstellungen bedeutet, dass die Felder erforderlich sind. Wenn Sie das Feld leer lassen, wird eine Fehlermeldung angezeigt

Konfigurieren Ihrer Suchformulare

Erstellen/Öffnen einer benutzerdefinierten Konfiguration

  1. Navigieren Sie zu Tools > Allgemein > 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: die Datumsbereich-Eigenschaft:

    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 die Datumsbereich-Eigenschaft:

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

      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