# Leitura de arquivo CSV ## 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.

## Componentes relacionados 1. [Manual trigger](/guia/conectores/categorias/triggers/manual-trigger.md) 2. [File Reader](/guia/conectores/categorias/manipulacao-de-arquivos/file-reader.md) 3. [File Remove](/guia/conectores/categorias/manipulacao-de-arquivos/file-remove.md) 4. [CSV](/guia/conectores/categorias/manipulacao-de-dados/csv.md) 5. [Loop/ForEach](/guia/conectores/categorias/conectores-essenciais/loop-foreach.md) 6. [Debugger](/guia/conectores/categorias/monitoramento/debugger.md) ## 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.

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.

### 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.

### 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.

### 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

## 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. --- # Agent Instructions: Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter: ``` GET https://docs.floui.io/guia/artigos/tutoriais/leitura-de-arquivo-csv.md?ask= ``` The question should be specific, self-contained, and written in natural language. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.