Documentação AEM as a Cloud Service Guia do usuário

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

Last update: Mon Jul 15 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

Tópicos:
Desenvolvimento

Criado para:

Administrador
Desenvolvedor

O Adobe Experience Manager as a Cloud Service vem com um poderoso mecanismo de Pesquisa.

Em combinação com isso, também há um conjunto de opções predefinidas para ajudar você a filtrar seu conteúdo. Essas facetas predefinidas como Data de Modificação, Status do Publish ou Status da Live Copy são mantidas para ajudá-lo a detalhar rapidamente os recursos necessários.

uso de pesquisa e filtro

Juntos, eles têm como objetivo ajudá-lo a localizar seu conteúdo de forma rápida e fácil a partir de:

NOTE

Você pode configurar o serviço Pesquisa e indexação de conteúdo subjacente.

Com o Search Forms, você pode personalizar e estender esses painéis, de acordo com suas necessidades específicas.

O Forms de Pesquisa fornece uma seleção predefinida de predicados que você pode combinar e definir. As caixas de diálogo para configurar estes formulários podem ser acessadas via:

Ferramentas
- Geral
  - Pesquisar Forms

Forms padrão default-forms

Ao acessar o console Forms de Pesquisa pela primeira vez, você pode ver que todas as configurações têm um símbolo de cadeado. Isso indica que a configuração correspondente é a configuração padrão (pronta para uso) e não pode ser excluída. Depois de personalizar e salvar, uma configuração do bloqueio desaparecerá. Ele reaparecerá quando você excluir sua configuração personalizada. Nesse caso, o padrão (e o indicador de cadeado) será reinstalado.

configurando a visão geral dos formulários de pesquisa

As configurações padrão (listadas alfabeticamente) disponíveis são:

Painel de pesquisa do administrador do Assets
Editor de páginas (Pesquisa de documentos)
Editor de páginas (Pesquisa de Fragmentos de Experiência)
Editor de páginas (Pesquisa de imagens)
Editor de páginas (Pesquisa de manuscrito)
Editor de páginas (Pesquisa de páginas)
Editor de páginas (Pesquisa de parágrafos)
Editor de páginas (Pesquisa de produtos)
Editor de páginas (pesquisa no Scene7)
Editor de páginas (Pesquisa de vídeos)
Trilho de pesquisa do administrador de projetos
Trilho de pesquisa da tradução do projeto
Painel de pesquisa do administrador de sites
Trilho de pesquisa do administrador de trechos
Painel de pesquisa do administrador do Stock
Painel de Pesquisa de Modelos de Fragmento do Conteúdo
Trilho de pesquisa do administrador de projetos
Trilho de pesquisa da tradução do projeto

NOTE

Para obter mais detalhes sobre os formulários de pesquisa relacionados ao ativo, consulte Assets - Pesquisar aspectos.

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

Status de aprovação

Pesquisar de acordo com o status de aprovação.

Rótulo do campo
Nome da propriedade*
Descrição

Autor

Pesquisar de acordo com o autor.

Espaço reservado
Nome da propriedade*
Descrição

Retirado por

Procurar ativos verificados por um usuário específico.

Rótulo do campo
Espaço reservado
Descrição

Status da retirada

Pesquisar ativos com um status de check-out específico.

Rótulo do campo
Nome da propriedade*
Descrição

Componentes

Permite que um autor pesquise/filtre por páginas com um componente específico. Por exemplo, uma galeria de imagens.

Espaço reservado
Nome da propriedade*
Profundidade da propriedade
Descrição

Intervalo de datas

Procure recursos 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 recursos com base no status de expiração.

Rótulo do campo
Nome da propriedade*
Descrição

Tamanho do arquivo

Filtrar recursos com base em seu tamanho.

Rótulo do campo
Nome da propriedade*
Caminho de opção
Descrição

Tipo de arquivo

Pesquise ativos com base no tipo de arquivo/mime.

Rótulo do campo
Nome da propriedade*
Caminho Mimetype
Descrição

Texto completo

Predicado de pesquisa para pesquisas de texto completo. Ele é mapeado com o operador "jcr:contains".

Espaço reservado
Nome de propriedade
Descrição

Grupo

Predicado de pesquisa para grupo (usado somente dentro do Predicado do Insights).

Rótulo do campo
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

Insights

Pesquise de acordo com uma seleção de parâmetros de Insights.

Este é um predicado complexo composto de vários predicados:

Grupo
Intervalo
Opções

Membro de coleção

Pesquisar ativos que sejam membros de uma coleção

Descrição

Propriedade de valores múltiplos

Pesquisar em vários valores de uma propriedade especificada.

Rótulo do campo
Espaço reservado
Nome da propriedade*
Suporte do delimitador
Delimitadores de entrada
Ignorar diferença entre maiúsculas e minúsculas
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
Nome da propriedade*
Seleção única
Adicionar opções
Manual
Descrição

Propriedade de opções

Pesquise em uma ou mais propriedades da opção.

Rótulo do campo
Nome da propriedade*
Caminho do nó de opções
Profundidade da propriedade
Seleção única
Descrição

Status da página

Filtrar páginas de acordo com seu status.

Rótulo do campo
Nome de propriedade do Publish*
Nome de propriedade das páginas bloqueadas*
Descrição

Caminho

Filtrar de acordo com o caminho específico. Você pode especificar vários caminhos como opções.

Rótulo do campo
Adicionar caminhos de pesquisa
Descrição

Navegador de caminhos

Forneça um navegador de caminho para pesquisar em um caminho raiz predefinido.

Espaço reservado
Caminho raiz
Descrição

Caminho oculto

Um filtro no caminho, não visível para o usuário.

Nome da propriedade (`path`)
Valor da propriedade (`/content/dam`)

Propriedade

Pesquisar em uma propriedade especificada.

Rótulo do campo
Espaço reservado
Nome de propriedade
Pesquisa parcial
Ignorar diferença entre maiúsculas e minúsculas
Descrição

Publicar status

Filtre recursos 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 da propriedade*
Descrição

Avaliação

Pesquise recursos de acordo com sua classificação média.

Rótulo do campo
Nome da propriedade*
Caminho de opção
Descrição

Data relativa

Filtrar recursos com base na data relativa de sua criação. Por exemplo, 1 semana atrás, 1 mês atrás.

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*
Caminho do nó de opções
Descrição

Status

Pesquisar de acordo com o status de aprovação e check-out.

Este é um predicado complexo composto de vários predicados:

Status de aprovação
Status da retirada

Configurações de predicado predicate-settings

Dependendo do predicado, uma seleção de configurações está disponível para configuração, incluindo:

Rótulo do campo

O rótulo que aparecerá 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 - é 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.
Nome(s) de Propriedade 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

Navegue até Ferramentas, Geral, Pesquisar Forms.
Selecione a configuração que deseja personalizar.
Use o ícone Editar para abrir a configuração para atualização.
Se for feita 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.

Selecione Concluído para salvar a configuração. Suas alterações poderão ser vistas na próxima vez que a configuração for usada.

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:

Abra a configuração personalizada para atualização.
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:
Dependendo se:
- Você está adicionando um novo 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:
Faça as alterações necessárias e confirme com Concluído. Suas alterações poderão ser vistas na próxima vez que a configuração for usada.

Pré-visualização da configuração de pesquisa previewing-the-search-configuration

Selecione o ícone Visualizar:
Exibe os formulários de pesquisa conforme são mostrados (totalmente expandidos) na coluna Pesquisa do console apropriado.
Feche a visualização para retornar e concluir a configuração.

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

Abra a configuração personalizada para atualização.
Selecione o campo de predicado (à direita), abra a guia Configurações e selecione o ícone Excluir (canto inferior esquerdo).
Uma caixa de diálogo solicitará a confirmação da ação de exclusão.
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, ela substituirá os padrões. Você pode restaurar a configuração padrão excluindo sua configuração personalizada.

NOTE

Não é possível excluir as configurações padrão.

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

Selecione a configuração necessária (por exemplo, Editor de páginas (pesquisa de parágrafos)) e o ícone Excluir na barra de ferramentas:
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. Normalmente, 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:

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

Definição de predicado

note note
NOTE
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 ser substituído quando você aplicar um hotfix ou pacote de recursos).
O método recomendado para configuração e outras alterações é:
Recrie o item necessário, como ele existe em `/libs`, em `/apps`. Nesse caso, de: `/libs/cq/gui/content/common/options/predicates` Fazer alterações em `/apps.`

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, selecione Editar.
Dependendo da configuração, adicione uma Propriedade de Opções ou Propriedade de Opções à configuração.
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
Selecione Concluído para salvar sua configuração.
Navegue até o console apropriado (neste exemplo, Sites) e abra o painel Pesquisar - Filtros. 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.