Corrisponde alle proprietà JCR BOOLEAN. Accetta solo i valori " true
" e " false
". In caso di " false
", la corrispondenza sarà valida se la proprietà ha il valore " false
" o se non esiste affatto. Questa funzione può essere utile per verificare la presenza di flag booleani impostati solo se abilitati.
Il parametro " operation
" ereditato non ha alcun significato.
Supporta l'estrazione dei facet. Fornirà bucket per ciascun valore true
o false
, ma solo per le proprietà esistenti.
percorso
relativo alla proprietà, ad esempio
myFeatureEnabled
o jcr:content/myFeatureEnabled
valore
per la proprietà check, "
true
" o " false
"
Limita il risultato ai frammenti di contenuto.
Non supporta il filtro.
Non supporta l'estrazione facet.
Confronta tra loro due proprietà JCR DATE. Può verificare se sono uguali, diversi, maggiori o maggiori di o uguali.
Si tratta di un predicato di solo filtraggio e non può sfruttare un indice di ricerca.
property1
percorso della prima proprietà data
property2
percorso della proprietà seconda data
operation
" =
" per la corrispondenza esatta, " !=
" per il confronto di disuguaglianza, " >
" per la proprietà1 maggiore di property2, " >=
" per la proprietà1 maggiore o uguale a property2. Il valore predefinito è " =
".
Corrisponde alle proprietà DATA JCR rispetto a un intervallo data/ora. Viene utilizzato lo standard ISO8601
formato per date e ore ( YYYY-MM-DDTHH:mm:ss.SSSZ
) e consente anche rappresentazioni parziali, come YYYY-MM-DD
. In alternativa, la marca temporale può essere fornita come numero di millisecondi a partire dal 1970 nel fuso orario UTC, il formato ora uniforme.
Potete cercare qualsiasi elemento tra due marche temporali, qualsiasi data più recente o precedente, e scegliere anche tra intervalli inclusivi e aperti.
Supporta l'estrazione dei facet. Fornirà i secchi "oggi", "questa settimana", "questo mese", "ultimi 3 mesi", "quest'anno", "l'anno scorso" e "prima dello scorso anno".
Non supporta il filtro.
proprietà
percorso relativo a una proprietà DATE
, ad esempio jcr:lastModified
lowerBound
data inferiore associata a una proprietà di controllo, ad esempio 2014-10-01
lowerOperation
" >
" (più recente) o " >=
" (più recente), si applica a lowerBound
. Il valore predefinito è " >
".
UpperBound
Upper associato a check property per, ad esempio 2014-10-01T12:15:00
UpperOperation
" <
" (precedente) o " <=
" (precedente o successiva), si applica alla variabile upperBound
. Il valore predefinito è " <
".
timeZone
ID del fuso orario da utilizzare quando non viene specificato come stringa data ISO-8601. L'impostazione predefinita è il fuso orario predefinito del sistema.
Esclude i nodi dal risultato se il percorso corrisponde a un'espressione regolare.
Si tratta di un predicato di solo filtraggio e non può sfruttare un indice di ricerca.
Non supporta l'estrazione facet.
excludepaths
espressione regolare confrontata con i percorsi dei risultati, escludendo quelli corrispondenti dal risultato.
Cerca i termini nell'indice full-text.
Non supporta il filtro.
Non supporta l'estrazione facet.
fulltext
termini di ricerca full-text
relPath
percorso relativo da cercare nella proprietà o nel nodo secondario. Questa proprietà è facoltativa.
Consente di creare condizioni nidificate. I gruppi possono contenere gruppi nidificati. Tutto in una query querybuilder è implicitamente in un gruppo radice, che può avere anche p.or
e p.not
parametri.
Esempio di corrispondenza tra una delle due proprietà e un valore:
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
Questo è concettualmente (1_property
OR 2_property)
.
Esempio per i gruppi nidificati:
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
Viene ricercato il termine "Management" all'interno delle pagine in /content/geometrixx/en
o nelle risorse in /content/dam/geometrixx
.
Questo è concettualmente fulltext AND ( (path AND type) OR (path AND type) )
. Tenere presente che tali join OR richiedono buoni indici per le prestazioni.
p.or
se è impostato su " true
", solo un predicato nel gruppo deve corrispondere. Questo valore predefinito è " false
", ovvero tutti devono corrispondere
p.not
se impostato su " true
", nega il gruppo (per impostazione predefinita, è " false
")
<predicate>
aggiunge predicati nidificati
N_<predicate>
aggiunge più predicati nidificati contemporaneamente, come 1_property, 2_property, ...
Limita il risultato agli elementi in cui la sessione corrente dispone dei privilegi JCR specificati.
Si tratta di un predicato di solo filtraggio e non può sfruttare un indice di ricerca. Non supporta l'estrazione dei facet.
hasPermission
privilegi JCR separati da virgola che la sessione utente corrente deve avere per il nodo in questione; ad esempio jcr:write
, jcr:modifyAccessControl
Trova le pagine CQ in una lingua specifica. Questo esamina sia la proprietà della lingua della pagina che il percorso della pagina, che spesso include la lingua o le impostazioni internazionali in una struttura del sito di livello principale.
Si tratta di un predicato di solo filtraggio e non può sfruttare un indice di ricerca.
Supporta l'estrazione dei facet. Forniranno bucket per ogni codice di lingua univoco.
language
Codice della lingua ISO, ad esempio " de
"
Controlla se un nodo è una risorsa principale DAM e non una risorsa secondaria. In pratica, si tratta di ogni nodo che non si trova all'interno di un nodo "subassets". Tenere presente che questo non verifica il tipo di nodo dam:Asset
. Per utilizzare questo predicato, è sufficiente impostare " mainasset=true
" o " mainasset=false
", non ci sono ulteriori proprietà.
Si tratta di un predicato di solo filtraggio e non può sfruttare un indice di ricerca.
Supporta l'estrazione dei facet. Fornirà 2 socket per risorse principali e secondarie.
main asset
booleano, " true
" per le risorse principali, " false
" per le risorse secondarie
Trova gli elementi che fanno parte di una raccolta di risorse sling specifica.
Si tratta di un predicato di solo filtraggio e non può sfruttare un indice di ricerca. Non supporta l'estrazione facet.
MemberOf
percorso della raccolta di risorse Sling
Corrisponde ai nomi dei nodi JCR.
Supporta l'estrazione dei facet. Fornirà bucket per ogni nome di nodo univoco (nome file).
nodename
pattern di nome nodo che consente i caratteri jolly: *
= any or no char, ?
= any char, [abc]
= only chars in parentesi
Corrisponde agli elementi controllando se una proprietà JCR DATE è maggiore o uguale all'ora del server corrente. Questo può essere utilizzato per controllare una proprietà " expiresAt
" come date e limitare solo a quelle che non sono ancora scadute ( notexpired=true
) o che sono già scadute ( notexpired=false
).
Non supporta il filtro.
Supporta l'estrazione dei facet nello stesso modo del predicato daterange.
not
booleano, " true
" per non ancora scaduto (data in futuro o uguale), " false
" per scaduto (data in passato) (obbligatorio)
proprietà
percorso relativo alla proprietà DATE
da verificare (obbligatorio)
Consente di ordinare il risultato. Se l'ordine è richiesto da più proprietà, questo predicato deve essere aggiunto più volte utilizzando il prefisso del numero, ad esempio 1_orderby=first
, 2_oderby=second
.
ordine
il nome della proprietà JCR indicato da una @ iniziale, ad esempio @jcr:lastModified
o @jcr:content/jcr:title
, oppure da un altro predicato nella query, ad esempio 2_property
, sul quale eseguire l'ordinamento.
ordina
direzione di ordinamento, " desc
" per discendente o " asc
" per crescente (predefinito)
case
se è impostato su " ignore
", l'ordinamento non fa distinzione tra maiuscole e minuscole, il che significa che "a" precede "B"; se vuoto o omesso, l'ordinamento è sensibile alle maiuscole/minuscole, il che significa "B" precede "a"
Ricerche all’interno di un determinato percorso.
Non supporta l'estrazione facet.
path
modello di percorso; in base all'esatta, l'intera sottostruttura corrisponderà (come aggiungere //*
in xpath, ma si noti che non include il percorso di base) (exact=false, default) o solo una corrispondenza esatta del percorso, che può includere caratteri jolly ( *
); se è impostato su se stesso, verrà eseguita la ricerca nell'intera sottostruttura, incluso il nodo di base
exact
se exact
è true/on, il percorso esatto deve corrispondere, ma può contenere caratteri jolly semplici ( *
) che corrispondono ai nomi, ma non " /
"; se è false (impostazione predefinita), tutti i discendenti sono inclusi (facoltativo)
piatto
esegue la ricerca solo negli elementi figlio diretti (come l'aggiunta di " /*
" in xpath) (utilizzato solo se ' exact
' non è true, facoltativo)
self
esegue la ricerca nella sottostruttura, ma include il nodo di base specificato come percorso (nessun carattere jolly)
Corrisponde alle proprietà JCR e ai relativi valori.
Supporta l'estrazione dei facet. Fornirà bucket per ogni valore di proprietà univoca nei risultati.
proprietà
percorso relativo alla proprietà, ad esempio jcr:title
valore
value to check property for; segue il tipo di proprietà JCR in conversioni stringa
N_value
utilizzare 1_value
, 2_value
, … per controllare più valori (combinati con OR
per impostazione predefinita, con AND
if and=true) (da 5.3)
e
impostato su true per combinare più valori ( N_value
) con AND (da 5.3)
operation
" equals
" per corrispondenza esatta (impostazione predefinita), " unequals
" per confronto di non uguaglianza, " like
" per l'utilizzo della funzione jcr:like
xpath (facoltativo), " not
" per nessuna corrispondenza (ad esempio " not(@prop)
" in xpath, value param verrà ignorato) o " exists
" per il controllo dell'esistenza (il valore può essere true - la proprietà deve esistere, il valore predefinito - o falso - è uguale a " not
")
profondità
numero di livelli di caratteri jolly al di sotto dei quali può esistere la proprietà/percorso relativo (ad esempio, property=size depth=2
controllerà nodo/dimensione, nodo/*/dimensione e nodo/*/*/dimensione)
Corrisponde a una proprietà JCR rispetto a un intervallo. Ciò si applica alle proprietà con tipi lineari quali LONG
, DOUBLE
e DECIMAL
. Per DATE
, vedere il predicato daterange che ha un formato data ottimizzato.
È possibile definire un limite inferiore e un limite superiore o solo uno di essi. Operazione (ad esempio È inoltre possibile specificare "minore di" o "minore o uguale a") per ciascun limite inferiore e superiore.
Non supporta l'estrazione facet.
proprietà
percorso relativo alla proprietà
lowerBound
lower bound to check, proprietà
lowerOperation
" >
" (predefinito) o " >=
" si applica a lowerValue
UpperBound
con limite superiore per controllare la proprietà
UpperOperation
" <
" (predefinito) o " <=
" si applica a lowerValue
decimale
" true
" se la proprietà selezionata è di tipo Decimal
Corrisponde alle proprietà JCR DATE
rispetto a un intervallo di data/ora utilizzando gli offset relativi all'ora del server corrente. È possibile specificare lowerBound
e upperBound
utilizzando un valore in millisecondi o la sintassi bugzilla 1s 2m 3h 4d 5w 6M 7y
(un secondo, due minuti, tre ore, quattro giorni, cinque settimane, sei mesi, sette anni). Prefisso con " -
" per indicare un offset negativo prima dell'ora corrente. Se si specifica solo lowerBound
o upperBound
, l'altro valore predefinito sarà 0, ovvero l'ora corrente.
Esempio:
upperBound=1h
(e no lowerBound
) seleziona qualsiasi elemento nell'ora successivalowerBound=-1d
(e no upperBound
) avrebbe selezionato qualcosa nelle ultime 24 orelowerBound=-6M
e upperBound=-3M
sceglierebbe qualsiasi cosa dai 6 ai 3 mesilowerBound=-1500
e upperBound=5500
avrebbe selezionato qualsiasi cosa tra 1500 millisecondi negli ultimi e 5500 millisecondi nel futurolowerBound=1d
e upperBound=2d
sceglierebbe qualsiasi cosa dopo domaniSi noti che non prende in considerazione anni bisestili e che tutti i mesi sono 30 giorni.
Non supporta il filtro.
Supporta l'estrazione dei facet nello stesso modo del predicato daterange.
UpperBound
data superiore in millisecondi o 1s 2m 3h 4d 5w 6M 7y
(un secondo, due minuti, tre ore, quattro giorni, cinque settimane, sei mesi, sette anni) rispetto all'ora corrente del server, utilizzare "-" per l'offset negativo
lowerBound
data inferiore in millisecondi o 1s 2m 3h 4d 5w 6M 7y
(un secondo, due minuti, tre ore, quattro giorni, cinque settimane, sei mesi, sette anni) rispetto all'ora corrente del server, utilizzare "-" per l'offset negativo
Gruppo di predicati radice. Supporta tutte le funzionalità di un gruppo e consente di impostare parametri di query globali.
Il nome "root" non viene mai utilizzato in una query, è implicito.
p.offset
numero che indica l’inizio della pagina dei risultati, ovvero quanti elementi saltare
p.limit
numero che indica le dimensioni della pagina
p.indovinaTotale
consigliato: evitare di calcolare l'intero risultato complessivo che può essere costoso; un numero che indica il totale massimo da conteggiare fino a (ad esempio 1000, un numero che fornisce agli utenti un feedback sufficiente sulla dimensione approssimativa e sui numeri esatti per risultati più piccoli) oppure " true
" per conteggiare solo fino al minimo necessario p.offset
+ p.limit
p.excerpt
se impostato su " true
", includete un estratto di testo completo nel risultato
p.hits
(solo per il servlet JSON) selezionate il modo in cui gli hit vengono scritti come JSON, con i seguenti standard (estensibili tramite il servizio ResultHitWriter):
semplice:
elementi minimi come path
, title
, lastmodified
, excerpt
(se impostati)
completo:
rendering JSON sling del nodo, con jcr:path
che indica il percorso dell'hit: per impostazione predefinita elenca solo le proprietà dirette del nodo, include una struttura ad albero più profonda con p.nodedepth=N
, con 0 che significa l'intera sottostruttura infinita; aggiungere p.acls=true
per includere le autorizzazioni JCR della sessione corrente sull'elemento risultato dato (mappature: create
= add_node
, modify
= set_property
, delete
= remove
)
selettivo:
solo le proprietà specificate in p.properties
, che è un elenco separato da spazi (utilizzare "+" negli URL) di percorsi relativi; se il percorso relativo ha una profondità > 1, questi saranno rappresentati come oggetti secondari; la speciale proprietà jcr:path include il percorso dell'hit
Include tutti i predicati di una query querybuilder persistente nella query corrente come un predicato di sottogruppo.
Si noti che questo non eseguirà una query supplementare ma estenderà la query corrente.
Le query possono essere persistenti a livello di programmazione utilizzando QueryBuilder#storeQuery()
. Il formato può essere una proprietà String su più righe o un nodo nt:file
che contiene la query come file di testo in formato delle proprietà Java.
Non supporta l'estrazione facet per i predicati della query salvata.
savedquery
percorso della query salvata (proprietà String o nodo nt:file
)
Ricerca per similarità utilizzando l'espressione JCR XPath rep:similar()
.
Non supporta il filtro. Non supporta l'estrazione facet.
percorso assoluto
simile al nodo per il quale trovare nodi simili
percorso relativo
locala a un nodo discendente o
.
per il nodo corrente (facoltativo, il valore predefinito è " .
")
Consente di cercare il contenuto a cui sono stati assegnati uno o più tag, specificando i percorsi del titolo dei tag.
Supporta l'estrazione dei facet. Fornirà bucket per ciascun tag univoco, utilizzando il percorso del titolo del tag corrente.
tag
percorso titolo tag da cercare, ad esempio "Proprietà risorsa: Orientamento / Orizzontale"
N_value
utilizzare 1_value
, 2_value
, … per controllare più tag (combinati con OR
per impostazione predefinita, con AND
if and=true) (da 5.6)
proprietà
proprietà (o percorso relativo alla proprietà) da esaminare (impostazione predefinita " cq:tags
")
Consente di cercare contenuti con tag con uno o più tag, specificando ID di tag.
Supporta l'estrazione dei facet. Fornirà bucket per ciascun tag univoco, utilizzando l'ID tag corrente.
tagid
ID tag da cercare, ad esempio " properties:orientation/landscape
"
N_value
utilizzare 1_value
, 2_value
, … per verificare la presenza di più tagidi (combinati con OR
per impostazione predefinita, con AND
if and=true) (da 5.6)
proprietà
proprietà (o percorso relativo alla proprietà) da esaminare (impostazione predefinita " cq:tags
")
Consente di cercare contenuti ai quali sono stati assegnati tag con uno o più tag, specificando le parole chiave. In questo modo, i tag che contengono queste parole chiave nei loro titoli verranno prima cercati, quindi il risultato verrà limitato solo agli elementi ai quali è stato assegnato il tag.
Non supporta l'estrazione facet.
tagsearch
parola chiave da cercare nei titoli dei tag
proprietà
proprietà (o percorso relativo alla proprietà) da esaminare (impostazione predefinita " cq:tags
")
lang
per effettuare ricerche solo in un determinato titolo di tag localizzato (ad esempio " de
")
all
(bool) cercare l’intero testo completo del tag, ad esempio tutti i titoli, la descrizione ecc. (ha la precedenza su "l ang
")
Limita i risultati a un tipo di nodo JCR specifico, sia al tipo di nodo principale che al tipo di mixin. Verranno inoltre individuati i sottotipi di tale tipo di nodo. Gli indici di ricerca del repository devono coprire i tipi di nodo per un'esecuzione efficiente.
Supporta l'estrazione dei facet. Forniranno bucket per ogni tipo univoco nei risultati.
tipo
tipo di nodo o nome di mixaggio da cercare, ad esempio cq:Page