As importações de CSV geralmente falham por causa da primeira linha. As linhas de dados podem estar bem, mas o sistema recetor depende de nomes de colunas limpos. Um cabeçalho em falta, um cabeçalho duplicado, um delimitador inesperado ou uma primeira linha deslocada podem fazer com que a importação se comporte como se todo o ficheiro estivesse avariado.
Validar a linha do cabeçalho antes da importação fornece um aviso antecipado enquanto o ficheiro ainda é fácil de inspecionar. O Validador CSV do Converty ajuda ao detetar delimitadores, verificar o tratamento do cabeçalho, listar problemas ao nível da linha e mostrar uma vista analisada de como o ficheiro está realmente a ser lido.
Porque é que a linha do cabeçalho apresenta tantos riscos
A linha do cabeçalho é o mapa do resto do ficheiro. Se o mapa estiver errado, os valores abaixo podem cair nos sítios errados.
Os problemas comuns incluem:
- nomes de colunas duplicados
- nomes de colunas em branco
- cabeçalhos separados pelo delimitador errado
- uma linha de dados acidentalmente tratada como cabeçalho
- uma linha de cabeçalho tratada como dados
- exportações de folhas de cálculo ocultas que não correspondem ao separador esperado
Estes problemas são frustrantes porque o ficheiro pode parecer razoável numa folha de cálculo. O problema só se torna óbvio quando outro sistema tenta analisá-lo.
Como validar o cabeçalho antes da importação
O fluxo de trabalho mais seguro é inspecionar a forma como o analisador CSV vê o ficheiro, e não apenas como a folha de cálculo o exibe.
1.º Abra o Validador CSV. 2.º Cole uma amostra ou carregue o ficheiro CSV. 3.º Reveja o delimitador detectado. 4.º Confirme se a primeira linha está a ser tratada como cabeçalho. 5.º Leia a lista de problemas em busca de campos em falta, cabeçalhos duplicados, linhas em branco ou problemas de formato de linha. 6.º Compare a visualização analisada com as colunas que o sistema de destino espera.
Isto torna a primeira linha visível como estrutura. Pode corrigir o ficheiro de origem antes que a importação a jusante se torne a ferramenta de depuração.
A validação de cabeçalho e a deteção de delimitador pertencem juntas
Os problemas de cabeçalho e os problemas de delimitador parecem geralmente iguais vistos de fora. Se um ficheiro separado por ponto e vírgula for lido como separado por vírgula, o analisador poderá ver toda a linha do cabeçalho como uma coluna. Isto pode fazer com que todas as linhas seguintes pareçam erradas.
É por isso que o Converty mostra a deteção de delimitadores e as vistas analisadas em conjunto. É necessário confirmar o limite do ficheiro antes de decidir se os nomes dos cabeçalhos estão errados.
Para o lado do delimitador do problema, leia Como corrigir problemas do delimitador CSV antes de uma importação. Para uma preparação de importação mais ampla, utilize Como validar ficheiros CSV antes que uma importação falhe.
Valide antes de mapear campos
Muitas ferramentas de importação solicitam que mapeie colunas CSV para campos de destino. Esta etapa de mapeamento é muito mais fácil quando a linha do cabeçalho está limpa. Se mapear os campos antes de verificar a estrutura do ficheiro, pode perder tempo a configurar uma exportação quebrada em vez de corrigir o ficheiro.
Abra o Validador CSV antes da importação quando necessitar de confirmar a linha do cabeçalho, o delimitador e a vista analisada antes de o ficheiro chegar ao sistema de destino.
