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.
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:
-
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.
/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
-
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 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.
-
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:
-
Abra a configuração personalizada para atualização.
-
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:
-
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:
-
-
Faça as alterações necessárias e confirme com Concluído.
Pré-visualização da configuração de pesquisa previewing-the-search-configuration
-
Selecione o ícone Visualizar:
-
Isso exibe os formulários de pesquisa conforme são mostrados (totalmente expandidos) na coluna Pesquisa do console apropriado.
-
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
-
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 solicita 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, isso substituirá os padrões. Você pode restaurar a configuração padrão excluindo sua configuração personalizada.
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. 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 pesquisavalue
- o valor da propriedade a ser pesquisada
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 é: - 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, clique no ícone Editar formulários de pesquisa.
-
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. 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:
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.