Convertidor online gratuito de VCARD a XML

Qué es vCard

vCard es un formato de contactos basado en texto que normalmente se almacena con la extensión .vcf. Cada registro está delimitado por BEGIN:VCARD y END:VCARD y puede contener nombres, números de teléfono, direcciones de correo electrónico, direcciones postales, organizaciones, fechas de nacimiento, fotografías, notas y propiedades personalizadas.

Los teléfonos, Microsoft Outlook, Apple Contacts, Google Contacts, Thunderbird, los sistemas de CRM y las aplicaciones de correo suelen crear o exportar vCards. Un archivo puede contener uno o muchos contactos. Las versiones 2.1, 3.0 y 4.0 difieren en la sintaxis de las propiedades, la codificación de caracteres, los parámetros y las funciones compatibles.

Qué es XML

XML es un formato de texto jerárquico que representa datos mediante elementos, atributos, namespaces y valores de texto. Admite la validación mediante un esquema XSD, consultas y transformaciones con herramientas XML, así como la integración con aplicaciones que definen un formato de importación XML.

XML no suele significar una única estructura universal para contactos. El formato estandarizado xCard, definido por RFC 6351, representa vCard 4.0 en XML, pero muchos programas requieren en su lugar un esquema propietario con nombres de elementos, namespaces y anidamiento diferentes. Confirme la documentación, el XSD o el XML de ejemplo de la aplicación receptora antes de elegir la estructura de salida.

Cómo convertir el archivo

Usar 101convert.com

En 101convert.com, seleccione la conversión de VCARD a XML, cargue el archivo .vcf, inicie la conversión y descargue el archivo .xml resultante. Esto es adecuado cuando la estructura XML del convertidor coincide con la del programa que realizará la importación y los datos de contacto pueden procesarse en línea; utilice un método local para las libretas de direcciones que deban permanecer en el dispositivo.

Abra el resultado en un editor compatible con XML y compruebe que está bien formado. Una descarga correcta no garantiza que el programa de destino acepte el esquema o conserve todas las propiedades de vCard.

Convertir localmente con Python

Para datos privados o procesamiento repetible, analice la vCard con el paquete vobject en lugar de reemplazar líneas mecánicamente. El siguiente script crea una estructura XML personalizada sencilla y conserva cada nombre de propiedad, conjunto de parámetros y representación de texto de su 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)

Guárdelo como vcard_to_xml.py y ejecútelo con Python 3.9 o una versión posterior:

python vcard_to_xml.py contacts.vcf contacts.xml

Esto produce elementos como <contacts>, <contact> y <property name="tel">. Es un punto de partida, no un formato de importación universal. Cambie los nombres de los elementos, el namespace, la representación de los parámetros, el formato de las fechas y el tratamiento de los valores estructurados para que coincidan con el esquema de destino. Si el destino acepta xCard, implemente la asignación de elementos y namespaces de RFC 6351 en lugar de utilizar esta estructura personalizada.

Comprobaciones de calidad y compatibilidad

Un XML válido no es necesariamente un XML compatible. Los importadores pueden requerir un elemento raíz, namespace, anidamiento de contactos, nombres de campos, sintaxis de tipos de teléfono y correo electrónico, formato de fecha o versión de xCard específicos. Valide el resultado con el XSD proporcionado cuando exista y pruébelo con una copia de la libreta de direcciones de destino.

Utilice un parser de vCard para gestionar líneas plegadas, valores quoted-printable, texto UTF-8, caracteres escapados, parámetros de propiedades, propiedades repetidas y reglas específicas de cada versión. Una conversión línea por línea puede dañar notas multilínea, nombres que no sean ASCII, etiquetas telefónicas o direcciones.

El script de ejemplo convierte los valores en texto y puede no conservar toda la semántica de campos estructurados como ADR y ORG, fotografías binarias, pertenencia a grupos, zonas horarias, campos privados o extensiones del proveedor. Revise los registros que contengan varios números de teléfono, direcciones de correo electrónico repetidas, fotografías y notas. Si deben conservarse todas las funciones de vCard, utilice un esquema xCard o del proveedor documentado y conserve el archivo .vcf original como copia de seguridad autorizada.