Executar um processo
Um processo pode ser executado de duas formas: manualmente, quando você importa os arquivos e dispara o processamento na hora, ou de forma automatizada, quando a plataforma carrega e processa os dados sozinha — por agendamento, a partir de outro processo ou por um gatilho de API externa. Este artigo cobre as duas formas.
Fluxo completo: só é possível executar um fluxo de preparação de dados completo, ou seja, com etapas sem erros e ao menos uma etapa de fonte de dados e uma de saída.
Execução manual
O botão Executar abre a tela de execução do processo, onde você importa os arquivos que percorrerão o fluxo em uma data de referência específica. Ao final, a plataforma carrega e processa os arquivos e direciona para a tela de visualização dos resultados.
Na tela de importação, você precisa:
definir uma data de referência, a data em que os resultados do processo são armazenados;
selecionar os arquivos que serão processados, escolhendo-os no computador ou arrastando-os para a área de carregamento;
associar os arquivos às fontes de dados do fluxo, manualmente ou por regra de identificação, caso não haja regras de identificação automática.
Datas com resultado: no calendário de data de referência, os dias que já têm resultados aparecem com uma marca verde. Você pode navegar pelo calendário e visualizar resultados de diferentes datas.
Tipo de importação
Ainda na tela de execução, você escolhe a forma de importação dos dados. As opções aparecem quando a data de referência escolhida já tem importação, e variam conforme o tipo de análise.
Substituir dados está disponível nas análises Turbo AI e Standard e é a opção padrão. Apaga todos os dados importados e as análises anteriores da data e os substitui pelos novos dados importados.
Atualizar execução está disponível na análise Turbo AI e se aplica às etapas de Análise Tabela e Análise Conciliação. Permite atualizar os dados de uma execução sem apagar todo o histórico, usando um identificador de linha quando configurado. Com o identificador, a plataforma compara os dados existentes com os da nova importação:
registros com a mesma chave e os mesmos dados permanecem como estão e não são duplicados;
registros com chave nova são inseridos como novos registros;
registros com a mesma chave, mas dados diferentes, têm o registro existente atualizado;
registros antigos cuja chave não aparece na nova importação não são alterados e permanecem no histórico.
Sem identificador de linha, a plataforma não consegue comparar registros entre execuções. Nesse caso, todos os registros da nova importação são inseridos, num comportamento incremental, o que pode gerar duplicidade, já que os dados antigos são preservados.
Incrementar dados está disponível na análise Standard. Mantém os dados importados anteriormente e incrementa os novos. O comportamento incremental se refere à entrada dos dados, não às análises: se você importar e uma análise já tiver sido feita, no Analytics ou no Recon, os dados são apagados da análise para receber a nova importação.
Em resumo, ao comparar Atualizar execução e Substituir dados:
Objetivo: atualizar dados mantendo o histórico, contra recriar os dados da execução.
Com identificador de linha: a atualização mantém o histórico, atualiza os registros enviados antes, adiciona os novos e preserva o que não foi reenviado; a substituição remove todos os dados anteriores e mantém apenas os novos.
Sem identificador de linha: a atualização incrementa os dados e insere tudo da nova importação; a substituição apaga tudo e insere apenas os novos.
Registros não reenviados: permanecem no histórico na atualização e são removidos na substituição.
Uso recomendado: a atualização serve para cargas parciais ou recorrentes; a substituição, para reprocessamento completo.
Sempre substituem: importações via API e a etapa Integrar Processo sempre têm seus dados substituídos, sem incremento.
Processar os resultados
Com os arquivos selecionados e associados às fontes corretas na data de referência, clique em Executar Processo. A plataforma processa os resultados e exibe a tela de análise.
Quando a data de referência vem do arquivo
Nos processos Turbo AI com a data de referência configurada na fonte (veja o artigo Fluxo de dados), cada data distinta do arquivo gera um carregamento próprio, e a execução muda em quatro pontos:
Sem data na tela de execução: o calendário dá lugar a um aviso de que a data vem de uma coluna da fonte.
Tipo de importação em toda execução: a janela pergunta entre Atualizar execução e Substituir execução sempre, e a escolha vale para todas as datas do arquivo.
Só a pasta atual: a execução manual considera apenas a pasta em que você está.
Acompanhamento na Gestão de importações: depois de clicar em Executar Processo, a plataforma abre a Gestão de importações filtrada nessa execução, e as datas aparecem conforme são importadas. Ao final, um aviso resume as datas rejeitadas e as linhas ignoradas, quando houver.
Para refazer uma data específica, execute de novo com um arquivo que traga as linhas dessa data: só as datas presentes no arquivo são processadas.
Limite de datas por execução: por padrão, cada execução aceita até 31 datas, e o limite pode ser diferente no seu ambiente. Se o arquivo trouxer mais datas que o limite, nenhuma data é executada, e a execução fica como Não executada, com a quantidade encontrada na mensagem. Divida o arquivo e execute por partes.
Execução automatizada
Além da execução manual, é possível automatizar a importação de dados. A automação pode ser disparada de três formas — por agendamento, a partir de outro processo ou por um gatilho de API externa. As configurações ficam em Configurações (ícone de engrenagem) → Automação. Em Tipo de automação, você escolhe entre:
Nenhum: não aplica nenhuma regra de automação.
Processo agendado: define o calendário de automação que controla as datas de referência, o horário de execução do carregamento (com a opção de adicionar mais horários) e o deslocamento em relação ao período do calendário.
Sequência a partir de processos: dispara a execução deste processo a partir da execução de outro. Você seleciona o processo desejado e o deslocamento em relação ao período do calendário de referência.
Sequência a partir de Fluxo de Automação: dispara a execução a partir de um fluxo existente nos Fluxos de Automação das Configurações Gerais de Processo. Você informa o código do disparo — que também permite acionar a execução por um gatilho externo, como uma chamada de API — e o deslocamento em relação ao período do calendário de referência.
Como o deslocamento atua: o Processo agendado importa os resultados na data de referência calculada pelo calendário de automação e pelo deslocamento. Por exemplo, ao executar o processo em 03/01 com o calendário Dias Corridos, ele importa os dados disponíveis em 03/01; com deslocamento "-2", importa os dados de dois dias antes, ou seja, 01/01.
Num processo com a data de referência configurada na fonte, a execução automática também tira as datas do arquivo, e cada data gera um carregamento. Com Considerar todas as pastas marcada, a plataforma gera um carregamento para cada pasta e cada data.
Artigos relacionados
Introdução aos Processos
Criar um processo
Visualizar e analisar