Conversor online gratuito de XML para VCARD

Um telefone, cliente de email ou aplicativo de agenda de contatos pode exigir contatos no formato vCard (.vcf) em vez de uma exportação XML específica do aplicativo. A conversão facilita a importação, o compartilhamento, a edição e a transferência de contatos entre dispositivos e programas compatíveis.

O que é XML

XML é um formato de texto baseado em tags para armazenar e trocar dados hierárquicos. Arquivos XML de contatos podem ser produzidos por sistemas de CRM, clientes de email, agendas de contatos, web services, backups de dispositivos e bancos de dados personalizados.

XML não possui um schema universal para contatos. Um arquivo pode usar <contact>, <firstName> e <phone>; outro pode usar <person>, <given> e <telephoneNumber>. Antes da conversão, identifique o elemento de contato repetido e os campos que contêm nomes, endereços de email, números de telefone, organizações, endereços postais, observações e identificadores. Namespaces e elementos aninhados também podem afetar a detecção de campos.

O que é o formato vCard

vCard é um formato padronizado de texto simples para registros de contatos, normalmente salvo com a extensão .vcf. Um arquivo pode conter um ou vários contatos e pode ser importado por telefones, clientes de email, agendas de contatos, sistemas de CRM e gerenciadores de contatos para desktop.

Cada registro começa com BEGIN:VCARD e termina com END:VCARD. As propriedades comuns incluem FN para o nome de exibição, N para os componentes estruturados do nome, TEL, EMAIL, ORG, ADR, NOTE e UID. vCard 3.0 geralmente é a opção mais segura para compatibilidade; vCard 4.0 oferece suporte a recursos mais recentes, mas pode não ser importado corretamente em telefones e aplicativos mais antigos.

Como converter XML para vCard

Para uma exportação de contatos convencional, use o conversor em 101convert.com: carregue o arquivo XML, escolha VCARD como formato de saída, inicie a conversão e baixe o arquivo .vcf resultante. Não é necessário instalar software. Inspecione a saída antes de importá-la quando o XML tiver sido gerado por um aplicativo proprietário.

Se a detecção automática de campos falhar, use um editor XML, um programa de transformação de dados ou um script personalizado:

1. Abra o XML e localize o elemento repetido uma vez para cada contato.
2. Mapeie os campos de origem para as propriedades do vCard: o nome de exibição para FN, os nomes e sobrenomes para N, os números de telefone para TEL, os endereços de email para EMAIL, a empresa para ORG e os componentes do endereço postal para ADR.
3. Escolha vCard 3.0, a menos que o aplicativo de destino ofereça suporte explícito a vCard 4.0.
4. Gere um bloco completo de vCard para cada contato e salve todos os blocos como um arquivo UTF-8, como contacts.vcf.
5. Importe o arquivo pelo menu de contatos do aplicativo de destino, normalmente Contacts → Import ou File → Import.

Um registro vCard 3.0 mínimo é:

BEGIN:VCARD
VERSION:3.0
N:Doe;Jane;;;
FN:Jane Doe
TEL;TYPE=CELL:+1-202-555-0147
EMAIL:jane.doe@example.com
ORG:Example Ltd
END:VCARD

Para conversões repetíveis, a biblioteca padrão do Python pode analisar uma estrutura XML simples e gerar vCards. Altere os nomes e caminhos dos elementos para corresponder à origem:

import xml.etree.ElementTree as ET

def esc(value):
    return (value or "").replace("\\", "\\\\").replace(";", "\\;") \
        .replace(",", "\\,").replace("\r", "").replace("\n", "\\n")

root = ET.parse("contacts.xml").getroot()
blocks = []
for contact in root.findall(".//contact"):
    first = contact.findtext("firstName", "")
    last = contact.findtext("lastName", "")
    full = (first + " " + last).strip()
    name = ";".join((esc(last), esc(first), "", "", ""))
    lines = [
        "BEGIN:VCARD", "VERSION:3.0", f"N:{name}",
        f"FN:{esc(full)}"
    ]
    phone = contact.findtext("phone", "")
    email = contact.findtext("email", "")
    if phone:
        lines.append(f"TEL:{esc(phone)}")
    if email:
        lines.append(f"EMAIL:{esc(email)}")
    lines.append("END:VCARD")
    blocks.append("\r\n".join(lines))

with open("contacts.vcf", "w", encoding="utf-8", newline="") as output:
    output.write("\r\n".join(blocks) + "\r\n")

Execute-o com python convert_contacts.py. Um script de produção deve lidar com namespaces XML, valores ausentes, vários elementos de telefone e email, line folding do vCard para linhas longas e escaping específico de propriedades. Ele também deve atribuir parâmetros TYPE adequados somente quando o XML identificar um número como móvel, comercial, residencial ou fax.

Limites de qualidade e compatibilidade

A qualidade da conversão depende do schema XML, não de sua extensão de arquivo. Um conversor não pode inferir com segurança o significado de um número sem rótulo, e os campos proprietários podem não ter um equivalente no vCard. Fotos, grupos, campos personalizados, permissões, registros vinculados, vários endereços e dados de relacionamento podem ser descartados ou transformados.

Mantenha o XML original como backup. Teste uma pequena amostra antes de converter uma agenda de contatos grande e, depois da importação, verifique os nomes, a codificação de caracteres, os rótulos de telefone, os registros duplicados, o texto não latino e as quebras de linha. Reimportar o mesmo arquivo .vcf pode criar duplicatas, e alguns aplicativos oferecem suporte apenas a um subconjunto das propriedades do vCard 3.0 ou 4.0.