Configuração de formulários de pesquisa

Use Pesquise o Forms para personalizar a seleção de predicados de pesquisa usados nos painéis de pesquisa disponíveis em vários consoles AEM e/ou painéis do ambiente do autor. A personalização desses 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 de Texto completo para pesquisas de texto completo, o predicado de Propriedade para procurar ativos que correspondam a uma única propriedade especificada por você ou o predicado de Opções para pesquisar ativos que correspondam a um ou mais valores especificados por você 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 (out-of-the-box) e não pode ser excluída. Depois de 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 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 (pesquisa do Scene7):

  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:

Prever configurações

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 flexível ou como o rótulo do 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 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 dentro dos recursos. Portanto, uma pesquisa nessa propriedade pode ser executada em um recurso e filhos recursivos até que o nível dos filhos seja igual a 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 de predicado. Depois de selecionar o ícone + é usado para adicionar a seleção à lista de opções válidas (em seguida, o ícone - para remover, 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 de opções, somente este está no campo predicado comum comum, o outro é específico para ativos.

• Seleção únicaSe
  marcada, as opções são renderizadas como caixas de seleção que permitem apenas uma seleção. Se estiver selecionado por engano, uma caixa de seleção pode ser desmarcada.

• Nome(s) de propriedade de publicação e Live Copy
  Os rótulos das caixas de seleção de publicação 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 deixados em branco, uma mensagem de erro será exibida

Configurando 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 Editar 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 uma personalização existente você pode selecionar um campo existente e atualizar as configurações.

5. Selecione Done 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 previsto 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 de intervalo de datas:

   

3. Dependendo de:

   • Você está adicionando um novo campo:

     Depois de adicionar o predicado, a guia Settings abrirá e mostrará as propriedades que podem ser definidas.

   • Você deseja atualizar um predicado existente:

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

   

4. Faça as alterações necessárias e confirme com Done.

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

1. Selecione o ícone de Pré-visualização:

   

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

   

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

Excluindo um Campo Predicado

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

2. Selecione o campo predicado (à direita), abra a guia Configurações e selecione o ícone Excluir (canto inferior esquerdo).

   

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

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

Depois de personalizar uma configuração, isso substituirá os padrões. É possível reinstalar a configuração padrão excluindo a configuração personalizada.

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

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

   

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

Adicionar opções prevê

Os predicados de opção (Opções, Propriedade de opções) permitem que você configure 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 as 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 mostrado no painel de pesquisa
   • value - o valor da propriedade a ser pesquisada

   

   OBSERVAÇÃO

   Você deve não 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 muito bem ser substituído quando você aplicar uma correção ou um 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. Neste caso a partir 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 do 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. Atualize os campos, em especial:

   • Nome da Propriedade

     Específico da propriedade node a ser pesquisada nos nós do público alvo. Por exemplo:

     jcr:content/cq:template

   • Caminho do nó de opção

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

     /apps/cq/gui/content/common/options/predicates/templatetype
     

5. Selecione Done 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 pré-visualização em formulários de pesquisa.