Configurar busca geral
Pré-requisito
- Acesso ao menu Configuração > Busca geral (CM032).
Apresentação
O SoftExpert Configuração disponibiliza um menu que permite aos administradores do sistema um maior controle sobre o comportamento da busca geral do SoftExpert Suite.
Obtenha mais detalhes sobre o uso da busca geral clicando aqui.
Entenda como a tela está dividida:
A - Na aba Status, é possível verificar a disponibilidade do serviço de busca, assim como informações sobre as indexações realizadas: quantos registros e arquivos foram indexados e o relatório das últimas indexações.
Estão disponíveis as opções que permitem acionar manualmente o processo de indexação, mas que somente devem ser usadas em casos extremos e mediante orientação da SoftExpert.
B - Na aba Relevâncias, é possível aumentar ou diminuir a relevância dada a cada um dos critérios levados em consideração na busca geral. Para isso, utilize o controle deslizante e ajuste-o para definir o valor desejado, ou preencha o campo disponível ao lado do controle.
Ao realizar configurações nesta aba, deve-se levar em conta que estas irão impactar na busca geral de todos os usuários do SoftExpert Suite.
C - Na aba Atributos para filtro, é possível configurar uma lista de atributos que estarão disponíveis como filtros para refinamento da busca. Ao realizar uma pesquisa na Busca geral, eles aparecerão em um painel lateral, no agrupador Atributos.
D - Na aba Sinônimos, é possível criar grupos de sinônimos que serão utilizados para refinar as buscas ao realizar uma pesquisa na Busca geral.
E - Clique no botão Salvar configurações para que as edições realizadas neste menu sejam aplicadas à busca geral.
Confira mais detalhes sobre cada uma das abas disponíveis:
Status
Serviço de busca
O Serviço de busca apresenta diferentes cores e mensagens conforme a saúde da engine de buscas. Veja abaixo as possíveis situações relacionados à saúde da engine:
| Status | Informação |
| GREEN | Indica que tanto o Elasticsearch quanto o Atlas estão funcionando e não há problemas com o índice. Porém, não indica necessariamente que o ambiente está totalmente indexado. |
| RED | Indica que o Atlas não está conseguindo se conectar com o Elasticsearch. Pode haver algum problema de configuração ou indisponibilidade do Elasticsearch. |
| YELLOW | Indica que existem réplicas configuradas para o Elasticsearch, porém estas não estão alocadas corretamente em seus nós. O serviço do Elasticsearch exibe este estado quando uma shard de réplica está no mesmo nó que a shard principal. |
| CHECK_ERROR | Indica que o SoftExpert Suite não está conseguindo se comunicar com o serviço do Atlas. Pode haver alguma configuração errada ou indisponibilidade do Atlas. |
Em um ambiente on-premise e com o Elasticsearch gerenciado pelo Suite (automanaged), é possível realizar ações como Reiniciar e configurar a memória do Elasticsearch. Esta opção também é válida para subir novamente o serviço de busca caso ele não esteja respondendo.
Indexação
Para que serve?
Para que o Elasticsearch opere corretamente, ele precisa que seus índices estejam criados. Com o processo de indexação, a engine realiza a indexação de todos os arquivos dentro de seu escopo, criando assim os índices.
Quanto tempo pode levar?
A duração da indexação esta diretamente ligada à quantidade de registros e arquivos a serem indexados; em alguns casos, pode levar dias para ser realizada.
Quais extensões de arquivos são indexadas?
Somente as extensões txt, doc, docx, xls, xlsx, pdf, eml, odt, ods, ppt, pptx, xml, rtf e odp podem ser indexadas.
Qual o tamanho máximo dos arquivos indexados?
O tamanho limite de um único arquivo a ser indexado é 30 MB.
Relevâncias
Valores de relevância padrão
| Campo | Valor padrão |
| Identificador | 30 |
| Título | 4 |
| Atributos | 2 |
| Nome do arquivo | 1.5 |
| Descrição | 1 |
| Conteúdo do arquivo | 1 |
| Palavra exata | 1 |
Para ajustar o valor dos critérios de relevância, utilize o controle deslizante para definir o valor desejado ou preencha o campo disponível ao lado do controle. É possível definir um valor de 0 a 50.
O menu fornece um botão que permite restaurar os valores padrão do SoftExpert Suite.
Como funciona a relevância?
A ordenação dos resultados pelo Elasticsearch é obtida por meio de um score de similaridade via algoritmo Okapi BM25. Neste algoritmo, os seguintes fatores são levados em consideração para calcular o score:
- Frequência do termo pesquisado em cada um dos campos indexados.
- Tamanho de cada campo indexado que contém o termo.
- Quantidade de documentos que possuem o termo.
É realizado então um cálculo matemático que une esses três fatores. Por exemplo, um documento que contém duas vezes o termo "caçamba" e possui um tamanho apenas de 1.000 palavras é mais relevante que outro documento que possui três vezes o termo "caçamba", porém tem 10.000 palavras.
Isso porque, em um texto com menor volume de caracteres, o tamanho do documento pode acabar sendo mais relevante que a frequência. Obviamente, se a frequência de termos aumentar, a análise será reconsiderada, pois é uma somatória dos três fatores.
Porém, se um texto possuir uma grande frequência de uma palavra, principalmente em se tratando de um texto menor, a relevância do termo será menor para esse documento, pois o algoritmo considera esse como um "termo comum" para aquele documento.
Além disso, após obter o score do algoritmo, este é multiplicado pelo valor do campo previamente definido nas relevâncias.
Por isso, é importante verificar se há atributos que contêm o termo no documento pesquisado, uma vez que estes também incrementarão o score da busca.
Atributos para filtro
Nesta aba, é possível configurar uma lista de até 10 atributos que estarão disponíveis como filtros para refinamento da busca. Estes atributos permitem que o usuário consiga aumentar o número de filtros laterais exibidos.
Ao realizar uma pesquisa na Busca geral, eles aparecerão no painel lateral esquerdo, na seção Atributos.
Os atributos que podem ser selecionados são os mesmo que podem ser preenchidos ao cadastrar um documento, por exemplo.
Sinônimos
Nesta aba, é possível criar grupos de sinônimos que serão utilizados ao realizar uma pesquisa na Busca geral.
Ao cadastrar um grupo de sinônimos, será possível informar ao sistema de busca que todas as palavras presentes no grupo possuem o mesmo significado. Isso possibilitará que as pesquisas realizadas dentro do SoftExpert Suite tragam resultados personalizados conforme a necessidade da empresa.
Por exemplo, se for criado um grupo de sinônimos contendo as palavras "Colaborador", "Funcionário" e "Usuário", sempre que for realizada uma pesquisa por "Colaborador", irão retornar também os registros que contenham as palavras "Funcionário" e "Usuário".
Para incluir um grupo de sinônimos, siga os seguintes passos:
1. Acesse a aba Sinônimos.
2. Clique no botão Incluir.
3. Informe o Nome do grupo.
4. Insira o Sinônimo desejado e clique no botão Incluir. Repita o processo até incluir todos os sinônimos do grupo.
5. Clique no botão Salvar.
Conclusão
Pronto! Agora você já sabe controlar o comportamento da busca geral do sistema.