Riferimento predicato di Query Builder

Ultimo aggiornamento: 5 maggio 2025

Si applica a:
Experience Manager 6.5

Argomenti:

Creato per:

Sviluppatore

ATTENZIONE

Le informazioni su questa pagina non sono esaustive.

Per informazioni complete, vedere l'elenco in Predicati disponibili nella console di Query Builder Debugger, ad esempio in:

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

Ad esempio, consulta:

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

Predicati

boolproperty

Corrisponde alle proprietà BOOLEAN di JCR. Accetta solo i valori " true" e " false". Se " false", viene restituito il risultato 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.

Il parametro ereditato " operation" non ha alcun significato.

Supporta l'estrazione dei facet. Fornisce bucket per ogni valore true o false, ma solo per le proprietà esistenti.

Proprietà

boolproperty
Percorso relativo alla proprietà, ad esempio myFeatureEnabled o jcr:content/myFeatureEnabled.
valore
Valore per cui controllare la proprietà, " true" o " false".

contentfragment

Limita il risultato ai frammenti di contenuto.

Filtro non supportato.

Non supporta l'estrazione dei facet.

Proprietà

contentfragment
Può essere utilizzato con qualsiasi valore per verificare la presenza di frammenti di contenuto.

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à

proprietà1

Percorso della prima proprietà data.
proprietà2

Percorso della seconda proprietà data.
operazione

" equals" per corrispondenza esatta, " !=" per confronto disuguaglianza, " greater" per proprietà1 maggiore di proprietà2, " >=" per proprietà1 maggiore o uguale a proprietà2. Il valore predefinito è " equals".

intervallo di date

Confronta le proprietà DATA JCR con un intervallo di data/ora. Questo utilizza lo standard ISO8601
formato 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à

proprietà

Percorso relativo di una proprietà DATE, ad esempio jcr:lastModified.
lowerBound

Limite di data inferiore per la verifica della proprietà, ad esempio 2014-10-01.
lowerOperation

" >" (più recente) o " >=" (più recente), si applica a lowerBound. Il valore predefinito è " >".
upperBound

Limite superiore per la verifica della proprietà, ad esempio 2014-10-01T12:15:00.
upperOperation

" <" (più vecchio) o " <=" (più o meno), si applica a upperBound. 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

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à

excludepaths

Espressione regolare associata ai percorsi dei risultati, escludendo quelli corrispondenti dal risultato.

full-text

Cerca i termini nell'indice full-text.

Filtro non supportato.

Non supporta l'estrazione dei facet.

Proprietà

full-text

I termini di ricerca full-text.
relPath

Percorso relativo per la ricerca nella proprietà o nel sottonodo. Questa proprietà è facoltativa.

gruppo

Consente di creare le condizioni nidificate. I gruppi possono contenere gruppi nidificati. Tutto ciò che si trova in una query di Query Builder è implicitamente in un gruppo radice, che può avere anche 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 O 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

La ricerca del termine "Gestione" viene eseguita nelle pagine di /content/geometrixx/en o nelle risorse di /content/dam/geometrixx.

Concettualmente fulltext AND ( (path AND type) OR (path AND type) ). Tali join OR necessitano di indici validi per le prestazioni.

Proprietà

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", il gruppo verrà ignorato (impostazione predefinita: " false").
<predicato>

Aggiunge predicati nidificati.
N_<predicato>

Aggiunge più predicati nidificati contemporaneamente, ad esempio 1_property, 2_property, ....

hasPermission

Limita il risultato agli elementi in cui la sessione corrente dispone dei privilegi JCR specificati.

Questo è un predicato di solo filtro e non può utilizzare un indice di ricerca. Non supporta l’estrazione dei facet.

Proprietà

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

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à

lingua

Codice della lingua ISO, ad esempio "de"

risorsa principale

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". Questa operazione non verifica il tipo di nodo dam:Asset. Per utilizzare questo predicato, impostare " mainasset=true" o " mainasset=false", non sono disponibili altre 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à

risorsa principale

Booleano, " true" per le risorse principali, " false" per le risorse secondarie.

memberOf

Trova elementi che sono membri di una raccolta di risorse sling specifica.

Questo è un predicato di solo filtro e non può utilizzare un indice di ricerca. Non supporta l'estrazione dei facet.

Proprietà

memberOf

Percorso della raccolta di risorse Sling.

nodename

Corrisponde ai nomi dei nodi JCR.

Supporta l'estrazione dei facet. Fornisce bucket per ogni nome di nodo univoco (nome file).

Proprietà

nodename

Pattern nome nodo che consente caratteri jolly: * = any o no char, ? = any char, [abc] = only chars in brackets.

non scaduto

Corrisponde agli elementi controllando se una proprietà DATA JCR è maggiore o uguale all’ora corrente del server. Può essere utilizzato per controllare una proprietà "expiresAt" come data e limitare solo a quelle non ancora scadute ( notexpired=true) o che sono già scadute ( notexpired=false).

Filtro non supportato.

Supporta l'estrazione di facet nello stesso modo del predicato dell'intervallo di dati.

Proprietà

non scaduto

Booleano, "true" per non ancora scaduto (data futura o uguale), " false" per scaduto (data passata) (obbligatorio).
proprietà

Percorso relativo della proprietà DATE da verificare (obbligatorio).

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à

orderby

Il nome della proprietà JCR indicato da una @ iniziale, ad esempio @jcr:lastModified o @jcr:content/jcr:title, o da un altro predicato nella query, ad esempio 2_property, su cui eseguire l'ordinamento.
ordina

Direzione di ordinamento, " desc" per decrescente o " asc" per crescente (impostazione predefinita).
caso

Se è impostato su ignore, l'ordinamento non fa distinzione tra maiuscole e minuscole, ovvero "a" precede "B"; se è vuoto o non viene specificato, l'ordinamento fa distinzione tra maiuscole e minuscole, ovvero "B" precede "a"

percorso

Esegue ricerche all'interno di un determinato percorso.

Non supporta l'estrazione dei facet.

Proprietà

percorso

Schema del percorso. A seconda di exact, l'intera sottostruttura corrisponde (come l'aggiunta di //* in xpath, ma si noti che questo 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 cercata l'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) tutti i discendenti sono inclusi (facoltativo).
piatto

Cerca solo gli elementi figlio 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à

Corrisponde alle proprietà JCR e ai relativi valori.

Supporta l'estrazione dei facet. Fornisce bucket per ogni valore di proprietà univoco nei risultati.

Proprietà

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

Utilizza 1_value, 2_value, … per verificare la presenza di più valori (combinati con OR per impostazione predefinita, con AND se e=true) (dalla versione 5.3).
e

Impostare su true per combinare più valori ( N_value) con AND (dalla versione 5.3).
operazione

"equals" per corrispondenza esatta (impostazione predefinita), " unequals" per confronto disuguaglianza, " like" per utilizzo della funzione xpath jcr:like (opzione facoltativa), " not" per nessuna corrispondenza (ad esempio, "not(@prop)" in xpath, parametro value ignorato) o " exists" per verifica 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

Corrisponde a una proprietà JCR rispetto a un intervallo. Questo vale per le proprietà con tipi lineari come LONG, DOUBLE e DECIMAL. Per DATE, vedere il predicato dell'intervallo di dati con input in 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à

proprietà

Percorso relativo alla proprietà.
lowerBound

Limite inferiore per cui verificare la proprietà.
lowerOperation

" >" (impostazione predefinita) o ">=", si applica a lowerValue
upperBound

Limite superiore per cui verificare la proprietà.
upperOperation

" <" (impostazione predefinita) o "<=", si applica a lowerValue
decimale

" true" se la proprietà selezionata è di tipo Decimal

relativedaterange

Corrisponde a JCR DATE proprietà rispetto a un intervallo di data/ora utilizzando scostamenti di ora relativi all'ora corrente del server. È possibile specificare lowerBound e upperBound utilizzando un valore di millisecondi o la sintassi di bugzilla 1s 2m 3h 4d 5w 6M 7y (un secondo, due minuti, tre ore, quattro giorni, cinque settimane, sei mesi, sette anni). Aggiungi il prefisso "-" per indicare uno scostamento negativo prima dell'ora corrente. Se si specifica solo lowerBound o upperBound, l'altro valore predefinito è 0, ovvero l'ora corrente.

Ad esempio:

upperBound=1h (e nessun lowerBound) selezionerebbe nulla nell'ora successiva
lowerBound=-1d (e nessun upperBound) avrebbe selezionato nulla nelle ultime 24 ore
lowerBound=-6M e upperBound=-3M potrebbero selezionare qualsiasi elemento che abbia tra i 6 e i 3 mesi
lowerBound=-1500 e upperBound=5500 potrebbero selezionare un valore compreso tra 1500 millisecondi nel passato e 5500 millisecondi nel futuro
lowerBound=1d e upperBound=2d selezionerebbero qualsiasi elemento nel giorno successivo a domani

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à

upperBound

Limite di 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 al tempo del server corrente, utilizzare "-" per 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 server corrente. Utilizzare "-" per ottenere un offset negativo.

radice

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à

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 che può essere costoso; o un numero che indica il totale massimo da contare fino a (ad esempio, 1000, un numero che fornisce agli utenti feedback sufficienti sulle dimensioni approssimative e sui numeri esatti per risultati più piccoli) o " true" per contare solo fino al minimo necessario p.offset + p.limit.
p.excerpt

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 più profonda con p.nodedepth=N, con 0 che indica la sottostruttura intera e infinita; aggiungi p.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 (utilizzare "+" negli URL); se il percorso relativo ha una profondità > 1, questi sono rappresentati come oggetti figlio; la speciale proprietà jcr:path include il percorso dell'hit

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à Stringa su più righe o un nodo nt:file che contiene la query come file di testo in formato proprietà Java™.

Non supporta l’estrazione dei facet per i predicati della query salvata.

Proprietà

savedquery

Percorso della query salvata (proprietà String o nodo nt:file).

simile

Ricerca per affinità utilizzando JCR XPath rep:similar().

Filtro non supportato. Non supporta l'estrazione dei facet.

Proprietà

simili
Percorso assoluto del nodo per il quale trovare nodi simili.
locale
Percorso relativo di un nodo discendente o . per il nodo corrente (facoltativo, l'impostazione predefinita è " .").

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à

tag

Percorso del titolo del tag da cercare, ad esempio "Proprietà risorsa: orientamento/orizzontale".
N_value

Utilizza 1_value, 2_value, … per verificare la presenza di più tag (combinati con OR per impostazione predefinita, con AND se e=true) (dalla versione 5.6).
proprietà

Proprietà (o percorso relativo della proprietà) da esaminare (impostazione predefinita " cq:tags")

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à

tagid

ID tag che consente di cercare, ad esempio, " properties:orientation/landscape".
N_value

Utilizza 1_value, 2_value, … per verificare la presenza di più tag (combinati con OR per impostazione predefinita, con AND se e=true) (dalla versione 5.6).
proprietà

Proprietà (o percorso relativo della proprietà) da esaminare (impostazione predefinita " cq:tags").

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à

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 la ricerca solo in un determinato titolo di tag localizzato (ad esempio, de).
tutti

(bool) Cerca l'intero testo completo del tag, ovvero tutti i titoli, la descrizione e così via. Ha la precedenza su "l ang".

tipo

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à

tipo

Tipo di nodo o nome mixin da cercare, ad esempio cq:Page.

recommendation-more-help