DocumentazioneAEM 6.5Guida utente

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

Last update: Sun Jul 14 2024 00:00:00 GMT+0000 (Coordinated Universal Time)
  • Argomenti:

Creato per:

  • Sviluppatore
CAUTION
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:
Ad esempio, consulta:

Generale general

Predicati predicates

boolproperty 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à properties

  • boolproperty
    Percorso relativo alla proprietà, ad esempio myFeatureEnabled o jcr:content/myFeatureEnabled.

  • valore
    Valore per cui controllare 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

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

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à properties-3

  • 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 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 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à 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", 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 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à 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". 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à properties-9

  • risorsa principale

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

memberOf 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à 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

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

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 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à properties-12

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

    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 path

Esegue ricerche all'interno di un determinato percorso.

Non supporta l'estrazione dei facet.

Proprietà properties-14

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

    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 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à properties-16

  • 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 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à properties-17

  • 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 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 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 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à properties-19

  • savedquery

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

simile similar

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

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

Proprietà properties-20

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

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

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