Exportar para CSV

Visão Geral

O objeto Exportar para CSV converte uma planilha do Excel em um arquivo CSV, permitindo que os dados sejam utilizados por outros sistemas, processos ou integrações que não trabalham diretamente com arquivos .xlsx.

Ele é utilizado para interoperabilidade, geração de relatórios em formato leve e integração com APIs, bancos de dados e processos legados.

---

Funcionamento

Ao ser executado, o objeto:

1. Utiliza uma instância de Excel aberta ou um arquivo Excel informado.

2. Converte o conteúdo da planilha para o formato CSV.

3. Aplica o delimitador configurado.

4. Gera o arquivo CSV no diretório informado.

5. Retorna o caminho do arquivo exportado em caso de sucesso.

Em caso de erro na exportação, é retornado o código RPA002 no atributo Path do objeto.

Quando usar

• Para converter relatórios Excel em CSV.

• Para integração com sistemas que consomem CSV.

• Para exportar dados para processamento em lote.

• Para envio de arquivos a APIs ou serviços externos.

Quando não usar

• Quando o destino aceita arquivos Excel diretamente.

• Para exportar arquivos que não estejam no formato .xlsx.

• Para leitura de dados (use objetos de leitura de Excel ou CSV).

---

Configuração

CAMPO	DESCRITIVO
Versão do componente	Versão do mecanismo de exportação (ex.: v2).
Título	Nome exibido no fluxo do robô.
Nome Identificador do Objeto	Identificador interno do objeto.
Selecionar objeto do tipo Excel	Instância do Excel aberta a ser exportada.
Delimitador	Caractere que separará as colunas no CSV (ex.: ;, ,).
Salvar em	Diretório onde o arquivo CSV será criado.
Nome do Arquivo	Nome do arquivo CSV a ser gerado. Opcional.

Comportamento padrão

• Se Salvar em não for informado, o CSV será criado no mesmo diretório do arquivo Excel.

• Se Nome do Arquivo não for informado, o CSV será criado com o mesmo nome do arquivo Excel.

---

Exemplos

Exemplo simples

Objetivo: Exportar uma planilha para CSV.

Configuração:

• Objeto Excel: excel

• Delimitador: ;

• Salvar em: C:\Roboteasy

• Nome do Arquivo: relatorio.csv

Resultado:

• O arquivo relatorio.csv será criado no diretório informado.

Exemplo aplicado

Cenário: Enviar relatório para sistema legado.

Fluxo:

1. Criar ou Abrir Excel

2. Preencher dados

3. Exportar para CSV

4. Enviar arquivo CSV por API ou FTP

---

Retornos

Em caso de sucesso:

• O atributo Path do objeto conterá o caminho completo do CSV gerado.

Em caso de erro:

• O atributo Path retornará o código RPA002.

Esse retorno pode ser validado com objetos como Buscar Resultado do Componente, If ou Switch.

---

Erros comuns e como evitar

Delimitador incompatível com o sistema de destino Verifique qual separador o sistema consumidor espera.

Excel não aberto ou inválido Certifique-se de que a instância do Excel esteja aberta e válida.

Permissão de gravação no diretório Garanta que o robô tenha permissão para criar arquivos no caminho informado.

---

Boas práticas

• Padronizar delimitador conforme cultura do sistema (ex.: ; no Brasil, , em inglês).

• Definir nome de arquivo com data/hora para evitar sobrescrita.

• Validar o retorno do Path após a exportação.

• Executar Try/Catch em processos críticos.

• Fechar o Excel após a exportação.

Robô Exemplo

11KB

Exportar para CSV - Robô Exemplo.roboteasy

Open