Convertisseur en ligne gratuit de XML en VCARD

Un téléphone, un client de messagerie ou une application de carnet d’adresses peut nécessiter des contacts au format vCard (.vcf) plutôt qu’une exportation XML spécifique à une application. La conversion du fichier facilite l’importation, le partage, la modification et le transfert des contacts entre les appareils et les programmes pris en charge.

Qu’est-ce que XML ?

XML est un format texte basé sur des balises permettant de stocker et d’échanger des données hiérarchiques. Les fichiers XML de contacts peuvent être produits par des systèmes CRM, des clients de messagerie, des carnets d’adresses, des services web, des sauvegardes d’appareils et des bases de données personnalisées.

XML ne possède pas de schéma universel pour les contacts. Un fichier peut utiliser <contact>, <firstName> et <phone> ; un autre peut utiliser <person>, <given> et <telephoneNumber>. Avant la conversion, identifiez l’élément de contact répété ainsi que les champs contenant les noms, les adresses e-mail, les numéros de téléphone, les organisations, les adresses postales, les notes et les identifiants. Les espaces de noms et les éléments imbriqués peuvent également influer sur la détection des champs.

Qu’est-ce que le format vCard ?

vCard est un format texte brut standardisé pour les fiches de contact, généralement enregistré avec l’extension .vcf. Un fichier peut contenir un ou plusieurs contacts et peut être importé par des téléphones, des clients de messagerie, des carnets d’adresses, des systèmes CRM et des gestionnaires de contacts pour ordinateur.

Chaque fiche commence par BEGIN:VCARD et se termine par END:VCARD. Les propriétés courantes incluent FN pour le nom affiché, N pour les composants structurés du nom, TEL, EMAIL, ORG, ADR, NOTE et UID. vCard 3.0 est généralement le choix le plus sûr en matière de compatibilité ; vCard 4.0 prend en charge des fonctionnalités plus récentes, mais peut ne pas être importé correctement sur les anciens téléphones et dans les anciennes applications.

Comment convertir XML en vCard

Pour une exportation classique de contacts, utilisez le convertisseur de 101convert.com : téléversez le fichier XML, choisissez VCARD comme format de sortie, lancez la conversion, puis téléchargez le fichier .vcf obtenu. Aucune installation de logiciel n’est requise. Examinez le résultat avant de l’importer lorsque le fichier XML provient d’une application propriétaire.

Si la détection automatique des champs échoue, utilisez un éditeur XML, un programme de transformation de données ou un script personnalisé :

1. Ouvrez le fichier XML et localisez l’élément répété une fois pour chaque contact.
2. Associez les champs source aux propriétés vCard : le nom affiché à FN, les prénoms et noms de famille à N, les numéros de téléphone à TEL, les adresses e-mail à EMAIL, l’entreprise à ORG et les composants de l’adresse postale à ADR.
3. Choisissez vCard 3.0, sauf si l’application destinataire prend explicitement en charge vCard 4.0.
4. Générez un bloc vCard complet par contact et enregistrez tous les blocs dans un fichier UTF-8 tel que contacts.vcf.
5. Importez le fichier via le menu des contacts de l’application destinataire, généralement Contacts → Import ou File → Import.

Voici une fiche vCard 3.0 minimale :

BEGIN:VCARD
VERSION:3.0
N:Doe;Jane;;;
FN:Jane Doe
TEL;TYPE=CELL:+1-202-555-0147
EMAIL:jane.doe@example.com
ORG:Example Ltd
END:VCARD

Pour des conversions répétées, la bibliothèque standard de Python peut analyser une structure XML simple et générer des vCards. Modifiez les noms et les chemins des éléments pour les faire correspondre à la source :

import xml.etree.ElementTree as ET

def esc(value):
    return (value or "").replace("\\", "\\\\").replace(";", "\\;") \
        .replace(",", "\\,").replace("\r", "").replace("\n", "\\n")

root = ET.parse("contacts.xml").getroot()
blocks = []
for contact in root.findall(".//contact"):
    first = contact.findtext("firstName", "")
    last = contact.findtext("lastName", "")
    full = (first + " " + last).strip()
    name = ";".join((esc(last), esc(first), "", "", ""))
    lines = [
        "BEGIN:VCARD", "VERSION:3.0", f"N:{name}",
        f"FN:{esc(full)}"
    ]
    phone = contact.findtext("phone", "")
    email = contact.findtext("email", "")
    if phone:
        lines.append(f"TEL:{esc(phone)}")
    if email:
        lines.append(f"EMAIL:{esc(email)}")
    lines.append("END:VCARD")
    blocks.append("\r\n".join(lines))

with open("contacts.vcf", "w", encoding="utf-8", newline="") as output:
    output.write("\r\n".join(blocks) + "\r\n")

Exécutez-le avec python convert_contacts.py. Un script destiné à la production doit gérer les espaces de noms XML, les valeurs manquantes, plusieurs éléments de téléphone et d’e-mail, le repli des lignes vCard trop longues et l’échappement propre à chaque propriété. Il doit également attribuer des paramètres TYPE appropriés uniquement lorsque le fichier XML indique qu’un numéro est mobile, professionnel, personnel ou un numéro de fax.

Limites de qualité et de compatibilité

La qualité de la conversion dépend du schéma XML, et non de son extension de fichier. Un convertisseur ne peut pas déduire de manière fiable la signification d’un numéro non étiqueté, et les champs propriétaires peuvent ne posséder aucun équivalent vCard. Les photos, les groupes, les champs personnalisés, les autorisations, les fiches liées, les adresses multiples et les données de relations peuvent être supprimés ou transformés.

Conservez le fichier XML original comme sauvegarde. Testez un petit échantillon avant de convertir un carnet d’adresses volumineux, puis vérifiez les noms, l’encodage des caractères, les libellés des téléphones, les fiches en double, les textes non latins et les sauts de ligne après l’importation. La réimportation du même fichier .vcf peut créer des doublons, et certaines applications ne prennent en charge qu’un sous-ensemble des propriétés vCard 3.0 ou 4.0.