Query Builder-Eigenschaftsverweis

Allgemein

Prädikate

boolproperty

Sucht nach JCR BOOLEAN-Eigenschaften. Only accepts the values " true" and " false". Im Fall von „false“ besteht eine Übereinstimmung, falls die Eigenschaft über den Wert „false“ verfügt oder überhaupt nicht vorhanden ist. Dies kann für die Prüfung auf boolesche Flags nützlich sein, die nur festgelegt werden, wenn sie aktiviert sind.

Der übernommene Parameter „operation“ hat keine Bedeutung.

Unterstützt die Facettenextraktion. Erstellt für jeden Wert (true oder false) einen Bucket, aber nur für vorhandene Eigenschaften.

Eigenschaften

  • Beispiel: boolproperty relative path to property
    myFeatureEnabled oder jcr:content/myFeatureEnabled sein.

  • Wert, für den die Eigenschaft überprüft werden soll,
    true" oder " false"

contentfragment

Schränkt das Ergebnis auf Inhaltsfragmente ein.

Filtern wird nicht unterstützt.

Facettenextraktion wird nicht unterstützt.

Eigenschaften

  • contentfragment Kann mit jedem Wert verwendet werden, um auf Inhaltsfragmente zu prüfen.

dateComparison

Vergleicht zwei JCR DATE-Eigenschaften miteinander. Kann testen, ob sie gleich, ungleich, größer oder größer-oder-gleich sind.

Dies ist eine reine Filtereigenschaft und kann keine Suchindizes nutzen.

Eigenschaften

  • property1

    path to first date property

  • property2

    path to second date property

  • operation

    " =" for exact match, " !=" for unequality comparison, " >" for property1 greater than property2, " >=" for property1 greater than or equal to property2. Der Standardwert ist " =".

daterange

Gleicht JCR DATE-Eigenschaften mit einem Datums-/Zeitintervall ab. Hierbei wird ISO8601 verwendet
Format für Daten und Uhrzeiten ( YYYY-MM-DDTHH:mm:ss.SSSZ) und erlaubt auch partielle Darstellungen, wie YYYY-MM-DD. Alternativ kann der Zeitstempel als Anzahl von Millisekunden seit 1970 in der Zeitzone UTC angegeben werden. Dies ist das Unix-Zeitformat.

Sie können nach allen Elementen zwischen zwei Zeitstempeln suchen, nach allem, was neuer oder älter als ein jeweiliges Datum ist, und aus inklusiven oder offenen Intervallen auswählen.

Unterstützt die Facettenextraktion. Stellt die Buckets „Heute“, „Diese Woche“, „Dieser Monat“, „Letzte 3 Monate“, „Dieses Jahr“, „Letztes Jahr“ und „Vor letztem Jahr“ zur Verfügung.

Filtern wird nicht unterstützt.

Eigenschaften

  • property

    relative path to a DATE property, for example jcr:lastModified

  • lowerBound

    lower date bound to check property for, for example 2014-10-01

  • lowerOperation

    " >" (newer) or " >=" (at or newer), applies to the lowerBound. Der Standardwert lautet " >".

  • upperBound

    upper bound to check property for, for example 2014-10-01T12:15:00

  • upperOperation

    " <" (older) or " <=" (at or older), applies to the upperBound. Der Standardwert lautet " <".

  • timeZone

    Kennung der Zeitzone, die verwendet werden soll, wenn keine ISO-8601-Datumszeichenfolge angegeben wird. Der Standardwert ist die standardmäßige Zeitzone des Systems.

excludepaths

Schließt Knoten aus dem Ergebnis aus, wenn ihr Pfad mit einem regulären Ausdruck übereinstimmt.

Dies ist eine reine Filtereigenschaft und kann keine Suchindizes nutzen.

Facettenextraktion wird nicht unterstützt.

Eigenschaften

  • excludepaths

    Regulärer Ausdruck, der anhand von Ergebnispfaden ausgewertet wird, wobei übereinstimmende aus dem Ergebnis ausgeschlossen werden.

fulltext

Sucht nach Ausdrücken im Volltextindex.

Filtern wird nicht unterstützt.

Facettenextraktion wird nicht unterstützt.

Eigenschaften

  • fulltext

    der/die Suchbegriff(e) im Volltext

  • relPath

    Der relative Pfad, der in der Eigenschaft oder dem Teilknoten durchsucht werden soll. Diese Eigenschaft ist optional.

-Gruppe

Ermöglicht die Erstellung verschachtelter Bedingungen. Gruppen können verschachtelte Gruppen enthalten. Alles in einer querybuilder-Abfrage gehört zu einer root-Gruppe, die auch p.or- und p.not-Parameter aufweisen kann.

Beispiel für die Zuordnung einer von zwei Eigenschaften anhand eines Werts:

group.p.or=true
group.1_property=jcr:title
group.1_property.value=My Page
group.2_property=navTitle
group.2_property.value=My Page

This is conceptually (1_property OR 2_property).

Beispiel für verschachtelte Gruppen:

fulltext=Management
group.p.or=true
group.1_group.path=/content/geometrixx/en
group.1_group.type=cq:Page
group.2_group.path=/content/dam/geometrixx
group.2_group.type=dam:Asset

This searches for the term "Management" within pages in /content/geometrixx/en or in assets in /content/dam/geometrixx.

Das ist konzeptionell fulltext AND ( (path AND type) OR (path AND type) ). Beachten Sie, dass solche ODER-Verknüpfungen gute Indizes benötigen, um optimale Leistung zu bieten.

Eigenschaften

  • p.or

    if set to " true", only one predicate in the group must match. Standardmäßig ist „false“ festgelegt, was bedeutet, dass alle übereinstimmen müssen.

  • p.not

    if set to " true", it negates the group (defaults to " false")

  • <preate>

    fügt verschachtelte Prädikate hinzu

  • N_<Vorhersage>

    adds multiple nested predicates of the same time, like 1_property, 2_property, ...

hasPermission

Beschränkt das Ergebnis auf Elemente, bei denen die aktuelle Sitzung die angegebenen JCR-Privilegien aufweist.

Dies ist eine reine Filtereigenschaft und kann keine Suchindizes nutzen. Facettenextraktion wird nicht unterstützt.

Eigenschaften

  • hasPermission

    comma-separated JCR privileges that the current user session must ALL have for the node in question; for example jcr:write, jcr:modifyAccessControl

language

Findet CQ-Seiten in einer bestimmten Sprache. Hierbei wird sowohl die Spracheigenschaft der Seite als auch der Seitenpfad betrachtet, der häufig die Sprache oder das Gebietsschema in einer Site-Struktur der höchsten Ebene enthält.

Dies ist eine reine Filtereigenschaft und kann keine Suchindizes nutzen.

Unterstützt die Facettenextraktion. Stellt Buckets für jeden eindeutigen Sprachcode zur Verfügung.

Eigenschaften

  • language

    ISO language code, for example " de"

mainasset

Prüft, ob ein Knoten ein DAM-Haupt-Asset und kein Unter-Asset ist. Dies ist im Allgemeinen jeder Knoten, der sich nicht in einem subassets-Knoten befindet. Hierbei wird nicht auf den Knotentyp dam:Asset geprüft. To use this predicate, simply set " mainasset=true" or " mainasset=false", there are no further properties.

Dies ist eine reine Filtereigenschaft und kann keine Suchindizes nutzen.

Unterstützt die Facettenextraktion. Stellt zwei Buckets für Haupt- und Unter-Assets bereit.

Eigenschaften

  • mainasset

    boolean, " true" for main assets, " false" for sub assets

memberOf

Sucht Objekte, die Mitglieder einer bestimmten Sling-Ressourcensammlung sind.

Dies ist eine reine Filtereigenschaft und kann keine Suchindizes nutzen. Facettenextraktion wird nicht unterstützt.

Eigenschaften

  • memberOf

    Pfad zur Sling-Ressourcensammlung

nodename

Sucht nach Namen von JCR-Knoten.

Unterstützt die Facettenextraktion. Stellt Buckets für alle eindeutigen Knotennamen (Dateinamen) zur Verfügung.

Eigenschaften

  • nodename

    node name pattern that allows wildcards: * = any or no char, ? = any char, [abc] = only chars in brackets

notexpired

Wertet Elemente aus, indem überprüft wird, ob eine JCR DATE-Eigenschaft größer oder gleich der aktuellen Serverzeit ist. Dies kann verwendet werden, um eine Datumseigenschaft wie „expiresAt“ zu überprüfen und das Ergebnis auf diejenigen zu beschränken, die noch nicht abgelaufen sind (notexpired=true) bzw. bereits abgelaufen sind ( notexpired=false).

Filtern wird nicht unterstützt.

Unterstützt die Facettenextraktion auf die gleiche Weise wie die Eigenschaft „daterange“.

Eigenschaften

  • notexpired

    Boolescher Wert, „true“ für noch nicht abgelaufen (Datum in der Zukunft oder gleich), „false“ für abgelaufen (Datum in der Vergangenheit) (erforderlich)

  • property

    relative path to the DATE property to check (required)

orderby

Ermöglicht das Sortieren des Ergebnisses. If ordering by multiple properties is required, this predicate needs to be added multiple times using the number prefix, such as 1_orderby=first, 2_oderby=second.

Eigenschaften

  • orderby

    either JCR property name indicated by a leading @, for example @jcr:lastModified or @jcr:content/jcr:title, or another predicate in the query, for example 2_property, on which to sort

  • sortieren

    sort direction, either " desc" for descending or " asc" for ascending (default)

  • case

    Wird hierfür „ignore“ festgelegt, wird die Groß-/Kleinschreibung nicht beachtet, „a“ kommt also vor „B“. Wird dies leer- oder ausgelassen, wird bei der Sortierung die Groß-/Kleinschreibung beachtet, „B“ kommt also vor „a“.

path

Sucht innerhalb eines gegebene Pfads.

Facettenextraktion wird nicht unterstützt.

Eigenschaften

  • path

    path pattern; depending on exact, either the entire subtree will match (like appending /* in xpath, but note that this does not include the base path) (exact=false, default) or only an exact path matches, which can include wildcards ( *); if self is set, the entire subtree including the base node will be searched

  • genau

    if exact is true/on, the exact path must match, but it can contain simple wildcards ( *), that match names, but not " /"; if it is false (default) all descendents are included (optional)

  • flach

    searches only the direct children (like appending " /*" in xpath) (only used if ' exact' is not true, optional)

  • self

    Durchsucht den Teilbaum aber bezieht den als Pfad angegebenen Basisknoten mit ein (keine Platzhalter)

property

Sucht nach JCR-Eigenschaften und ihren Werten.

Unterstützt die Facettenextraktion. Stellt für jeden eindeutigen Eigenschaftswert in den Ergebnissen einen Bucket zur Verfügung.

Eigenschaften

  • property

    relative path to property, for example jcr:title

  • Wert

    Wert, auf den die Eigenschaft überprüft werden soll. Verarbeitet Umwandlungen anhand des JCR-Eigenschaftstyps als Zeichenfolgen.

  • N_value

    use 1_value, 2_value, … to check for multiple values (combined with OR by default, with AND if and=true) (since 5.3)

  • und

    set to true for combining multiple values ( N_value) with AND (since 5.3)

  • operation

    " equals"für exakte Übereinstimmung (Standard), " unequals"für Ungleichheitsvergleich, " like"für die Verwendung der jcr:like xpath-Funktion (optional), " not"für keine Übereinstimmung (z. B. " not(@prop)"in xpath wird value param ignoriert) oder " exists"für die Prüfung der Existenz (Wert kann true sein - Eigenschaft muss vorhanden sein, Standard - oder false - identisch mit " not"

  • depth

    Anzahl der Platzhalterebenen, unter denen die Eigenschaft/der relative Pfad vorhanden sein kann (z. B. property=size depth=2 überprüft Node/Größe, Node/&ast;/Größe und Node/&ast;/&ast;/size)

rangeproperty

Ordnet eine JCR-Eigenschaft einem Intervall zu. This applies to properties with linear types such as LONG, DOUBLE and DECIMAL. Details zu DATE finden Sie im Abschnitt zur Eigenschaft „daterange“, die für Eingaben im Datumsformat optimiert wurde.

Sie können eine untere Grenze und eine obere Grenze oder nur eine von ihnen definieren. Der Vorgang (z. B. „lesser than“ oder „lesser or equals“) kann auch einzeln für die untere und obere Grenze festgelegt werden.

Facettenextraktion wird nicht unterstützt.

Eigenschaften

  • property

    relativer Pfad zur Eigenschaft

  • lowerBound

    lower bound to check-Eigenschaft für

  • lowerOperation

    " >" (default) or " >=", applies to the lowerValue

  • upperBound

    Obergrenze für Prüfeigenschaft

  • upperOperation

    " <" (default) or " <=", applies to the lowerValue

  • decimal

    " true" if the checked property is of type Decimal

relativedaterange

Gleicht JCR DATE-Eigenschaften anhand von Zeit-Offsets, die relativ zur aktuellen Serverzeit sind, mit einem Datums-/Zeitintervall ab. You can specify lowerBound and upperBound using either a millisecond value or the bugzilla syntax 1s 2m 3h 4d 5w 6M 7y (one second, two minutes, three hours, four days, five weeks, six months, seven years). Prefix with " -" to indicate a negative offset before the current time. Wenn Sie nur lowerBound oder upperBound angeben, wird für die jeweils andere Grenze standardmäßig „0“ festgelegt, was die aktuelle Zeit bedeutet.

Beispiel:

  • upperBound=1h (und nein lowerBound) würde in der nächsten Stunde irgendetwas auswählen
  • lowerBound=-1d (und nein upperBound) würde in den letzten 24 Stunden etwas auswählen
  • lowerBound=-6M und upperBound=-3M wählen Sie alle 6 Monate bis 3 Monate aus.
  • lowerBound=-1500 und upperBound=5500 wählt alles aus, was im Zeitraum zwischen einschließlich 1500 Millisekunden in der Vergangenheit und einschließlich 5500 Millisekunden in der Zukunft liegt.
  • lowerBound=1d und upperBound=2d wählte übermorgen alles aus

Hinweis: Schaltjahre werden nicht berücksichtigt und alle Monate haben 30 Tage.

Filtern wird nicht unterstützt.

Unterstützt die Facettenextraktion auf die gleiche Weise wie die Eigenschaft „daterange“.

Eigenschaften

  • upperBound

    upper date bound in milliseconds or 1s 2m 3h 4d 5w 6M 7y (one second, two minutes, three hours, four days, five weeks, six months, seven years) relative to current server time, use "-" for negative offset

  • lowerBound

    lower date bound in milliseconds or 1s 2m 3h 4d 5w 6M 7y (one second, two minutes, three hours, four days, five weeks, six months, seven years) relative to current server time, use "-" for negative offset

root

Stammeigenschaftsgruppe. Unterstützt alle Eigenschaften einer Gruppe und ermöglicht das Festlegen globaler Abfrage-Parameter.

Der Name „root“ wird in Abfragen nie verwendet, er ist impliziert.

Eigenschaften

  • p.offset

    Zahl, die den Anfang der Ergebnisseite anzeigt, d. h. wie viele Elemente übersprungen werden sollen.

  • p.limit

    Zahl, die das Seitenformat angibt

  • p.rateTotal

    recommended: avoid calculating the full result total which can be costly; either a number indicating the maximum total to count up to (for example 1000, a number that gives users enough feedback on the rough size and exact numbers for smaller results) or " true" to count only up to the minimum necessary p.offset + p.limit

  • p.excerpt

    if set to " true", include full text excerpt in the result

  • p.hits

    (nur für das JSON-Servlet) Legt fest, wie Treffer als JSON geschrieben werden. Folgende Standardmethoden stehen zur Auswahl (erweiterbar über den Dienst „ResultHitWriter“):

    • einfach:

      Minimale Elemente wie path, title, lastmodified, excerpt (falls festgelegt)

    • vollständig:

      sling JSON rendering of the node, with jcr:path indicating the path of the hit: by default just lists the direct properties of the node, include a deeper tree with p.nodedepth=N, with 0 meaning the entire, infinite subtree; add p.acls=true to include the JCR permissions of the current session on the given result item (mappings: create = add_node, modify = set_property, delete = remove)

    • selektiv:

      only properties specified in p.properties, which is a space separated (use "+" in URLs) list of relative paths; if the relative path has a depth > 1 these will be represented as child objects; the special jcr:path property includes the path of the hit

savedquery

Fügt alle Eigenschaften einer beständigen querybuilder-Abfrage der aktuellen Abfrage als Untergruppeneigenschaft hinzu.

Dabei wird keine Extra-Abfrage ausgeführt, sondern die aktuellen Query erweitert.

Queries can be persisted programmatically using QueryBuilder#storeQuery(). Das Format kann entweder eine String-Eigenschaft mit mehreren Zeilen oder ein nt:file-Knoten sein, der die Abfrage als Textdatei im Java-Eigenschaftsformat enthält.

Die Facettenextraktion wird für die Eigenschaften der gespeicherten Abfrage nicht unterstützt

Eigenschaften

  • savedquery

    path to the saved query (String property or nt:file node)

similar

Similarity search using JCR XPath's rep:similar().

Filtern wird nicht unterstützt. Facettenextraktion wird nicht unterstützt.

Eigenschaften

  • similar Absoluter Pfad zum Knoten, für den ähnliche Knoten gefunden werden sollen.

  • lokal einen relativen Pfad zu einem untergeordneten Knoten oder
    . für die aktuelle Node (optional) (Standard ist " .")

tag

Sucht nach Inhalten mit Tags, indem Tag-Titelpfade angegeben werden.

Unterstützt die Facettenextraktion. Stellt Buckets für jedes einzigartige Tag bereit. Dazu wird jeweils der aktuelle Tag-Titelpfad verwendet.

Eigenschaften

  • tag

    Tag-Titelpfad, nach dem gesucht werden soll, z. B. „Asset-Eigenschaften: Ausrichtung/Querformat“

  • N_value

    use 1_value, 2_value, … to check for multiple tags (combined with OR by default, with AND if and=true) (since 5.6)

  • property

    property (or relative path to property) to look at (default " cq:tags")

tagid

Sucht nach Inhalten mit Tags, indem Tag-IDs angegeben werden.

Unterstützt die Facettenextraktion. Stellt Buckets für jedes einzigartige Tag bereit. Dazu wird jeweils der aktuelle Tag-ID verwendet.

Eigenschaften

  • tagid

    tag id to look for, for example " properties:orientation/landscape"

  • N_value

    use 1_value, 2_value, … to check for multiple tagids (combined with OR by default, with AND if and=true) (since 5.6)

  • property

    property (or relative path to property) to look at (default " cq:tags")

tagsearch

Sucht nach Inhalten mit Tags, indem Suchbegriffe angegeben werden. Hierbei wird zunächst nach Tags gesucht, die diese Suchbegriffe in ihrem Titel enthalten, worauf das Ergebnis auf Elemente mit diesen Tags eingeschränkt wird.

Facettenextraktion wird nicht unterstützt.

Eigenschaften

  • tagsearch

    Suchbegriff, nach dem in Tag-Titeln gesucht werden soll

  • property

    property (or relative path to property) to look at (default " cq:tags")

  • lang

    to search in a certain localized tag title only (e.g. " de")

  • all

    (bool) den gesamten Tag Volltext durchsuchen, d.h. alle Titel, Beschreibung usw. (hat Vorrang vor "l ang")

Typ

Schränkt Ergebnisse auf einen bestimmten JCR-Knotentyp ein, sowohl den primären Knotentyp als auch den Mixin-Typ. Hierbei werden auch Untertypen dieses Knotentyps gefunden. Zur effizienten Ausführung müssen Repository-Suchindizes die Knotentypen enthalten.

Unterstützt die Facettenextraktion. Stellt für jeden einzigartigen Typ in den Ergebnissen einen Bucket zur Verfügung.

Eigenschaften

  • Typ

    node type or mixin name to search for, for example cq:Page

Auf dieser Seite