Riferimento predicato di Query Builder query-builder-predicate-reference
Generale general
Predicati predicates
boolproperty boolproperty
Corrisponde alle proprietà BOOLEAN di JCR. Accetta solo i valori ". true
" e " false
". Se " false
", corrisponde se la proprietà ha il valore " false
" o se non esiste affatto. Questo può essere utile per verificare la presenza di flag booleani impostati solo se attivati.
L’ ereditato " operation
Il parametro " non ha alcun significato.
Supporta l'estrazione dei facet. Fornisce bucket per ogni true
o false
ma solo per le proprietà esistenti.
Proprietà properties
-
boolproperty
Percorso relativo alla proprietà, ad esempiomyFeatureEnabled
ojcr:content/myFeatureEnabled
. -
valore
Valore per cui verificare la proprietà, "true
" o "false
".
contentfragment contentfragment
Limita il risultato ai frammenti di contenuto.
Filtro non supportato.
Non supporta l'estrazione dei facet.
Proprietà properties-1
- contentfragment
Può essere utilizzato con qualsiasi valore per verificare la presenza di frammenti di contenuto.
dateComparison datecomparison
Confronta due proprietà DATA JCR tra loro. Puoi verificare se sono uguali, ineguali, maggiori o maggiori o uguali.
Questo è un predicato di solo filtro e non può utilizzare un indice di ricerca.
Proprietà properties-2
-
property1
Percorso della prima proprietà data.
-
property2
Percorso della seconda proprietà data.
-
operazione
"
equals
" per corrispondenza esatta, "!=
" per il confronto della disuguaglianza, "greater
" per property1 maggiore di property2, ">=
" per property1 maggiore o uguale a property2. Il valore predefinito è "equals
".
intervallo di date daterange
Confronta le proprietà DATA JCR con un intervallo di data/ora. Utilizza il formato ISO8601 per data e ora ( YYYY-MM-DDTHH:mm:ss.SSSZ
) e consente anche rappresentazioni parziali, come YYYY-MM-DD
. In alternativa, la marca temporale può essere fornita come il numero di millisecondi dal 1970 nel fuso orario UTC, il formato ora UNIX®.
Puoi cercare qualsiasi cosa tra due marche temporali, qualsiasi cosa più recente o più vecchia di una determinata data e anche scegliere tra intervalli inclusivi e aperti.
Supporta l'estrazione dei facet. Fornisce bucket "oggi", "questa settimana", "questo mese", "ultimi 3 mesi", "quest’anno", "ultimo anno" e "prima dello scorso anno".
Filtro non supportato.
Proprietà properties-3
-
proprietà
Percorso relativo di un
DATE
proprietà, ad esempiojcr:lastModified
. -
lowerBound
Limite di data inferiore per la verifica della proprietà, ad esempio,
2014-10-01
. -
lowerOperation
"
>
" (più recente) o ">=
" (uguale o successivo), si applica allowerBound
. Il valore predefinito è ">
". -
upperBound
Limite superiore per la verifica della proprietà, ad esempio
2014-10-01T12:15:00
. -
upperOperation
"
<
" (precedente) o "<=
" (precedente o uguale a), si applica alupperBound
. Il valore predefinito è "<
". -
fuso orario
ID del fuso orario da utilizzare quando non è specificato come stringa di data ISO-8601. Il fuso orario predefinito è quello del sistema.
excludepaths excludepaths
Esclude i nodi dal risultato in cui il loro percorso corrisponde a un’espressione regolare.
Questo è un predicato di solo filtro e non può utilizzare un indice di ricerca.
Non supporta l'estrazione dei facet.
Proprietà properties-4
-
excludepaths
Espressione regolare associata ai percorsi dei risultati, escludendo quelli corrispondenti dal risultato.
full-text fulltext
Cerca i termini nell'indice full-text.
Filtro non supportato.
Non supporta l'estrazione dei facet.
Proprietà properties-5
-
full-text
I termini di ricerca full-text.
-
relPath
Percorso relativo per la ricerca nella proprietà o nel sottonodo. Questa proprietà è facoltativa.
gruppo group
Consente di creare le condizioni nidificate. I gruppi possono contenere gruppi nidificati. Tutto ciò che si trova in una query del generatore di query è implicitamente in un gruppo principale, che può avere p.or
e p.not
parametri.
Esempio per associare una delle due proprietà a 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
Concettualmente (1_property
OPPURE 2_property)
.
Esempio di 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
Questo cerca il termine "Gestione" nelle pagine di /content/geometrixx/en
o in risorse in /content/dam/geometrixx
.
Concettualmente fulltext AND ( (path AND type) OR (path AND type) )
. Tali join OR necessitano di indici validi per le prestazioni.
Proprietà properties-6
-
p.or
Se impostato su "
true
", solo un predicato nel gruppo deve corrispondere. Il valore predefinito è "false
", il che significa che tutti devono corrispondere -
p.not
Se impostato su "
true
", ignora il gruppo (impostazione predefinita: "false
"). -
<predicate>
Aggiunge predicati nidificati.
-
N_<predicate>
Aggiunge più predicati nidificati nello stesso momento, come
1_property, 2_property, ...
.
hasPermission haspermission
Limita il risultato agli elementi in cui la sessione corrente ha il valore specificato Privilegi JCR.
Questo è un predicato di solo filtro e non può utilizzare un indice di ricerca. Non supporta l’estrazione dei facet.
Proprietà properties-7
-
hasPermission
I privilegi JCR separati da virgole che la sessione utente corrente deve avere TUTTO il nodo in questione. Ad esempio:
jcr:write
,jcr:modifyAccessControl
.
lingua language
Trova le pagine CQ in una lingua specifica. Vengono esaminate sia la proprietà lingua della pagina che il percorso della pagina, che spesso include la lingua o le impostazioni locali in una struttura del sito principale.
Questo è un predicato di solo filtro e non può utilizzare un indice di ricerca.
Supporta l'estrazione dei facet. Fornisce bucket per ogni codice lingua univoco.
Proprietà properties-8
-
lingua
Codice della lingua ISO, ad esempio, "
de
"
risorsa principale mainasset
Controlla se un nodo è una risorsa principale DAM e non una risorsa secondaria. In pratica, si tratta di ogni nodo non incluso in un nodo "risorse secondarie". Questo non verifica la presenza di dam:Asset
tipo di nodo. Per utilizzare questo predicato, imposta " mainasset=true
" o " mainasset=false
", non sono presenti ulteriori proprietà.
Questo è un predicato di solo filtro e non può utilizzare un indice di ricerca.
Supporta l’estrazione facet e fornisce due bucket per le risorse principali e secondarie.
Proprietà properties-9
-
risorsa principale
Booleano, "
true
" per le risorse principali, "false
" per le risorse secondarie.
memberOf memberof
Trova gli elementi che sono membri di un raccolta di risorse sling.
Questo è un predicato di solo filtro e non può utilizzare un indice di ricerca. Non supporta l'estrazione dei facet.
Proprietà properties-10
-
memberOf
Percorso della raccolta di risorse Sling.
nodename nodename
Corrisponde ai nomi dei nodi JCR.
Supporta l'estrazione dei facet. Fornisce bucket per ogni nome di nodo univoco (nome file).
Proprietà properties-11
-
nodename
Schema nome nodo che consente caratteri jolly:
*
= qualsiasi carattere o nessun carattere,?
= qualsiasi carattere,[abc]
= solo caratteri tra parentesi.
non scaduto notexpired
Corrisponde agli elementi controllando se una proprietà DATA JCR è maggiore o uguale all’ora corrente del server. Può essere utilizzato per controllare un’" expiresAt
" piace la proprietà data e limita a quelle che non sono ancora scadute ( notexpired=true
) o che sono già scaduti ( notexpired=false
).
Filtro non supportato.
Supporta l'estrazione di facet nello stesso modo del predicato dell'intervallo di dati.
Proprietà properties-12
-
non scaduto
Booleano, "
true
" per non ancora scaduto (data futura o uguale), "false
" per scaduto (data nel passato) (obbligatorio). -
proprietà
Percorso relativo per
DATE
proprietà da controllare (obbligatoria).
orderby orderby
Consente di ordinare i risultati. Se è necessario ordinare per più proprietà, questo predicato deve essere aggiunto più volte utilizzando il prefisso numerico, ad esempio 1_orderby=first
, 2_oderby=second
.
Proprietà properties-13
-
orderby
Nome della proprietà JCR indicato da una @ iniziale, ad esempio
@jcr:lastModified
o@jcr:content/jcr:title
, o un altro predicato nella query, ad esempio,2_property
, su cui eseguire l'ordinamento. -
sort
Direzione di ordinamento, scegliendo tra "
desc
" per decrescente o "asc
" per crescente (impostazione predefinita). -
caso
Se impostato su
ignore
, l'ordinamento non distingue tra maiuscole e minuscole, ovvero "a" precede "B"; se vuoto o non specificato, l'ordinamento distingue tra maiuscole e minuscole, ovvero "B" precede "a"
percorso path
Esegue ricerche all'interno di un determinato percorso.
Non supporta l'estrazione dei facet.
Proprietà properties-14
-
percorso
Schema del percorso. A seconda dell’esatta, l’intera sottostruttura corrisponde (ad esempio, aggiungendo
//*
in xpath, ma tieni presente che non include il percorso di base) (exact=false, default) o solo una corrispondenza esatta del percorso, che può includere caratteri jolly (*
); se self è impostato, viene eseguita la ricerca nell'intera sottostruttura, incluso il nodo di base. -
esatto
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), vengono inclusi tutti i discendenti (facoltativo). -
piatto
Cerca solo i figli diretti (ad esempio aggiungendo "
/*
" in xpath) (utilizzato solo se "exact
' non è true, facoltativo). -
self
Esegue la ricerca nella sottostruttura ma include il nodo di base indicato come percorso (nessun carattere jolly).
proprietà property
Corrisponde alle proprietà JCR e ai relativi valori.
Supporta l'estrazione dei facet. Fornisce bucket per ogni valore di proprietà univoco nei risultati.
Proprietà properties-15
-
proprietà
Percorso relativo alla proprietà, ad esempio
jcr:title
. -
valore
Valore di cui controllare la proprietà; segue il tipo di proprietà JCR per le conversioni di stringhe.
-
N_value
Utilizzare
1_value
,2_value
, … per verificare la presenza di più valori (combinati conOR
per impostazione predefinita, conAND
if and=true) (dal punto 5.3). -
e
Impostare su true per combinare più valori (
N_value
) con E (dal 5.3). -
operazione
"
equals
" per corrispondenza esatta (impostazione predefinita), "unequals
" per il confronto della disuguaglianza, "like
" per l’utilizzo dijcr:like
funzione xpath (opzionale), "not
" se non corrisponde (ad esempio, "not(@prop)
" in xpath, il parametro value viene ignorato) o "exists
" per il controllo dell’esistenza (il valore può essere true - la proprietà deve esistere, il valore predefinito - o false - è uguale a "not
"). -
profondità
Numero di livelli di caratteri jolly sotto i quali può esistere la proprietà o il percorso relativo (ad esempio,
property=size depth=2
controlla nodo/dimensione, nodo/*/dimensione e nodo/*/*/dimensione).
rangeproperty rangeproperty
Corrisponde a una proprietà JCR rispetto a un intervallo. Questo vale per le proprietà con tipi lineari come LONG
, DOUBLE
, e DECIMAL
. Per DATE
, consulta il predicato dell’intervallo di dati con input nel formato data ottimizzato.
È possibile definire un limite inferiore e un limite superiore o solo uno di essi. L’operazione (ad esempio, "minore di" o "minore o uguale a") può essere specificata anche per i limiti inferiore e superiore, singolarmente.
Non supporta l'estrazione dei facet.
Proprietà properties-16
-
proprietà
Percorso relativo alla proprietà.
-
lowerBound
Limite inferiore per cui verificare la proprietà.
-
lowerOperation
"
>
" (impostazione predefinita) o ">=
", si applica allowerValue
-
upperBound
Limite superiore per cui verificare la proprietà.
-
upperOperation
"
<
" (impostazione predefinita) o "<=
", si applica allowerValue
-
decimale
"
true
" se la proprietà selezionata è di tipo Decimal
relativedaterange relativedaterange
Corrisponde a JCR DATE
proprietà rispetto a un intervallo di data/ora utilizzando gli offset temporali relativi all'ora corrente del server. È 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 è 0, che indica l'ora corrente.
Ad esempio:
upperBound=1h
(e nolowerBound
) avrebbe selezionato qualsiasi cosa nell'ora successivalowerBound=-1d
(e noupperBound
) avrebbe selezionato qualsiasi cosa nelle ultime 24 orelowerBound=-6M
eupperBound=-3M
sceglierebbe qualsiasi prodotto di età compresa tra 6 e 3 mesilowerBound=-1500
eupperBound=5500
consente di selezionare un valore compreso tra 1500 millisecondi nel passato e 5500 millisecondi nel futurolowerBound=1d
eupperBound=2d
avrebbe selezionato qualsiasi cosa nel dopodomani
Non prende in considerazione anni bisestili e tutti i mesi sono 30 giorni.
Filtro non supportato.
Supporta l'estrazione di facet nello stesso modo del predicato dell'intervallo di dati.
Proprietà properties-17
-
upperBound
Limite superiore della data 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 al tempo del server corrente, utilizzate "-" per ottenere un offset negativo. -
lowerBound
Limite di 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 al tempo del server corrente, utilizzate "-" per ottenere un offset negativo.
radice root
Gruppo di predicati radice. Supporta tutte le funzioni di un gruppo e consente di impostare i parametri di query globali.
Il nome "root" non viene mai utilizzato in una query, è implicito.
Proprietà properties-18
-
p.offset
Numero che indica l'inizio della pagina dei risultati, ovvero il numero di elementi da saltare.
-
p.limit
Numero che indica le dimensioni della pagina.
-
p.guessTotal
Consigliato: evita di calcolare il totale completo dei risultati, il che può essere costoso; o un numero che indica il totale massimo da contare (ad esempio, 1000, un numero che fornisce agli utenti un feedback sufficiente sulle dimensioni approssimative e sui numeri esatti per risultati più piccoli) o "
true
" per contare solo il minimo necessariop.offset
+p.limit
. -
p.estratto
Se impostato su "
true
", includi un estratto di testo completo nel risultato. -
p.hits
(solo per il servlet JSON) seleziona il modo in cui gli hit vengono scritti come JSON, con questi standard (estensibili tramite il servizio ResultHitWriter):
-
semplice:
Elementi minimi come
path
,title
,lastmodified
,excerpt
(se impostato). -
completo:
Rendering Sling JSON 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 conp.nodedepth=N
, dove 0 indica l'intero sottoalbero infinito; aggiungerep.acls=true
per includere le autorizzazioni JCR della sessione corrente sull’elemento risultato specificato (mappature:create
=add_node
,modify
=set_property
,delete
=remove
). -
selettivo:
Solo le proprietà specificate in
p.properties
, che è un elenco di percorsi relativi separato da spazi (negli URL utilizzare "+"); se il percorso relativo ha una profondità > 1, questi sono rappresentati come oggetti secondari; la speciale proprietà jcr:path include il percorso dell’hit
-
savedquery savedquery
Include tutti i predicati di una query persistente di Query Builder nella query corrente come predicato di sottogruppo.
Non viene eseguita una query aggiuntiva, ma viene estesa la query corrente.
Le query possono essere rese persistenti a livello di programmazione utilizzando QueryBuilder#storeQuery()
. Il formato può essere una proprietà String su più righe o una proprietà nt:file
nodo che contiene la query come file di testo in formato Java™ properties.
Non supporta l’estrazione dei facet per i predicati della query salvata.
Proprietà properties-19
-
savedquery
Percorso della query salvata (proprietà String o
nt:file
nodo ).
simile similar
Ricerca per affinità utilizzando JCR XPath rep:similar()
.
Filtro non supportato. Non supporta l'estrazione dei facet.
Proprietà properties-20
-
simile
Percorso assoluto del nodo per il quale trovare nodi simili. -
locale
Un percorso relativo a un nodo discendente o.
per il nodo corrente (facoltativo, il valore predefinito è ").
").
tag tag
Cerca il contenuto con uno o più tag, specificando i percorsi dei titoli dei tag.
Supporta l'estrazione dei facet. Fornisce bucket per ogni tag univoco, utilizzando il percorso del titolo del tag corrente.
Proprietà properties-21
-
tag
Percorso del titolo del tag da cercare, ad esempio "Proprietà risorsa: orientamento/orizzontale".
-
N_value
Utilizzare
1_value
,2_value
, … per verificare la presenza di più tag (combinati conOR
per impostazione predefinita, conAND
if and=true) (dal punto 5.6). -
proprietà
Proprietà (o percorso relativo della proprietà) da esaminare (impostazione predefinita "
cq:tags
")
tagid tagid
Cerca il contenuto con uno o più tag, specificando gli ID tag.
Supporta l'estrazione dei facet. Fornisce bucket per ogni tag univoco, utilizzando il relativo ID tag corrente.
Proprietà properties-22
-
tagid
Tag ID che consente di cercare, ad esempio, "
properties:orientation/landscape
". -
N_value
Utilizzare
1_value
,2_value
, … per verificare la presenza di più tag (combinati conOR
per impostazione predefinita, conAND
if and=true) (dal punto 5.6). -
proprietà
Proprietà (o percorso relativo della proprietà) da esaminare (impostazione predefinita "
cq:tags
").
tagsearch tagsearch
Cerca il contenuto con uno o più tag, specificando le parole chiave. In questo modo, vengono innanzitutto cercati i tag che contengono queste parole chiave nei titoli, quindi vengono limitati solo gli elementi con queste parole chiave.
Non supporta l'estrazione dei facet.
Proprietà Properties-1
-
tagsearch
Parola chiave da cercare nei titoli dei tag.
-
proprietà
Proprietà (o percorso relativo della proprietà) da esaminare (impostazione predefinita
cq:tags
). -
lang
Per eseguire una ricerca solo in un determinato titolo di tag localizzato (ad esempio,
de
). -
tutto
(bool) Cerca l'intero testo completo del tag, ovvero tutti i titoli, la descrizione e così via. Ha la precedenza su "L
ang
".
tipo type
Limita i risultati a un tipo di nodo JCR specifico, sia di tipo di nodo principale che mixin. In questo modo vengono trovati anche i sottotipi di quel tipo di nodo. Gli indici di ricerca dell’archivio devono coprire i tipi di nodo per un’esecuzione efficiente.
Supporta l'estrazione dei facet. Fornisce bucket per ogni tipo univoco nei risultati.
Proprietà Properties-2
-
tipo
Tipo di nodo o nome mixin da cercare, ad esempio
cq:Page
.