Defina uma origem de pesquisa

Configure uma fonte de pesquisa básica para consultar dados de uma tabela de instância ou configurar um script de busca de dados avançada para consultar dados em várias tabelas e fontes de dados ou para extrair dados de qualquer lugar na Web.

Antes de Iniciar

Função necessária: administrador

Procedimento

1. Na IU da plataforma, navegue até Portal de serviços > Portais e selecione o portal ao qual você deseja adicionar fontes de pesquisa.
2. Em Fontes de pesquisa lista relacionada, clique em Novo para adicionar uma fonte de pesquisa.
3. Defina os campos no Origem da pesquisa formulário.

   Tabela 1. Formulário Origem da pesquisa

   Campo	Descrição
   Nome	O valor de exibição da categoria de pesquisa.
   ID	O ID do registro. O valor deve ser exclusivo e não deve incluir espaços ou caracteres especiais.
   Aplicação	O escopo da origem de pesquisa.
   Funções	Se o plug-in Suporte a critérios do usuário do Portal de serviços não estiver habilitado, defina as funções do usuário para acessar esta fonte de pesquisa.
   Modelo de página de pesquisa	O modelo HTML que exibe os resultados da pesquisa. Se estiver definindo uma origem de pesquisa básica, você não precisará mudar o modelo padrão. Para obter um exemplo de um modelo modificado, consulte Tutorial: Configurar uma fonte de pesquisa de base de conhecimento externa.

4. Preencha os campos no Fonte de dados guia.

   Campo	Descrição
   É fonte com script	Adiciona um script avançado de busca de dados. Se estiver configurando uma tabela de instância como a fonte de dados, não marque esta opção.
   Script de obtenção de dados	Script que define o endpoint e as chamadas de API para buscar dados. Este campo só fica visível quando Origem com script selecionado. Para obter um exemplo de script de busca de dados, consulte Tutorial: Configurar uma fonte de pesquisa de base de conhecimento externa. Nota: Se estiver definindo um script de geração de aspecto, injete o objeto de aspecto no script de obtenção de dados e atualize o script para gerar dados para cada item de aspecto. Para obter um exemplo, consulte as origens de pesquisa da Base de conhecimento e do Catálogo de serviços. Os aspectos de pesquisa podem não se comportar como esperado se integrados a uma fonte de pesquisa avançada que consulta dados de um site que não seja ServiceNow.
   Script de geração de aspecto	Script que define aspectos de pesquisa para uma origem de pesquisa com script. Permita que os usuários finais filtrem os resultados da pesquisa para obter um conjunto de resultados mais significativo.Este campo só fica visível quando Origem com script selecionado. Nota: Se estiver definindo um script de geração de aspecto, injete o objeto de aspecto no script de obtenção de dados e atualize o script para gerar dados para cada item de aspecto. Para obter um exemplo, consulte as origens de pesquisa da Base de conhecimento e do Catálogo de serviços. Os aspectos de pesquisa podem não se comportar como esperado se integrados a uma fonte de pesquisa avançada que consulta dados de um site que não seja ServiceNow.
   Tabela	Selecione uma tabela na lista da qual você deseja extrair seus resultados. Você pode selecionar qualquer tabela na plataforma. Por exemplo, Usuário [sys_user] ou Conhecimento [kb_knowledge]. Nota: Somente tabelas indexadas retornam resultados de pesquisa. Saiba mais: Configure a table for indexing and searching.
   Condições	Filtra os resultados com base em condições definidas. Por exemplo, Ativo é verdadeiro.
   Campo de exibição primário	Selecione qual campo você deseja exibir na página de resultados da pesquisa. Por exemplo, Nome.
   Campos de exibição	Selecione campos adicionais para exibir na página de resultados da pesquisa. Por exemplo, ID do usuário, E-mail e Cidade.
   Paginar resultados	Pagina os resultados da pesquisa. Verdadeiro por padrão. Se Origem com script estiver selecionado, o valor será atualizado para falso. Para habilitar a paginação para uma origem de pesquisa com script, consulte Paginar resultados da fonte de pesquisa. Defina o número máximo de resultados por consulta para a origem de pesquisa nas opções de instância do widget Página de pesquisa ou do widget de pesquisa facetada.

5. Configurar Autocompletação configurações para permitir que os resultados da pesquisa preencham o campo de pesquisa com base na entrada do usuário.

   Campo	Descrição
   Habilitar autocompletável	Permite a funcionalidade autocompletável. Se você não quiser integrar digitação antecipada em sua fonte de pesquisa, desmarque a caixa de seleção.
   Configuração autocompletável avançada	Opcionalmente, adicione um script autocompletável avançado para configurar a forma como os resultados da pesquisa são exibidos. Para obter mais informações, consulte Crie um modelo autocompletável avançado.
   Glifo autocompletável	Adiciona um ícone ao lado de cada resultado autocompletável.
   Página	Define uma página do portal de serviços para exibir o resultado selecionado. Por exemplo, se formulário se estiver configurado, um resultado de digitação antecipada selecionado será aberto em um formulário.

   

6. Clique em Enviar.

O que Fazer Depois

Para permitir que os usuários finais refinem os resultados da pesquisa, Adicione aspectos a uma origem de pesquisa simples.

• Paginar resultados da fonte de pesquisa
  Limite o número de resultados que uma origem de pesquisa exibe de uma só vez para melhorar o desempenho. Os usuários finais podem carregar mais resultados conforme necessário.
• Crie um modelo autocompletável avançado
  Configure a forma como os resultados de digitação antecipada são exibidos com um modelo avançado.
• Tutorial: Configurar uma fonte de pesquisa de base de conhecimento externa
  Defina uma fonte de pesquisa avançada para retornar dados de qualquer fonte na Internet. Para entender o poder das fontes de pesquisa, siga este tutorial para configurar uma fonte de pesquisa de base de conhecimento externa.
• Exemplo: Configure uma fonte de pesquisa do GitHub
  Configure uma fonte de pesquisa avançada que consulta dados de um site externo.