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âmetroDescriçãoValor padrãoTipo 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.

Atualizado