Leitura de arquivo CSV

Neste artigo iremos manipular um arquivo do tipo CSV, criando objetos com suas linhas e enviando em uma requisição post.

Introdução

Neste tutorial vamos criar um fluxo exemplo simples iniciado com o conector Manual trigger para execução manual do fluxo para leitura/conversão de um arquivo CSV em objetos JavaScript.

Fluxo completo utilizado

Componentes relacionados

1. Manual trigger

2. File Reader

3. File Remove

4. CSV

5. Loop/ForEach

6. Debugger

Passo a passo

1. Iniciando o fluxo

Na biblioteca de componentes/conectores como dito antes foi escolhido o iniciador manual com a configuração de exibir formulário de entrada ligado, já que este é um fluxo para leitura de um documento, portanto receberá o mesmo.

Configurando input no formulário

Carregando um arquivo de exemplo

Após carregarmos o arquivo, é possível observar alguns atributos relacionados ao upload como a pasta de destino, o atributo do formulário, um filename (renomeado intermente pelo Floui para garantir integridade dos dados), o atributo path que compila o destination + filename.

Podemos ainda observar o atributo size para controle do consumo do storage e o mimetype que define o tipo de arquivo a ser manipulado.

Estrutura de arquivos no Floui

2. Procurando arquivo

Com o atributo path em mãos, podemos passar o caminho ao componente File Reader que irá mapear o arquivo salvo no Storage e encarregar de oferecer uma saída de dados ao arquivo em memória no formato de texto.

Configurando o File Reader

Payload do componente File Reader

3. Convertendo arquivo

Agora que já temos os dados do arquivo CSV importado na memória do storage, podemos passar esses dados para leitura no formato CSV. Para isso, algumas configurações serão necessárias como:

Definir o tipo de dados: CSV ou objeto JavaScript

Indicar onde os dados posem ser encontrados: no nosso caso, será o payload definido no componente File Reader (archive).

Definir o tipo de delimitador dos dados de acordo com a sua base.

O campo Qualificador de texto permite definir se haverá tratamento especial para textos que estejam entre aspas, definindo-o como único campo. Isso ajuda na correta interpretação e importação dos dados, mantendo a integridade das informações no arquivo CSV.

Configurando o conector CSV

Payload do componente CSV

4. Removendo o arquivo usado

Chamamos a atenção agora para o componente File Remove. Imagine que seu fluxo seja uma automação que irá receber centenas de arquivos CSV para a leitura de pedidos. Após a leitura dos dados que serão armazenados em um banco externo, os arquivos permaneceriam em seu storage sem utilidade.

Pensando em cenários similares, aplicamos o File Remove, que deleta o arquivo após a leitura.

5. Iterando objetos

Assim como em em linhas de códigos, o Floui conta com o componente de iterações chamado Loop / ForEach que tem como função interar arrays de objetos ou listas e retornar um a um.

Componente Loop recebendo um array e retornando linha a linha

Payload do componente Loop / ForEach

Conclusão

Este foi um exemplo de uso para conversão de arquivos CSV. Agora, você decide como irá manipular seus dados salvando em um Floui Database ou usando conectores HTTP Request para envia-los para outras APIs.

Com este fluxo exemplo é possível converter, enviar e verificar informações de um documento CSV da forma que desejar.