Riferimento predicato Query Builder

Generale

• root
• gruppo
• ordine

Predicati

• boolproperty
• contentFragment
• dateComparison
• daterange
• excludepaths
• fulltext
• hasPermission
• language
• main asset
• MemberOf
• nodename
• not
• path
• proprietà
• rangeproperty
• relativedaterange
• savedquery
• similar
• tag
• tagid
• tagsearch
• tipo

boolproperty

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.

Proprietà

• percorso
  relativo alla proprietà, ad esempio
  myFeatureEnabled o jcr:content/myFeatureEnabled

• valore
  per la proprietà check, "
  true" o " false"

content fragment

Limita il risultato ai frammenti di contenuto.

Non supporta il filtro.

Non supporta l'estrazione facet.

Proprietà

• frammento di
  contenutoPuò essere utilizzato con qualsiasi valore per verificare la presenza di frammenti di contenuto.

dateComparison

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.

Proprietà

• 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 è " =".

daterange

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à

• 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 percorsi

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.

Proprietà

• excludepaths

  espressione regolare confrontata con i percorsi dei risultati, escludendo quelli corrispondenti dal risultato.

fulltext

Cerca i termini nell'indice full-text.

Non supporta il filtro.

Non supporta l'estrazione facet.

Proprietà

• fulltext

  termini di ricerca full-text

• relPath

  percorso relativo da cercare nella proprietà o nel nodo secondario. Questa proprietà è facoltativa.

gruppo

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.

Proprietà

• 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, ...

hasPermission

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.

Proprietà

• hasPermission

  privilegi JCR separati da virgola che la sessione utente corrente deve avere per il nodo in questione; ad esempio jcr:write, jcr:modifyAccessControl

language

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.

Proprietà

• language

  Codice della lingua ISO, ad esempio " de"

main asset

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.

Proprietà

• main asset

  booleano, " true" per le risorse principali, " false" per le risorse secondarie

MemberOf

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.

Proprietà

• MemberOf

  percorso della raccolta di risorse Sling

nodename

Corrisponde ai nomi dei nodi JCR.

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

Proprietà

• nodename

  pattern di nome nodo che consente i caratteri jolly: * = any or no char, ? = any char, [abc] = only chars in parentesi

not expired

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.

Proprietà

• 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)

orderby

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.

Proprietà

• 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"

path

Ricerche all’interno di un determinato percorso.

Non supporta l'estrazione facet.

Proprietà

• 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)

proprietà

Corrisponde alle proprietà JCR e ai relativi valori.

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

Proprietà

• 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/&ast;/dimensione e nodo/&ast;/&ast;/dimensione)

rangeproperty

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à

• 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

relativedaterange

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 successiva
• lowerBound=-1d (e no upperBound) avrebbe selezionato qualcosa nelle ultime 24 ore
• lowerBound=-6M e upperBound=-3M sceglierebbe qualsiasi cosa dai 6 ai 3 mesi
• lowerBound=-1500 e upperBound=5500 avrebbe selezionato qualsiasi cosa tra 1500 millisecondi negli ultimi e 5500 millisecondi nel futuro
• lowerBound=1d e upperBound=2d sceglierebbe qualsiasi cosa dopo domani

Si 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.

Proprietà

• 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

root

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.

Proprietà

• 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

savedquery

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.

Proprietà

• savedquery

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

simili

Ricerca per similarità utilizzando l'espressione JCR XPath rep:similar().

Non supporta il filtro. Non supporta l'estrazione facet.

Proprietà

• 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 è " .")

tag

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.

Proprietà

• 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")

tagid

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.

Proprietà

• 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")

tagsearch

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.

Proprietà

• 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")

tipo

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.

Proprietà

• tipo

  tipo di nodo o nome di mixaggio da cercare, ad esempio cq:Page