Predikatreferens för Query Builder query-builder-predicate-reference
Allmänt general
Predikat predicates
boolproperty boolproperty
Matchar JCR BOOLEAN-egenskaper. Endast värdena " true
och " false
". If " false
", matchar om egenskapen har värdet " false
" eller om den inte finns alls. Detta kan vara användbart för att kontrollera om det finns booleska flaggor som bara är inställda när de är aktiverade.
Ärvda " operation
parametern har ingen betydelse.
Stöder extrahering av ansikten. Tillhandahåller bucket för varje true
eller false
värde, men bara för befintliga egenskaper.
Egenskaper properties
-
boolproperty
Relativ sökväg till egenskap, till exempelmyFeatureEnabled
ellerjcr:content/myFeatureEnabled
. -
value
Värde att kontrollera egenskap för, "true
" eller "false
".
innehållfragment contentfragment
Begränsar resultatet till innehållsfragment.
Filtrering stöds inte.
Stöder inte facetextrahering.
Egenskaper properties-1
- innehållfragment
Den kan användas med vilket värde som helst för att kontrollera om det finns innehållsfragment.
dateComparison datecomparison
Jämför två JCR DATE-egenskaper med varandra. Du kan testa om de är lika, olika, större än eller större än eller lika med.
Detta är ett predikat som bara kan filtreras och det går inte att använda ett sökindex.
Egenskaper properties-2
-
property1
Sökväg till första datumegenskap.
-
property2
Sökväg till andra datumegenskap.
-
operation
"
equals
" för exakt matchning, "!=
" för jämförelse av skillnader, "greater
" for property1 större än property2, ">=
" för property1 större än eller lika med property2. Standardvärdet är "equals
".
daterange daterange
Matchar JCR DATE-egenskaper mot ett datum/tidsintervall. Detta använder ISO8601-formatet för datum och tider ( YYYY-MM-DDTHH:mm:ss.SSSZ
) och tillåter även partiella representationer, som YYYY-MM-DD
. Alternativt kan tidsstämpeln anges i antal millisekunder sedan 1970 i UTC-tidszonen, UNIX®-tidsformatet.
Du kan söka efter vad som helst mellan två tidsstämplar, vad som helst nyare eller äldre än ett visst datum, och du kan även välja mellan inkluderande och öppna intervall.
Stöder extrahering av ansikten. Innehåller fickorna"idag","den här veckan","den här månaden","de senaste tre månaderna","det här året","det senaste året" och"tidigare än det senaste året".
Filtrering stöds inte.
Egenskaper properties-3
-
property
Relativ sökväg till en
DATE
egenskap, till exempeljcr:lastModified
. -
lowerBound
Lägre bindningsdatum till check-egenskap, till exempel
2014-10-01
. -
lowerOperation
"
>
" (nyare) eller ">=
" (på eller nyare), gäller förlowerBound
. Standardvärdet är ">
". -
upperBound
Övre gräns till check property for, till exempel
2014-10-01T12:15:00
. -
upperOperation
"
<
" (äldre) eller "<=
" (vid eller äldre), gäller förupperBound
. Standardvärdet är "<
". -
timeZone
ID för den tidszon som ska användas när den inte anges som en ISO-8601-datumsträng. Standardvärdet är systemets standardtidszon.
exkluderingar excludepaths
Utesluter noder från resultatet där deras sökväg matchar ett reguljärt uttryck.
Detta är ett predikat som bara kan filtreras och det går inte att använda ett sökindex.
Stöder inte facetextrahering.
Egenskaper properties-4
-
exkluderingar
Reguljära uttryck matchade mot resultatsökvägar, utan matchande sökvägar från resultatet.
fulltext fulltext
Söker efter termer i fulltextindexet.
Filtrering stöds inte.
Stöder inte facetextrahering.
Egenskaper properties-5
-
fulltext
Fulltextsöktermer.
-
relPath
Den relativa sökvägen som ska sökas i egenskapen eller undernoden. Den här egenskapen är valfri.
grupp group
Tillåter att kapslade villkor skapas. Grupper kan innehålla kapslade grupper. Allt i en fråga i en frågeverktyget ingår implicit i en rotgrupp som kan ha p.or
och p.not
parametrar också.
Exempel på matchning av en av två egenskaper mot ett värde:
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
Detta är begreppsmässigt (1_property
ELLER 2_property)
.
Exempel för kapslade grupper:
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
Detta söker efter termen "Förvaltning" på sidor i /content/geometrixx/en
eller i tillgångar i /content/dam/geometrixx
.
Detta är begreppsmässigt fulltext AND ( (path AND type) OR (path AND type) )
. Sådana ELLER-kopplingar behöver bra index för att fungera.
Egenskaper properties-6
-
p.or
Om inställt på "
true
", måste bara ett predikat i gruppen matcha. Standardvärdet är "false
", vilket betyder att alla måste matcha -
p.not
Om inställt på "
true
", negeras gruppen (standardvärdet är "false
"). -
<predicate>
Lägger till kapslade predikat.
-
N_<predicate>
Lägger till flera kapslade predikat samtidigt, som
1_property, 2_property, ...
.
hasPermission haspermission
Begränsar resultatet till objekt där den aktuella sessionen har den angivna JCR-behörighet.
Detta är ett predikat som bara kan filtreras och det går inte att använda ett sökindex. Det stöder inte facetextrahering.
Egenskaper properties-7
-
hasPermission
Kommaavgränsade JCR-behörigheter som den aktuella användarsessionen måste ALLA ha noden i fråga. Till exempel:
jcr:write
,jcr:modifyAccessControl
.
språk language
Söker efter CQ-sidor på ett visst språk. Det här tittar både på sidspråksegenskapen och sidsökvägen, som ofta innehåller språket eller språket i en webbplatsstruktur på den översta nivån.
Detta är ett predikat som bara kan filtreras och det går inte att använda ett sökindex.
Stöder extrahering av ansikten. Tillhandahåller bucket för varje unik språkkod.
Egenskaper properties-8
-
språk
ISO-språkkod, till exempel "
de
"
huvudtillgång mainasset
Kontrollerar om en nod är en DAM-huvudresurs och inte en underresurs. Detta är i stort sett alla noder som inte finns i en delresursnod. Detta söker inte efter dam:Asset
nodtyp. Ange " mainasset=true
" eller " mainasset=false
", det finns inga fler egenskaper.
Detta är ett predikat som bara kan filtreras och det går inte att använda ett sökindex.
Stöder facet-extrahering och ger två möjligheter för huvud- och delresurser.
Egenskaper properties-9
-
huvudtillgång
Boolean, "
true
" for main assets, "false
" för delresurser.
medlemOf memberof
Söker efter objekt som tillhör en viss resursinsamling för sling.
Detta är ett predikat som bara kan filtreras och det går inte att använda ett sökindex. Stöder inte facetextrahering.
Egenskaper properties-10
-
medlemOf
Sökväg till Sling-resurssamling.
nodename nodename
Matchar JCR-nodnamn.
Stöder extrahering av ansikten. Anger bucket för varje unikt nodnamn (filnamn).
Egenskaper properties-11
-
nodename
Nodnamnsmönster som tillåter jokertecken:
*
= ett eller inga tecken,?
= any char,[abc]
= endast tecken inom hakparenteser.
inte utgånget notexpired
Matchar objekt genom att kontrollera om en JCR DATE-egenskap är större eller lika med den aktuella servertiden. Detta kan användas för att kontrollera en expiresAt
" som date-egenskap och begränsa till endast de som ännu inte har gått ut ( notexpired=true
) eller som redan har gått ut ( notexpired=false
).
Filtrering stöds inte.
Stöder facet-extrahering på samma sätt som daterange-predikatet.
Egenskaper properties-12
-
inte utgånget
Boolean, "
true
" för ännu inte förfallit (datum i framtiden eller lika med), "false
" för utgången (tidigare datum) (obligatoriskt). -
property
Relativ sökväg till
DATE
egenskap som ska kontrolleras (obligatoriskt).
orderby orderby
Låter resultaten sorteras. Om det krävs en ordning efter flera egenskaper måste predikatet läggas till flera gånger med talprefixet, till exempel 1_orderby=first
, 2_oderby=second
.
Egenskaper properties-13
-
orderby
Antingen JCR-egenskapsnamn som anges av t.ex. ett radavstånd på @
@jcr:lastModified
eller@jcr:content/jcr:title
eller ett annat predikat i frågan, till exempel2_property
, som vi ska sortera efter. -
sortera
Sorteringsriktning, antingen
desc
" för fallande eller "asc
" för stigande (standard). -
case
Om inställt på
ignore
, blir sorteringsskiftläget okänsligt, vilket innebär att"a" kommer före"B". Om det är tomt eller utelämnas är sorteringen skiftlägeskänslig, vilket innebär att"B" kommer före"a"
bana path
Söker i en viss bana.
Stöder inte facetextrahering.
Egenskaper properties-14
-
bana
Banmönster. Beroende på exakt, matchar antingen hela underträdet (som att lägga till
//*
in xpath, but note that this does not include the base path) (exact=false, default), or only an exact path, which can include wilcards (*
); om self anges genomsöks hela underträdet inklusive basnoden. -
exakt
If
exact
är true/on, den exakta sökvägen måste matcha, men den kan innehålla enkla jokertecken (*
), som matchar namn, men inte "/
"; om det är false (standard) inkluderas alla underordnade (valfritt). -
platt
Söker bara efter direkt underordnade objekt (som att lägga till "
/*
" in xpath) (används endast om "exact
' är inte sant, valfritt). -
self
Söker i underträdet men inkluderar basnoden som angetts som sökväg (inga jokertecken).
property property
Matchar JCR-egenskaper och deras värden.
Stöder extrahering av ansikten. Innehåller grupper för varje unikt egenskapsvärde i resultatet.
Egenskaper properties-15
-
property
Relativ sökväg till egenskap, till exempel
jcr:title
. -
value
Värde som egenskapen ska kontrolleras för; följer JCR-egenskapstypen till strängkonverteringar.
-
N_värde
Använd
1_value
,2_value
, … för att kontrollera om det finns flera värden (i kombination medOR
som standard medAND
if och=true) (sedan 5.3). -
och
Ange som true för att kombinera flera värden (
N_value
) med OCH (sedan 5.3). -
operation
"
equals
" för exakt matchning (standard), "unequals
" för jämförelse av skillnader, "like
" för att användajcr:like
xpath-funktion (valfri), "not
" för ingen matchning (till exempel "not(@prop)
" in xpath, value param is ignore) eller "exists
" for exist check (value can be true - property must exist, the default - or false - same as "not
"). -
djup
Antal jokernivåer under vilka egenskapen/den relativa sökvägen kan finnas (till exempel
property=size depth=2
kontrollerar nod/storlek, nod/*/size och nod/*/*/size).
rangeProperty rangeproperty
Matchar en JCR-egenskap mot ett intervall. Detta gäller egenskaper med linjär typ som LONG
, DOUBLE
och DECIMAL
. För DATE
, se daterange-predikatet som har optimerade indata för datumformat.
Du kan definiera en nedre gräns och en övre gräns eller endast en av dem. Åtgärden (t.ex. "mindre än" eller "mindre eller lika med") kan också anges individuellt för den nedre och övre gränsen.
Stöder inte facetextrahering.
Egenskaper properties-16
-
property
Relativ sökväg till egenskap.
-
lowerBound
Lägre gräns för att kontrollera egenskap för.
-
lowerOperation
"
>
" (standard) eller ">=
", gäller förlowerValue
-
upperBound
Övre gräns för att kontrollera egenskap för.
-
upperOperation
"
<
" (standard) eller "<=
", gäller förlowerValue
-
decimal
"
true
" om egenskapen checked är av typen Decimal
relativ relativedaterange
Matchar JCR DATE
egenskaper mot ett datum/tidsintervall med tidsförskjutningar i förhållande till den aktuella servertiden. Du kan ange lowerBound
och upperBound
med ett millisekundvärde eller bugzillasyntax 1s 2m 3h 4d 5w 6M 7y
(en sekund, två minuter, tre timmar, fyra dagar, fem veckor, sex månader, sju år). Prefix med " -
" om du vill ange en negativ förskjutning före den aktuella tiden. Om du bara anger lowerBound
eller upperBound
blir den andra standardvärdet 0, vilket innebär den aktuella tiden.
Till exempel:
upperBound=1h
(och nej)lowerBound
) skulle välja vad som helst under nästa timmelowerBound=-1d
(och nej)upperBound
) skulle välja vad som helst de senaste 24 timmarnalowerBound=-6M
ochupperBound=-3M
väljer du mellan 6 månader och 3 månaderlowerBound=-1500
ochupperBound=5500
kan välja mellan 1 500 millisekunder tidigare och 5 500 millisekunder i framtidenlowerBound=1d
ochupperBound=2d
skulle välja vad som helst i övermorgon
Den tar inte hänsyn till skottår och alla månader är 30 dagar.
Filtrering stöds inte.
Stöder facet-extrahering på samma sätt som daterange-predikatet.
Egenskaper properties-17
-
upperBound
Övre gräns i millisekunder eller
1s 2m 3h 4d 5w 6M 7y
(en sekund, två minuter, tre timmar, fyra dagar, fem veckor, sex månader, sju år) i förhållande till aktuell servertid, använd "-" för negativ offset. -
lowerBound
Nedre gräns för datum i millisekunder eller
1s 2m 3h 4d 5w 6M 7y
(en sekund, två minuter, tre timmar, fyra dagar, fem veckor, sex månader, sju år) i förhållande till aktuell servertid, använd "-" för negativ offset.
root root
Rotpredikatgrupp. Stöder alla funktioner i en grupp och låter dig ange globala frågeparametrar.
Namnet "root" används aldrig i en fråga, det är implicit.
Egenskaper properties-18
-
p.offset
Numret som anger början på resultatsidan, det vill säga hur många objekt som ska hoppas över.
-
p.limit
Numret som anger sidstorleken.
-
p.gissningTotal
Rekommenderas: undvik att beräkna det totala resultatet som kan vara kostsamt; antingen en siffra som anger det högsta antalet som ska räknas upp till (t.ex. 1000, ett tal som ger användarna tillräckligt med feedback på grovstorleken och exakta tal för mindre resultat) eller "
true
" för att endast räkna upp till det minsta nödvändigap.offset
+p.limit
. -
p.excerpt
Om inställt på "
true
", inkludera utdrag av fullständig text i resultatet. -
p.hits
(endast för JSON-servern) väljer du hur träffar skrivs som JSON, med dessa standardinställningar (utbyggbara via ResultHitWriter-tjänsten):
-
enkel:
Minimala objekt som
path
,title
,lastmodified
,excerpt
(om angivet). -
full:
Sling JSON rendering of the node, with
jcr:path
anger träffens sökväg: som standard visas bara nodens direkta egenskaper, inklusive ett djupare träd medp.nodedepth=N
, med 0 betyder hela det oändliga underträdet, lägg tillp.acls=true
för att inkludera JCR-behörigheterna för den aktuella sessionen för det angivna resultatobjektet (mappningar:create
=add_node
,modify
=set_property
,delete
=remove
). -
selektiv:
Endast egenskaper som anges i
p.properties
, som är en blankstegsavgränsad lista (använd "+" i URL:er) med relativa sökvägar. Om den relativa sökvägen har ett djup > 1 representeras de som underordnade objekt. Den speciella egenskapen jcr:path innehåller sökvägen till träffen
-
sparad fråga savedquery
Inkluderar alla predikat för en beständig frågebyggarfråga i den aktuella frågan som ett undergruppsprediat.
Detta kör inte en extra fråga utan utökar den aktuella frågan.
Frågor kan sparas programmatiskt med QueryBuilder#storeQuery()
. Formatet kan vara en strängegenskap med flera rader eller en nt:file
nod som innehåller frågan som en textfil i Java™-egenskapsformat.
Stöder inte facetextrahering för predikaten i den sparade frågan.
Egenskaper properties-19
-
sparad fråga
Sökväg till den sparade frågan (egenskapen String eller
nt:file
nod).
liknande similar
Likhetssökning med JCR XPath rep:similar()
.
Filtrering stöds inte. Stöder inte facetextrahering.
Egenskaper properties-20
-
liknande
Absolut sökväg till noden som liknande noder ska hittas för. -
lokal
En relativ sökväg till en underordnad nod eller.
för den aktuella noden (valfritt) är ".
").
tag tag
Söker efter innehåll som har taggats med en eller flera taggar genom att ange sökvägar för taggtiteln.
Stöder extrahering av ansikten. Tillhandahåller bucket för varje unik tagg med hjälp av den aktuella taggtitelsökvägen.
Egenskaper properties-21
-
tag
Taggtitelsökväg som du vill söka efter, t.ex. "Resursegenskaper : Orientation / Landscape".
-
N_värde
Använd
1_value
,2_value
, … för att kontrollera om det finns flera taggar (i kombination medOR
som standard medAND
if och=true) (sedan 5.6). -
property
Egenskap (eller relativ sökväg till egenskap) som ska kontrolleras (standard)
cq:tags
")
tagid tagid
Söker efter innehåll som taggats med en eller flera taggar genom att ange tagg-ID:n.
Stöder extrahering av ansikten. Tillhandahåller bucket för varje unik tagg med deras aktuella tagg-ID.
Egenskaper properties-22
-
tagid
Tagg-id så att du till exempel kan leta efter"
properties:orientation/landscape
". -
N_värde
Använd
1_value
,2_value
, … för att kontrollera om det finns flera taggar (i kombination medOR
som standard medAND
if och=true) (sedan 5.6). -
property
Egenskap (eller relativ sökväg till egenskap) som ska kontrolleras (standard)
cq:tags
").
tagsearch tagsearch
Söker efter innehåll som taggats med en eller flera taggar genom att ange nyckelord. Detta söker först efter taggar som innehåller dessa nyckelord i sina titlar och begränsar sedan resultatet till endast objekt som taggats med dessa.
Stöder inte facetextrahering.
Egenskaper Properties-1
-
tagsearch
Nyckelord att söka efter i taggtitlar.
-
property
Egenskap (eller relativ sökväg till egenskap) som ska undersökas (standard)
cq:tags
). -
lang
Om du bara vill söka i en viss lokaliserad taggtitel (till exempel
de
). -
alla
(bool) Sök i hela taggens fulltext, det vill säga alla titlar, beskrivning och så vidare. Har företräde framför"l"
ang
".
type type
Begränsar resultaten till en viss JCR-nodtyp, både primär nodtyp och blandningstyp. Detta söker även efter undertyper av den nodtypen. Databasens sökindex måste omfatta nodtyperna för effektiv körning.
Stöder extrahering av ansikten. Innehåller grupper för varje unik typ i resultatet.
Egenskaper Properties-2
-
type
Nodtyp eller mixnamn att söka efter, till exempel
cq:Page
.