Voorlopige naslaggids voor Query Builder

Laatst bijgewerkt: 5 mei 2025

Van toepassing op:
Experience Manager 6.5

Onderwerpen:

Gemaakt voor:

Ontwikkelaar

LET OP

De informatie op deze pagina is niet volledig.

Voor volledige informatie, zie de lijst onder Beschikbare predikaten op de Debugger van de Bouwer van de Vraag console; bijvoorbeeld, bij:

http://localhost:4502/libs/cq/search/content/querydebug.html

Zie bijvoorbeeld:

http://localhost:4502/system/console/services?filter=%28component.factory%3Dcom.day.cq.search.eval.PredicateEvaluator%2F*%29

Voorspellen

boolproperty

Komt overeen met de JCR BOOLEAN-eigenschappen. Accepteert alleen de waarden " true" en " false". Als " false", komt dit overeen als de eigenschap de waarde " false" heeft of als deze helemaal niet bestaat. Dit kan handig zijn om te controleren op Booleaanse markeringen die alleen zijn ingesteld wanneer deze zijn ingeschakeld.

De overgeërfde parameter " operation" heeft geen betekenis.

Ondersteunt facetextractie. Verstrekt emmers voor elke true of false waarde, maar slechts voor bestaande eigenschappen.

Eigenschappen

boolproperty
Relatief pad naar eigenschap, bijvoorbeeld myFeatureEnabled of jcr:content/myFeatureEnabled .
waarde
Waarde waarvoor de eigenschap moet worden gecontroleerd: " true" of " false".

contentfragment

Hiermee beperkt u het resultaat tot inhoudsfragmenten.

Filteren wordt niet ondersteund.

Biedt geen ondersteuning voor facetextractie.

Eigenschappen

contentfragment
Deze kan met elke waarde worden gebruikt om te controleren op inhoudsfragmenten.

dateComparison

Vergelijkt twee JCR DATE-eigenschappen met elkaar. U kunt testen of ze gelijk, ongelijk, groter dan of groter dan of gelijk zijn.

Dit is een voorspelling die alleen kan worden gefilterd en er kan geen zoekindex worden gebruikt.

Eigenschappen

property1

Eigenschap pad naar eerste datum.
property2

Pad naar tweede-datumeigenschap.
verrichting

" equals" voor exacte overeenkomst, " !=" voor ongelijkheidsvergelijking, " greater" voor eigenschap1 groter dan eigenschap2, " >=" voor eigenschap1 groter dan of gelijk aan eigenschap2. De standaardwaarde is " equals".

daterange

Hiermee worden de JCR-DATE-eigenschappen vergeleken met een datum-/tijdinterval. Dit gebruikt ISO8601
notatie voor datums en tijden ( YYYY-MM-DDTHH:mm:ss.SSSZ) en staat ook gedeeltelijke representaties toe, zoals YYYY-MM-DD . U kunt de tijdstempel ook opgeven als het aantal milliseconden dat is verstreken sinds 1970 in de UTC-tijdzone, de UNIX®-tijdnotatie.

U kunt zoeken naar iets tussen twee tijdstempels, alles wat nieuwer of ouder is dan een bepaalde datum, en u kunt ook kiezen tussen inclusieve en open intervallen.

Ondersteunt facetextractie. Verstrekt emmers "vandaag", "deze week", "deze maand", "laatste drie maanden", "dit jaar", "vorig jaar" en "vroeger dan vorig jaar".

Filteren wordt niet ondersteund.

Eigenschappen

bezit

Relatief pad naar een eigenschap DATE , bijvoorbeeld jcr:lastModified .
lowerBound

Lagere datum gebonden aan check eigenschap for, bijvoorbeeld 2014-10-01.
lowerOperation

" >" (nieuwer) of " >=" (hoger of hoger) is van toepassing op de lowerBound . De standaardwaarde is " >".
upperBound

Bovenaan gebonden om de eigenschap te controleren op, bijvoorbeeld, 2014-10-01T12:15:00 .
upperOperation

" <" (ouder) of " <=" (ouder of ouder), is van toepassing op upperBound . De standaardwaarde is " <".
timeZone

Id van tijdzone die moet worden gebruikt wanneer deze niet wordt gegeven als een ISO-8601-datumtekenreeks. De standaardwaarde is de standaardtijdzone van het systeem.

exclusief paden

Hiermee sluit u knooppunten uit van het resultaat wanneer het pad ervan overeenkomt met een reguliere expressie.

Dit is een voorspelling die alleen kan worden gefilterd en er kan geen zoekindex worden gebruikt.

Biedt geen ondersteuning voor facetextractie.

Eigenschappen

exclusief wegen

Gewone expressie die overeenkomt met resultaatpaden, exclusief overeenkomende paden uit het resultaat.

fulltext

Zoekt naar termen in de fullText-index.

Filteren wordt niet ondersteund.

Biedt geen ondersteuning voor facetextractie.

Eigenschappen

fulltext

De zoektermen in fulltext.
relPath

Het relatieve pad naar de eigenschap of het subknooppunt. Deze eigenschap is optioneel.

groep

Hiermee kunnen geneste voorwaarden worden gemaakt. Groepen kunnen geneste groepen bevatten. Alles in een query builder-query bevindt zich impliciet in een hoofdgroep, die ook p.or - en p.not -parameters kan hebben.

Voorbeeld voor het afstemmen van een van de twee eigenschappen op een waarde:

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

Dit is conceptueel (1_property OR 2_property) .

Voorbeeld voor geneste groepen:

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

Dit zoekt naar de termijn "Beheer"binnen pagina's in /content/geometrixx/en of in activa in /content/dam/geometrixx.

Dit is conceptueel fulltext AND ( (path AND type) OR (path AND type) ) . Zulke OF verbindingen hebben goede indexen voor prestaties nodig.

Eigenschappen

p.or

Indien ingesteld op " true", mag slechts één voorspelling in de groep overeenkomen. Dit is standaard " false", wat betekent dat alles moet overeenkomen
p.not

Indien ingesteld op " true", wordt de groep genegeerd (standaard ingesteld op " false").
<preate>

Hiermee voegt u geneste voorvertoningen toe.
N_<predicate>

Hiermee voegt u meerdere geneste voorspellen tegelijk toe, zoals 1_property, 2_property, ... .

hasPermission

Beperkt het resultaat tot punten waar de huidige zitting de gespecificeerde voorrechten JCR heeft.

Dit is een voorspelling die alleen kan worden gefilterd en er kan geen zoekindex worden gebruikt. Het ondersteunt geen facetextractie.

Eigenschappen

hasPermission

JCR-bevoegdheden die door komma's worden gescheiden en die ALLES voor de huidige gebruikerssessie moet hebben. Bijvoorbeeld jcr:write , jcr:modifyAccessControl .

taal

Hiermee zoekt u CQ-pagina's in een specifieke taal. Hierbij wordt zowel naar de eigenschap language van de pagina als naar het paginapad gekeken, dat vaak de taal of landinstelling in een site-structuur op hoofdniveau bevat.

Dit is een voorspelling die alleen kan worden gefilterd en er kan geen zoekindex worden gebruikt.

Ondersteunt facetextractie. Verstrekt emmers voor elke unieke taalcode.

Eigenschappen

taal

ISO taalcode, bijvoorbeeld, "de"

hoofdmiddel

Controleert of een knooppunt een DAM-hoofdelement is en geen subelement. Dit is eigenlijk elk knooppunt dat zich niet binnen een 'subassets'-knooppunt bevindt. Dit controleert niet op het knooppunttype dam:Asset. Als u deze voorspelling wilt gebruiken en " mainasset=true" of " mainasset=false" wilt instellen, zijn er geen eigenschappen meer.

Dit is een voorspelling die alleen kan worden gefilterd en er kan geen zoekindex worden gebruikt.

Steunt facetextractie en verstrekt twee emmers voor hoofd en subassets.

Eigenschappen

mainasset

Boolean, " true" voor hoofdelementen, " false" voor subelementen.

lidOf

Vindt punten die lid van een specifieke sling middelinzamelingzijn.

Dit is een voorspelling die alleen kan worden gefilterd en er kan geen zoekindex worden gebruikt. Biedt geen ondersteuning voor facetextractie.

Eigenschappen

memberOf

Pad van Sling-bronverzameling.

nodenaam

Komt overeen met namen van JCR-knooppunten.

Ondersteunt facetextractie. Verstrekt emmers voor elke unieke knoopnaam (filename).

Eigenschappen

nodename

Naamnotatiepatroon waarbij jokertekens zijn toegestaan: * = willekeurig of geen teken, ? = willekeurig teken, [abc] = alleen tekens tussen haakjes.

notexpired

Komt overeen met items door te controleren of een JCR DATE-eigenschap groter of gelijk is aan de huidige servertijd. Dit kan worden gebruikt om een " expiresAt"-achtige datumeigenschap in te schakelen en alleen de eigenschappen die nog niet zijn verlopen ( notexpired=true ) of die al zijn verlopen ( notexpired=false ).

Filteren wordt niet ondersteund.

Ondersteunt facetextractie op dezelfde manier als de daterange predikaat.

Eigenschappen

notexpired

Boolean, " true" for not expired yet (date in the future or equal), " false" for expired (date in the past) (required).
bezit

Relatief pad naar de eigenschap DATE die moet worden gecontroleerd (vereist).

ordonneren

Hiermee kunt u de resultaten sorteren. Als de volgorde door meerdere eigenschappen vereist is, moet deze voorspelling meerdere keren worden toegevoegd met behulp van het voorvoegsel number, zoals 1_orderby=first, 2_oderby=second .

Eigenschappen

orderby

De JCR-eigenschapnaam die wordt aangeduid door een regelafstand @, bijvoorbeeld @jcr:lastModified of @jcr:content/jcr:title , of een andere voorspelling in de query, bijvoorbeeld 2_property , waarop moet worden gesorteerd.
soort

Sorteer de richting " desc" voor aflopend of " asc" voor oplopend (standaard).
geval

Indien ingesteld op ignore , wordt het sorteren van hoofdletters en kleine letters ongevoelig, wat betekent dat "a" komt vóór "B"; als het sorteren leeg is of wordt weggelaten, is het sorteren hoofdlettergevoelig, wat betekent dat "B" komt vóór "a"

pad

Hiermee zoekt u in een bepaald pad.

Biedt geen ondersteuning voor facetextractie.

Eigenschappen

weg

Padpatroon. Afhankelijk van het exacte aantal komt ofwel de volledige subboomstructuur overeen (zoals //* wordt toegevoegd in xpath, maar dit omvat niet het basispad) (exact=false, standaard), ofwel alleen een exacte padovereenkomst, die jokertekens kan bevatten ( * ); als self is ingesteld, wordt de volledige substructuur, inclusief het basisknooppunt, doorzocht.
nauwkeurig

Als exact true/on is, moet het exacte pad overeenkomen, maar het kan eenvoudige jokertekens ( * ) bevatten, die identieke namen, maar niet " / ". Als het pad false is (standaard), worden alle afstammingen opgenomen (optioneel).
vlak

Hiermee zoekt u alleen de directe onderliggende elementen (zoals " /*" toevoegen in xpath) (alleen gebruikt als ' exact' niet true is, optioneel).
zelf

Doorzoekt de substructuur maar neemt het basisknooppunt op dat als pad wordt opgegeven (geen jokertekens).

eigenschap

Komt overeen met de JCR-eigenschappen en hun waarden.

Ondersteunt facetextractie. Verstrekt emmers voor elke unieke bezitswaarde in de resultaten.

Eigenschappen

bezit

Relatief pad naar eigenschap, bijvoorbeeld jcr:title .
waarde

Waarde waarop de eigenschap moet worden gecontroleerd; volgt het eigenschapstype JCR op tekenreeksconversies.
N_value

Gebruik 1_value, 2_value , … om te controleren op meerdere waarden (standaard gecombineerd met OR , met AND if en=true) (sinds 5.3).
en

Ingesteld op true voor het combineren van meerdere waarden ( N_value) met AND (sinds 5.3).
verrichting

"equals" voor exacte overeenkomst (standaardwaarde), " unequals" voor ongelijkheidsvergelijking, " like" voor het gebruik van de jcr:like xpath-functie (optioneel), " not " voor geen overeenkomst (bijvoorbeeld "not(@prop)" in xpath, value param wordt genegeerd) of " exists" voor controle op bestaan (waarde kan waar zijn - eigenschap moet bestaan, de standaardwaarde - of false - hetzelfde als " not").
diepte

Aantal jokertekenniveaus waaronder de eigenschap/het relatieve pad kan bestaan (bijvoorbeeld property=size depth=2 controleert knooppunt/grootte, knooppunt/*/size en knooppunt/*/*/*/size).

rangeproperty

Hiermee wordt een JCR-eigenschap vergeleken met een interval. Dit geldt voor eigenschappen met lineaire typen, zoals LONG , DOUBLE en DECIMAL . Zie voor DATE de daterange-voorspelling die geoptimaliseerde invoer voor de datumnotatie heeft.

U kunt een ondergrens en een bovengrens of slechts één van hen bepalen. De bewerking (bijvoorbeeld "kleiner dan" of "kleiner of gelijk aan") kan ook afzonderlijk worden opgegeven voor de onderste en bovenste binding.

Biedt geen ondersteuning voor facetextractie.

Eigenschappen

bezit

Relatief pad naar eigenschap.
lowerBound

Ondergrens om eigenschap te controleren voor.
lowerOperation

" >" (standaardwaarde) of " >=", is van toepassing op lowerValue
upperBound

Bovengrens om de eigenschap te controleren op.
upperOperation

" <" (standaardwaarde) of " <=", is van toepassing op lowerValue
decimaal

" true" als de gecontroleerde eigenschap van het type Decimaal is

relativedaterange

Vergelijkt JCR DATE eigenschappen met een datum-/tijdinterval met tijdverschuivingen ten opzichte van de huidige servertijd. U kunt lowerBound en upperBound opgeven met een millisecondenwaarde of de bugzilla-syntaxis 1s 2m 3h 4d 5w 6M 7y (één seconde, twee minuten, drie uur, vier dagen, vijf weken, zes maanden, zeven jaar). Voorvoegsel met " -" om een negatieve verschuiving vóór de huidige tijd aan te geven. Als u alleen lowerBound of upperBound opgeeft, wordt de andere standaard ingesteld op 0, wat de huidige tijd betekent.

Bijvoorbeeld:

upperBound=1h (en geen lowerBound ) selecteert de afbeelding in het volgende uur
lowerBound=-1d (en geen upperBound ) selecteert niets in de afgelopen 24 uur
lowerBound=-6M en upperBound=-3M selecteert elke 6 maanden tot 3 maanden oud
lowerBound=-1500 en upperBound=5500 selecteert in het vervolg iets tussen 1500 milliseconden en 5500 milliseconden
lowerBound=1d en upperBound=2d zouden overmorgen iets selecteren

Het neemt schrikkeljaren niet in overweging en alle maanden zijn 30 dagen.

Filteren wordt niet ondersteund.

Ondersteunt facetextractie op dezelfde manier als de daterange predikaat.

Eigenschappen

upperBound

Bovenste datum gebonden in milliseconden of 1s 2m 3h 4d 5w 6M 7y (één seconde, twee minuten, drie uren, vier dagen, vijf weken, zes maanden, zeven jaar) met betrekking tot huidige servertijd, gebruik "-"voor negatieve compensatie.
lowerBound

Lagere datum gebonden in milliseconden of 1s 2m 3h 4d 5w 6M 7y (één seconde, twee minuten, drie uren, vier dagen, vijf weken, zes maanden, zeven jaar) met betrekking tot huidige servertijd, gebruik "-"voor negatieve compensatie.

basis

Hoofdvoorspelbare groep. Steunt alle eigenschappen van een groep en laat u globale vraagparameters plaatsen.

De naam "wortel"wordt nooit gebruikt in een vraag, het is impliciet.

Eigenschappen

p.offset

Het getal dat het begin van de resultatenpagina aangeeft, dat wil zeggen het aantal items dat moet worden overgeslagen.
p.limit

Het getal dat het paginaformaat aangeeft.
p.radenTotal

Aanbevolen: vermijd het berekenen van het volledige resultaattotaal, wat kostbaar kan zijn. Ofwel een getal dat het maximale totaal aangeeft dat moet worden geteld tot (bijvoorbeeld 1000, een getal dat gebruikers voldoende feedback geeft op de ruwe grootte en exacte getallen voor kleinere resultaten), ofwel " true" om alleen te tellen tot het minimaal noodzakelijke p.offset + p.limit .
p.excerpt

Indien ingesteld op " true", neemt u het volledige tekstfragment op in het resultaat.
p.hits

(alleen voor de JSON-servlet) selecteer de manier waarop de treffers als JSON worden geschreven, met de volgende standaardresultaten (uitbreidbaar via de service ResultHitWriter):
- eenvoudig:
  
  Minimale items zoals path , title , lastmodified en excerpt (indien ingesteld).
- volledig:
  
  JSON-rendering van het knooppunt splitsen, met jcr:path die het pad van de hit aangeeft: standaard worden alleen de directe eigenschappen van het knooppunt weergegeven, inclusief een diepere structuur met p.nodedepth=N , die 0 staat voor de gehele, oneindige substructuur; voeg p.acls=true toe om de JCR-machtigingen van de huidige sessie voor het opgegeven resultaatitem op te nemen (toewijzingen: create = add_node, modify = set_property, delete = remove = }).
- selectief:
  
  Alleen de eigenschappen die zijn opgegeven in p.properties , dat een spatie is die is gescheiden (gebruik "+" in URL's) in de lijst met relatieve paden; als het relatieve pad een diepte heeft > 1, worden deze vertegenwoordigd als onderliggende objecten; de speciale eigenschap jcr:path bevat het pad van de hit

opgeslagen query

Omvat alle predikaten van een persisted vraag van de vraagbouwer in de huidige vraag als subgroup predikaat.

Hiermee wordt geen extra query uitgevoerd, maar wordt de huidige query uitgebreid.

Query's kunnen met programmacode worden voortgezet met QueryBuilder#storeQuery() . De indeling kan een eigenschap van een tekenreeks met meerdere regels zijn of een knooppunt nt:file dat de query als een tekstbestand in de Java™-eigenschappenindeling bevat.

Biedt geen ondersteuning voor facetextractie voor de voorspelling van de opgeslagen query.

Eigenschappen

opgeslagen vraag

Pad naar de opgeslagen query (eigenschap String of knooppunt nt:file ).

gelijkaardig

Gelijksoortige zoekopdracht met JCR XPath rep:similar().

Filteren wordt niet ondersteund. Biedt geen ondersteuning voor facetextractie.

Eigenschappen

gelijkaardig
Absoluut pad naar het knooppunt waarvoor vergelijkbare knooppunten moeten worden gevonden.
lokaal
Een relatief pad naar een afstammend knooppunt of . voor het huidige knooppunt (optioneel, standaard is " .").

tag

Hiermee zoekt u naar inhoud die is gelabeld met een of meer tags door titelpaden voor tags op te geven.

Ondersteunt facetextractie. Verschaft emmers voor elke unieke tag, waarbij het huidige pad voor de tagtitel wordt gebruikt.

Eigenschappen

markering

Titelpad van tag om bijvoorbeeld te zoeken naar "Eigenschappen van element: oriëntatie / liggend".
N_value

Gebruik 1_value, 2_value , … om te controleren op meerdere tags (standaard gecombineerd met OR , met AND if en=true) (sinds 5.6).
bezit

Eigenschap (of relatief pad naar eigenschap) die moet worden bekeken (standaard " cq:tags")

gelabeld

Hiermee zoekt u naar inhoud die is gelabeld met een of meer tags, door tag-id's op te geven.

Ondersteunt facetextractie. Verschaft emmers voor elke unieke tag met behulp van de huidige tag-id.

Eigenschappen

tagid

Label id zodat u bijvoorbeeld naar " properties:orientation/landscape" kunt zoeken.
N_value

Gebruik 1_value, 2_value , … om te controleren op meerdere tags (standaard gecombineerd met OR , met AND if en=true) (sinds 5.6).
bezit

Eigenschap (of relatief pad naar eigenschap) om naar te kijken (standaard " cq:tags").

tagzoeken

Zoekt naar inhoud gelabeld met een of meer tags door trefwoorden op te geven. Hiermee wordt eerst gezocht naar tags die deze trefwoorden in hun titels bevatten, en vervolgens wordt het resultaat beperkt tot alleen items die met deze trefwoorden zijn getagd.

Biedt geen ondersteuning voor facetextractie.

Eigenschappen

tagsearch

Trefwoord dat moet worden gezocht in tagtitels.
bezit

Eigenschap (of relatief pad naar eigenschap) om naar te kijken (standaard cq:tags).
lang

Als u alleen in een bepaalde gelokaliseerde tagtitel wilt zoeken (bijvoorbeeld de ).
allen

(bool) Zoek volledige labeltekst, dat wil zeggen alle titels, beschrijving enzovoort. Heeft voorrang op "l ang".

type

Hiermee beperkt u de resultaten tot een specifiek JCR-knooppunttype, zowel het primaire knooppunttype als het mixintype. Dit vindt ook subtypes van dat knooptype. In de zoekindexen van de opslagplaats moeten de knooppunttypen worden opgenomen voor een efficiënte uitvoering.

Ondersteunt facetextractie. Verstrekt emmers voor elk uniek type in de resultaten.

Eigenschappen

type

Node type of mixin naam aan onderzoek naar, bijvoorbeeld, cq:Page.

recommendation-more-help