Show Menu
TÓPICOS×

Referência do Predicado do Query Builder

Predicados

propriedade

Corresponde às propriedades BOOLEAN do JCR. Aceita apenas os valores " true " e " false ". No caso de " false ", corresponderá se a propriedade tiver o valor " false " ou se não existir. Isso pode ser útil para verificar sinalizadores booleanos que só são definidos quando ativados.
O parâmetro " operation " herdado não tem significado.
Suporta extração de facetas. Fornecerá compartimentos para cada true ou false valor, mas somente para propriedades existentes.

Propriedades

  • boolproperty relative path to property, por exemplo myFeatureEnabled ou jcr:content/myFeatureEnabled
  • valor para verificar a propriedade, " true " ou " false "

contentfragment

Restringe o resultado a fragmentos de conteúdo.
Não suporta filtragem.
Não suporta extração de facetas.

Propriedades

  • contentfragment Pode ser usado com qualquer valor para verificar fragmentos de conteúdo.

dateComparison

Compara duas propriedades JCR DATE entre si. Pode testar se são iguais, desiguais, maiores ou maiores que ou iguais.
Este é um predicado somente para filtragem e não pode aproveitar um índice de pesquisa.

Propriedades

  • property1
    propriedade path to first date
  • property2
    propriedade path to second date
  • operation
    " = " para correspondência exata, " != " para comparação de desigualdade, " > " para propriedade1 maior que propriedade2, " >= " para propriedade1 maior ou igual a propriedade2. O valor padrão é " = ".

daterange

Corresponde às propriedades JCR DATE em relação a um intervalo de data/hora. Isso usa o formato ISO8601para datas e horas ( YYYY-MM-DDTHH:mm:ss.SSSZ ) e permite também representações parciais, como YYYY-MM-DD . Como alternativa, o carimbo de data e hora pode ser fornecido como o número de milissegundos desde 1970 no fuso horário UTC, o formato de hora único.
Você pode procurar qualquer coisa entre dois carimbos de data e hora, qualquer coisa mais recente ou mais antiga que uma data específica, e também escolher entre intervalos inclusivos e abertos.
Suporta extração de facetas. Fornecerá baldes "hoje", "esta semana", "este mês", "últimos 3 meses", "este ano", "último ano" e "anterior ao ano passado".
Não suporta filtragem.

Propriedades

  • propriedade
    caminho relativo para uma DATE propriedade, por exemplo jcr:lastModified
  • lowerBound
    data inferior vinculada para verificar a propriedade, por exemplo 2014-10-01
  • lowerOperation
    " > " (mais recente) ou " >= " (mais recente ou mais recente), aplica-se ao lowerBound . O padrão é " > ".
  • upperBound
    limite superior para verificar a propriedade, por exemplo, 2014-10-01T12:15:00
  • upperOperation
    " < " (mais antigo) ou " <= " (mais antigo ou mais antigo) se aplica ao upperBound . O padrão é " < ".
  • timeZone
    ID do fuso horário a ser usado quando não for fornecido como uma string de data ISO-8601. O padrão é o fuso horário padrão do sistema.

excludedoors

Exclui nós do resultado, onde seu caminho corresponde a uma expressão regular.
Este é um predicado somente para filtragem e não pode aproveitar um índice de pesquisa.
Não suporta extração de facetas.

Propriedades

  • excludedoors
    expressão regular comparada com caminhos de resultado, exceto os correspondentes do resultado.

fulltext

Pesquisa termos no índice de texto completo.
Não suporta filtragem.
Não suporta extração de facetas.

Propriedades

  • texto completo
    os termos de pesquisa de texto completo
  • relPath
    o caminho relativo a ser pesquisado na propriedade ou subnó. Essa propriedade é opcional.

grupo

Permite criar condições aninhadas. Os grupos podem conter grupos aninhados. Tudo o que está em uma consulta do querybuilder está implicitamente em um grupo raiz, que também pode ter p.or e p.not parâmetros.
Exemplo para corresponder uma de duas propriedades contra um valor:
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

Isto é conceitualmente (1_property OR 2_property) .
Exemplo para grupos aninhados:
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

Isso pesquisa o termo " Gerenciamento " nas páginas em /content/geometrixx/en ou nos ativos em /content/dam/geometrixx .
Isto é conceitualmente fulltext AND ( (path AND type) OR (path AND type) ) . Observe que tais junções OU precisam de bons índices para o desempenho.

Propriedades

  • p.or
    se definido como " true ", somente um predicado no grupo deve corresponder. O padrão é " false ", o que significa que todos devem corresponder
  • p.not
    se estiver definido como " true ", nega o grupo (o padrão é " false ")
  • <predicate>
    adiciona predicados aninhados
  • N_<predicado>
    adiciona vários predicados aninhados do mesmo tempo, como 1_property, 2_property, ...

hasPermission

Restringe o resultado a itens nos quais a sessão atual tem os privilégios JCR especificados.
Este é um predicado somente para filtragem e não pode aproveitar um índice de pesquisa. Não suporta a extração de facetas.

Propriedades

  • hasPermission
    privilégios JCR separados por vírgulas que a sessão do usuário atual deve ter TODOS para o nó em questão; por exemplo jcr:write , jcr:modifyAccessControl

language

Encontra páginas CQ em um idioma específico. Isso analisa a propriedade de idioma da página e o caminho da página que geralmente inclui o idioma ou a localidade em uma estrutura de site de nível superior.
Este é um predicado somente para filtragem e não pode aproveitar um índice de pesquisa.
Suporta extração de facetas. Fornecerá compartimentos para cada código de idioma exclusivo.

Propriedades

  • language
    código de idioma ISO, por exemplo " de "

ativo principal

Verifica se um nó é um ativo principal do DAM e não um subativo. Isto é basicamente cada nó não dentro de um nó "subassets". Observe que isso não verifica o tipo de dam:Asset nó. Para usar esse predicado, basta definir " mainasset=true " ou " mainasset=false ", não há outras propriedades.
Este é um predicado somente para filtragem e não pode aproveitar um índice de pesquisa.
Suporta extração de facetas. Fornecerá dois compartimentos para principais e subativos.

Propriedades

  • ativo principal
    booleano, " true " para ativos principais, " false " para subativos

membroOf

Localiza itens que são membros de uma coleção de recursos de sling específica.
Este é um predicado somente para filtragem e não pode aproveitar um índice de pesquisa. Não suporta extração de facetas.

Propriedades

  • membroOf
    caminho da coleção de recursos Sling

nodenome

Corresponde aos nomes dos nós JCR.
Suporta extração de facetas. Fornecerá compartimentos para cada nome de nó exclusivo (nome de arquivo).

Propriedades

  • nodenome
    padrão de nome do nó que permite curingas: * = qualquer ou nenhum caractere, ? = qualquer caractere, [abc] = somente caracteres entre colchetes

notexpired

Corresponde itens verificando se uma propriedade JCR DATE é maior ou igual à hora atual do servidor. Isso pode ser usado para verificar uma propriedade de data " expiresAt " como a propriedade de data e limitar-se apenas àqueles que ainda não expiraram ( notexpired=true ) ou que já expiraram ( notexpired=false ).
Não suporta filtragem.
Suporta a extração de facetas da mesma forma que o predicado daterange.

Propriedades

  • notexpired
    booleano, " true " para ainda não expirado (data no futuro ou igual), " false " para expirado (data no passado) (obrigatório)
  • propriedade
    caminho relativo para a DATE propriedade a ser verificada (obrigatório)

orderby

Permite classificar o resultado. Se for necessário ordenar por várias propriedades, esse predicado precisa ser adicionado várias vezes usando o prefixo de número, como 1_orderby=first , 2_oderby=second .

Propriedades

  • orderby
    o nome da propriedade JCR indicado por um @ à esquerda, por exemplo @jcr:lastModified , ou @jcr:content/jcr:title , ou outro predicado na consulta, por exemplo 2_property , no qual classificar
  • classificar
    direção de classificação, " desc " para decrescente ou " asc " para crescente (padrão)
  • caso
    se estiver definido como " ignore " fará com que o processo de triagem não diferencie maiúsculas de minúsculas, o que significa que "a" vem antes de "B"; se vazio ou deixado de fora, a classificação diferencia maiúsculas de minúsculas, o que significa "B" vem antes de "a"

path

Pesquisa em um determinado caminho.
Não suporta extração de facetas.

Propriedades

  • path
    padrão do caminho; dependendo do exato, a subárvore inteira corresponderá (como anexar //* no xpath, mas observe que isso não inclui o caminho base) (exato=falso, padrão) ou somente uma correspondência exata de caminho, que pode incluir curingas ( * ); se auto estiver definido, a subárvore inteira, incluindo o nó base, será pesquisada
  • exato
    se exact for true/on, o caminho exato deve corresponder, mas pode conter curingas simples ( * ), que correspondem aos nomes, mas não " / "; se for falso (padrão), todos os descendentes serão incluídos (opcional)
  • apartamento
    pesquisa somente os filhos diretos (como anexar " /* " no xpath) (usado somente se ' exact ' não for verdadeiro, opcional)
  • self
    pesquisa a subárvore, mas inclui o nó base fornecido como caminho (sem curingas)

propriedade

Corresponde às propriedades do JCR e seus valores.
Suporta extração de facetas. Fornecerá compartimentos para cada valor de propriedade exclusivo nos resultados.

Propriedades

  • propriedade
    caminho relativo para a propriedade, por exemplo jcr:title
  • valor
    valor para verificar a propriedade; segue o tipo de propriedade JCR para conversões de string
  • N_value
    usar 1_value , 2_value , ... para verificar vários valores (combinados com OR por padrão, com AND if e=true) (desde 5.3)
  • e
    definido como true para combinar vários valores ( N_value ) com AND (desde 5.3)
  • operation
    " equals " para correspondência exata (padrão), " unequals " para comparação de desigualdade, " like " para usar a função jcr:like xpath (opcional), " not " para nenhuma correspondência (por exemplo, " not(@prop) " no xpath, o parâmetro value será ignorado) ou " exists " para verificação de existência (o valor pode ser true - a propriedade deve existir, o padrão - ou false - igual a " not ")
  • profundidade
    número de níveis curingas abaixo dos quais a propriedade/caminho relativo pode existir (por exemplo, property=size depth=2 verificará o nó/tamanho, nó/&ast;/size e nó/&ast;/&ast;/size)

rangeproperty

Corresponde uma propriedade JCR a um intervalo. Isso se aplica a propriedades com tipos lineares como LONG , DOUBLE e DECIMAL . Para ver DATE o predicado de intervalo de datas que otimizou a entrada de formato de data.
É possível definir um limite inferior e um limite superior ou apenas um deles. A operação (por exemplo, "menor que" ou "menor ou igual a") também pode ser especificado para limite inferior e superior individualmente.
Não suporta extração de facetas.

Propriedades

  • propriedade
    caminho relativo para a propriedade
  • lowerBound
    limite inferior para verificar a propriedade para
  • lowerOperation
    " > " (padrão) ou " >= ", aplica-se à variável lowerValue
  • upperBound
    limite superior para verificar a propriedade
  • upperOperation
    " < " (padrão) ou " <= ", aplica-se à variável lowerValue
  • decimal
    " true " se a propriedade selecionada for do tipo Decimal

paredaterange

Corresponde JCR DATE as propriedades em relação a uma data/intervalo usando os deslocamentos de tempo relativos à hora atual do servidor. Você pode especificar lowerBound e upperBound usar um valor de milissegundo ou a sintaxe bugzilla 1s 2m 3h 4d 5w 6M 7y (um segundo, dois minutos, três horas, quatro dias, cinco semanas, seis meses, sete anos). Prefixo com " - " para indicar um deslocamento negativo antes da hora atual. Se você especificar apenas lowerBound ou upperBound , o outro assumirá 0 como padrão, o que significa a hora atual.
Por exemplo:
  • upperBound=1h (e não lowerBound ) selecionaria qualquer item na próxima hora
  • lowerBound=-1d (e não upperBound ) selecionaria qualquer item nas últimas 24 horas
  • lowerBound=-6M e upperBound=-3M selecionaria entre 6 meses e 3 meses
  • lowerBound=-1500 e upperBound=5500 selecionaria algo entre 1500 milissegundos no passado e 5500 milissegundos no futuro
  • lowerBound=1d e upperBound=2d selecionaria qualquer coisa depois de amanhã
Observe que não leva anos bissextos em consideração e todos os meses são 30 dias.
Não suporta filtragem.
Suporta a extração de facetas da mesma forma que o predicado daterange.

Propriedades

  • upperBound
    limite de data superior em milissegundos ou 1s 2m 3h 4d 5w 6M 7y (um segundo, dois minutos, três horas, quatro dias, cinco semanas, seis meses, sete anos) em relação ao tempo atual do servidor, use "-" para deslocamento negativo
  • lowerBound
    limite de data inferior em milissegundos ou 1s 2m 3h 4d 5w 6M 7y (um segundo, dois minutos, três horas, quatro dias, cinco semanas, seis meses, sete anos) em relação ao tempo atual do servidor, use "-" para deslocamento negativo

root

Grupo de predicados raiz. Suporta todos os recursos de um grupo e permite definir parâmetros de consulta globais.
O nome "raiz" nunca é usado em uma consulta, é implícito.

Propriedades

  • p.offset
    número que indica o início da página de resultados, ou seja, quantos itens ignorar
  • p.limit
    número que indica o tamanho da página
  • p.aginárioTotal
    recomendado: Evitar calcular o total dos resultados que possam ser dispendiosos; um número que indica o total máximo para contar até (por exemplo, 1000, um número que dá aos usuários feedback suficiente sobre o tamanho bruto e números exatos para obter resultados menores) ou " true " para contar apenas até o mínimo necessário p.offset + p.limit
  • p.excerto
    se definido como " true ", inclua o trecho de texto completo no resultado
  • p.hits
    (somente para o servlet JSON) selecione a maneira como as ocorrências são gravadas como JSON, com essas ocorrências padrão (extensíveis pelo serviço ResultHitWriter):
    • simples :
      itens mínimos como path , title , lastmodified , excerpt (se definido)
    • completo :
      renderização JSON Sling do nó, com jcr:path indicação do caminho da ocorrência: por padrão, apenas lista as propriedades diretas do nó, inclui uma árvore mais profunda com p.nodedepth=N , ou seja, 0 subárvore inteira infinita; adicione p.acls=true para incluir as permissões do JCR da sessão atual no item de resultado fornecido (mapeamentos: create = add_node , modify = set_property , delete = remove )
    • seletivo :
      somente as propriedades especificadas em p.properties , que é uma lista separada por espaços (use "+" em URLs) de caminhos relativos; se o caminho relativo tiver uma profundidade > 1, eles serão representados como objetos filhos; a propriedade jcr:path especial inclui o caminho da ocorrência

savedquery

Inclui todos os predicados de uma consulta do querybuilder persistente na consulta atual como um predicado de subgrupo.
Observe que isso não executará uma consulta extra, mas estenderá a consulta atual.
As consultas podem ser mantidas programaticamente usando QueryBuilder#storeQuery() . O formato pode ser uma propriedade String de várias linhas ou um nt:file nó que contenha a consulta como um arquivo de texto no formato de propriedades Java.
Não suporta a extração de facetas para os predicados da consulta salva.

Propriedades

  • savedquery
    caminho para a consulta salva (propriedade String ou nt:file nó)

similar

Pesquisa de semelhança usando JCR XPath rep:similar() .
Não suporta filtragem. Não suporta extração de facetas.

Propriedades

  • caminho absoluto semelhante ao nó para o qual encontrar nós semelhantes
  • local um caminho relativo para um nó descendente ou . para o nó atual (opcional, o padrão é " . ")

tag

Pesquisa conteúdo marcado com uma ou mais tags, especificando caminhos de título de tag.
Suporta extração de facetas. Fornecerá compartimentos para cada tag exclusiva, usando seu caminho de título de tag atual.

Propriedades

  • tag
    caminho do título da tag a procurar, por exemplo, "Propriedades do ativo : Orientação / Paisagem"
  • N_value
    usar 1_value , 2_value , ... para verificar se há várias tags (combinadas com OR por padrão, com AND if e=true) (desde 5.6)
  • propriedade
    propriedade (ou caminho relativo para propriedade) a ser vista (padrão " cq:tags ")

tagid

Pesquisa conteúdo marcado com uma ou mais tags, especificando IDs de tags.
Suporta extração de facetas. Fornecerá compartimentos para cada tag exclusiva, usando sua ID de tag atual.

Propriedades

  • tagid
    id da tag a ser procurada, por exemplo " properties:orientation/landscape "
  • N_value
    usar 1_value , 2_value , ... para verificar se há várias tags (combinadas com OR por padrão, com AND if e=true) (desde 5.6)
  • propriedade
    propriedade (ou caminho relativo para propriedade) a ser vista (padrão " cq:tags ")

tagsearch

Pesquisa conteúdo marcado com uma ou mais tags, especificando palavras-chave. Primeiro, isso pesquisará por tags que contenham essas palavras-chave em seus títulos e, em seguida, restringirá o resultado somente aos itens marcados com elas.
Não suporta extração de facetas.

Propriedades

  • tagsearch
    palavra-chave a ser pesquisada em títulos de tag
  • propriedade
    propriedade (ou caminho relativo para propriedade) a ser vista (padrão " cq:tags ")
  • lang
    para pesquisar somente um título de tag localizado (por exemplo, " de ")
  • all
    (bool) pesquisar todo o texto da tag, ou seja, todos os títulos, descrição etc. (tem precedência sobre "l ang ")

tipo

Restringe os resultados a um tipo de nó JCR específico, tanto do tipo de nó primário quanto do tipo de mixin. Isso também localizará subtipos desse tipo de nó. Observe que os índices de pesquisa do repositório precisam abranger os tipos de nó para uma execução eficiente.
Suporta extração de facetas. Fornecerá compartimentos para cada tipo exclusivo nos resultados.

Propriedades

  • tipo
    tipo de nó ou nome de mixagem a ser procurado, por exemplo cq:Page