Criar uma integração de dados

Adicione informações novas ou atualizadas aos seus conjuntos de dados atuais importando-as para tabelas existentes em sua aplicação com o poder de IntegrationHub. Programe importações futuras para adicionar dados em horários específicos.

Este vídeo mostra como executar o procedimento a seguir.

Antes de Iniciar

• Você deve ter uma tabela existente em sua aplicação. Para obter mais informações, consulte Criar tabela vazia.
  Nota:

  Atualmente, os arquivos do Excel são o único formato de dados aceito que os usuários podem carregar.
• Função necessária: admin, sn_app_eng_studio.user, sn_app_eng_studio.admin ou deleged_developer. Para obter mais informações, consulte Delege desenvolvedores usando AES.

Procedimento

1. Navegar até Tudo > App Engine > App Engine Studio.
2. Na página Meus apps, abra sua aplicação.
3. Ao lado do título Dados, selecione o ícone Adicionar ( ).
4. Selecione Crie uma integração de dados .

Configure sua fonte de importação de dados

5. Execute as etapas a seguir para configurar sua fonte de importação de dados.
   1. Preencha os campos para a integração de dados.

      Campo	Descrição
      Nome	Nome da sua integração.
      Descrição resumida	Descrição da sua integração.
      Aplicação	Nome do escopo da aplicação para sua integração.

   2. Selecione Salvar e continuar .
   3. Use o. Tipo de origem para selecionar um tipo de fonte de dados.
      • Para escolher um arquivo Excel ou CSV, selecione AD-HOC > > Arquivo, e depois qualquer um Excel ou CSV . Na seção Carregamento de arquivo, carregue um arquivo XLSX, XLS, CSV ou ZIP.
      • Para escolher uma ação de Fluxo de dados, selecione Spokes . Os fluxos de dados ativos são organizados por spoke e listados em ordem alfabética. Na seção Conexão, selecione o alias de conexão. Para ações de fluxo de dados que usam um alias de conexão, você pode substituir o alias de conexão padrão por qualquer um dos aliases secundários. Para obter mais informações, consulte Crie um alias de conexão e credencial .
   4. Configurar a fonte de dados.
      • Para configurar uma planilha do Excel, especifique qual planilha usar e qual número de linha usar para o cabeçalho. Apenas uma planilha e um cabeçalho podem ser especificados.
      • Para configurar um arquivo CSV, selecione o delimitador.
      • Para configurar uma ação de fluxo de dados, insira as entradas necessárias. Esta seção só aparece se a ação Fluxo de dados tiver entradas para inserir. As ações de fluxo de dados com entradas têm entradas exclusivas, portanto, os campos nesta seção dependem de qual ação de fluxo de dados está selecionada e de sua configuração. Todos os valores padrão já configurados pelas entradas do Spoke são pré-preenchidos. Você pode exibir os detalhes da ação Fluxo de dados clicando no ícone de informações ( ) ao lado dele. Clicar no ícone abre a configuração da ação Fluxo de dados.
6. Selecione Salvar botão.

Escolha sua tabela de destino e configure as opções de importação

7. Selecione Mapa para destino .
8. Selecione a tabela de destino e as opções para a integração de dados que você está criando.
   Mapear os dados de origem para a tabela de destino permite que você controle como o sistema trata os dados carregados.
   1. Na página Mapeamento de dados da tabela de origem para destino, selecione Adicione uma tabela .
   2. Na janela Propriedades de mapeamento, preencha os campos.

      Campo	Descrição
      Tabela de destino	Nome da tabela para a qual transformar seus dados.
      Executar regras de negócio da tabela ao importar	Opção para executar as regras de negócios da tabela de destino ao importar os dados.
      Executar a importação de forma síncrona	Opção para executar a importação de forma síncrona. Quando os dados são transformados em paralelo e há vários registros de origem com um valor de aglutinação específico, marcar esta opção garante que somente um registro com esse valor de aglutinação seja inserido por vez. Para obter mais informações, consulte a seção Inserções sincronizadas no Importações simultâneas página.

   3. Selecione Save (Salvar).

      Você pode adicionar várias tabelas de destino à sua integração. Repita as etapas 4a a 4c para cada tabela de destino que você deseja adicionar.

      As tabelas são listadas na ordem em que são adicionadas. Você pode mudar a ordem usando o ícone de arrastar à esquerda de cada cartão de mesa para arrastar o cartão para uma posição diferente. A ordem dos cartões de tabela determina a ordem em que os dados são transformados nas tabelas de destino no tempo de execução.

      Nota:

      Não é possível selecionar a mesma tabela mais de uma vez e não é possível selecionar uma tabela estendida ou uma tabela primária de uma tabela que já está na integração.

Mapeie campos de importação para sua tabela de destino

9. Mapeie os campos em sua importação para a tabela de destino executando as seguintes ações.

   Figura 1. Mapeando dados para a tabela de destino

   

   1. Na página Mapeamento de dados da tabela de origem para destino, selecione o botão com a tabela de destino para a qual você deseja mapear.
      Isso abre a seção de mapeamento de dados da tabela. O lado esquerdo da página mostra os dados de origem. O lado direito é para a tabela de destino.
   2. Use o. Adicione um campo , Adicione todos os campos , ou Mapeamento automático botão para configurar o lado de destino e iniciar o mapeamento de dados.
      • Para adicionar todos os campos na tabela de destino, selecione Adicione todos os campos . Os campos são adicionados em ordem alfabética.
      • Para adicionar campos individualmente, selecione Adicione um campo e escolha o nome do campo na lista. Um campo só pode ser adicionado uma vez.
      • Para adicionar campos e mapeá-los automaticamente, selecione Mapeamento automático . O mapeamento automático mapeia entidades de origem para entidades de destino com nomes semelhantes. . Mapeamento automático o botão tem duas opções.
        • Todos os campos correspondentes na tabela de destino adiciona todos os campos e mapeia os que correspondem.
        • Todos os campos não mapeados na seleção de destino mapeia somente os campos que você já adicionou, mas ainda não mapeou. Se você ainda não adicionou nenhum campo, esta opção não estará disponível.

      • Para uma entidade de destino que já foi mapeada, selecione Mapeamento automático não muda seu valor. Um campo mapeado automaticamente tem um ícone de varinha na cápsula de dados.

        Por padrão, o mapeamento automático mapeia no máximo uma entidade de origem para uma entidade de destino. Você pode mudar isso definindo o. glide.ih.automap.extractonepropriedade como falsa.

        O mapeamento automático corresponde as entidades de origem e destino procurando nomes de coluna que tenham pelo menos 80% de correspondência. Você pode modificar isso com glide.ih.automap.minimum.scorepropriedade. Por exemplo, para fazer correspondências com base em uma semelhança de 60%, você pode definir glide.ih.automap.minimum.scorepara 60.

   3. Mapeie dados arrastando cápsulas de dados da origem para Valor na tabela de destino.

      Você também pode mapear dados usando o seletor de cápsulas ( ) no lado direito da tabela de destino. Você pode inserir mais de um valor na coluna Valor, também pode inserir texto.

      Após mapear um campo de origem para um campo de destino, um pequeno ícone de marca de seleção ( ) aparece ao lado do nome do campo de origem. Se você mover o cursor para a marca de seleção, a dica de ferramenta listará os campos de destino para os quais o campo de origem foi mapeado, até cinco campos.

   4. Opcional: Use o. Correspondência alterne a chave para especificar campos em que o sistema deve verificar se há dados correspondentes e, se encontrados, atualizar registros existentes em vez de criar novos registros.

      Por exemplo, se uma tabela de destino tiver um Número do pedido e um registro com um número de pedido de 743, há duas opções para lidar com possíveis correspondências.

      • . Correspondência chave de alternância para Número do pedido o campo está ativado, o sistema verifica se há dados correspondentes. Se os dados de origem tiverem um registro com o mesmo número de pedido, o sistema atualizará o registro existente na tabela de destino.
      • . Correspondência chave de alternância para Número do pedido o campo está desativado, o sistema não verifica se há dados correspondentes. Se os dados de origem tiverem um registro com o mesmo número de pedido, o sistema criará um novo registro na tabela de destino. Nesse caso, a tabela de destino terá dois registros, ambos com um número de pedido de 743.
   5. Opcional: Para campos de escolha e referência, especifique a coluna para a qual mapear os dados.
      1. Selecione o ícone de engrenagem ( ).
      2. Em Campo , selecione a coluna para mapear.
      3. Em Se não existir nenhum registro correspondente, faça o seguinte , especifique o que fazer se essa coluna não estiver disponível.
         • Crie uma nova opção/registro : Cria a opção ou o registro na tabela de destino.
         • Ignore este campo : Ignora somente o campo na tabela de destino.
         • Ignorar este registro : Ignora o registro inteiro na tabela de destino.
      4. Clique em Done (Concluído).
   6. Opcional: Mude ou modifique seus dados aplicando funções de transformação.
      Por exemplo, você pode usar a função Transformação de maiúsculas para mudar uma cadeia de caracteres de entrada para todos os caracteres maiúsculos. Para obter mais informações, consulte Funções de transformação .

      Nota:

      Nem todas as funções de transformação disponíveis ao criar fluxos e subfluxos estão disponíveis em IntegrationHub- Importar.

      1. Selecione o ícone da função de transformação ( ).
      2. Selecione uma função de transformação no menu e selecione OK .
      3. Para aplicar funções de transformação adicionais, selecione Adicione uma nova transformação . As funções de transformação são aplicadas na ordem em que são selecionadas.
      4. Depois de adicionar todas as suas funções de transformação, selecione Concluído .
10. Quando terminar o mapeamento, clique em Salvar .

Importe o arquivo ou programe a importação de dados

11. Escolha o que fazer com a importação de dados que você acabou de criar e mapear.
    • Para importar o conjunto de dados carregado agora, selecione Executar importação .
    • Para configurar uma importação futura dos dados, selecione Programe uma importação .
    Consulte Run or schedule a data import.
12. Opcional: Se você executou a importação, visualize a tabela e certifique-se de que ela apareça com o conteúdo adicional retornando à tabela de destino, atualizando a tela do navegador e clicando em Visualização .
13. Opcional: Se você adicionou novas colunas durante a importação e deseja que elas sejam exibidas na tabela de destino, selecione Personalize a lista para editar as colunas exibidas.