Conversor online gratuito de VCF para XML

Um sistema de gerenciamento de contatos, um utilitário de migração ou um arquivo morto pode exigir XML quando os contatos são fornecidos como um arquivo .vcf. A conversão expõe nomes, números, endereços de email e outros campos a softwares baseados em XML para importação ou edição.

O que é o formato VCF

Para dados de contato, VCF significa vCard, um formato baseado em texto especificado por padrões incluindo vCard 3.0 (RFC 2426) e vCard 4.0 (RFC 6350). Um arquivo pode conter um ou vários registros de contato com campos como FN, N, TEL, EMAIL, ADR, ORG, NOTE e PHOTO.

Apple Contacts, Google Contacts, Microsoft Outlook, catálogos de endereços do Android e clientes de email criam arquivos VCF para exportação, compartilhamento ou backup. VCF oferece suporte a quebra de linhas, caracteres de escape, parâmetros de campo como TYPE=CELL e propriedades específicas de aplicativos X-. Sua sintaxe baseada em linhas é portátil, mas muitos sistemas que processam dados hierárquicos precisam de XML.

O que é XML

XML representa dados com elementos aninhados, atributos e texto. XML parsers padrão podem lê-lo, e uma XML Schema Definition (XSD) pode validar sua estrutura, campos obrigatórios, tipos de dados e namespaces. XML não tem um schema universal para contatos, portanto o conversor deve produzir os nomes dos elementos e a hierarquia exigidos pelo aplicativo receptor.

Um resultado básico poderia usar <contacts>, <contact>, <fullName>, <phone> e <email>. O escape adequado de XML preserva caracteres como & e <; os atributos podem manter parâmetros VCF como CELL e WORK. O XML resultante só será útil se sua estrutura corresponder à documentação ou ao schema do software de destino.

Usando o conversor integrado

1. Abra 101convert.com e escolha a conversão de VCF para XML.
2. Selecione o arquivo de contatos com a extensão .vcf e inicie a conversão.
3. Baixe o arquivo .xml gerado.
4. Abra o XML em um navegador ou XML editor e verifique o número de contatos, nomes, números de telefone, endereços de email e campos especiais antes de importá-lo.

Esse método não requer instalação e é adequado quando o destino aceita a estrutura XML genérica do conversor. Arquivos de contatos podem conter informações pessoais; portanto, use um método local quando houver restrições de upload ou requisitos de confidencialidade.

Usando Python para uma estrutura definida

Use um script quando o destino exigir nomes exatos de elementos, namespaces, atributos ou um XSD. Instale o parser de vCard com python -m pip install vobject e salve o código a seguir como vcf_to_xml.py:

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

root = ET.Element("contacts")
with open("contacts.vcf", encoding="utf-8-sig") as source:
    for card in vobject.readComponents(source):
        contact = ET.SubElement(root, "contact")
        for name, properties in card.contents.items():
            for prop in properties:
                element = ET.SubElement(contact, name.lower())
                for parameter, values in prop.params.items():
                    if not isinstance(values, (list, tuple)):
                        values = [values]
                    element.set(parameter.lower(), ",".join(str(v) for v in values))
                value = prop.value
                if isinstance(value, bytes):
                    element.set("encoding", "base64")
                    element.text = base64.b64encode(value).decode("ascii")
                else:
                    element.text = str(value)

ET.ElementTree(root).write("contacts.xml", encoding="utf-8", xml_declaration=True)

Execute-o com python vcf_to_xml.py. O script cria uma estrutura genérica e preserva propriedades e parâmetros repetidos, mas não está automaticamente em conformidade com o schema de contatos de um fornecedor. Substitua os nomes gerados, adicione namespaces ou mapeie valores estruturados como N e ADR de acordo com o XSD ou a especificação de importação do destinatário.

Limites de qualidade e compatibilidade

Verifique a versão e a codificação da origem antes da conversão. Um parser deve processar linhas dobradas e pontuação com escape, mas campos personalizados, grupos de contatos, fusos horários, fotografias incorporadas e propriedades específicas de fornecedores podem ser omitados, achatados ou representados de forma diferente. Os campos estruturados de vCard também podem se tornar texto simples, a menos que o conversor mapeie explicitamente seus componentes.

Um XML bem-formado não é automaticamente um XML que pode ser importado. Valide a saída em relação ao XSD do destinatário quando houver um, ou compare-a com um arquivo de exemplo do aplicativo de destino. Não use uma planilha como método geral de conversão: importar VCF para o Excel ou outra planilha pode causar a perda de campos repetidos, parâmetros, fotos e valores multilinha, e uma exportação XML pode usar um schema específico de planilha em vez do schema de contatos exigido pelo destino.

Confirme que a entrada é um VCF de contatos. A mesma extensão é usada pelo Variant Call Format científico, que começa com metadados como ##fileformat=VCF e armazena variantes genômicas, não contatos; ele requer um schema XML e um conversor específicos para genômica.