Conversor online gratuito de VCARD para XML

O que é vCard

vCard é um formato de contatos baseado em texto, normalmente armazenado com a extensão .vcf. Cada registro é delimitado por BEGIN:VCARD e END:VCARD e pode conter nomes, números de telefone, endereços de email, endereços postais, organizações, aniversários, fotografias, observações e propriedades personalizadas.

Telefones, Microsoft Outlook, Apple Contacts, Google Contacts, Thunderbird, sistemas de CRM e aplicativos de email normalmente criam ou exportam vCards. Um arquivo pode conter um contato ou muitos contatos. As versões 2.1, 3.0 e 4.0 diferem na sintaxe das propriedades, na codificação de caracteres, nos parâmetros e nos recursos compatíveis.

O que é XML

XML é um formato de texto hierárquico que representa dados com elementos, atributos, namespaces e valores de texto. Ele permite a validação com um schema XSD, consultas e transformações com ferramentas XML e integração com aplicativos que definem um formato de importação XML.

XML normalmente não significa uma única estrutura universal de contatos. O formato padronizado xCard, definido pela RFC 6351, representa vCard 4.0 em XML, mas muitos programas exigem, em vez disso, um schema proprietário com nomes de elementos, namespaces e aninhamentos diferentes. Consulte a documentação, o XSD ou um XML de exemplo do aplicativo de destino antes de escolher a estrutura de saída.

Como converter o arquivo

Use 101convert.com

Em 101convert.com, selecione a conversão de VCARD para XML, carregue o arquivo .vcf, inicie a conversão e baixe o arquivo .xml resultante. Isso é adequado quando a estrutura XML do conversor corresponde ao programa de importação e os dados dos contatos podem ser processados online; use um método local para catálogos de endereços que precisam permanecer no dispositivo.

Abra a saída em um editor compatível com XML e verifique se ela está bem formada. Um download concluído não garante que o programa de destino aceitará o schema ou preservará todas as propriedades do vCard.

Converta localmente com Python

Para dados privados ou processamento repetível, analise o vCard com o pacote vobject em vez de substituir linhas mecanicamente. O script a seguir cria uma estrutura XML personalizada simples e preserva o nome de cada propriedade, o conjunto de parâmetros e a representação textual de seu valor:

python -m pip install vobject

import sys
import vobject
import xml.etree.ElementTree as ET

source, destination = sys.argv[1:3]
root = ET.Element("contacts")

with open(source, "r", encoding="utf-8-sig", newline="") as file:
    for card in vobject.readComponents(file):
        contact = ET.SubElement(root, "contact")
        for name, properties in card.contents.items():
            for prop in properties:
                element = ET.SubElement(contact, "property", {"name": name})
                for key, values in prop.params.items():
                    element.set(key.lower(), ",".join(str(value) for value in values))
                value = prop.value
                if isinstance(value, (list, tuple)):
                    element.text = ";".join(str(part) for part in value)
                else:
                    element.text = "" if value is None else str(value)

ET.indent(root, space="  ")
ET.ElementTree(root).write(destination, encoding="utf-8", xml_declaration=True)

Salve-o como vcard_to_xml.py e execute-o com Python 3.9 ou posterior:

python vcard_to_xml.py contacts.vcf contacts.xml

Isso produz elementos como <contacts>, <contact> e <property name="tel">. É um ponto de partida, não um formato de importação universal. Altere os nomes dos elementos, o namespace, a representação dos parâmetros, a formatação de datas e o tratamento de valores estruturados para corresponder ao schema de destino. Se o destino aceitar xCard, implemente o mapeamento de elementos e namespaces da RFC 6351 em vez de usar essa estrutura personalizada.

Verificações de qualidade e compatibilidade

XML válido não é necessariamente XML compatível. Os importadores podem exigir um elemento raiz, namespace, aninhamento de contatos, nomes de campos, sintaxe específica para tipos de telefone e email, formato de data ou versão do xCard. Valide o resultado com o XSD fornecido, quando houver um, e teste-o com uma cópia do catálogo de endereços de destino.

Use um parser de vCard para lidar com linhas dobradas, valores quoted-printable, texto UTF-8, caracteres escapados, parâmetros de propriedades, propriedades repetidas e regras específicas de cada versão. Uma conversão linha a linha pode corromper observações com várias linhas, nomes não ASCII, rótulos de telefone ou endereços.

O script de exemplo converte valores em texto e pode não preservar toda a semântica de campos estruturados, como ADR e ORG, fotografias binárias, associação a grupos, fusos horários, campos privados ou extensões do fornecedor. Revise registros que contenham vários números de telefone, endereços de email repetidos, fotografias e observações. Se todos os recursos do vCard precisarem ser preservados, use um schema xCard ou do fornecedor documentado e mantenha o arquivo .vcf original como backup oficial.