Referência de predicado do construtor de consultas

Geral

• raiz
• grupo
• orderby

Predicados

• boolproperty
• contentfragment
• dateComparison
• intervalo de datas
• excludepaths
• texto completo
• hasPermission
• idioma
• principal ativo
• memberOf
• nodename
• não expirado
• caminho
• propriedade
• rangeproperty
• relativedaterange
• savedquery
• semelhante
• tag
• tagid
• tagsearch
• tipo

boolproperty

Corresponde às propriedades BOOLEANAS do JCR. Aceita apenas os valores " true" e " false". Se " false", corresponderá se a propriedade tiver o valor " false" ou se não existir. Isso pode ser útil para verificar se há sinalizadores booleanos definidos apenas quando ativados.

O " operationO parâmetro " não tem significado.

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

Propriedades

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

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

contentfragment

Restringe o resultado aos fragmentos de conteúdo.

Não oferece suporte à filtragem.

Não oferece suporte à extração de facetas.

Propriedades

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

dateComparison

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

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

Propriedades

• property1

  Caminho para a propriedade da primeira data.

• property2

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

intervalo de datas

Corresponde as propriedades JCR DATE com um intervalo de data/hora. Usa o formato ISO8601 para 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 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", "último ano" e "anterior ao ano passado".

Não oferece suporte à filtragem.

Propriedades

• propriedade

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

• lowerBound

  Data inferior vinculada para verificar a propriedade para, por exemplo, 2014-10-01.

• lowerOperation

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

• upperBound

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

• upperOperation

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

• timeZone

  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

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

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

Não oferece suporte à extração de facetas.

Propriedades

• excludepaths

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

texto completo

Pesquisa por termos no índice de texto completo.

Não oferece suporte à filtragem.

Não oferece suporte à extração de facetas.

Propriedades

• texto completo

  Os termos de pesquisa de texto completo.

• relPath

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

grupo

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 pode ter p.or e p.not também.

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

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

Isso pesquisa o termo "Gerenciamento" nas páginas em /content/geometrixx/en ou em ativos no /content/dam/geometrixx.

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

Propriedades

• p.ou

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

• p.não

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

• <predicate>

  Adiciona predicados aninhados.

• N_<predicate>

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

hasPermission

Restringe o resultado a itens nos quais a sessão atual tem o valor especificado Privilégios JCR.

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

Propriedades

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

idioma

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.

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

• idioma

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

principal ativo

Verifica se um nó é um ativo principal do DAM e não um subativo. Basicamente, isso ocorre em todos os nós que não estão dentro de um nó "subassets". Isso não verifica o dam:Asset tipo de nó. Para usar esse predicado, defina " mainasset=true" ou " mainasset=false", não há mais propriedades.

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

Suporta extração de facetas e fornece dois buckets para ativos principais e secundários.

Propriedades

• principal ativo

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

memberOf

Localiza itens que são membros de um coleção de recursos do sling.

Este é um predicado somente de filtragem e não pode usar um índice de pesquisa. Não oferece suporte à extração de facetas.

Propriedades

• memberOf

  Caminho da coleção de recursos do Sling.

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

• nodename

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

não expirado

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

Não oferece suporte à filtragem.

Suporta extração de facetas da mesma forma que o predicado daterange.

Propriedades

• não expirado

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

• propriedade

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

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

• orderby

  O nome da propriedade do 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 definida como ignore, 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 vazia ou for deixada de fora, a classificação diferencia maiúsculas de minúsculas, o que significa que "B" vem antes de "a"

caminho

Pesquisa em um determinado caminho.

Não oferece suporte à extração de facetas.

Propriedades

• caminho

  Padrão de caminho. Dependendo do exato, a subárvore inteira corresponde (como anexar //* no xpath, mas observe que isso não inclui o caminho base) (exato=falso, padrão), ou apenas uma correspondência de caminho exato, que pode incluir curingas ( *); se self for 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 a nomes, mas não " /"; se for falso (padrão) todos os descendentes serão incluídos (opcional).

• plano

  Pesquisa somente os filhos diretos (como anexar " /*" no xpath) (usado somente se ' exact' não é 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.

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

Propriedades

• propriedade

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

• Valor_N

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

• e

  Defina como verdadeiro para combinar vários valores ( N_value) com E (desde 5.3).

• operação

  "equals" para correspondência exata (padrão), " unequals" para comparação de desigualdade, " like" para usar o jcr:like função xpath (opcional), " not" para nenhuma correspondência (por exemplo, "not(@prop)" no xpath, o parâmetro value é ignorado) ou " exists"para verificação de existência (o valor pode ser verdadeiro - a propriedade deve existir, o padrão - ou falso - o mesmo que" not").

• profundidade

  Número de níveis curingas abaixo dos quais a propriedade/caminho relativo pode existir (por exemplo, property=size depth=2 verifica nó/tamanho, nó/*/tamanho e nó/*/*/tamanho).

rangeproperty

Corresponde uma propriedade JCR a um intervalo. Isso se aplica 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 oferece suporte à extração de facetas.

Propriedades

• 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

Corresponde JCR DATE propriedades em um intervalo de data/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 (um segundo, dois minutos, três horas, quatro dias, cinco semanas, seis meses, sete anos). Prefixar com " -" para indicar um deslocamento negativo antes da hora atual. Se você especificar apenas lowerBound ou upperBound, o outro toma como padrão 0, 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 coisa nas últimas 24 horas
• lowerBound=-6M e upperBound=-3M selecionaria qualquer idade entre 6 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 no dia depois de amanhã

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

Não oferece suporte à filtragem.

Suporta extração de facetas da mesma forma que o predicado daterange.

Propriedades

• upperBound

  Data superior associada 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 à 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) em relação à hora atual do servidor, use "-" para deslocamento negativo.

raiz

Grupo de predicados raiz. Suporta todos os recursos de um grupo e permite a definição de parâmetros de consulta globais.

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

Propriedades

• 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

  Recomendado: evite calcular o total do resultado completo, que pode ser caro; um número que indique o total máximo a ser contado até (por exemplo, 1000, um número que fornece aos usuários feedback suficiente sobre o tamanho bruto e números exatos para resultados menores) ou " true" para contar somente até o mínimo necessário p.offset + p.limit.

• p.excerpt

  Se definida 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).

  • completo:

    Renderização Sling JSON do nó, com jcr:path indicando o caminho da ocorrência: por padrão, apenas lista as propriedades diretas do nó, inclui uma árvore mais profunda com p.nodedepth=N, com 0 significando a subárvore inteira e infinita; adicione p.acls=true para incluir as permissões JCR da sessão atual no item de resultado fornecido (mapeamentos: create = add_node, modify = set_property, delete = remove).

  • seletivo:

    Somente propriedades especificadas em p.properties, que é uma lista de caminhos relativos separada por espaços (use "+" em URLs); se o caminho relativo tiver uma profundidade > 1, eles serão representados como objetos filho; a propriedade especial jcr:path inclui o caminho da ocorrência

savedquery

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

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

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

Não oferece suporte à extração de facetas para os predicados da consulta salva.

Propriedades

• savedquery

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

semelhante

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

Não oferece suporte à filtragem. Não oferece suporte à extração de facetas.

Propriedades

• 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

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

• tag

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

• Valor_N

  Uso 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 a propriedade) a ser observada (padrão " cq:tags")

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

• tagid

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

• Valor_N

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

• propriedade

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

tagsearch

Pesquisa conteúdo marcado com uma ou mais tags, especificando palavras-chave. Primeiro, busca tags que contenham essas palavras-chave em seus títulos, depois restringe o resultado a apenas itens marcados com eles.

Não oferece suporte à extração de facetas.

Propriedades

• tagsearch

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

• propriedade

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

• lang

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

• todas

  (bool) Pesquisar texto completo da tag inteira, ou seja, todos os títulos, descrições e assim por diante (tem precedência sobre "l" ang").

tipo

Restringe os resultados a um tipo de nó JCR específico, seja do tipo de nó primário ou do tipo de mixin. Isso também 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

• tipo

  Tipo de nó ou nome de mixin a ser pesquisado, por exemplo, cq:Page.