Processamento local e privacidade de dados
A conversão de arquivos de tabela ocorre inteiramente no navegador do usuário. Ao selecionar ou arrastar um arquivo para a ferramenta, a análise dos dados de origem em formato CSV, JSON ou XLSX e a geração do arquivo de saída para download são realizadas localmente.
Como o processamento é feito do lado do cliente, nenhum dado é enviado para o BroBroGo. Isso garante que o conteúdo das planilhas e arquivos estruturados permaneça restrito ao dispositivo do usuário durante todo o processo de conversão.
Estrutura de dados e mapeamento de formatos
A conversão entre CSV, JSON e Excel exige o mapeamento de diferentes estruturas de representação de dados. Enquanto o CSV e o Excel organizam as informações em tabelas bidimensionais rígidas compostas por linhas e colunas, o JSON utiliza uma estrutura hierárquica de objetos e arrays.
Para viabilizar a transformação de dados estruturados em tabelas e vice-versa, a ferramenta aplica regras específicas de conversão:
- JSON para Tabela: Arrays de objetos são convertidos em linhas de tabela, onde as chaves dos objetos de primeiro nível tornam-se as colunas. Caso existam objetos aninhados, as chaves internas são achatadas utilizando caminhos separados por pontos para identificar a hierarquia original. Arrays de arrays são interpretados diretamente como linhas da tabela resultante.
- Excel para outros formatos: A ferramenta lê exclusivamente os valores visíveis contidos na primeira planilha do arquivo XLSX.
Limitações na conversão de planilhas
A conversão de arquivos do Excel (XLSX) para formatos de texto plano, como CSV ou JSON, resulta na perda de elementos visuais e estruturais complexos. O conversor extrai apenas os dados textuais e numéricos finais exibidos nas células.
- Fórmulas: A ferramenta não calcula fórmulas matemáticas ou lógicas contidas nas células. Apenas o valor resultante visível no momento da importação é extraído e convertido.
- Estilização: Elementos de formatação visual, como cores de fundo, fontes, bordas, alinhamentos e larguras de colunas, são completamente descartados no arquivo de saída.
O papel dos delimitadores em arquivos CSV
O formato CSV (Comma-Separated Values) representa tabelas em arquivos de texto plano, utilizando um caractere específico para separar os valores de cada coluna em uma linha. A escolha do delimitador correto é essencial para que softwares de planilha ou bancos de dados interpretem a estrutura do arquivo sem corromper os dados.
A ferramenta permite configurar o delimitador de saída para as conversões que geram arquivos CSV. O usuário pode definir o caractere de separação entre três opções padronizadas:
| Delimitador | Descrição | Uso comum |
|---|---|---|
| Vírgula | Utiliza o caractere , para separar os campos. |
Padrão internacional em sistemas configurados no idioma inglês. |
| Ponto e vírgula | Utiliza o caractere ; para separar os campos. |
Comum em sistemas configurados em português, onde a vírgula é o separador decimal. |
| Tabulação | Utiliza o caractere de tabulação (Tab). | Frequentemente chamado de formato TSV, útil para evitar conflitos com pontuações no texto. |
Tratamento de erros e restrições do sistema
Durante a importação, análise ou gravação dos arquivos, o conversor valida a estrutura dos dados e o tamanho dos arquivos. Caso ocorra alguma inconsistência, a interface exibe mensagens de erro específicas para orientar o usuário:
- Se nenhum arquivo for carregado antes de iniciar a operação: "Escolha um arquivo primeiro."
- Se o formato do arquivo importado não for suportado: "Escolha um arquivo CSV, JSON ou XLSX."
- Se o arquivo exceder o limite físico de processamento do navegador: "Este arquivo é grande demais. Use um arquivo com menos de
{max}." - Se o formato de saída selecionado for idêntico ao formato de entrada: "Escolha um formato de saída diferente."
- Se ocorrer uma falha genérica de leitura: "Não foi possível converter este arquivo."
- Se a estrutura do arquivo CSV estiver corrompida: "Não foi possível analisar este CSV."
- Se o arquivo JSON contiver erros de sintaxe ou não puder ser mapeado em linhas e colunas: "Este JSON é inválido ou não possui formato de tabela."
- Se o arquivo do Excel estiver corrompido ou em formato incompatível: "Não foi possível abrir este arquivo do Excel."
- Se a tabela de origem não contiver dados: "Este arquivo não possui linhas de tabela."
- Se o volume de dados ultrapassar os limites de exibição da ferramenta: "Esta tabela possui mais de
{max}linhas." ou "Esta tabela possui mais de{max}colunas." - Se o processo for interrompido pelo usuário: "Conversão cancelada."
- Se o processamento travar devido à complexidade do arquivo: "Esta conversão está demorando muito. Tente um arquivo menor."
Perguntas Frequentes
Minhas planilhas são enviadas para algum servidor?
Não. Os arquivos CSV, JSON e XLSX são analisados diretamente no seu navegador, e o download é gerado localmente.
A ferramenta preserva fórmulas e formatação do Excel?
Não. Esta ferramenta converte os valores visíveis da primeira planilha em uma tabela limpa. Ela não calcula fórmulas nem preserva a estilização das células.
Como o JSON é convertido em uma tabela?
Arrays de objetos tornam-se linhas, as chaves dos objetos tornam-se colunas e chaves de objetos aninhados são achatadas com caminhos de pontos. Arrays de arrays são mantidos como linhas de tabela.