11 Execução de uma Integração

Você executa uma integração para extrair os dados do sistema de origem e, em seguida, exibe e verifica os resultados. Se os dados foram transformados corretamente, você poderá enviá-los ao sistema de destino.

A página Executar Integração é formada por duas guias: Opções e Filtros.

A guia Opções permite que você selecione opções gerais e de destino para a integração selecionada no estágio de transformação. Observe que as seleções de período nessa página dependem do sistema de destino.

A guia Filtros permite que você adicione e modifique rapidamente filtros no tempo de execução e execute-os, em vez de modificar sempre a definição de integração. Os filtros são usados para consultar os dados nas origens de dados. As alterações nos filtros não são salvas e são usadas apenas para essa execução.

Assista a este tutorial para obter informações sobre como executar integrações: Definição de Opções de Integração de Dados Baseada em Arquivo e Execução de Integrações no Enterprise Planning Cloud.

Para executar uma integração:

  1. Na página inicial de Integração de Dados, selecione uma integração e clique em A imagem mostra o ícone Executar..
  2. Selecione a guia Opções.
  3. Selecione Importar Origem para importar os dados do sistema de origem e executar a transformação necessária, como importar, mapear e validar os dados.

    Selecione esta opção somente quando:

    • você estiver executando uma integração pela primeira vez.
    • os dados no sistema de origem tiverem sido alterados. Por exemplo, se você revisou os dados no workbench após a exportação e houve a necessidade de modificar os dados no sistema de origem.

    Em muitos casos, os dados do sistema de origem não podem ser alterados após a importação dos dados da origem pela primeira vez. Nesse caso, não será necessário manter a importação dos dados caso eles não tenham sido alterados.

  4. Selecione Recalcular para ignorar a importação de dados, mas reprocesse os dados com mapeamentos atualizados.
  5. No Modo de Importação, selecione o método para importação de dados.

    Modos de importação disponíveis:

    • Acrescentar — Mantenha as linhas existentes do PDV, mas acrescente novas linhas ao PDV. Por exemplo, o primeiro carregamento possui 100 linhas e o segundo possui 50 linhas. Nesse caso, 50 linhas são acrescentadas. Após o carregamento, o total de linhas do PDV muda para 150.

    • Substituir – Apaga todos os dados do PDV no destino e depois carrega da origem ou do arquivo. Por exemplo, o primeiro carregamento possui 100 linhas e o segundo, 70 linhas. Nesse caso, 100 linhas são removidas e 70 linhas são carregadas em TDATASSEG. Após esse carregamento, o total de linhas é 70.

      Para um aplicativo Planning, a opção Substituir apaga dados das dimensões Ano, Período, Cenário, Versão e Entidade que você está carregando e depois carrega os dados da origem ou do arquivo. Note que, quando você tem um ano de dados no aplicativo Planning, mas só está carregando um mês, essa opção apaga todo o ano antes de executar o carregamento.

      Nota:

      Ao executar uma integração no modo de Substituição para um cubo ASO, se o membro Cenário for um membro compartilhado, será executado apenas o carregamento de dados Numérico. Certifique-se de especificar o nome do membro com o nome totalmente qualificado, incluindo a hierarquia completa. Os métodos de carregamento Todos os Tipos de Dados não funcionam quando o membro de cenário é um membro compartilhado.

      Nota:

      O modo de Substituição não é suportado para o método de carregamento "Todos os tipos de dados com incremento automático de item de linha".
    • Mesclar – (somente Account Reconciliation). Mescle saldos alterados com dados existentes para o mesmo local.

      O modo de mesclagem elimina a necessidade de carregar um arquivo de dados inteiro quando apenas alguns saldos foram alterados desde a última vez que os dados foram carregados no Account Reconciliation. Se os mapeamentos mudarem entre dois carregamentos, os clientes deverão recarregar o conjunto de dados completo.

      Por exemplo, um cliente pode ter 100 linhas de saldos existentes para um número de IDs de conta, cada um com um valor de US$ 100,00. Se o cliente executar a integração no modo de mesclagem e a origem tiver uma linha para um ID de conta com um valor de US$ 80, após a execução da integração, haverá 100 linhas de saldos, das quais 99 terão um saldo de US$ 100,00 e 1 que terá um saldo de US$ 80,00.

    • Sem Importação — Ignore totalmente a importação de dados.

    • Mapear e Validar — Ignore a importação dos dados, mas reprocesse os dados com mapeamentos atualizados.

  6. Em Período de Início, selecione o primeiro período para o qual os dados devem ser carregados.
    Você pode filtrar períodos simplesmente digitando o(s) caractere(s) que forma(m) o filtro. Digite, por exemplo, J para filtrar por meses que começacam com J como Junho ou Julho. Você também pode clicar na lista suspensa e especificar critérios de filtro adicionais na caixa de edição mostrada abaixo Mais resultados disponíveis, use outros filtros.

    Esse nome de período deve ser definido no mapeamento de período.

    Nota:

    Use um Período de Início e um Período de Término que pertence a um único Ano Fiscal. Se um intervalo de período abranger anos fiscais, você enfrentará os seguintes problemas:

    • Durante o carregamento de dados no modo de substituição, o sistema apaga os dados de ambos os anos
    • Ao exportar dados, você obterá dados duplicados

    As situações acima se aplicam a todos os modos de carregamento de dados, inclusive o modo padrão e o modo rápido.

  7. Em Período de Término, selecione o último período para o qual os dados devem ser carregados.

    Esse nome de período deve ser definido no mapeamento de período.

  8. Em Período, selecione o período para o qual carregar dados.

    Se um período de PDV tiver sido selecionado na página inicial, o período selecionado será padronizado aqui. Se nenhum período de PDV for selecionado, o sistema padronizará para o último período usado com base no cache do navegador.

    É possível selecionar outro período quando um ícone de desbloqueio (Imagem mostra o ícone de desbloqueio. aparecer ao lado dele.

    Quando o modo de PDV Global for habilitado em Configurações do Sistema no Data Management, o período será padronizado para o Período de PDV Global e um cliente não terá permissão para selecionar outro período. Nesse caso, um ícone de bloqueio (Imagem mostra o ícone de bloqueio.aparecerá ao lado da lista suspensa Período.

  9. Selecione Exportar para destino para exportar os dados para o aplicativo de destino.
  10. Selecione Executar Verificação para gerar os dados e, em seguida, execute o Relatório de Verificação.
  11. No Modo de Exportação, selecione o método para exportar dados para o aplicativo de destino.

    Opções disponíveis:

    • Mesclar — Substitua os dados existentes pelos novos dados do arquivo de carregamento. (Por padrão, todo carregamento de dados é processamento no modo Mesclar.) Se os dados não existirem, crie-os.

    • Substituir – Apaga todos os dados do PDV no destino e depois carrega da origem ou do arquivo. Por exemplo, o primeiro carregamento possui 100 linhas e o segundo, 70 linhas. Nesse caso, 100 linhas são removidas e 70 linhas são carregadas na tabela intermediária. Após esse carregamento, o total de linhas é 70.

      Para um aplicativo Planning, a opção Substituir apaga dados das dimensões Ano, Período, Cenário, Versão e Entidade que você está carregando e depois carrega os dados da origem ou do arquivo. Note que, quando você tem um ano de dados no aplicativo Planning, mas só está carregando um mês, essa opção apaga todo o ano antes de executar o carregamento.

    • Acumular—Acumula os dados no aplicativo pelos dados no arquivo de carregamento. Para cada ponto de vista exclusivo no arquivo de dados, o valor do arquivo de carregamento é adicionado ao valor no aplicativo.

    • Subtrair – Subtraia o valor na origem ou no arquivo do valor no aplicativo de destino. Por exemplo, quando você tiver 300 no destino e 100 na origem, o resultado será 200.

    • Simulação: (somente Financial Consolidation and Close e Tax Reporting) Verifique um arquivo de carregamento de dados em busca de registros inválidos sem carregar dados no aplicativo de destino. O sistema valida o arquivo de carregamento de dados e lista qualquer registro inválido em um log, que relaciona 100 erros ou menos. Para cada erro, o log indica cada registro em erro com sua mensagem de erro correspondente. Os detalhes do log estão disponíveis em Detalhes do Processo.

      Nota:

      A Execução a Seco ignora a opção de destino Habilitar Segurança de Dados para Usuários Administradores e sempre usa a API REST para o usuário administrador.
    • Sem Exportação — Ignore totalmente a exportação de dados.

    • Verificar — Após exportação dos dados para o sistema de destino, exiba o relatório de verificação para o PDV atual. Se os dados do relatório de verificação não existirem para o PDV atual, uma página em branco será exibida.

  12. Clique em Filtros
  13. Adicione ou modifique o(s) filtro(s) para execução no tempo de execução.

    Os filtros são usados para consultar os dados nas origens de dados. Os filtros especificados na página Executar Integração não são salvos e são usados apenas para essa execução.

    Para obter mais informações, consulte Definição de Filtros.
  14. Somente Integrações Baseadas no Arquivo: Se nenhum perfil de arquivo tiver sido selecionado para a integração, em Arquivo, especifique o arquivo a ser usado no tempo de execução.

    Se um arquivo tiver sido selecionado quando a integração foi criada na página Geral, o perfil de arquivo selecionado será mostrado no campo e você não conseguirá carregar um arquivo diferente no tempo de execução com outro perfil de arquivo.

  15. Clique em Executar.