Les bases de vCard 4.0 : le format text/vcard pour échanger des contacts

Ce que c'est

Une vCard (RFC 6350, type de média text/vcard) est une séquence de lignes de contenu terminées par CRLF entre BEGIN:VCARD et END:VCARD, chacune de la forme NAME;PARAM=value:value. VERSION:4.0 doit suivre immédiatement BEGIN:VCARD ; FN (le nom d'affichage formaté) est la seule autre propriété obligatoire. N porte le nom structuré sous forme de cinq composants séparés par des points-virgules (noms de famille ; prénoms ; autres noms ; préfixes honorifiques ; suffixes honorifiques). TEL, EMAIL, ADR, URL, ORG, TITLE, PHOTO, BDAY, NOTE, UID et REV sont facultatives, la plupart répétables, avec des paramètres TYPE (work, home) et PREF pour les distinguer et les classer. Le jeu de caractères est UTF-8 et ne peut pas être remplacé ; une virgule, un point-virgule ou une barre oblique inverse à l'intérieur d'une valeur est échappé par une barre oblique inverse ; les lignes de contenu devraient être repliées à 75 octets en insérant CRLF plus un caractère d'espacement. La RFC 7095 définit jCard, le même modèle de données sous forme de structure de tableau JSON.

Pourquoi c'est important

Les vCards circulent via les codes QR, les signatures d'e-mail, la synchronisation CardDAV et les imports CRM. La plupart des échecs sont d'ordre formel : un FN manquant, une virgule non échappée dans un nom d'entreprise qui scinde la valeur, une syntaxe de la version 3.0 mélangée à des paramètres de la 4.0, ou une photo intégrée en base64 de plusieurs mégaoctets qu'aucun code QR ne peut contenir.

Comment l'appliquer

• Émettre au minimum VERSION:4.0, FN et N ; construire N à partir de champs structurés plutôt que de scinder un nom d'affichage sur les espaces, ce qui échoue pour de nombreuses conventions de nommage.
• Écrire TEL comme une URI tel: sous forme internationale (TEL;TYPE=work;VALUE=uri:tel:+41…), EMAIL avec un TYPE, et ADR avec ses sept composants dans l'ordre (boîte postale ; adresse étendue ; rue ; localité ; région ; code postal ; pays), en laissant les composants vides sous forme de chaînes vides entre les points-virgules.
• Définir UID (une URN ou une URL stable par contact) et REV (un horodatage) afin que les clients qui se synchronisent mettent à jour plutôt que de dupliquer.
• Référencer les photos par URL dans les cartes destinées aux codes QR ; ne les intégrer que dans les fichiers échangés directement.
• Valider en important dans deux applications de contacts différentes ; les erreurs d'échappement et de repliement se manifestent par des champs tronqués ou fusionnés.

Pièges

Supposer que tout importateur comprend la 4.0 : beaucoup attendent encore les conventions de la 3.0, il faut donc s'en tenir à des propriétés et des orthographes de paramètres largement prises en charge. Des fins de ligne converties en LF par un éditeur de texte. Un ordre de nom occidental fixe dans FN pour des noms qui ne le suivent pas. Stocker les contacts avec la vCard comme source de vérité, au lieu de champs structurés qui la génèrent.