DocumentaçãoAEM 6.5 LTSGuia do usuário

Referência de predicado do construtor de consultas query-builder-predicate-reference

Last update: Fri Jan 30 2026 00:00:00 GMT+0000 (Coordinated Universal Time)
  • Aplica-se a:
  • Experience Manager 6.5 LTS
  • Tópicos:

Criado para:

  • Desenvolvedor
CAUTION
As informações nesta página não são exaustivas.
Para obter informações completas, consulte a lista em Predicados disponíveis no console do Query Builder Debugger; por exemplo, em:
Por exemplo, consulte:

Geral general

Predicados predicates

boolproperty boolproperty

Corresponde às propriedades BOOLEANAS do JCR. Aceita apenas os valores " true" e " false." Se definido como " false", ele corresponderá se a propriedade tiver o valor " false" ou se ela não existir. Útil para verificar se há sinalizadores booleanos que só são definidos quando ativados.

O parâmetro herdado "operation" não tem significado.

Oferece suporte à extração de facetas. Fornece compartimentos para cada valor true ou false, mas somente para propriedades existentes.

Propriedades properties

  • boolproperty
    Caminho relativo para a propriedade, por exemplo, myFeatureEnabled ou jcr:content/myFeatureEnabled.

  • valor
    Valor para verificar a propriedade, " true" ou " false."

contentfragment contentfragment

Restringe o resultado aos fragmentos de conteúdo.

Ela não oferece suporte à filtragem.

Não há suporte para extração de facetas.

Propriedades properties-1

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

dateComparison datecomparison

Compara duas propriedades JCR DATE entre si. Você pode testar se eles são iguais, desiguais, maiores ou maiores ou iguais.

Um predicado somente de filtragem e não pode usar um índice de pesquisa.

Propriedades properties-2

  • propriedade1

    Caminho para a propriedade da primeira data.

  • propriedade2

    Caminho para a segunda propriedade de data.

  • operação

    " equals" para correspondência exata, " !=" para comparação de desigualdade, " greater" para property1 maior que property2, " >=" para property1 maior ou igual a property2. O valor padrão é " equals."

daterange daterange

Corresponde as propriedades DATE do JCR a um intervalo de data e hora. Usa o ISO8601
formato para datas e horas ( YYYY-MM-DDTHH:mm:ss.SSSZ) e também permite 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 UNIX®.

Você pode procurar qualquer item entre dois carimbos de data e hora, qualquer item mais recente ou mais antigo que uma determinada data, e também escolher entre intervalos inclusivos e abertos.

Oferece suporte à extração de facetas. Fornece intervalos "hoje", "esta semana", "este mês", "últimos 3 meses", "este ano", "ano passado" e "antes do ano passado".

Ela não oferece suporte à filtragem.

Propriedades properties-3

  • propriedade

    Caminho relativo para uma propriedade DATE, por exemplo, jcr:lastModified.

  • lowerBound

    Data inferior associada à verificação da propriedade para, por exemplo, 2014-10-01.

  • lowerOperation

    " >" (mais recente) ou " >=" (em ou mais recente), aplica-se a lowerBound. O padrão é ">."

  • upperBound

    Limite superior para verificar a propriedade, por exemplo, 2014-10-01T12:15:00.

  • upperOperation

    " <" (mais antigo) ou " <=" (mais antigo), aplica-se a upperBound. O padrão é "<."

  • fuso horário

    ID do fuso horário a ser usada quando não for fornecida como uma string de data ISO-8601. O padrão é o fuso horário padrão do sistema.

excludepaths excludepaths

Exclui nós do resultado em que o caminho de cada um deles corresponde a uma expressão regular.

Um predicado somente de filtragem e não pode usar um índice de pesquisa.

Não há suporte para extração de facetas.

Propriedades properties-4

  • excludepaths

    A expressão regular corresponde aos caminhos de resultado, excluindo os correspondentes do resultado.

fulltext fulltext

Pesquisa por termos no índice de texto completo.

Ela não oferece suporte à filtragem.

Não há suporte para extração de facetas.

Propriedades properties-5

  • texto completo

    Os termos de pesquisa de texto completo.

  • relPath

    O caminho relativo para pesquisar na propriedade ou no subnó. Essa propriedade é opcional.

group group

Permite que condições aninhadas sejam criadas. Os grupos podem conter grupos aninhados. Tudo em uma consulta do construtor de consultas está implicitamente em um grupo raiz, que também pode ter p.or e p.not parâmetros.

Exemplo para corresponder uma das duas propriedades a 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

Conceitualmente (1_property OU 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

Pesquisa o termo "Gerenciamento" nas páginas em /content/geometrixx/en ou nos ativos em /content/dam/geometrixx.

Conceitualmente fulltext AND ( (path AND type) OR (path AND type) ). Essas associações OR precisam de bons índices para o desempenho.

Propriedades properties-6

  • p.or

    Se definido como " true", somente um predicado no grupo deverá corresponder. O padrão é " false", o que significa que todos devem corresponder

  • p.não

    Se definido como " true", nega o grupo (o padrão é " false").

  • <predicado>

    Adiciona predicados aninhados.

  • N_<predicado>

    Adiciona vários predicados aninhados ao mesmo tempo, como 1_property, 2_property, ....

hasPermission haspermission

Restringe o resultado aos itens em que a sessão atual tem os privilégios JCR especificados.

Um predicado somente de filtragem e não pode usar um índice de pesquisa. Não há suporte para extração de facetas.

Propriedades properties-7

  • hasPermission

    Privilégios JCR separados por vírgulas que a sessão do usuário atual deve ter TODOS os nós em questão. Por exemplo, jcr:write, jcr:modifyAccessControl.

language language

Localiza páginas do CQ em um idioma específico. Isso verifica a propriedade de idioma da página e o caminho da página, que geralmente inclui o idioma ou localidade em uma estrutura de site de nível superior.

Um predicado somente de filtragem e não pode usar um índice de pesquisa.

Oferece suporte à extração de facetas. Fornece intervalos para cada código de idioma exclusivo.

Propriedades properties-8

  • idioma

    Código de idioma ISO, por exemplo, "de."

mainasset mainasset

Verifica se um nó é um ativo principal do DAM e não um subativo. Basicamente, cada nó não está dentro de um nó "subassets". Não verifica o tipo de nó dam:Asset. Para usar este predicado, defina " mainasset=true" ou " mainasset=false", não há mais propriedades.

Um predicado somente de filtragem e não pode usar um índice de pesquisa.

Ela oferece suporte à extração de facetas e fornece dois buckets para ativos principais e secundários.

Propriedades properties-9

  • ativo principal

    Booleano, " true" para ativos principais, " false" para subativos.

memberOf memberof

Localiza itens que são membros de uma coleção de recursos de sling específica.

Um predicado somente de filtragem e não pode usar um índice de pesquisa. Não há suporte para extração de facetas.

Propriedades properties-10

  • memberOf

    Caminho da coleção de recursos do Sling.

nodename nodename

Corresponde aos nomes de nó JCR.

Oferece suporte à extração de facetas. Fornece buckets para cada nome de nó exclusivo (nome do arquivo).

Propriedades properties-11

  • nodename

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

notexpired notexpired

Corresponde a itens verificando se uma propriedade JCR DATE é maior ou igual à hora atual do servidor. Pode ser usado para verificar uma " expiresAt" como propriedade de data e limitar apenas àqueles que ainda não expiraram ( notexpired=true) ou que já expiraram ( notexpired=false).

Ela não oferece suporte à filtragem.

Ela suporta a extração de facetas da mesma forma que o predicado daterange.

Propriedades properties-12

  • nãoexpirou

    Booleano, " true" para ainda não expirado (data futura ou igual), " false" para expirado (data no passado) (obrigatório).

  • propriedade

    Caminho relativo para a propriedade DATE a ser verificada (obrigatório).

orderby orderby

Permite que os resultados sejam classificados. Se a ordenação por várias propriedades for necessária, esse predicado deverá ser adicionado várias vezes usando o prefixo numérico, como 1_orderby=first, 2_oderby=second.

Propriedades properties-13

  • 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 definido como ignore, ele faz com que a classificação não diferencie maiúsculas de minúsculas, o que significa que "a" vem antes de "B"; se estiver vazio ou for deixado de fora, a classificação diferencia maiúsculas de minúsculas, o que significa que "B" vem antes de "a"

path path

Pesquisa em um determinado caminho.

Não há suporte para extração de facetas.

Propriedades properties-14

  • caminho

    Padrão de caminho. Quando exact=false (padrão), a pesquisa corresponde a toda a subárvore no caminho especificado — semelhante ao acréscimo de //* em XPath, mas não inclui o próprio caminho base. Quando exact=true, a pesquisa corresponde somente ao caminho exato, que pode incluir curingas *. Se self estiver definido, a pesquisa incluirá o nó base e sua subárvore inteira.

  • exato

    Se exact for verdadeiro (ativado), o caminho exato deve corresponder, mas pode conter curingas simples ( *), que correspondem a nomes, mas não " /"; se for falso (padrão), todos os descendentes serão incluídos (opcional).

  • simples

    Pesquisa somente os filhos diretos (como o acréscimo de "/*" em 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).

property property

Corresponde às propriedades do JCR e seus valores.

Oferece suporte à extração de facetas. Fornece intervalos para cada valor de propriedade exclusivo nos resultados.

Propriedades properties-15

  • 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

    Use 1_value, 2_value, … para verificar se há vários valores (combinados com OR por padrão, com AND if e=true) (desde a versão 5.3).

  • e

    Definido como verdadeiro para combinar vários valores ( N_value) com AND (desde 5.3).

  • operação

    Use equals para uma correspondência exata (padrão) e unequals para uma comparação de desigualdade. Use like para aplicar a função XPath jcr:like opcional. Use not para nenhuma correspondência (por exemplo, not(@prop) em XPath); nesse caso, o parâmetro value é ignorado. Use exists para verificar se uma propriedade existe: true (padrão) requer a propriedade, e false é equivalente a not.

  • profundidade

    Um número de níveis curinga sob os quais a propriedade e o caminho relativo podem existir. Por exemplo, property=size depth=2 verifica o nó e o tamanho, node/*/size e node/*/*/size.

rangeproperty rangeproperty

Corresponde uma propriedade JCR a um intervalo. Aplica-se a propriedades com tipos lineares, como LONG, DOUBLE e DECIMAL. Para DATE, consulte o predicado de intervalo de datas que otimizou a entrada de formato de data.

Você pode 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 especificada para limites inferior e superior, individualmente.

Não há suporte para extração de facetas.

Propriedades properties-16

  • propriedade

    Caminho relativo para a propriedade.

  • lowerBound

    Limite inferior para verificar a propriedade.

  • lowerOperation

    " >" (padrão) ou " >=" aplica-se ao lowerValue

  • upperBound

    Limite superior para verificar a propriedade.

  • upperOperation

    " <" (padrão) ou " <=" aplica-se ao lowerValue

  • decimal

    " true" se a propriedade marcada for do tipo Decimal

relativedaterange relativedaterange

Corresponde as propriedades JCR DATE a um intervalo de data e hora usando deslocamentos de tempo relativos à hora atual do servidor. Você pode especificar lowerBound e upperBound usando um valor de milissegundo ou a sintaxe bugzilla 1s 2m 3h 4d 5w 6M 7y. Prefixo com " -" para indicar um deslocamento negativo antes da hora atual. Se você especificar apenas lowerBound ou upperBound, o outro valor padrão será 0, significando a hora atual.

Por exemplo:

  • upperBound=1h (e nenhum lowerBound) selecionaria nada na próxima hora
  • lowerBound=-1d (e nenhum upperBound) selecionaria qualquer item nas últimas 24 horas
  • lowerBound=-6M e upperBound=-3M selecionariam qualquer item com 6 a 3 meses
  • lowerBound=-1500 e upperBound=5500 selecionariam algo entre 1500 milissegundos no passado e 5500 milissegundos no futuro
  • lowerBound=1d e upperBound=2d selecionariam qualquer item depois de amanhã

Ele não leva anos bissextos em consideração e todos os meses são 30 dias.

Ela não oferece suporte à filtragem.

Ela suporta a extração de facetas da mesma forma que o predicado daterange.

Propriedades properties-17

  • upperBound

    Limite superior de data 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) relativo à hora atual do servidor, use "-" para deslocamento negativo.

  • lowerBound

    Limite inferior de data 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) relativo à hora atual do servidor, use "-" para deslocamento negativo.

root root

Grupo de predicados raiz. Ela é compatível com todos os recursos de um grupo e permite definir parâmetros de consulta globais.

O nome "root" nunca é usado em uma query, ele é implícito.

Propriedades properties-18

  • p.offset

    O número que indica o início da página de resultados, ou seja, quantos itens devem ser ignorados.

  • p.limit

    O número que indica o tamanho da página.

  • p.guessTotal

    Para evitar o custo de calcular um total de resultado completo, não conte todas as correspondências. Em vez disso, defina um total máximo para contar até (por exemplo, 1000) para fornecer aos usuários um tamanho bruto e totais exatos para resultados menores. Ou defina como true para contar somente até o mínimo necessário: p.offset + p.limit.

  • p.excerpt

    Se definido como " true", incluir trecho de texto completo no resultado.

  • p.hits

    (somente para o servlet JSON) selecione a forma como as ocorrências são gravadas como JSON, com estas padrão (extensíveis por meio do serviço ResultHitWriter):

    • simples:

      Mínimo de itens como path, title, lastmodified, excerpt (se definido).

    • cheio:

      Os resultados são renderizados como Sling JSON para cada nó, com jcr:path mostrando o caminho da ocorrência. Por padrão, a resposta inclui somente as propriedades diretas do nó; use p.nodedepth=N para incluir conteúdo mais profundo, onde 0 retorna a subárvore inteira. Defina p.acls=true para incluir as permissões JCR da sessão atual para cada item (create = add_node, modify = set_property, delete = remove).

    • seletivo:

      A resposta inclui somente as propriedades listadas em p.properties, que é uma lista separada por espaços de caminhos relativos (use + em URLs). Se um caminho relativo tiver uma profundidade maior que 1, a saída o aninhará como objetos filho. A propriedade especial jcr:path sempre inclui o caminho da ocorrência.

savedquery savedquery

Inclui todos os predicados de uma consulta persistente do construtor de consultas na consulta atual como um predicado de subgrupo.

Ela não executa uma consulta extra, mas estende a consulta atual.

As consultas podem ser persistidas de forma programática usando QueryBuilder#storeQuery(). O formato pode ser uma propriedade de Cadeia de Caracteres de várias linhas ou um nó nt:file que contém a consulta como um arquivo de texto no formato de propriedades Java™.

Não há suporte para extração de facetas para os predicados da consulta salva.

Propriedades properties-19

  • savedquery

    Caminho para a consulta salva (propriedade de cadeia de caracteres ou nó nt:file).

similar similar

Pesquisa de semelhança usando JCR XPath's rep:similar().

Ela não oferece suporte à filtragem. Não há suporte para extração de facetas.

Propriedades properties-20

  • semelhante
    Caminho absoluto para o nó para o qual localizar nós semelhantes.

  • local
    Um caminho relativo para um nó descendente ou . para o nó atual (opcional, o padrão é " .").

tag tag

Pesquisa conteúdo marcado com uma ou mais tags, especificando caminhos de título de tag.

Oferece suporte à extração de facetas. Fornece intervalos para cada tag exclusiva, usando o caminho do título da tag atual.

Propriedades properties-21

  • marca

    O caminho do título da tag a ser procurado, por exemplo, "Propriedades dos ativos : Orientação / Paisagem".

  • N_value

    Use 1_value, 2_value, … para verificar se há várias marcas (combinadas com OR por padrão, com AND if e=true) (desde a versão 5.6).

  • propriedade

    Propriedade (ou caminho relativo para a propriedade) a ser examinada (padrão " cq:tags")

tagid tagid

Pesquisa conteúdo marcado com uma ou mais tags, especificando IDs de tag.

Oferece suporte à extração de facetas. Fornece compartimentos para cada tag exclusiva, usando a ID de tag atual.

Propriedades properties-22

  • tagid

    ID da tag para que você possa procurar, por exemplo, " properties:orientation/landscape."

  • N_value

    Use 1_value, 2_value, … para verificar se há vários tagids (combinados com OR por padrão, com AND if e=true) (desde a versão 5.6).

  • propriedade

    Propriedade (ou caminho relativo para a propriedade) a ser examinada (padrão " cq:tags").

tagsearch tagsearch

Pesquisa conteúdo marcado com uma ou mais tags, especificando palavras-chave. Pesquisa primeiro tags que contêm essas palavras-chave em seus títulos e, em seguida, restringe o resultado somente a itens marcados.

Não há suporte para extração de facetas.

Propriedades Properties-1

  • tagsearch

    Palavra-chave a ser pesquisada em títulos de tags.

  • propriedade

    Propriedade (ou caminho relativo para a propriedade) a ser examinada (padrão cq:tags).

  • lang

    Para pesquisar apenas um determinado título de tag localizado (por exemplo, de).

  • todos

    (bool) Pesquisa o texto completo da tag, ou seja, todos os títulos, descrições e assim por diante. Tem prioridade sobre "l ang."

type type

Restringe os resultados a um tipo de nó JCR específico, do tipo de nó primário ou de mixin, e encontra subtipos desse tipo de nó. Os índices de pesquisa do repositório devem abranger os tipos de nó para uma execução eficiente.

Oferece suporte à extração de facetas. Fornece intervalos para cada tipo exclusivo nos resultados.

Propriedades Properties-2

  • tipo

    Tipo de nó ou nome de mixin para procurar, por exemplo, cq:Page.

recommendation-more-help
51c6a92d-a39d-46d7-8e3e-2db9a31c06a2