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.

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:

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:

   

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:

   

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.

   

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.

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:

   

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

   

   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
     

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:

   

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.