Criar uma fonte de dados do tipo REST (Integration Hub)

  • Versão de lançamento: Xanadu
  • Atualizado 1 de ago. de 2024
  • 3 min. de leitura
  • Crie um registro de fonte de dados do tipo REST (IntegrationHub) para definir quais dados um conjunto para importação deve importar de uma REST API.

    Antes de Iniciar

    Funções necessárias: import_admin e action_designer

    Procedimento

    1. Navegar até Todos > 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 para importação Um rótulo para a tabela de preparação do conjunto de importação a ser usada.
      Nome da tabela de conjunto para importação O Now Platform usa o rótulo que você inseriu 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 Testar carregamento de 20 registros.
      Tamanho do Lote Especifica o tamanho que os lotes devem ter. Aparece somente quando o campo Usar importação em lote está selecionado.
      As propriedades glide.import_set_load_usebatch e glide.import_set_load_batch_size afetam esses campos. A ordem de prioridade das propriedades e 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 de campo.
      • Por exemplo, se glide.import_set_load_usebatch = verdadeiro e a propriedade glide.import_set_load_batch_size não estiver definida, use o tamanho de lote padrão de 1000.
      • Por exemplo, se a propriedade glide.import_set_load_usebatch não estiver definida e o campo Usar importação em lote = verdadeiro, use o valor do campo Tamanho do lote (ou o padrão de 1000 se o valor do campo Tamanho do lote não estiver definido)
      • Por exemplo, se a propriedade glide.import_set_load_usebatch = falso e o campo Usar importação em lote = verdadeiro, não use a 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 Integration Hub. Depois que a ação de solicitação for publicada em Integration Hub, você poderá escolhê-la como uma ação de solicitação no registro da fonte de dados. Para obter mais informações, consulte Definir 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 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: o número da linha atual em toda a carga de resposta
      • result: 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 para importação. O caminho deve ser // para objetos JSON.
      Descartar Matrizes Selecionado para descartar matrizes JSON como um valor. Desmarcado para serializar matrizes JSON como um valor.
      Expandir elementos secundários do nó Selecionado se os elementos secundários do nó XML ou objeto JSON devem ser convertidos em colunas adicionais. Desmarcado se o valor da coluna primária for um fragmento XML ou JSON. Para JSON, observe que a seleção desta 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.