Definir uma fonte de pesquisa

  • Versão de lançamento: Washingtondc
  • Atualizado 10 de jan. de 2026
  • 4 min. de leitura

    • Configure uma origem de pesquisa básica para consultar dados de uma tabela de instância ou configure 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. Na lista relacionada Fontes de pesquisa, clique em Novo para adicionar uma fonte de pesquisa.
    3. Defina os campos no formulário de origem de pesquisa.
      Tabela 1. Formulário de origem de 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 fonte de pesquisa.
      Funções Se o plug-in Suporte aos critérios do usuário do Portal de serviços não estiver habilitado, defina as funções do usuário para acessar essa origem de pesquisa.
      Modelo de página de pesquisa

      O modelo HTML que exibe os resultados da pesquisa. Se estiver definindo uma fonte 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 origem de pesquisa de base de conhecimento externa.
    4. Preencha os campos na guia Fonte de dados.
      Campo Descrição
      É fonte com script Adiciona um script de busca de dados avançada. Se estiver configurando uma tabela de instância como 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 É fonte de script é selecionado.

      Para obter um exemplo de um script de busca de dados, consulte Tutorial: configurar uma origem 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 É fonte de 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 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 a serem exibidos 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 de script for selecionado, o valor será atualizado para falso. Para habilitar a paginação para uma origem de pesquisa com script, consulte Paginar resultados da origem da pesquisa.

      Defina o número máximo de resultados por consulta para a origem de pesquisa no widget Página de pesquisa ou nas opções de instância do widget Pesquisa de aspectos.
    5. Defina as configurações de Digitação antecipada 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 de digitação antecipada. Se você não quiser integrar a digitação antecipada à sua fonte de pesquisa, desmarque a caixa de seleção.
      Configuração autocompletável avançada Opcionalmente, adicione um script de digitação antecipada avançado para configurar a maneira como os resultados da pesquisa são exibidos. Para obter mais informações, consulte Criar um modelo de digitação antecipada avançado.
      Glifo autocompletável Adiciona um ícone ao lado de cada resultado de digitação antecipada.
      Página Define uma página do portal de serviços para exibir o resultado selecionado. Por exemplo, se o formulário estiver configurado, um resultado de digitação antecipada selecionado será aberto em um formulário.

      Exemplo de configurações da guia Digitação antecipada. O campo Página está definido como formulário.

    6. Clique em Enviar.

    O que Fazer Depois

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