Convertisseur en ligne gratuit de VCARD en XML

Qu’est-ce que vCard ?

vCard est un format de contacts textuel généralement stocké avec l’extension .vcf. Chaque enregistrement est délimité par BEGIN:VCARD et END:VCARD et peut contenir des noms, des numéros de téléphone, des adresses e-mail, des adresses postales, des organisations, des dates d’anniversaire, des photographies, des notes et des propriétés personnalisées.

Les téléphones, Microsoft Outlook, Apple Contacts, Google Contacts, Thunderbird, les systèmes de CRM et les applications de messagerie créent ou exportent couramment des vCards. Un fichier peut contenir un ou plusieurs contacts. Les versions 2.1, 3.0 et 4.0 diffèrent par la syntaxe des propriétés, l’encodage des caractères, les paramètres et les fonctionnalités prises en charge.

Qu’est-ce que XML ?

XML est un format textuel hiérarchique qui représente les données à l’aide d’éléments, d’attributs, d’espaces de noms et de valeurs textuelles. Il permet la validation selon un schéma XSD, l’interrogation et la transformation avec des outils XML, ainsi que l’intégration avec des applications qui définissent un format d’importation XML.

XML ne désigne généralement pas une structure universelle pour les contacts. Le format standardisé xCard, défini par la RFC 6351, représente vCard 4.0 en XML, mais de nombreux programmes exigent plutôt un schéma propriétaire avec des noms d’éléments, des espaces de noms et une imbrication différents. Consultez la documentation, le XSD ou un exemple XML de l’application destinataire avant de choisir la structure de sortie.

Comment convertir le fichier

Utiliser 101convert.com

Sur 101convert.com, sélectionnez la conversion VCARD-to-XML, importez le fichier .vcf, démarrez la conversion, puis téléchargez le fichier .xml obtenu. Cette méthode convient lorsque la structure XML du convertisseur correspond à celle du programme d’importation et que les données des contacts peuvent être traitées en ligne ; utilisez une méthode locale pour les carnets d’adresses qui doivent rester sur l’appareil.

Ouvrez la sortie dans un éditeur compatible avec XML et vérifiez qu’elle est bien formée. Un téléchargement réussi ne garantit pas que le programme de destination acceptera le schéma ou conservera toutes les propriétés vCard.

Convertir localement avec Python

Pour les données privées ou les traitements répétables, analysez la vCard avec le package vobject au lieu de remplacer mécaniquement les lignes. Le script suivant crée une structure XML personnalisée simple et conserve chaque nom de propriété, ensemble de paramètres et représentation textuelle de sa valeur :

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)

Enregistrez-le sous le nom vcard_to_xml.py et exécutez-le avec Python 3.9 ou une version ultérieure :

python vcard_to_xml.py contacts.vcf contacts.xml

Le script produit des éléments tels que <contacts>, <contact> et <property name="tel">. Il s’agit d’un point de départ, et non d’un format d’importation universel. Modifiez les noms d’éléments, l’espace de noms, la représentation des paramètres, le format des dates et la gestion des valeurs structurées afin de les adapter au schéma de destination. Si la destination accepte xCard, implémentez le mappage des éléments et de l’espace de noms de la RFC 6351 au lieu d’utiliser cette structure personnalisée.

Contrôles de qualité et de compatibilité

Un XML valide n’est pas nécessairement un XML compatible. Les importateurs peuvent exiger un élément racine, un espace de noms, une imbrication des contacts, des noms de champs, une syntaxe particulière pour les types de téléphones et d’adresses e-mail, un format de date ou une version xCard précis. Validez le résultat avec le XSD fourni lorsqu’il existe et testez-le avec une copie du carnet d’adresses de destination.

Utilisez un analyseur vCard pour gérer les lignes repliées, les valeurs quoted-printable, le texte UTF-8, les caractères d’échappement, les paramètres de propriétés, les propriétés répétées et les règles propres à chaque version. Une conversion ligne par ligne peut altérer les notes multilignes, les noms comportant des caractères non ASCII, les libellés de téléphone ou les adresses.

Le script d’exemple convertit les valeurs en texte et peut ne pas conserver toute la sémantique des champs structurés tels que ADR et ORG, des photographies binaires, de l’appartenance à des groupes, des fuseaux horaires, des champs privés ou des extensions de fournisseurs. Examinez les enregistrements contenant plusieurs numéros de téléphone, des adresses e-mail répétées, des photographies et des notes. Si toutes les fonctionnalités vCard doivent être conservées, utilisez un schéma xCard ou un schéma fournisseur documenté et conservez le fichier .vcf original comme sauvegarde de référence.