Criar uma integração de dados

Adicione informações novas ou atualizadas aos conjuntos de dados atuais importando-as para tabelas existentes em sua aplicação por meio do poder de Integration Hub. 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 uma tabela em branco.
  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 ou delegado_developer. Para obter mais informações, consulte Delegar desenvolvedores usando AES.

Procedimento

1. Navegar até Todos > 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 ).
4. Selecione Criar uma integração de dados.

Configurar sua origem de importação de dados

5. Configure sua origem de importação de dados executando as etapas a seguir.
   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 menu Tipo de origem para selecionar um tipo de fonte de dados.
      • Para escolher um arquivo do Excel ou CSV, selecione Ad-hoc > > Arquivo, 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 Criar um alias de conexão e credencial.
   4. Configurar a fonte de dados.
      • Para configurar uma planilha do Excel, especifique qual folha usar e qual número de linha usar para o cabeçalho. Somente uma folha 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ó aparecerá se a ação de 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 preenchidos previamente. Você pode exibir os detalhes da ação de fluxo de dados clicando no ícone de informações ( ícone ) ao lado dele. Clicar no ícone abre a configuração da ação de fluxo de dados.
6. Selecione o botão Salvar.

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

7. Selecione a guia Mapear 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 Origem para mapeamento de dados da tabela de destino, selecione Adicionar uma tabela.
   2. Na janela Propriedades de mapeamento, preencha os campos.

      Campo	Descrição
      Tabela de destino	Nome da tabela para a qual os dados serão transformados.
      Executar as regras de negócio da tabela ao importar.	Opção para executar as regras de negócio 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 na página Importações simultâneas.

   3. Selecione 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 ícone de arrastar à esquerda de cada cartão da tabela para arrastar o cartão para uma posição diferente. A ordem dos cartões de tabela determina a ordem na qual os dados são transformados nas tabelas de destino no tempo de execução.

      Nota:

      Você não pode selecionar a mesma tabela mais de uma vez e não pode selecionar uma tabela estendida ou tabela primária de uma tabela já na integração.

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

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

   Figura 1. Mapeamento de dados para a tabela de destino

   

   1. Na página Origem para mapeamento de dados da tabela de destino, selecione o botão com a tabela de destino que 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 botão Adicionar um campo, Adicionar todos os camposou Mapear automaticamente para configurar o lado de destino e começar a mapear dados.
      • Para adicionar todos os campos na tabela de destino, selecione Adicionar todos os campos. Os campos são adicionados em ordem alfabética.
      • Para adicionar campos individualmente, selecione Adicionar 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 Mapeamentoautomático . O mapeamento automático mapeia entidades de origem para entidades de destino com nomes semelhantes. O botão Mapeamento automático tem duas opções.
        • Todos os campos correspondentes na tabela de destino adiciona todos os campos e mapeia aqueles que correspondem.
        • Todos os campos não mapeados na seleção de destino mapeiam 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, selecionar Mapeamento automático não muda seu valor. Um campo automapeado tem um ícone de varinha em sua 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 a propriedade glide.ih.automap.extractone como falsa.

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

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

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

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

   4. Opcional: Use o comutador de alternância Corresponder para especificar campos em que o sistema deve verificar se há dados correspondentes e, se encontrado, atualizar os registros existentes em vez de criar novos.

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

      • Se o comutador de alternância Corresponder do campo Número do pedido estiver ativado, o sistema verificará se há dados correspondentes. Se os dados de origem tiverem um registro com o mesmo número de ordem, o sistema atualizará o registro existente na tabela de destino.
      • Se o comutador de alternância Corresponder do campo Número do pedido estiver desativado, o sistema não verificará se há dados correspondentes. Se os dados de origem tiverem um registro com o mesmo número de ordem, 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 ordem de 743.
   5. Opcional: Para campos de opção e referência, especifique a coluna para a qual os dados serão mapeados.
      1. Selecione o ícone de engrenagem (ícone de ).
      2. Em Campo, selecione a coluna para a qual 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.
         • Criar uma nova opção/registro: cria a opção ou o registro na tabela de destino.
         • Ignorar este campo: ignora somente o campo na tabela de destino.
         • Ignorar este registro: ignora o registro inteiro na tabela de destino.
      4. Selecione Concluído.
   6. Opcional: Altere ou modifique seus dados aplicando funções de transformação.
      Por exemplo, você pode usar a função de transformação de maiúsculas para alterar uma cadeia de caracteres de entrada para todos os caracteres em maiúsculas. Para obter mais informações, consulte Funções de transformação.

      Nota:

      Nem todas as funções de transformação disponíveis durante a criação de fluxos e subfluxos estão disponíveis em Integration Hub - Importar.

      1. Selecione o ícone da função de transformação ( ícone da ).
      2. Selecione uma função de transformação no menu e selecione OK.
      3. Para aplicar funções de transformação adicionais, selecione Adicionar 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 funções de transformação, selecione Concluído.
10. Quando terminar o mapeamento, clique em Salvar.

Importar o arquivo ou programar 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 que você carregou agora, selecione Executar importação.
    • Para configurar uma importação futura dos dados, selecione Programar uma importação.
    Consulte Run or schedule a data import.
12. Opcional: Se você executou a importação, visualize a tabela e verifique se ela aparece com o conteúdo adicional, retornando à tabela de destino, atualizando a tela do navegador e clicando em Visualizar.
13. Opcional: Se você adicionou novas colunas durante a importação e deseja que elas sejam exibidas na tabela de destino, selecione Personalizar lista para editar as colunas exibidas.