CSV to Excel

Descubra mais sobre o componente CSV to Excel e saiba como utilizá-lo na Digibee Integration Platform.

O CSV to Excel converte arquivos em formato CSV em arquivos XLSX. Você pode gerar apenas um arquivo de Excel por execução.

Parâmetros

Dê uma olhada nos parâmetros de configuração do componente. Parâmetros suportados por expressões Double Braces estão marcados com (DB).

Parâmetro	Descrição	Valor padrão	Tipo de dado
Multiple Sheets	Se a opção estiver ativada, múltiplos arquivos CSV vão resultar em múltiplas planilhas; do contrário, apenas um arquivo Excel vai ser criado.	False	Booleano
Sheet Information	ao clicar em Add, você ativa os parâmetros CSV File Name, Sheet Name Destination e CSV Delimiter. Com esses parâmetros, você pode importar os dados de vários arquivos CSV para as abas um arquivo Excel (isso somente é possível se o arquivo Excel conter diferentes abas).	N/A	Opções de Sheet Information
CSV File Name (DB)	Nome do arquivo CSV a ser importado. Este parâmetro também fica disponível se a opção Multiple Sheets estiver desativada.	file.csv	String
Sheet Name Destination	nome da aba que deve receber os dados do arquivo CSV.	N/A	String
CSV Delimiter	Delimitador do arquivo CSV.	N/A	String
Excel File Name	Nome do arquivo que será salvo. Se o campo estiver vazio, será considerada a propriedade "fileName"	file	String
Maximum File Size	Tamanho máximo permitido para o arquivo (em bytes). Este parâmetro é opcional. Deve ser usado somente se o usuário desejar mais controle sobre o arquivo gerado. Lembre-se que o arquivo Excel a ser gerado provavelmente será maior do que os dados CSV de entrada.	1048576	Long
Charset	Codificação do nome para a leitura do arquivo.	UTF-8	String
Sheet Name	Nome da planilha de Excel. Se o campo estiver vazio, a planilha será salva como "Sheet1".	Sheet	String
Delimiter	Delimitador no qual o CSV está configurado.	, (vírgula)	String
Fail On Error	Se a opção estiver habilitada, a execução do pipeline com erro será interrompida; do contrário, a execução do pipeline continua, mas o resultado vai mostrar um valor falso para a propriedade "success".	False	Booleano
Column Properties	Ao clicar em Add, você ativa os parâmetros Column, Date Format e Column Type. Com esses parâmetros, você pode indicar um tipo de dado a uma coluna específica de um arquivo Excel que será criado.	N/A	Opções de Column Properties
Column	Coluna que contém os dados que serão tratados.	N/A	String
Date Format	Formato de dado a ser usado se o tipo do campo é Date (por exemplo: Column Type = Date).	dd/MM/yyyy	String
Column Type	Tipo de dado da coluna.	Number	String
Set password	Se esta opção estiver habilitada, você poderá definir uma senha para proteger o arquivo de saída Excel.	False	Booleano
Password (DB)	Senha do arquivo Excel. Este parâmetro fica disponível apenas quando a opção Set Password estiver habilitada. Este campo suporta caracteres de texto e expressões em Double Braces.	N/A	String

CSV to Excel em ação

Utilizando múltiplos arquivos CSV de uma só vez

Você deve habilitar a opção Multiple Sheets para que seja possível especificar múltiplos arquivos CSV na geração de novas planilhas. Isso vale tanto para arquivos de Excel existentes ou inexistentes.

Se você precisar criar novas planilhas dentro de um arquivo Excel existente, informe o nome desse arquivo no campo Excel File Name. Dessa forma, o arquivo será atualizado com as novas planilhas.

No entanto, se você quiser criar um novo arquivo de Excel com essas planilhas, então não preencha o campo Excel File Name (ou preencha com o nome de um arquivo inexistente).

Utilizando um arquivo CSV

No campo Excel File Name, insira o nome do arquivo CSV a ser utilizado na criação de uma nova planilha.

Se você precisar criar novas planilhas dentro de um arquivo Excel existente, informe o nome desse arquivo no campo Excel File Name. Assim, o arquivo será atualizado com as novas planilhas.

No entanto, se você quiser criar um novo arquivo de Excel com essas planilhas, então não preencha o campo Excel File Name (ou preencha com o nome de um arquivo inexistente).

Desaconselhamos a criação de uma nova planilha em um arquivo de Excel já existente e grande (com uma ou mais planilhas com alta quantidade de dados), porque para criar as novas planilhas é necessário abrir o arquivo de Excel inteiro e isso consome muita memória. Por outro lado, isso não acontece quando um novo arquivo de Excel é criado de uma vez só com múltiplas planilhas - nesse caso, utiliza-se um stream no processo de criação.

Exemplos de configuração

O exemplo abaixo vai resultar na criação de um arquivo XLXS. Todas as colunas e linhas do CSV serão lidas como string:

{
       "type": "connector",
       "name": "csv para excel-connector",
       "stepName": "csv-test",
       "params": {
            "fileName": "{{message.fileName}}",
            "excelFileName": "arquivo",
            "delimiter": ",",
            "failOnError": false
       }
}

Veja quais são os tipos de configuração para algumas colunas:

{
       "type": "connector",
       "name": "csv para excel-connector",
       "stepName": "csv-test",
       "params": {
            "fileName": "{{message.fileName}}",
            "excelFileName": "arquivo",
            "cellDefinitions": "[{\" column \ ": \" A \ ", \" type \ ": \" NUMBER \ "}, {\" column \ ": \" B \ ", \" dateFormat \ " : \ "dd-MM-aaaa \", \ "type \": \ "DATE \"}, {\ "column \": \ "C \", \ "type \": \ "BOOLEAN \"}] ",
         "delimiter": ",",
         "failOnError": false
       }
}

A manipulação de arquivos dentro de um pipeline é feita de maneira protegida. Todos os arquivos podem ser acessados apenas em um diretório temporário, onde cada KEY do pipeline tem acesso ao seu próprio conjunto de arquivos.