Ir para o conteúdo principal
Bethemesh

Renomear colunas CSV

Altere os nomes dos cabeçalhos de um CSV mantendo os valores e a ordem das colunas, depois obtenha o ficheiro atualizado.

  • Área de transferência

Integrar este widget

Personalize o resultado, verifique a pré-visualização e copie o código.

Pré-visualização

Tipo de código de integração

Código a copiar

Responsivo e redimensionado automaticamente pela Bethemesh.

Uma linha por renomeação: antigo => novo

Esta ferramenta foi útil?

Como funciona esta ferramenta?

Uma importação de contactos, produtos ou faturas pode falhar apenas porque os nomes das colunas não correspondem aos campos exigidos pela aplicação de destino. Renomear as colunas CSV permite adaptar esse primeiro registo sem voltar a escrever os dados nem deslocar os campos. Pode aplicar várias correspondências ao mesmo tempo: uma referência interna passa a ter um identificador claro e o título de um montante pode indicar a respetiva moeda. Os valores mantêm-se como texto inalterado, incluindo zeros iniciais e vírgulas decimais, quando só é necessário ajustar os nomes.

O primeiro registo lógico é sempre interpretado como cabeçalho; não existe uma opção para ficheiros sem títulos. O separador é detetado entre vírgula, ponto e vírgula, tabulação e barra vertical, contando as ocorrências fora dos campos entre aspas nesse registo. Um campo entre aspas pode conter separadores e mudanças de linha. Duas aspas consecutivas no seu interior representam uma aspa literal. Uma aspa por fechar impede a operação. Uma marca BOM UTF-8 inicial é removida durante a leitura.

Escreva uma correspondência por linha no formato antigo => novo. Os espaços exteriores dos dois nomes introduzidos são retirados. A opção para ignorar espaços nos cabeçalhos começa ativa e também remove os espaços exteriores do título original antes da comparação. As maiúsculas e os acentos continuam a distinguir nomes: Codigo e codigo são diferentes. Ao desativar a opção, um título original rodeado de espaços deixa de corresponder ao nome simplificado da regra. Esta opção não limpa os espaços existentes nas células de dados.

As substituições são simultâneas e consultam os títulos originais. Assim, a => b em conjunto com b => c produz b e c, sem aplicar duas alterações à primeira coluna. Os títulos sem correspondência permanecem intactos e os destinos vazios são ignorados. São permitidos nomes finais repetidos e as respetivas células são conservadas, embora um importador seguinte possa exigir propriedades únicas. A saída usa o separador detetado, acrescenta as aspas necessárias e utiliza finais de linha LF: preserva os valores, mas não todos os detalhes de escrita do ficheiro original.

Como usar esta ferramenta

  1. Forneça o CSV com os títulos

    Cole a tabela ou importe um ficheiro de texto CSV ou TSV. Confirme que o primeiro registo contém os cabeçalhos a alterar, e não um comentário introdutório colocado antes da tabela.

  2. Defina cada mudança de nome

    Use uma linha por correspondência e o separador exato =>. Verifique maiúsculas, acentos e nomes de destino; mantenha a opção dos espaços ativa se os títulos originais tiverem margens desnecessárias.

  3. Compare o cabeçalho resultante

    Execute a operação, confronte os títulos obtidos com o esquema de destino e copie ou exporte o CSV. O contador inclui todas as colunas com correspondência, mesmo quando o nome atribuído é igual ao anterior.

Casos de uso

Preparar um catálogo para importação

Adapte os títulos de uma exportação do fornecedor aos campos exigidos pelo programa de inventário, sem alterar as referências dos produtos nem retirar os respetivos zeros iniciais.

Esclarecer a moeda de um preço

Substitua preco por preco_eur para indicar a moeda dos montantes num catálogo. A alteração do título não converte valores nem aplica qualquer taxa de câmbio.

Uniformizar um esquema de troca

Aplique as correspondências acordadas com um parceiro antes de juntar exportações cujas colunas descrevem a mesma informação, mas apresentam designações diferentes.

Exemplos

Identificar a referência e a moeda

São substituídos dois cabeçalhos. A vírgula de 12,50 continua a ser uma vírgula e B04 mantém o zero. Não há cálculos nem mudanças de tipo, e os dois produtos conservam a ordem original.

Entrada

ref;preco
A17;12,50
B04;8,00
Regras: ref => referencia; preco => preco_eur

Resultado

referencia;preco_eur
A17;12,50
B04;8,00

Reconhecer um título com espaços exteriores

O título original tem um espaço antes e depois de codigo. A opção permite reconhecê-lo sem modificar cidade nem Braga. Se a desativar, esse cabeçalho com espaços não é substituído pela regra simplificada.

Entrada

 codigo ;cidade
C3;Braga
Regra: codigo => identificador; ignorar espaços ativo

Resultado

identificador;cidade
C3;Braga

Dicas e boas práticas

  • Escolha destinos únicos quando o programa seguinte transformar as linhas em objetos JSON. Esta operação admite cabeçalhos repetidos e não determina como outro importador resolve essas repetições.
  • Se introduzir novamente o mesmo nome antigo, a última correspondência substitui as anteriores. Consolide as decisões para evitar que uma instrução ultrapassada fique em último lugar e se sobreponha à pretendida.
  • O tamanho importável depende do controlo de ficheiros e da memória disponível no navegador. Para exportações grandes, comece por uma amostra representativa que inclua campos entre aspas, decimais e caracteres acentuados.

Perguntas frequentes

Uma regra falha se a coluna original não existir?

Não. Simplesmente não altera nada nem aumenta o contador. Se nenhum cabeçalho mudar, confirme primeiro a grafia do nome, as maiúsculas e a opção dos espaços antes de mexer nas linhas de dados.

Posso renomear colunas que já têm o mesmo título?

Sim. A regra aplica-se a cada ocorrência correspondente e todas as células permanecem presentes. Uma única correspondência por nome não permite, contudo, atribuir um destino diferente a cada ocorrência de um título repetido.

O novo nome pode conter uma vírgula?

Sim. O serializador acrescenta aspas quando o título contém o separador detetado, uma aspa ou uma mudança de linha. Uma vírgula isolada não exige aspas quando o ficheiro usa ponto e vírgula como separador.

Renomear os cabeçalhos também ordena ou limpa os registos?

Não: apenas são substituídas as células de cabeçalho que correspondem às regras, com processamento no navegador. Para retirar colunas ou alterar a sua ordem, utilize antes a seleção de colunas CSV.

Ferramentas relacionadas

Ferramentas semelhantes ou complementares a esta.

Ferramentas semelhantes

Selecione as colunas de um CSV que pretende manter no resultado final.

Dados e folhas de cálculoUtilizar esta ferramenta

Funda vários ficheiros CSV numa única tabela mantendo colunas coerentes.

Dados e folhas de cálculoEm destaqueUtilizar esta ferramenta

Valide a estrutura de um ficheiro CSV e identifique rapidamente linhas ou colunas problemáticas.

Dados e folhas de cálculoEm destaqueUtilizar esta ferramenta