Configuração de formulários de pesquisa

Use Pesquisar Forms para personalizar a seleção de predicados de pesquisa usados nos painéis de pesquisa disponíveis em vários consoles e/ou painéis de AEM do ambiente do autor. Personalizar esses painéis torna a funcionalidade de pesquisa versátil de acordo com suas necessidades específicas.

Um intervalo de predicados está disponível prontamente. Você pode adicionar vários predicados, incluindo (entre outros) o predicado Propriedade para procurar ativos que correspondam a uma única propriedade especificada por você, ou o predicado Opções para pesquisar ativos que correspondam a um ou mais valores especificados para uma propriedade específica.

Você pode configurar os formulários de pesquisa usados em vários consoles e no navegador de ativos (ao editar páginas). As caixas de diálogo para configurar estes formulários podem ser acessadas através de:

  • Ferramentas

    • Geral

      • Formulários de pesquisa

Ao acessar esse console pela primeira vez, você pode ver que todas as configurações têm um símbolo de cadeado. Isso indica que a configuração apropriada é a configuração padrão (pronta para uso) e não pode ser excluída. Após personalizar a configuração, o bloqueio desaparecerá, a menos que você exclua sua configuração personalizada, nesse caso, o padrão (e o indicador de cadeado) será reinstalado.

chlimage_1-374

Configurações

As configurações padrão disponíveis são:

  • Editor de páginas (Pesquisa de documentos):

    Essa configuração define as opções disponíveis ao pesquisar por documento no navegador de ativos (ao editar uma página).

  • Editor de páginas (Pesquisa de imagens):

    Essa configuração define as opções disponíveis ao pesquisar por imagens no navegador de ativos (ao editar uma página).

  • Editor de páginas (Pesquisa de manuscrito):

    Essa configuração define as opções disponíveis ao pesquisar por manuscritos no navegador de ativos (ao editar uma página).

  • Editor de páginas (Pesquisa de páginas):

    Essa configuração define as opções disponíveis ao pesquisar por páginas no navegador de ativos (ao editar uma página).

  • Editor de páginas (Pesquisa de parágrafos):

    Essa configuração define as opções disponíveis ao pesquisar por parágrafos no navegador de ativos (ao editar uma página).

  • Editor de páginas (Pesquisa de produto):

    Essa configuração define as opções disponíveis ao procurar produtos no navegador de ativos (ao editar uma página).

  • Editor de páginas ( [antigo Scene7] search do Dynamic Media Classic):

    Essa configuração define as opções disponíveis ao pesquisar recursos do Scene7 no navegador de ativos (ao editar uma página).

  • Trilho de pesquisa do administrador de sites:

    Essa configuração define as opções de pesquisa disponíveis para o usuário ao usar o painel de pesquisa do console Sites .

  • Editor de página (Pesquisa de vídeos):

    Essa configuração define as opções disponíveis ao procurar vídeos no navegador de ativos (ao editar uma página).

  • Trilho de pesquisa do administrador de ativos:

    Essa configuração define as opções de pesquisa disponíveis para o usuário ao usar o console Ativos .

  • Painel de pesquisa do administrador de catálogos:

    Essa configuração define as opções de pesquisa disponíveis para o usuário ao pesquisar um catálogo de comércio.

  • Painel de pesquisa do administrador de pedidos:

    Essa configuração define as opções de pesquisa disponíveis para o usuário ao pesquisar pedidos de comércio.

  • Painel de pesquisa do administrador das coleções do produto:

    Essa configuração define as opções de pesquisa disponíveis para o usuário ao pesquisar coleções de produtos de comércio.

  • Painel de pesquisa do administrador de produtos:

    Essa configuração define as opções de pesquisa disponíveis para o usuário ao pesquisar produtos de comércio.

  • Trilho de pesquisa do administrador de projetos:

    Essa configuração define as opções de pesquisa disponíveis para o usuário ao pesquisar projetos.

Predicados e suas configurações

Predicados

Os seguintes predicados estão disponíveis, dependendo da configuração:

Predicado Propósito Configurações
Analytics Pesquise/filtre recursos no navegador Sites ao mostrar dados fornecidos pelo Analytics. Os filtros de pesquisa do Analytics são carregados para corresponder às colunas de análise personalizadas mapeadas.
  • Rótulo do campo
  • Descrição
Última modificação do ativo Data em que o ativo foi modificado pela última vez.
Um predicado personalizado, com base no Predicado de data.
Componentes Permite que um autor pesquise/filtre por páginas que têm um componente específico nele. Por exemplo, uma galeria de imagens.
  • Rótulo do campo
  • Espaço reservado
  • Nome da Propriedade*
  • Profundidade da propriedade
  • Descrição
Data Pesquisa de ativos com base em controle deslizante com base em uma propriedade de data.
  • Rótulo do campo
  • Nome da Propriedade*
  • Descrição
Intervalo de datas Pesquise ativos criados em um intervalo especificado para uma propriedade de data. No painel Pesquisar , é possível especificar datas de Início e Término.
  • Rótulo do campo
  • Espaço reservado
  • Nome da Propriedade*
  • Texto do intervalo (de)*
  • Texto do intervalo (até)*
  • Descrição
Status da expiração Pesquisar ativos com base no status de expiração.
  • Rótulo do campo
  • Nome da Propriedade*
  • Descrição
Tamanho do arquivo Pesquisar ativos com base em seu tamanho.
  • Rótulo do campo
  • Nome da Propriedade*
  • Caminho de opção
  • Descrição
Filtro oculto Um filtro na propriedade e no valor , não visível para o usuário.
  • Nome da Propriedade
  • Valor da propriedade
  • Descrição
Opções

As opções são nós de conteúdo criados pelo usuário.

Consulte Adicionar um predicado de opções para obter mais informações.

  • Rótulo do campo
  • Caminho JSON
  • Nome da Propriedade*
  • Única seleção
  • Caminho de opção
  • Descrição
Propriedade Opções Pesquise em uma propriedade da opção .
  • Rótulo do campo
  • Nome da Propriedade*
  • Caminho do nó de opções
  • Única seleção
  • Descrição
Status da página Pesquise páginas de acordo com seu status.
  • Rótulo do campo
  • Nome da propriedade de publicação
  • Nome de propriedade do LiveCopy
  • Descrição
Caminho Pesquise ativos localizados em um caminho específico.
  • Rótulo do campo
  • Adicionar caminho de pesquisa
  • Descrição
Propriedade Pesquise em uma propriedade especificada. nenhum
Publicar status Pesquisar ativos com base em seu status de publicação
  • Rótulo do campo
  • Nome da Propriedade*
  • Descrição
Intervalo Pesquise recursos que estão dentro de um intervalo especificado. No painel Pesquisar , é possível especificar valores mínimos e máximos para o intervalo.
  • Rótulo do campo
  • Nome da Propriedade
  • Descrição
Opções de intervalo Um predicado de pesquisa específico para Ativos e o mesmo Predicado de controle deslizante comum. Ainda está disponível devido a problemas de compatibilidade com versões anteriores.
  • Rótulo do campo
  • Nome da Propriedade*
  • Caminho de opção
  • Descrição
Classificação Pesquise ativos de acordo com sua classificação.
  • Rótulo do campo
  • Nome da Propriedade*
  • Caminho de opção
  • Descrição
Data relativa Pesquisar ativos com base na data relativa de sua criação
  • Rótulo do campo
  • Nome da Propriedade*
  • Data relativa
  • Descrição
Intervalo do controle deslizante Um predicado de pesquisa comum que estende o predicado de intervalo com o recurso do controle deslizante. O valor da propriedade pesquisada deve estar entre os limites do controle deslizante.
  • Rótulo do campo
  • Nome da Propriedade*
  • Descrição
Tag Pesquisar ativos com base em tags. Você pode configurar a propriedade Caminho para preencher várias tags na lista Tags.
  • Rótulo do campo
  • Nome da Propriedade*
  • Caminho de opção
  • Descrição
Tags Pesquisar com base em tags.
  • Espaço reservado
  • Nome da Propriedade*
  • Descrição
OBSERVAÇÃO
  • Os predicados de pesquisa comuns são definidos em:
    /libs/cq/gui/components/common/admin/customsearch/searchpredicates

  • Os predicados de pesquisa relacionados somente ao siteadmin (interface clássica) estão localizados em:
    /libs/cq/gui/components/siteadmin/admin/searchpanel/searchpredicates

  • Eles estão obsoletos e disponíveis apenas para compatibilidade com versões anteriores.

Essas informações são apenas para referência. Você não deve fazer alterações em /libs.

Configurações do predicado

Dependendo do predicado, uma seleção de configurações está disponível para configuração:

  • Rótulo do campo

    O rótulo que aparecerá como o cabeçalho que pode ser recolhido ou como o rótulo de campo do predicado.

  • Descrição

    Detalhes descritivos do usuário.

  • Espaço reservado

    Texto vazio ou o espaço reservado do predicado caso nenhum texto de filtragem seja inserido.

  • Nome da Propriedade

    A propriedade a ser pesquisada. Ele usa um caminho relativo e os curingas */*/* especificam a profundidade da propriedade em relação ao nó jcr:content (cada asterisco representa um nível de nó).

    Se você quiser pesquisar apenas em um nó filho de primeiro nível do recurso que tenha a propriedade x no nó jcr:content, use */jcr:content/x

  • Profundidade da propriedade

    A profundidade máxima para procurar essa propriedade nos recursos. Portanto, uma pesquisa nessa propriedade pode ser executada em um recurso e em filhos recursivos até que o nível dos filhos seja igual à profundidade especificada.

  • Valor da propriedade

    O valor da propriedade como uma string absoluta ou como uma linguagem de expressão; por exemplo, cq:Page ou

    ${empty requestPathInfo.suffix ? "/content" : requestPathInfo.suffix}.

  • Texto do intervalo

    O rótulo do campo de intervalo no predicado Intervalo de datas.

  • Caminho de opção

    O usuário pode selecionar o caminho usando o Navegador de caminhos na guia de configuração do predicado. Depois de selecionar o ícone + é usado para adicionar a seleção à lista de opções válidas (em seguida, o ícone - é removido, se necessário).

    As opções são nós de conteúdo criados pelo usuário, com a seguinte estrutura:

    (jcr:primaryType = nt:unstructured, value (String), jcr:title (String))

  • Opções
    caminho do nóEfetivamente o mesmo que
    Caminho das opções, somente se estiver no campo predicado comum, o outro é específico para ativos.

  • Single
    SelectIf marcada, as opções são renderizadas como caixas de seleção que permitem somente uma seleção. Se estiver selecionado incorretamente, uma caixa de seleção pode ser desmarcada.

  • Publicar e Live Copy Nome(s) de propriedades
    Os rótulos das caixas de seleção publicar e live copy para o predicado específico Sites.

  • O * nos rótulos de campo na guia Settings significa que os campos são obrigatórios e, se deixado em branco, uma mensagem de erro será exibida

Configurar seu Forms de pesquisa

Criando/Abrindo uma Configuração Personalizada

  1. Navegue até Ferramentas, Geral, Pesquisar Forms.

  2. Selecione a configuração que deseja personalizar.

  3. Use o ícone Edit para abrir a configuração para atualização.

  4. Se uma nova personalização você provavelmente desejará adicionar novos campos de predicado e definir as configurações conforme necessário. Se houver uma personalização, você poderá selecionar um campo existente e atualizar as configurações.

  5. Selecione Concluído para salvar a configuração.

    OBSERVAÇÃO

    As configurações personalizadas são armazenadas (conforme o caso) em:

    • /apps/cq/gui/content/facets/<option>
    • /apps/commerce/gui/content/facets/<option>

Adicionar/editar um campo predicado e definir configurações de campo

Você pode adicionar ou editar campos e definir/atualizar suas configurações:

  1. Abra a configuração personalizada para atualização.

  2. Se quiser adicionar um novo campo, abra a guia Selecionar predicado e arraste o predicado necessário para o local desejado. Por exemplo, o Predicado do intervalo de datas:

    chlimage_1-375

  3. Dependendo de:

    • Você está adicionando um novo campo:

      Após adicionar o predicado, a guia Settings será aberta e mostrará as propriedades que podem ser definidas.

    • Você deseja atualizar um predicado existente:

      Selecione o campo predicado (à direita) e abra a guia Settings.
      Por exemplo, as configurações para Predicado do intervalo de datas:

    chlimage_1-375

  4. Faça as alterações necessárias e confirme com Concluído.

Pré-visualização da Configuração de Pesquisa

  1. Selecione o ícone Preview :

  2. Isso exibirá os formulários de pesquisa da forma que serão exibidos (totalmente expandidos) na coluna Pesquisar do console apropriado.

    chlimage_1-377

  3. ​Feche a visualização para retornar e concluir a configuração.

Excluindo um Campo de Predicado

  1. Abra a configuração personalizada para atualização.

  2. Selecione o campo predicado (à direita), abra a guia Settings e selecione o ícone Delete (parte inferior esquerda).

  3. Uma caixa de diálogo solicitará a confirmação da ação de exclusão.

  4. Confirme esta e quaisquer outras alterações com Concluído.

Excluindo uma configuração (para restabelecer o padrão)

Após personalizar uma configuração, os padrões serão substituídos. Você pode restabelecer a configuração padrão excluindo a configuração personalizada.

OBSERVAÇÃO

Não é possível excluir nenhuma das configurações padrão.

A exclusão de uma configuração personalizada é feita no console:

  1. Selecione a configuração necessária (por exemplo, Editor de páginas (pesquisa de parágrafos)) e, em seguida, o ícone Excluir na barra de ferramentas:

    chlimage_1-378

  2. A configuração personalizada será excluída e o padrão reinstalado (isso é indicado pelo reaparecimento do símbolo de cadeado no console).

Adicionar Predicados de Opções

Os predicados de opção (Opções, Propriedade de opções) permitem configurar um item a ser pesquisado. Normalmente, eles são usados para procurar algo diretamente abaixo da página; por exemplo, uma propriedade no nó da página.

O exemplo a seguir (para pesquisar de acordo com o modelo usado para criar uma página) ilustra as etapas envolvidas:

  1. Crie o nó que define a propriedade a ser pesquisada.

    Você precisará de um nó raiz contendo definições das opções individuais para estar disponível para o usuário.

    Os nós das opções individuais precisam das propriedades:

    • jcr:title - o rótulo do campo a ser exibido no painel de pesquisa
    • value - o valor da propriedade a ser pesquisada

    chlimage_1-379

    OBSERVAÇÃO

    Você não deve alterar nada no caminho /libs.

    Isso ocorre porque o conteúdo de /libs é substituído na próxima vez que você atualizar sua instância (e pode ser substituído quando você aplicar um hotfix ou pacote de recursos).

    O método recomendado para configuração e outras alterações é:

    1. Recrie o item necessário, como ele existe em /libs, em /apps. Nesse caso, de:
    2. /libs/cq/gui/content/common/options/predicates
    3. Faça quaisquer alterações em /apps.
  2. Abra o console Pesquisar Forms e selecione a configuração que deseja atualizar. Por exemplo, Painel de pesquisa do administrador de sites.

    Em seguida, clique/toque no ícone Editar formulários de pesquisa.

  3. Dependendo da configuração, adicione Options ou Options Property à configuração.

  4. Atualizar os campos, em particular:

    • Nome da Propriedade

      Específico da propriedade do nó a ser pesquisado nos nós de destino. Por exemplo:

      jcr:content/cq:template

    • Caminho do nó da opção

      Selecione o caminho onde suas opções são mantidas. Por exemplo:

      /apps/cq/gui/content/common/options/predicates/templatetype
      chlimage_1-380

  5. Selecione Concluído para salvar sua configuração.

  6. Navegue até o console apropriado (neste exemplo, Sites) e abra o painel Pesquisar. Os formulários de pesquisa recém-definidos, juntamente com as várias opções, estarão visíveis. Selecione a opção necessária para ver os resultados da pesquisa:

    chlimage_1-381

Permissões de usuário

A tabela a seguir lista as permissões necessárias para executar ações de edição, exclusão e visualização em formulários de pesquisa.

Ação Permissões
Editar Permissões de leitura e gravação no nó /apps .
Excluir Permissões de Leitura, Gravação e Exclusão no nó /apps
Visualizar Permissões de Leitura, Gravação e Exclusão no nó /var/dam/content.
Permissões de leitura e gravação no /apps nó .

Nesta página

Adobe Summit Banner

A virtual event April 27-28.

Expand your skills and get inspired.

Register for free
Adobe Summit Banner

A virtual event April 27-28.

Expand your skills and get inspired.

Register for free
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