Show Menu
ARGOMENTI×

Riferimento predicato Query Builder

Predicati

boolproperty

Corrisponde alle proprietà JCR BOOLEAN. Accetta solo i valori " true " e " false ". In caso di " false ", corrisponderà 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 ogni true o false valore, ma solo per le proprietà esistenti.

Proprietà

  • boolproperty percorso relativo alla proprietà, ad esempio myFeatureEnabled o jcr:content/myFeatureEnabled
  • value value to check property for, " true " or " false "

contentfragment

Limita il risultato ai frammenti di contenuto.
Non supporta il filtro.
Non supporta l'estrazione facet.

Proprietà

  • frammento di contenuto Può 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 corrispondenza esatta, " != " per confronto di non uguaglianza, " > " per proprietà1 maggiore di property2, " >= " per proprietà1 maggiore o uguale a property2. Il valore predefinito è " = ".

daterange

Corrisponde alle proprietà DATA JCR rispetto a un intervallo data/ora. Questo utilizza il formato ISO8601per 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 DATE proprietà, ad esempio jcr:lastModified
  • lowerBound
    data inferiore associata a check property, ad esempio 2014-10-01
  • lowerOperation
    " > " (più recente) o " >= " (più recente o più recente), si applica al lowerBound . Il valore predefinito è " > ".
  • UpperBound
    Upper bound to check property, ad esempio 2014-10-01T12:15:00
  • UpperOperation
    " < " (precedente) o " <= " (precedente o precedente), si applica al 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.

excludepaths

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 principale, che può avere p.or e p.not anche 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 O 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 " Gestione " all’interno delle pagine /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, su " false ")
  • <predicate>
    aggiunge predicati nidificati
  • N_<predicato>
    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 "

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 "subassets". Si noti che questo non verifica il tipo di dam:Asset nodo. Per utilizzare questo predicato, impostare semplicemente " 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à

  • principale
    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: * = qualsiasi o nessun carattere, ? = qualsiasi carattere, [abc] = solo caratteri tra parentesi

not

Corrisponde agli elementi controllando se una proprietà JCR DATE è maggiore o uguale all'ora del server corrente. 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 DATE proprietà da verificare (obbligatorio)

ordine

Consente di ordinare il risultato. Se l'ordine è richiesto da più proprietà, questo predicato deve essere aggiunto più volte utilizzando il prefisso numerico, 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 (predefinita)
  • case
    se impostato su " ignore " renderà insensibile la 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 l'aggiunta //* 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 è vero, 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à univoco 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
    use 1_value , 2_value , ... per controllare più valori (combinati con OR per impostazione predefinita, con AND if e=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 il confronto di uguaglianza, " like " per l'utilizzo della funzione jcr:like xpath (facoltativo), " not " per l'assenza di 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 informazioni, consulta il predicato dell’intervallo di date con 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 al lowerValue
  • UpperBound
    limite superiore per controllare la proprietà
  • UpperOperation
    " < " (predefinito) o " <= ", si applica al lowerValue
  • decimale
    " true " se la proprietà selezionata è di tipo Decimal

relativedaterange

Corrisponde JCR DATE alle proprietà rispetto a un intervallo di data/ora utilizzando gli offset relativi all'ora del server corrente. È possibile specificare lowerBound e upperBound utilizzare un valore in 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). Prefisso con " - " per indicare un offset negativo prima dell'ora corrente. Se si specifica solo lowerBound o upperBound , l'altro valore predefinito è 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 qualcosa 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 del server corrente, utilizzare "-" per l'offset negativo
  • lowerBound
    data più bassa 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.impressionTotal
    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 dà agli utenti un feedback sufficiente sulla dimensione approssimativa e sui numeri esatti per risultati più piccoli) oppure " true " per contare 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 indicazione del 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 di percorsi relativi separati da spazi (utilizzate "+" negli URL); 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 nt:file nodo 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 nt:file nodo)

similar

Ricerca per similarità con 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
  • local un percorso relativo a un nodo discendente o . per il nodo corrente (facoltativo, il valore predefinito è " . ")

tag

Consente di cercare contenuti con tag con 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
    use 1_value , 2_value , ... per controllare più tag (combinati con OR per impostazione predefinita, con AND if e=true) (da 5.6)
  • 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
    use 1_value , 2_value , ... per verificare la presenza di più tag (combinati con OR per impostazione predefinita, con AND if e=true) (da 5.6)
  • proprietà
    (o percorso relativo alla proprietà) da esaminare (impostazione predefinita " cq:tags ")

tagsearch

Consente di ricercare contenuti ai quali sono assegnati 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à
    (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 del mixin da cercare, ad esempio cq:Page