Referência de previsão do Query Builder

Geral

Predicados

boolproperty

Corresponde às propriedades BOOLEAN do JCR. Aceita somente 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 valor true ou false, mas somente para propriedades existentes.

Propriedades

  • caminho
    boolpropertyrelative para propriedade, 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


  • contentfragmentPode 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 property1 maior que property2, " >=" para property1 maior que ou igual a property2. O valor padrão é " =".

daterange

Corresponde às propriedades JCR DATE em relação a um intervalo de data/hora. Isso usa o ISO8601
formato 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 ú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 propriedade DATE, por exemplo jcr:lastModified

  • lowerBound

    data inferior vinculada à propriedade check 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 ou mais antigo), aplica-se a 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.

excludepath

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

    a expressão regular correspondeu aos 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 no subnó. Essa propriedade é opcional.

grupo

Permite criar condições aninhadas. Os grupos podem conter grupos aninhados. Tudo o que está em um query do querybuilder está implicitamente em um grupo raiz, que também pode ter parâmetros p.or e p.not.

Exemplo para corresponder uma de duas propriedades em relação 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 "Management" 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) ). Esteja ciente de que tais junções OU precisam de bons índices para o desempenho.

Propriedades

  • p.or

    se definido como " true", apenas 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_<predicate>

    adiciona vários predicados aninhados do mesmo tempo, como 1_property, 2_property, ...

hasPermission

Restringe o resultado aos itens em que 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. Ele não suporta 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

  • linguagem

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

mainasset

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 nó dam:Asset. 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

MemberOf

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

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

nodename

Corresponde aos nomes dos nós do 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 caractere ou nenhum, ? = 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 semelhante " expiresAt" e limitar somente à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 propriedade DATE a ser verificada (obrigatório)

orderby

Permite classificar o resultado. Se a ordem por várias propriedades for necessária, esse predicado precisa ser adicionado várias vezes usando o prefixo number, 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 no query, por exemplo 2_property, no qual classificar

  • classificar

    direção de classificação, " desc" para decrescente ou " asc" para ascendente (padrão)

  • caso

    se definido como " ignore" fará com que a classificação não diferencie maiúsculas de minúsculas, significando 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

  • caminho

    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 deverá corresponder, mas pode conter curingas simples ( *), que correspondam 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) (somente usado 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

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

  • operação

    " 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 - 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 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 DATE, consulte 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 a lowerValue

  • upperBound

    limite superior para verificar a propriedade

  • upperOperation

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

  • decimal

    " true" se a propriedade selecionada for do tipo Decimal

relativedaterange

Corresponde as propriedades JCR DATE em relação a um intervalo de data/hora usando os 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). 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 qualquer coisa 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

raiz

Grupo de predicados raiz. Suporta todos os recursos de um grupo e permite definir parâmetros de query globais.

O nome "raiz" nunca é usado em um query, é implícito.

Propriedades

  • p.offset

    número que indica o start 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 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 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, o que significa 0 como a subárvore inteira e 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 um query querybuilder persistente no query atual como um predicado de subgrupo.

Observe que isso não executará um query extra, mas estenderá o query atual.

Os query podem ser persistentes programaticamente usando QueryBuilder#storeQuery(). O formato pode ser uma propriedade String de várias linhas ou um nó nt:file que contenha o query como um arquivo de texto no formato de propriedades Java.

Não suporta extração de facetas para os predicados do query salvo.

Propriedades

  • savedquery

    caminho para o query salvo (propriedade String ou nó nt:file)

similar

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

Não suporta filtragem. Não suporta extração de facetas.

Propriedades

  • caminho absoluto
    semelhante ao nó para o qual encontrar nós semelhantes

  • caminho relativo
    locala 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 ser procurado, por exemplo, "Propriedades do ativo : Orientação / Paisagem"

  • N_value

    use 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

    use 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 prioridade 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 mistura a ser procurado, por exemplo cq:Page

Nesta página

Adobe Maker Awards Banner

Time to shine!

Apply now for the 2021 Adobe Experience Maker Awards.

Apply now
Adobe Maker Awards Banner

Time to shine!

Apply now for the 2021 Adobe Experience Maker Awards.

Apply now