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 Dynamic Media Classic 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, Operações, 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-376

  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-376

  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