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

Use a Forms de Pesquisa 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 de criação. A personalização desses painéis torna a funcionalidade de pesquisa versátil, de acordo com suas necessidades específicas.

Um intervalo do predicados está disponível e pronto para uso. Você pode adicionar vários predicados, incluindo (entre outros) o predicado Propriedade, para pesquisar ativos que correspondam a uma única propriedade especificada por você. Ou, no predicado Opções, para pesquisar ativos que correspondem 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 via:

  • Ferramentas

    • Geral

      • Pesquisar Forms

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) é restabelecido.

Janela de formulários de pesquisa

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 um 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 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 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 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 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 pesquisar produtos no navegador de ativos (ao editar uma página).

  • Editor de páginas (Dynamic Media Classic [pesquisa anterior 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).

  • Painel 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áginas (Pesquisa de vídeos):

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

  • Painel de Pesquisa do Administrador do Assets:

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

  • 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 de Coleções de Produtos:

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

  • 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 comerciais.

  • Painel 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 do Sites ao mostrar dados alimentados por análise. 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 com um componente específico. Por exemplo, uma galeria de imagens.
  • Rótulo do campo
  • Espaço reservado
  • Nome da propriedade*
  • Profundidade da propriedade
  • Descrição
Data
Pesquisa deslizante de ativos 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, você pode 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
Pesquise 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 de propriedade
  • Valor de propriedade
  • Descrição
Opções

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

Consulte Adicionando um Predicado de Opções para obter mais informações.

  • Rótulo do campo
  • Caminho JSON
  • Nome da propriedade*
  • Seleção única
  • Caminho de opção
  • Descrição
Propriedade de opções
Pesquise em uma propriedade da opção.
  • Rótulo do campo
  • Nome da propriedade*
  • Caminho do nó de opções
  • Seleção única
  • Descrição
Status da página
Pesquisar 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
Pesquisar em uma propriedade especificada.
nenhum
Publicar status
Pesquisar ativos com base no status de publicação
  • Rótulo do campo
  • Nome da propriedade*
  • Descrição
Intervalo
Pesquisar 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 de propriedade
  • Descrição
Opções de intervalo
Um predicado de pesquisa específico para o Assets e o mesmo que o Predicado de controle deslizante comum. O 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
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 de 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
Pesquise 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 só estão disponíveis para compatibilidade com versões anteriores.
Essas informações são somente para referência. Não alterar /libs.

Configurações de 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 aparece como o cabeçalho recolhível ou como o rótulo do campo do predicado.

  • Descrição

    Detalhes descritivos do usuário.

  • Espaço reservado

    Texto vazio ou o marcador de posição 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ê deseja pesquisar apenas em um nó filho de primeiro nível do recurso que tem a propriedade x no nó jcr:content, use */jcr:content/x

  • Profundidade da propriedade

    A profundidade máxima para pesquisar essa propriedade nos recursos. Assim, 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 cadeia absoluta ou 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 da opção

    O usuário pode selecionar o caminho usando o Navegador de caminho na guia de configuração do predicado. Após selecionar +, o ícone é usado para adicionar a seleção à lista de opções válidas (em seguida, o ícone - a ser 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))

  • Caminho do nó de opções
    Efetivamente igual ao Caminho de opções, somente isso está no campo de predicado comum, o outro é específico para ativos.

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

  • Nomes de propriedades do Publish e da Live Copy
    Os rótulos das caixas de seleção Publicar e Live Copy para o predicado específico do Sites.

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

Configuração do Forms de pesquisa configuring-your-search-forms

Criação/abertura de uma configuração personalizada creating-opening-a-customized-configuration

  1. Navegue até Ferramentas >> Geral >> 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 for feita uma nova personalização, você provavelmente vai 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.

    note note
    NOTE
    As configurações personalizadas são armazenadas (conforme apropriado) em:
    • /apps/cq/gui/content/facets/<option>
    • /apps/commerce/gui/content/facets/<option>

Adicionar/editar um campo de predicado e definir configurações de campo add-edit-a-predicate-field-and-define-field-settings

É possível adicionar ou editar campos e definir/atualizar suas configurações:

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

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

    Editando um formulário de pesquisa

  3. Dependendo se:

    • Você está adicionando um campo:

      Depois de adicionar o predicado, a guia Configurações é aberta e mostra as propriedades que podem ser definidas.

    • Você deseja atualizar um predicado existente:

      Selecione o campo de predicado (à direita) e abra a guia Configurações.

    Por exemplo, as configurações para o Predicado do intervalo de datas:

    Propriedades do 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 previewing-the-search-configuration

  1. Selecione o ícone Visualizar:

    Visualizar formulários de pesquisa

  2. Isso exibe os formulários de pesquisa conforme são mostrados (totalmente expandidos) na coluna Pesquisa do console apropriado.

    Visualizando o formulário de pesquisa

  3. Feche a visualização para que você possa retornar e concluir a configuração.

Exclusão de um campo de predicado deleting-a-predicate-field

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

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

    Ícone Excluir

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

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

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

Depois de personalizar uma configuração, isso substituirá os padrões. Você pode restaurar a configuração padrão excluindo sua 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 o ícone Excluir na barra de ferramentas:

    Excluindo um formulário

  2. A configuração personalizada é excluída e o padrão é restabelecido (isso é indicado pela reaparição do símbolo de cadeado no console).

Adição de 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. Eles são usados para pesquisar algo diretamente na 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 na qual será pesquisada.

    Você precisa de um nó raiz que contenha definições das opções individuais para estar disponível ao usuário.

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

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

    Adicionando opções no CRXDE

    note note
    NOTE
    não altere 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. Fazer alterações em /apps.
  2. Abra o console Forms de Pesquisa e selecione a configuração que deseja atualizar. Por exemplo, Painel de pesquisa do administrador de sites.

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

  3. Dependendo da configuração, adicione uma Propriedade de opções ou Propriedade de opções à configuração.

  4. Atualize os campos, especialmente:

    • Nome da Propriedade

      Específica a propriedade do nó a ser pesquisada nos nós de destino. Por exemplo:

      jcr:content/cq:template

    • Caminho do nó de opção

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

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

    Adicionando caminho de propriedade

  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, ficam visíveis. Selecione a opção necessária para ver os resultados da pesquisa:

    Os resultados finais

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 nó /apps .
Excluir
Permissões de Leitura, Gravação e Exclusão no nó /apps
Visualização
Permissões de leitura, gravação e exclusão no nó /var/dam/content.
permissões de Leitura e Gravação no nó /apps.
recommendation-more-help
19ffd973-7af2-44d0-84b5-d547b0dffee2