Riferimento predicato di Query Builder query-builder-predicate-reference

CAUTION
Le informazioni su questa pagina non sono esaustive.
Per informazioni complete, consulta l’elenco in Predicati disponibili nella console Debugger di Query Builder; ad esempio, in:
Ad esempio, consulta:

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 " operationIl 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 esempio myFeatureEnabled o jcr: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 esempio jcr: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 al lowerBound. 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 al 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 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 con OR per impostazione predefinita, con AND 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 di jcr: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 al lowerValue

  • upperBound

    Limite superiore per cui verificare la proprietà.

  • upperOperation

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

  • 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 no lowerBound) avrebbe selezionato qualsiasi cosa nell'ora successiva
  • lowerBound=-1d (e no upperBound) avrebbe selezionato qualsiasi cosa nelle ultime 24 ore
  • lowerBound=-6M e upperBound=-3M sceglierebbe qualsiasi prodotto di età compresa tra 6 e 3 mesi
  • lowerBound=-1500 e upperBound=5500 consente di selezionare un valore compreso tra 1500 millisecondi nel passato e 5500 millisecondi nel futuro
  • lowerBound=1d e upperBound=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 necessario p.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 con p.nodedepth=N, dove 0 indica l'intero sottoalbero infinito; aggiungere 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 (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 con OR per impostazione predefinita, con AND 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 con OR per impostazione predefinita, con AND 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.

recommendation-more-help
19ffd973-7af2-44d0-84b5-d547b0dffee2