Funcionamento do Conversor de Ficheiros de Tabela
Este conversor permite transformar ficheiros de dados tabulares entre os formatos CSV, JSON e Excel diretamente no seu navegador. O processo inicia-se ao selecionar um único ficheiro do seu dispositivo ou ao arrastá-lo para a área de importação. Após a deteção automática do formato de entrada, define-se o formato de saída pretendido e, no caso de conversões para CSV, especifica-se o delimitador a utilizar. O resultado convertido é apresentado numa pré-visualização antes de se proceder ao descarregamento do novo ficheiro.
O processamento dos dados ocorre localmente. Os ficheiros CSV, JSON e XLSX são analisados no próprio navegador do utilizador e o descarregamento é gerado de forma local, pelo que nada é enviado para o BroBroGo.
Estrutura de Dados e Formatos Suportados
A conversão de dados exige a correspondência entre diferentes formas de representação estrutural:
- CSV (Comma-Separated Values): Um formato de texto plano onde os dados são organizados em linhas e as colunas são separadas por um carácter delimitador específico.
- JSON (JavaScript Object Notation): Um formato de texto estruturado baseado em pares de chave-valor e matrizes, frequentemente utilizado para a transmissão de dados na web.
- XLSX (Excel): Um formato de folha de cálculo binário e comprimido que suporta múltiplas folhas, fórmulas, formatação e metadados.
O conversor aceita um ficheiro de cada vez, limitando-se aos formatos CSV, JSON ou XLSX. Ficheiros excessivamente grandes podem não ser processados. Durante a importação, o sistema valida a integridade do ficheiro e apresenta mensagens específicas caso ocorram falhas, tais como "Não foi possível analisar este CSV.", "Este JSON é inválido ou não possui formato de tabela." ou "Não foi possível abrir este ficheiro do Excel.".
Regras de Conversão e Tratamento de JSON Aninhado
A transformação de estruturas de dados lineares em formatos hierárquicos, ou vice-versa, obedece a regras estritas de mapeamento:
- De JSON para Tabela: Para criar uma estrutura bidimensional de linhas e colunas a partir de dados JSON, as matrizes (arrays) de objetos são convertidas em linhas de tabela. As chaves dos objetos definem as colunas. Quando existem objetos aninhados, as suas chaves internas são achatadas através da criação de caminhos separados por pontos. As matrizes de matrizes são mantidas diretamente como linhas da tabela.
- De Excel para Outros Formatos: A conversão extrai exclusivamente os valores visíveis da primeira folha de cálculo do ficheiro Excel.
Limitações na Conversão de Folhas de Cálculo
Ao converter ficheiros do Excel para formatos de texto plano como CSV ou JSON, ocorrem perdas inevitáveis de propriedades que não pertencem à estrutura de dados pura. O conversor não calcula fórmulas matemáticas nem preserva a estilização, cores, fontes ou formatação visual das células da folha de cálculo original.
Parâmetros de Entrada e Métricas de Saída
O utilizador controla a conversão através de opções específicas na interface, obtendo de seguida os metadados do ficheiro gerado.
Opções de Configuração
- Entrada: O formato do ficheiro de origem é identificado de forma automática pelo sistema após o carregamento.
- Saída: O utilizador deve selecionar uma opção diferente do formato de origem entre CSV, JSON ou Excel. Se tentar converter para o mesmo formato, surge o aviso "Escolha um formato de saída diferente.".
- Delimitador CSV: Quando o destino é CSV, define-se o carácter de separação entre as colunas, escolhendo entre Vírgula, Ponto e vírgula ou Tabulação.
Informação de Retorno
Após a conclusão do processo, a interface exibe o resultado e disponibiliza as seguintes métricas sobre o ficheiro gerado:
| Métrica | Descrição |
|---|---|
| Linhas | O número total de linhas detetadas e convertidas na tabela. |
| Colunas | O número de colunas que compõem a estrutura da tabela. |
| Saída | O tamanho do ficheiro final gerado após a conversão. |
Resolução de Erros e Limites de Processamento
Durante a operação, podem surgir mensagens de erro associadas a limites técnicos ou a problemas na estrutura dos ficheiros de origem:
- Se o utilizador tentar iniciar a conversão sem carregar um documento, a interface exibe "Escolha um ficheiro primeiro.".
- Ficheiros que não correspondam aos formatos aceites acionam o aviso "Escolha um ficheiro CSV, JSON ou XLSX.".
- Caso o ficheiro exceda a capacidade de processamento do navegador, é exibida a mensagem "Este ficheiro é grande demais. Use um ficheiro com menos de
{max}.". - Se o processo ultrapassar o tempo limite de execução, surge o alerta "Esta conversão está a demorar muito tempo. Tente um ficheiro menor.".
- Tabelas vazias ou que excedam as dimensões máximas permitidas geram os erros "Este ficheiro não possui linhas de tabela.", "Esta tabela possui mais de
{max}linhas." ou "Esta tabela possui mais de{max}colunas.".
Perguntas Frequentes
As minhas folhas de cálculo são enviadas para algum servidor?
Não. Os ficheiros CSV, JSON e XLSX são analisados diretamente no seu navegador, e o descarregamento é gerado localmente.
A ferramenta preserva fórmulas e formatação do Excel?
Não. Esta ferramenta converte os valores visíveis da primeira folha de cálculo numa tabela limpa. Não calcula fórmulas nem preserva a estilização das células.
Como o JSON é convertido numa tabela?
Matrizes (arrays) de objetos tornam-se linhas, as chaves dos objetos tornam-se colunas e as chaves de objetos aninhados são achatadas com caminhos de pontos. Matrizes de matrizes são mantidas como linhas de tabela.