Fundamentos da pesquisa search-essentials

Visão geral overview

O recurso de pesquisa é um recurso essencial do AEM Communities. Além do Pesquisa na plataforma AEM , a AEM Communities fornece a variável API de pesquisa UGC para fins de pesquisa de conteúdo gerado pelo usuário (UGC). O UGC tem propriedades exclusivas, pois é inserido e armazenado separadamente de outro conteúdo AEM e dados do usuário.

Para Comunidades, as duas coisas geralmente pesquisadas são:

Esta seção da documentação é de interesse para desenvolvedores que estão criando componentes personalizados que criam ou gerenciam o UGC.

Nós de Segurança e Sombra security-and-shadow-nodes

Para um componente personalizado, é necessário usar o SocialResourceUtilities métodos. Os métodos de utilitário que criam e pesquisam o UGC estabelecerão o nós sombra e verifique se o membro tem as permissões corretas para a solicitação.

O que não é gerenciado por meio dos utilitários SRP são propriedades relacionadas à moderação.

Consulte Princípios básicos de SRP e UGC para obter informações sobre métodos de utilitários usados para acessar nós de sombra UGC e ACL.

API de pesquisa UGC ugc-search-api

O repositório comum UGC é fornecido por um dos vários provedores de recursos de armazenamento (SRPs), cada um com possivelmente uma linguagem de consulta nativa diferente. Portanto, independentemente do SRP escolhido, o código personalizado deve usar métodos do Pacote da API UGC (com.adobe.cq.social.ugc.api) que chamará a linguagem de consulta apropriada para o SRP escolhido.

Pesquisas ASRP asrp-searches

Para ASRP, o UGC é armazenado na nuvem do Adobe. Embora o UGC não esteja visível no CRX, moderação O está disponível nos ambientes do autor e de publicação. O uso da variável API de pesquisa UGC funciona para ASRP da mesma forma que para outros SRPs.

Atualmente, não existem ferramentas para gerenciar pesquisas ASRP.

Ao criar propriedades personalizadas que podem ser pesquisadas, é necessário seguir as requisitos de nomenclatura.

Pesquisas do MSRP msrp-searches

Para MSRP, o UGC é armazenado no MongoDB configurado para usar o Solr para pesquisa. O UGC não estará visível no CRX, mas moderação O está disponível nos ambientes do autor e de publicação.

Relativamente ao MSRP e ao Solr:

Os recursos de pesquisa personalizados devem usar o API de pesquisa UGC.

Ao criar propriedades personalizadas que podem ser pesquisadas, é necessário seguir as requisitos de nomenclatura.

Pesquisas JSRP jsrp-searches

Para JSRP, o UGC é armazenado em Oak e é visível somente no repositório do autor ou da instância de publicação do AEM em que foi inserido.

Como o UGC normalmente é inserido no ambiente de publicação, para sistemas de produção de vários editores, é necessário configurar um cluster de publicação, não um farm de publicação, para que o conteúdo inserido fique visível de todos os editores.

Para JSRP, o UGC inserido no ambiente de publicação nunca estará visível no ambiente do autor. Assim todos moderação As tarefas ocorrem no ambiente de publicação.

Os recursos de pesquisa personalizados devem usar o API de pesquisa UGC.

Indexação do Oak oak-indexing

Embora os índices Oak não sejam criados automaticamente para a pesquisa da plataforma AEM, a partir AEM 6.2 eles foram adicionados ao AEM Communities para melhorar o desempenho e fornecer suporte para paginação ao apresentar resultados de pesquisa UGC.

Se as propriedades personalizadas estiverem em uso e as pesquisas estiverem lentas, será necessário criar índices adicionais para que as propriedades personalizadas sejam mais eficazes. Para manter a portabilidade, siga as requisitos de nomenclatura ao criar propriedades personalizadas que podem ser pesquisadas.

Para modificar índices existentes ou criar índices personalizados, consulte Consultas e indexação do Oak.

O Gerenciador de Índice Oak está disponível em ACS AEM Commons. Ele fornece:

Para visualizar os índices existentes do Oak em CRXDE Lite, o local é:

Propriedades de Pesquisa Indexada indexed-search-properties

Propriedades de pesquisa padrão default-search-properties

Veja a seguir algumas das propriedades pesquisáveis usadas para vários recursos das Comunidades:

Nomenclatura de propriedades personalizadas naming-of-custom-properties

Ao adicionar propriedades personalizadas, para que essas propriedades fiquem visíveis, as classificações e pesquisas criadas com o API de pesquisa UGC, é *obrigatório *para adicionar um sufixo ao nome da propriedade.

O sufixo é para idiomas de consulta que usam um schema:

Solr é um exemplo de linguagem de consulta que usa um schema .

Notas:

Filtros filters

Componentes que incluem o sistema de comentários suporta a adição do parâmetro de filtro aos endpoints.

A sintaxe do filtro para a lógica E e OU é expressa da seguinte maneira (mostrada antes de ser codificada no URL):

A implementação padrão do Componente de pesquisa O usa essa sintaxe como pode ser visto no URL que abre a página Resultados da pesquisa no Guia de componentes da comunidade. Para experimentar, procure por http://localhost:4503/content/community-components/en/search.html.

Os operadores de filtro são:

É importante que o URL faça referência ao componente Comunidades (recurso) e não à página na qual o componente é colocado:

Ferramentas SRP srp-tools

Há um projeto do Adobe Marketing Cloud GitHub que contém:

Ferramentas SRP da AEM Communities

Esse repositório contém ferramentas para gerenciar dados no SRP.

Atualmente, há um servlet que fornece a capacidade de excluir todo o UGC de qualquer SRP.

Por exemplo, para excluir todos os UGC no ASRP:

curl -X POST http://localhost:4502/services/social/srp/cleanup?path=/content/usergenerated/asi/cloud -uadmin:admin

Resolução de problemas troubleshooting

Consulta Solr solr-query

Para ajudar a solucionar problemas com uma consulta Solr, habilite o log DEBUG para

com.adobe.cq.social.srp.impl.SocialSolrConnector.

A consulta Solr real será exibida com o URL codificado no log de depuração:

A consulta para solr é: sort=timestamp+desc&bl=en&pl=en&start=0&rows=10 &q=%2Btitle_t:(hello)+%2Bprovider_id:\/content/usergenerated/asi/mongo/content/+%2Bresource_type_s:&df=provider_id&trf=verbatim&fq={!cost%3D100}report_suite:mongo

O valor da variável q é a consulta. Depois que a codificação do URL é decodificada, o query pode ser transmitido à ferramenta Solr Admin Query para depuração adicional.

Recursos relacionados related-resources