Configuração de formulários de pesquisa configuring-search-forms

CAUTION
AEM 6.4 chegou ao fim do suporte estendido e esta documentação não é mais atualizada. Para obter mais detalhes, consulte nossa períodos de assistência técnica. Encontre as versões compatíveis here.

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.

A gama de predicadoss estão disponíveis 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 usado em vários consoles e no navegador de ativos (ao editar páginas). O caixas de diálogo para configurar esses formulários pode ser acessado via:

  • 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. Depois de personalizar a configuração, o bloqueio desaparecerá, a menos que você excluir sua configuração personalizada, nesse caso, o padrão (e o indicador de cadeado) será reinstalado.

chlimage_1-374

Configurações configurations

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 (Dynamic Media Classic) [anteriormente Scene7] search):

    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 predicates-and-their-settings

Predicados predicates

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
Opções Propriedade
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.
nenhuma
Publicar status
Pesquisar ativos com base em seu status de publicação
  • Rótulo do campo
  • Nome da Propriedade*
  • Descrição
Intervalo
Pesquise os 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
Avaliação
Pesquisar 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
NOTE
  • 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 predicate-settings

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 curingas */*/* especifique a profundidade da propriedade em relação à variável 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 o x na jcr:content uso do nó */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 na variável Intervalo de datas predicado.

  • 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 + é usado para adicionar a seleção à lista de opções válidas (em seguida, o ícone - í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))

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

  • Seleção única
    Se 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 Propriedade
    Os rótulos das caixas de seleção publicar e live copy para o predicado específico Sites.

  • O &último; nos rótulos de campo na Configurações guia significa que os campos são obrigatórios e, se deixado em branco, uma mensagem de erro será exibida

Configurar sua Forms de pesquisa configuring-your-search-forms

Criando/Abrindo uma Configuração Personalizada creating-opening-a-customized-configuration

  1. Navegar para Ferramentas, Operações, Pesquisar Forms.

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

  3. Use o Editar ícone 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. Selecionar Concluído para salvar a configuração.

    note note
    NOTE
    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 add-edit-a-predicate-field-and-define-field-settings

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 o Selecionar predicado e arraste o predicado necessário para o local desejado. Por exemplo, a variável Predicado de intervalo de datas:

    chlimage_1-375

  3. Dependendo de:

    • Você está adicionando um novo campo:

      Após adicionar o predicado Configurações será aberta e mostrará as propriedades que podem ser definidas.

    • Você deseja atualizar um predicado existente:

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

    chlimage_1-376

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

Visualização da configuração de pesquisa previewing-the-search-configuration

  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. Fechar a pré-visualização para retornar e concluir a configuração.

Excluindo um campo de predicado deleting-a-predicate-field

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

  2. Selecione o campo predicado (à direita) e abra o Configurações e selecione a Excluir ícone (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 Concluído.

Excluindo uma configuração (para restabelecer o padrão) deleting-a-configuration-to-reinstate-the-default

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.

NOTE
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 depois a variável 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 adding-options-predicates

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

    note note
    NOTE
    Você must não altere nada no /libs caminho.
    Isso ocorre porque o conteúdo da variável /libs O é 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, sob /apps. Nesse caso, de:
    2. /libs/cq/gui/content/common/options/predicates
    3. Faça quaisquer alterações no /apps.
  2. Abra o Pesquisar Forms e selecione a configuração que deseja atualizar. Por exemplo, Painel de pesquisa do administrador de sites.

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

  3. Dependendo da configuração, adicione uma Opções ou Propriedade Opções à 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. Selecionar Concluído para salvar sua configuração.

  6. Navegue até o console apropriado (neste exemplo, Sites) e abra o Pesquisar trilho. 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 user-permissions

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 /apps nó .
Excluir
Permissões de Leitura, Gravação e Exclusão no /apps
Visualizar
Permissões de Leitura, Gravação e Exclusão no /var/dam/content nó .
Permissões de leitura e gravação no /apps nó .
recommendation-more-help
5ce3024a-cbea-458b-8b2f-f9b8dda516e8