Criar um REST ( IntegrationHub fonte de dados do tipo )

  • Versão de lançamento: Zurich
  • Atualizado 31 de jul. de 2025
  • 3 min. de leitura
  • Crie um REST (IntegrationHub) Digite registro de fonte de dados para definir quais dados um conjunto de importação deve importar de uma REST API.

    Antes de Iniciar

    Funções necessárias: Import_admin e action_designer

    Procedimento

    1. Navegar até Tudo > Conjuntos para importação do sistema > Administração > Fontes de dados.
    2. Clique em Nova.
    3. Preencha o formulário.
      Campo Descrição
      Nome Um nome exclusivo para esta fonte de dados.
      Rótulo da tabela de conjunto de importação Um rótulo para a tabela de preparação do conjunto de importação usar.
      Nome da tabela de conjunto de importação . ServiceNow AI Platform usa o rótulo inserido para criar um nome de tabela exclusivo. Isso evita a colisão de namespace com uma tabela já existente.
      Tipo REST (IntegrationHub) .
      Formato Um dos seguintes formatos: Personalizado (analisar por script), JSON ou XML.
      Usar importação em lote Se selecionado, especifica que os dados de carregamento devem ser colocados em lote quando você clicar em Carregar dados ou Carregar 20 registros .
      Tamanho do Lote Especifica o tamanho dos lotes. Aparece somente quando Importação em lote o campo está selecionado.
      . glide.import_set_load_usebatche. glide.import_set_load_batch_sizeas propriedades afetam esses campos. A ordem de prioridade das propriedades e dos campos é a seguinte: Se a propriedade estiver definida, use o valor da propriedade. Caso contrário, use o valor do campo. Se nenhuma propriedade estiver definida, use o tamanho de lote padrão de 1000.
      • Por exemplo, se glide.import_set_load_usebatch. verdadeiro e. glide.import_set_load_batch_size. 200 , use 200 como o tamanho do lote, independentemente dos valores do campo.
      • Por exemplo, se glide.import_set_load_usebatch. verdadeiro e o. glide.import_set_load_batch_sizea propriedade não está definida, use o tamanho de lote padrão de 1000.
      • Por exemplo, se o glide.import_set_load_usebatcha propriedade não está definida e Importação em lote campo verdadeiro , use Tamanho do lote valor do campo (ou o padrão de 1000 se Tamanho do lote o valor do campo não está definido)
      • Por exemplo, se o glide.import_set_load_usebatchfalso e Importação em lote verdadeiro, não use importação em lote, pois a propriedade está definida como falsa.
      Ação de solicitação Ação de solicitação de fonte de dados que será invocada para obter dados. Você pode escolher somente ações de solicitação publicadas.

      Clique no link na caixa de diálogo abaixo para criar/configurar uma nova ação de solicitação de fonte de dados em IntegrationHub. Depois que a ação de solicitação é publicada em IntegrationHub, você pode escolhê-lo como Ação de solicitação No registro Fonte de dados. Para obter mais informações, consulte Defina propriedades da ação.

      Paginação de suporte Selecionado para habilitar a paginação da ação de solicitação. A paginação ajuda a reduzir a sobrecarga de processamento processando um número especificado de registros por vez, em vez de processar todos os registros de uma só vez.
      Limite Número máximo de registros por página. Por exemplo, para processar 50 registros por vez, insira um Limite de 50.
      Deslocamento O deslocamento inicial usado para paginação. O deslocamento é o número do registro inicial. Por exemplo, para processar 50 registros por vez, começando com o primeiro registro, insira um Limite de 50 e um Deslocamento de 0.
      Analisando script Digite o script usado para analisar uma única linha de entrada. Três parâmetros estão disponíveis nesta função:
      • linha : a linha atual a ser analisada pelo script
      • LineNumber número da linha atual em toda a carga de resposta
      • resultado resultado de saída
      Caminho para cada linha A expressão de caminho usada para selecionar objetos JSON, que se tornarão linhas na tabela de conjunto de importação. O caminho deve ser // Para objetos JSON.
      Descartar Matrizes Selecionado para descartar matrizes JSON como um valor. Não selecionado para serializar matrizes JSON como um valor.
      Expandir elementos secundários do nó Selecionado se os elementos secundários do nó XML ou do objeto JSON precisarem ser convertidos em colunas adicionais. Se o valor da coluna primária deve ser um fragmento XML ou JSON. Para JSON, observe que selecionar esta opção expande somente objetos, não matrizes. Para obter suporte a matrizes aninhadas, consulte Exemplos de importação de arquivo JSON.
      Dados em uma única coluna Selecionado para armazenar dados em uma única coluna.
      XPath para cada linha Expressão XPath que seleciona os nós que se tornam linhas na tabela de importação. Os secundários dos nós selecionados se tornarão as colunas nas linhas.
    4. Clique em Enviar.

    O que Fazer Depois

    Defina um mapa de transformação para a nova fonte de dados e execute uma importação.