IA no seu dispositivo — profissional e privado.

Documentos

CSV para XML: como converter um arquivo CSV em XML válido online

Converta CSV em XML grátis online: use o cabeçalho como nomes de elemento, defina raiz e linha, corrija nomes inválidos, escape valores e escolha a codificação certa.

Atualizado em 8 de novembro de 20269 min de leitura

Para converter CSV em XML, abra o conversor de CSV para XML, solte o seu arquivo, dê nome ao elemento raiz e ao elemento de linha, confira a prévia e baixe o resultado. Cada linha do CSV vira um elemento de linha, e cada coluna vira um elemento filho com o nome do cabeçalho ou, se preferir, um atributo. O que exige atenção não é a conversão em si, mas a diferença entre os dois formatos: o cabeçalho de uma planilha pode ser qualquer texto, enquanto um nome XML segue regras rígidas, e caracteres como & e < precisam ser escapados. Este guia explica como funciona o mapeamento, o que cada configuração faz e o que, na prática, faz uma importação falhar.

Como um conversor de CSV para XML mapeia suas colunas

Pegue um arquivo de três colunas com o cabeçalho id,city,total e uma linha de dados 7,Paris,19.90. Com as configurações padrão, o resultado é um elemento raiz chamado root, um elemento chamado row para cada linha de dados e um elemento filho por coluna: <root><row><id>7</id><city>Paris</city><total>19.90</total></row></root>. A primeira linha do CSV nunca é gravada como dado; ela fornece os nomes.

Parte do CSVVira em XMLConfiguração que controla
O arquivo inteiroUm elemento raiz que envolve tudoElemento raiz (padrão root)
Cada linha de dadosUm elemento dentro da raizElemento de linha (padrão row)
Cada campo do cabeçalhoO nome de um elemento filho ou de um atributoPrimeira linha como nomes de elemento
Cada célulaTexto de elemento, valor de atributo ou CDATAEscrever colunas como, mais ajustes por coluna
Uma célula vaziaUm elemento vazio, nada ou xsi:nilCélulas vazias
Sem linha de cabeçalhoOs nomes column_1, column_2 e assim por dianteDesligue Primeira linha como nomes de elemento

Antes de escolher qualquer coisa, pergunte qual programa vai ler o arquivo. Se outro sistema espera um formato específico (por exemplo <products><product> com um atributo sku), use exatamente esses nomes. XML diferencia maiúsculas de minúsculas: Product e product são elementos diferentes, e um importador que procura um não vai encontrar o outro.

Converter CSV para XML, passo a passo

1

Adicione o CSV

Abra a ferramenta de CSV para XML e solte um arquivo .csv, .tsv, .txt ou .psv. O delimitador (vírgula, ponto e vírgula, tabulação ou barra vertical), o caractere de aspas e a codificação são detectados a partir do próprio arquivo.

2

Dê nome à raiz e à linha

Troque root e row pelos nomes que o sistema de destino espera, por exemplo orders e order. Se você digitar um nome que o XML não aceita, a ferramenta avisa e corrige o nome antes de usá-lo.

3

Escolha como as colunas são escritas

Em Escrever colunas como, escolha Elementos ou Atributos para o arquivo todo. Depois, na tabela Colunas, você pode mudar qualquer coluna para CDATA ou Ignorar, e vê cada cabeçalho ao lado do nome de elemento que será usado.

4

Decida sobre células vazias e a declaração

Escolha Elemento vazio, Omitir ou xsi:nil para as células em branco e deixe Incluir declaração XML ligado, a menos que o destinatário peça um fragmento sem ela.

5

Confira a prévia e baixe

A prévia mostra as primeiras vinte linhas geradas pelo mesmo código da exportação, com a indicação Bem formado ou Mal formado. Quando estiver certo, clique em Baixar XML.

Cabeçalhos que o XML não aceita

É aqui que a maioria das conversões feitas à mão falha. Um nome de elemento XML precisa começar com uma letra ou um sublinhado e não pode conter espaços, a maior parte dos sinais de pontuação nem dois-pontos. Nomes que começam com xml, em qualquer combinação de maiúsculas e minúsculas, são reservados pela especificação. Cabeçalhos de planilha quebram essas regras o tempo todo: Order ID, 2024, -id, Total (£), Unit price/kg. Um conversor que copia esses textos direto para as tags gera um arquivo que qualquer analisador rejeita já na primeira linha.

Cabeçalho no CSVNome de elemento usadoPor quê
First NameFirst_NameUma sequência de caracteres inválidos vira um único sublinhado
Total (£)TotalA pontuação no final é removida, em vez de virar sublinhados
2024_2024Um nome não pode começar com dígito, então um sublinhado é adicionado
xml ou XmlDataRecebe um sublinhado na frenteNomes que começam com xml são reservados
Name, NameName, Name_2Nomes repetidos são numerados para se distinguirem
Führung, 名前Sem alteraçãoLetras de qualquer sistema de escrita são válidas em XML

A ferramenta corrige cada nome segundo as regras de nomes do XML e mostra o cabeçalho original ao lado do nome usado, com a contagem de quantos foram renomeados, então nada muda sem você ver. Se o sistema de destino precisa de nomes específicos, o mais limpo é renomear os cabeçalhos no próprio CSV antes de converter: assim o arquivo que você guarda e o XML que você envia ficam iguais.

Nomes de raiz e linha, elementos ou atributos por coluna, CDATA, regras para células vazias, indentação e codificações são todos grátis. Grátis: um arquivo de até 25 MB. Pro: até 50 arquivos de uma vez em um ZIP, aninhamento por uma coluna, namespaces e um esquema XSD gerado. Tudo roda no seu dispositivo, não nos nossos servidores.

Converter CSV para XML

Elementos, atributos ou CDATA?

Elementos são a escolha segura padrão. <city>Paris</city> aceita texto de qualquer tamanho, inclusive quebras de linha, pode ficar vazio e pode ter um tipo. Escolha elementos quando estiver em dúvida.

Atributos colocam o valor na própria linha: <row id="7" city="Paris"/>. O arquivo fica bem menor e é fácil de ler com valores curtos, como IDs e códigos. Muitos importadores esperam IDs como atributos e campos descritivos como elementos; por isso o padrão pode ser alterado por coluna. Tem uma armadilha: analisadores XML trocam uma tabulação ou quebra de linha literal dentro de um atributo por um espaço, então um endereço de várias linhas gravado como atributo simples perde as quebras de linha. Este conversor grava esses caracteres como referências (&#10; para uma quebra de linha), e o valor volta intacto.

CDATA envolve um valor para que ele passe sem alteração, o que serve para uma coluna com um trecho de HTML. Ignorar deixa uma coluna totalmente de fora, útil para chaves internas que não devem ir para o outro sistema.

Escape: os caracteres que quebram o XML

Cinco caracteres têm significado especial em XML. No texto de um elemento, & vira &amp;, < vira &lt; e > vira &gt;. Dentro de um atributo, aspas duplas e simples também são escapadas, como &quot; e &apos;. Um nome de produto como Fish & Chips <large> precisa chegar como Fish &amp; Chips &lt;large&gt;, senão o arquivo não fica bem formado. O conversor faz isso em todos os valores, então não escape nada antes no CSV: se fizer, &amp; vira &amp;amp; e o destinatário mostra o código em vez do caractere.

Alguns caracteres não podem aparecer em XML 1.0 de jeito nenhum, escapados ou não: a maioria dos caracteres de controle abaixo do espaço, como o byte NUL ou a quebra de página que exportações de bancos de dados antigos às vezes trazem. Eles são removidos, e a ferramenta informa quantos eram. Se esse número for alto, a exportação de origem provavelmente está danificada ou em outra codificação.

Um CSV com aspas quebradas (uma aspa solta no meio de um campo) pode juntar várias linhas em uma única célula comprida, e nenhum escape de XML resolve isso. Passe o arquivo antes pelo CSV Escape / Fix ou abra-o no visualizador de CSV para ver se as colunas estão alinhadas.

Codificações e acentos que viram caracteres estranhos

O arquivo XML é sempre gravado em UTF-8, e a linha de declaração diz isso: <?xml version="1.0" encoding="UTF-8"?>. O risco está na entrada. Se o CSV for lido com a codificação errada, café vira café ou um ponto de interrogação, e esse estrago passa para o XML como se fosse texto de verdade.

O CSV veio de…Codificação a usarSinal de que a escolha está errada
A maioria dos aplicativos modernos e exportações onlineUTF-8 (Detectar encontra)é ou ’ no lugar de acentos e apóstrofos
Uma exportação como texto Unicode de uma planilhaUTF-16 LE (normalmente uma marca de ordem de bytes decide)Uma única coluna cheia de lacunas
Um sistema antigo da Europa Ocidental ou um salvamento padrão de planilhaWindows-1252Símbolos de euro e aspas curvas viram quadradinhos
Um arquivo que realmente é Latin-1ISO-8859-1 (real)Raro; os bytes 0x80 a 0x9F são códigos de controle, não aspas

Deixe Codificação em Detectar primeiro. Se o arquivo começa com uma marca de ordem de bytes (BOM), ela sempre prevalece sobre a lista, e a ferramenta avisa que ignorou a sua escolha. Antes de baixar, confira na prévia uma linha com nomes acentuados ou com ç.

Configurações que mudam o que o destinatário vê

  • Células vazias: Elemento vazio grava <city></city>, Omitir não grava nada e xsi:nil grava <city xsi:nil="true"/>, a única opção que informa a um sistema com esquema que o valor está ausente de propósito.
  • Adicionar xsi:type aos elementos: marca cada valor como integer, decimal, boolean, date, time, dateTime ou string, mas só quando todos os valores da coluna se encaixam. Um CEP como 01234 continua sendo texto, então o zero à esquerda é preservado.
  • Indentação: 2 espaços, 4 espaços ou uma tabulação para um arquivo que pessoas vão ler; Minificado coloca tudo em uma linha e gera o menor arquivo.
  • Ignorar linhas iniciais e Prefixo de comentário: descartam uma linha de título acima do cabeçalho real ou linhas que começam com #, para que não sejam lidas como nomes nem como dados.

Se o seu arquivo tiver mais de 25 MB, divida o CSV por número de linhas e converta as partes, mantendo o cabeçalho em cada uma. Se você ainda está decidindo se XML é o formato certo, JSON, CSV ou XML compara os três; para dados que já estão em JSON, use JSON para XML.

Perguntas frequentes

Como converto um arquivo CSV para XML de graça?

Solte o CSV no conversor de CSV para XML, defina os nomes do elemento raiz e do elemento de linha, escolha elementos ou atributos, confira a prévia de vinte linhas e baixe o XML. Um arquivo de até 25 MB é grátis, com todas as configurações que afetam o próprio XML.

Como uso a linha de cabeçalho do CSV como tags XML?

Mantenha Primeira linha como nomes de elemento ligada. Cada cabeçalho vira o nome de um elemento filho, corrigido onde o XML o rejeitaria; por exemplo, 2024 vira _2024. Se desligar, as colunas se chamam column_1, column_2 e assim por diante.

Por que meu XML aparece como mal formado?

Geralmente por um nome de tag que viola as regras do XML, um & ou < sem escape em um valor ou um caractere de controle perdido. O conversor corrige nomes, escapa valores e remove caracteres inválidos, então a saída dele é bem formada. Se um arquivo feito em outro lugar falhar, converta o CSV de novo aqui.

Posso deixar algumas colunas como atributos e outras como elementos?

Sim. Defina o padrão em Escrever colunas como e depois mude qualquer coluna na tabela Colunas para Elementos, Atributos, CDATA ou Ignorar. Tudo isso é grátis.

Por que os acentos aparecem errados no meu XML?

O CSV foi lido com a codificação errada. O XML é gravado em UTF-8, então o estrago aconteceu na leitura. Ajuste Codificação para UTF-8, Windows-1252 ou UTF-16 conforme o CSV foi salvo e confira na prévia uma linha com acentos.

Posso converter vários CSV de uma vez ou criar XML aninhado?

Esses são recursos Pro: até 50 arquivos de uma vez baixados em um único ZIP, agrupamento de linhas por uma coluna-chave para XML aninhado, um namespace e um esquema XSD gerado. A versão gratuita converte um arquivo por vez em XML plano.

Continue lendo

Mais sobre Documentos →