Conversor online gratuito de XML para VCF

Telefones e clientes de email frequentemente importam contatos como arquivos vCard, enquanto um programa de backup ou gerenciamento de contatos pode fornecer apenas uma exportação XML. A conversão da exportação produz um arquivo .vcf que pode ser importado, compartilhado ou editado em aplicativos que não entendem o schema XML original.

O que é o formato XML

XML é um formato estruturado baseado em tags usado por aplicativos de agenda de endereços, ferramentas de backup para dispositivos móveis, sistemas CRM e bancos de dados personalizados. Ele pode armazenar nomes, números de telefone, endereços de email, endereços postais, grupos, notas, fotos e metadata específica do aplicativo.

XML não define uma estrutura universal de contatos. Um aplicativo pode usar <firstName> e <lastName>, enquanto outro usa <given>, <family> ou elementos aninhados, como <phone><number>. Um conversor precisa reconhecer o schema do programa de origem; um documento XML arbitrário não é automaticamente uma lista de contatos.

O que é o formato VCF

VCF, também chamado de vCard, é um formato de texto para um ou mais cartões de contato eletrônicos. As propriedades padrão incluem nomes, números de telefone, endereços de email, organizações, cargos, endereços postais, datas de nascimento, notas, sites e fotografias.

Telefones, agendas de endereços para desktop, clientes de email e softwares de gerenciamento de contatos geralmente oferecem suporte a VCF. Um arquivo pode conter um contato ou vários, representados por blocos repetidos BEGIN:VCARD e END:VCARD. O programa de destino também pode aceitar arquivos .vcf separados para contatos individuais.

vCard 3.0 costuma ser a versão de saída mais segura para aplicativos antigos e novos. vCard 4.0 oferece suporte a recursos mais recentes, mas não é aceito por todos os importadores; use a versão exigida pelo programa de destino quando houver uma especificação.

Como converter XML em VCF

Se o aplicativo de origem puder exportar diretamente para vCard, use o comando File → Export → vCard em vez de converter um arquivo XML intermediário. Isso geralmente preserva mais campos e categorias de contatos do que um conversor genérico.

Use o conversor em 101convert.com

1. Abra o conversor de XML para VCF em 101convert.com.
2. Selecione o arquivo XML que contém os contatos.
3. Inicie a conversão e salve o arquivo .vcf gerado.
4. Abra o telefone ou programa de contatos de destino e escolha o comando de importação de contatos, como Contacts → Import.

Esse método funciona quando o XML usa um schema de contatos compatível e não requer software instalado. Como os arquivos de contatos podem conter informações privadas, use um método offline quando os dados não puderem sair do computador.

Mapeie um arquivo XML proprietário com software para desktop ou um script

Para uma exportação XML de um aplicativo proprietário, primeiro identifique os elementos que contêm cada contato. Um editor de texto ou visualizador XML pode mostrar se os contatos se repetem em caminhos como .//contact ou .//person e se o documento usa um namespace XML.

Um script de conversão pode então mapear esses elementos para propriedades vCard: escreva N para nomes de família e nomes próprios estruturados, FN para o nome de exibição, uma linha TEL para cada número de telefone e uma linha EMAIL para cada endereço de email. A biblioteca padrão xml.etree.ElementTree do Python pode analisar o XML e gravar texto UTF-8 em um arquivo como contacts.vcf. Ajuste os caminhos dos elementos e os mapeamentos de namespace para corresponder ao schema de origem.

Ao usar um gerenciador de contatos ou organizador para desktop, importe o XML somente se a documentação dele listar exatamente esse formato XML. Um aplicativo que oferece suporte a XML em geral ainda pode rejeitar uma exportação de contatos criada por outro programa.

Limitações de qualidade e compatibilidade

• O mapeamento de campos depende do schema: a conversão automática pode omitir grupos, campos de relacionamento, metadata personalizada, categorias ou identificadores específicos do aplicativo.
• Valores repetidos precisam de propriedades separadas: vários números de telefone e endereços de email devem se tornar linhas TEL e EMAIL separadas, não um único campo separado por vírgulas.
• Caracteres especiais precisam de escape: vírgulas, ponto e vírgula, barras invertidas e quebras de linha têm significados especiais em valores de texto vCard. Um conversor válido deve aplicar escape a eles e usar as terminações de linha vCard exigidas.
• A codificação afeta nomes e notas: UTF-8 preserva caracteres acentuados, cirílicos, árabes e asiáticos, mas o importador de destino ainda pode exibi-los incorretamente.
• As fotos podem não ser transferidas: o XML pode conter um caminho de imagem, URL ou valor binário codificado, enquanto o VCF geralmente precisa de dados de imagem incorporados com o tipo de mídia correto.
• Duplicatas e registros perdidos são possíveis: compare o número de contatos de origem e importados, verifique nomes, números de telefone e endereços de email e teste uma cópia pequena antes de importar toda a agenda de endereços.
• CSV é apenas um intermediário opcional: ele pode ajudar quando um programa de contatos oferece suporte à importação e exportação de CSV, mas costuma perder fotos, grupos, notas e campos com vários valores.