vCard

vCard est un format standard ouvert d'échange de données personnelles (Visit Card soit Carte de visite).

La version 4.0 de 2011 de vCard est définie par les RFC 6350 et 6868. La version précédente est le vCard 3.0 de 1998. Les différences entre ces formats sont exposées en Annexe de la RFC^[1].

L'un ou l'autre de ces formats sont utilisés par le logiciel Carnet d'adresses d'Apple ou encore les logiciels de courrier électronique comme Mozilla Thunderbird ou Outlook Express. vCard est également utilisé par des appareils mobiles (téléphones mobiles, assistants personnels, GPS) pour échanger des éléments de carnet d'adresses, mais aussi par des logiciels de messagerie instantanée comme Jabber ou Skype.

Format

Le fichier vCard est un format de carnet d'adresses qui peut contenir une ou plusieurs adresses. Lorsqu'il n'en contient qu'une seule, on parle plus naturellement de carte de visite.

Un fichier vCard porte une extension vcf (sigle pour Virtual Card File). Son contenu est lisible par n'importe quel éditeur de texte.

Il est utile pour donner ses coordonnées personnelles ou professionnelles à une relation.

Historique


Version	Année	Publication
4.0	2011 (août)	RFC 6350^[2] et 6868^[3]
3.0	1998 (septembre)	RFC 2425^[4] et 2426^[5]
2.1	1996 (septembre)	vCard 2.1 par Internet Mail Consortium Source IMC : http://www.imc.org/pdi/vcard-21.txt Source Internet Archive : vcard-21.txt^[6] vcard-21.doc^[7] (avec liens et mise en page) Anecdote : Transfert de propriété de Versit à IMC ^[8]
1.0	1990	versit consortium Source externe : CalConnect ^[9]

Exemples

L'exemple suivant est un fichier avec une adresse unique.

Exemples : Jean_Dupont.vcf

vCard 2.1 (1996) :

BEGIN:VCARD
VERSION:2.1
FN:Jean Dupont
N:Dupont;Jean
ADR;WORK;PREF;QUOTED-PRINTABLE:;Bruxelles 1200=Belgique;6A Rue Th. Decuyper
LABEL;QUOTED-PRINTABLE;WORK;PREF:Rue Th. Decuyper 6A=Bruxelles 1200=Belgique
TEL;CELL:+1234 56789
EMAIL;INTERNET:jean.dupont@example.com
UID:
END:VCARD

vCard 3.0 (1998) :

BEGIN:VCARD
VERSION:3.0
N:Gump;Forrest
FN:Forrest Gump
ORG:Bubba Gump Shrimp Co.
TITLE:Shrimp Man
PHOTO;VALUE=URL;TYPE=GIF:http://www.example.com/dir_photos/my_photo.gif
TEL;TYPE=WORK;VOICE:(111) 555-1212
TEL;TYPE=HOME;VOICE:(404) 555-1212
ADR;TYPE=WORK:;;100 Waters Edge;Baytown;LA;30314;United States of America
LABEL;TYPE=WORK:100 Waters Edge\nBaytown, LA 30314\nUnited States of America
ADR;TYPE=HOME:;;42 Plantation St.;Baytown;LA;30314;United States of America
LABEL;TYPE=HOME:42 Plantation St.\nBaytown, LA 30314\nUnited States of America
EMAIL;TYPE=PREF,INTERNET:forrestgump@example.com
REV:20080424T195243Z
END:VCARD

vCard 4.0 (2011) :

BEGIN:VCARD
VERSION:4.0
N:Gump;Forrest;;Mr.;
FN:Forrest Gump
ORG:Bubba Gump Shrimp Co.
TITLE:Shrimp Man
PHOTO;MEDIATYPE=image/gif:http://www.example.com/dir_photos/my_photo.gif
TEL;TYPE=work,voice;VALUE=uri:tel:+1-111-555-1212
TEL;TYPE=home,voice;VALUE=uri:tel:+1-404-555-1212
ADR;TYPE=WORK;PREF=1;LABEL="100 Waters Edge\nBaytown\n, LA 30314\nUnited States of America":;;100 Waters Edge;Baytown;LA;30314;United States of America
ADR;TYPE=HOME;LABEL="42 Plantation St.\nBaytown\, LA 30314\nUnited States of America":;;42 Plantation St.;Baytown;LA;30314;United States of America
EMAIL:forrestgump@example.com
REV:20080424T195243Z
x-qq:21588891
END:VCARD

Un carnet d'adresses continuerait avec de nouvelles cartes commençant par BEGIN:VCARD et se terminant par END:VCARD.

Propriétés

Le format vCard implémente les types de propriétés suivants. Toute vCard commence par BEGIN:VCARD et se termine par END:VCARD. Toute vCard doit contenir la propriété VERSION, qui définit la version de la vCard. VERSION doit apparaître immédiatement après BEGIN, excepté dans le standard vCard 2.1 où elle peut apparaître n'importe où. Toutes les autres propriétés sont facultatives selon les versions et peuvent être définies dans n'importe quel ordre.

Nom	Présence			Traduction	Description	Propriétés	Exemple
Nom	v. 2.1	v. 3.0	v. 4.0	Traduction	Description	Propriétés	Exemple
`ADR`	Optionnel	Optionnel	Optionnel	Adresse de livraison (Delivery Address)	Une représentation structurée de l'adresse physique de livraison associé à l'objet vCard	Champs textes séparés par des points-virgules : Boîte postale, Adresse étendue, Nom de rue, Ville, Région (ou état/province), Code postal et Pays	`ADR;TYPE=home:;;3 rus des Lys;Lyon;12;12345;France`
`AGENT`	Optionnel	Optionnel	Non défini	Agent (Agent)	Informations à propos d'une autre personne qui agira au nom de la personne associée à la vCard. Généralement, cela peut être un administrateur, un assistant ou un secrétaire de l'individu de la vCard.	Une autre vCard ou une URI vers la vCard de l'Agent	`AGENT:http://mi6.gov.uk/007`
`ANNIVERSARY`	Non défini	Optionnel	Optionnel	Date de mariage (Anniversary)	Date de mariage de l'individu	Date au format AAAAMMJJ ou ISO 8601	`ANNIVERSARY:19901021`
`BDAY`	Optionnel	Optionnel	Optionnel	Date de naissance (Birthday)	Date de naissance de l'individu associé à la vCard	Date au format AAAAMMJJ ou ISO 8601	`BDAY:19700310`
`BEGIN`	Requis	Requis	Requis	Début (Begin)	Toute vCard doit commencer par cette propriété	Unique champ texte	`BEGIN:VCARD`
`CALADRURI`	Non défini	Non défini	Optionnel	URI de l'adresse du calendrier (Calendar adress URI)	URL à utiliser pour envoyer une nouvelle planification sur le calendrier d'un individu	Une unique URI	`CALADRURI:http://example.com/calendar/jdoe`
`CALURI`	Non défini	Non défini	Optionnel	URI du calendrier (Calendar URI)	URL vers le calendrier de l'individu	Une unique URI	`CALURI:http://example.com/calendar/jdoe`
`CATEGORIES`	Optionnel	Optionnel	Optionnel	Catégorie (Category)	Catégories applicables à la vCard	Champs textes séparés par des virgules représentant chacun une catégorie	`CATEGORIES:nageur, cycliste`
`CLASS`	Non défini	Optionnel	Non défini	Classe (Class)	Sensibilité des informations contenues dans la vCard	Unique champ texte (PUBLIC, PRIVATE ou CONFIDENTIAL)	`CLASS:public`
`CLIENTPIDMAP`	Non défini	Non défini	Optionnel	Carte PID client (Client PID map)	Utilisé pour synchroniser différentes versions d'une même vCard	Entier et URI séparés d'un point virgule	`CLIENTPIDMAP:1;urn:uuid:3df403f4-5924-4bb7-b077-3c711d9eb34b`
`EMAIL`	Optionnel	Optionnel	Optionnel	Email (Email)	L'adresse email associée à l'objet vCard	Unique champ texte	`EMAIL:johndoe@hotmail.com`
`END`	Requis	Requis	Requis	Fin (End)	Toute vCard doit finir par cette propriété	Unique champ texte	`END:VCARD`
`FBURL`	Non défini	Non défini	Optionnel	URL Dipo/Occupé (Free/Busy URL)	URL montrant quand l'individu est "disponible" ou "occupé" sur son calendrier	Une unique URI	`FBURL:http://example.com/fb/jdoe`
`FN`	Optionnel	Requis	Requis	Nom formaté (Formatted Name)	La chaîne formatée représentant le nom associé à l'objet vCard	Unique champ texte	`FN:Dr. John Doe`
`GENDER`	Non défini	Non défini	Optionnel	Genre (Gender)	Genre de l'individu	Unique caractère ('','M','F','O','N','U') puis unique champ texte facultatif séparés d'un point virgule	`GENDER:F`
`GEO`	Optionnel	Optionnel	Optionnel	Géopositionnement (Global Positioning)	Propriété indiquant la latitude et la longitude	Latitude et Longitude en décimale séparées par un point-virgule	2.1, 3.0: `GEO:39.95;-75.1667` 4.0: `GEO:geo:39.95,-75.1667`
`IMPP`	Non défini	Non défini	Optionnel	Messagerie Instantanée et Protocole de Présence (Instant Messaging and Presence Protocol)	URL vers la messagerie instantanée de l'individu	Une unique URI	`IMPP:aim:johndoe@aol.com`
`KEY`	Optionnel	Optionnel	Optionnel	Clé publique (Public Key)	La clé publique de chiffrement associée à l'objet vCard	Unique champ binaire ou texte	2.1: `KEY;PGP:http://example.com/key.pgp` 2.1: `KEY;PGP;ENCODING=BASE64:[base64-data]` 3.0: `KEY;TYPE=PGP:http://example.com/key.pgp` 3.0: `KEY;TYPE=PGP;ENCODING=b:[base64-data]` 4.0: `KEY;MEDIATYPE=application/pgp-keys:http://example.com/key.pgp` 4.0: `KEY:data:application/pgp-keys;base64,[base64-data]`
`KIND`	Non défini	Non défini	Optionnel	Type (Kind)	Le type d'objet représenté par la vCard	Unique champ texte ('individual', 'group', 'organization' ou 'location')	`KIND:individual`
`LABEL`	Optionnel	Optionnel	Remplacé	Libellé de l'adresse (Label Address)	Libellé de l'adresse physique de livraison de la personne ou de l'objet associé à la vCard. En 4.0, cette information est stockée sous forme de paramètre de la propriété `ADR`	Unique champ texte	`LABEL;TYPE=HOME:123 Main St.\nSpringfield, IL 12345\nUSA`
`LANG`	Non défini	Non défini	Optionnel	Langue (Language)	Langue utilisée par l'individu	Unique champ langage	`LANG:fr-FR`
`LOGO`	Optionnel	Optionnel	Optionnel	Logo (Logo)	Une illustration ou le logo de l'organisation associé à l'individu de l'objet vCard	Une URI vers une ressource externe ou le contenu binaire de l'image (en précisant encodage et type)	2.1: `LOGO;PNG:http://example.com/logo.png` 2.1: `LOGO;PNG;ENCODING=BASE64:[base64-data]` 3.0: `LOGO;TYPE=PNG:http://example.com/logo.png` 3.0: `LOGO;TYPE=PNG;ENCODING=b:[base64-data]` 4.0: `LOGO;MEDIATYPE=image/png:http://example.com/logo.png` 4.0: `LOGO:data:image/png;base64,[base64-data]`
`MAILER`	Optionnel	Optionnel	Non défini	Programme de mailing (Email Program) (Optionnel)	Le type de programme de mailing utilisé	Unique champ texte	`MAILER:Thunderbird`
`MEMBER`	Non défini	Non défini	Optionnel	Membre (Member)	Membre du groupe. Propriété utilisable uniquement si la propriété `KIND` est définie sur "group"	Une unique URI (vers une vCard ou un "mailto")	`MEMBER:urn:uuid:03a0e51f-d1aa-4385-8a53-e29025acd8af`
`N`	Requis	Requis	Optionnel	Nom (Name)	Une représentation structurée du nom de la personne, du lieu ou de la chose associée à l'objet vCard	Champs textes séparés par des points-virgules : Nom de Famille, Prénom(s), Nom(s) additionnel(s), Titre(s) (D^r, P^r, ...), Suffixe(s) (Jr., M.D.). Les champs peuvent contenir eux-mêmes plusieurs valeurs séparées par des virgules.	`N:Doe;John;;Dr;`
`NAME`	Non défini	Optionnel	Non défini	Nom (Name)	Une représentation textuelle de la propriété `SOURCE`
`NICKNAME`	Non défini	Optionnel	Optionnel	Surnom (Nickname)	Un nom descriptif ou familier donné à la place ou en addition du nom de la personne, du lieu ou de la chose associé	Un ou plusieurs champs textes séparés par des virgules	`NICKNAME:Jon,Johnny`
`NOTE`	Optionnel	Optionnel	Optionnel	Note (Note)	Spécifie des informations supplémentaires ou un commentaire qui est associée à la vCard	Unique champ texte	`NOTE:Je connais la technique du tigre et de la grue, \ net je suis plus que compétent dans l'art exquis de l'épée de samouraï.`
`ORG`	Optionnel	Optionnel	Optionnel	Nom ou département de l'organisation (Organization Name or Organizational unit)	Le nom et optionnellement le ou les département(s) associé(s) à l'objet vCard. Cette propriété est basée sur les propriétés du Nom et du Département de l'organisation dans la norme X.520.	Champs textes séparés par des points-virgules : de l'entité la plus englobante à gauche à l'entité la plus précise au sein de l'organisation à droite.	`ORG:Google;Équipe GMail;Détection des spams`
`PHOTO`	Optionnel	Optionnel	Optionnel	Photographie (Photograph)	Une illustration ou une photographie de l'individu associé à la vCard	Une URI vers une ressource externe ou le contenu binaire de l'image (en précisant encodage et type)	2.1: `PHOTO;JPEG:http://example.com/photo.jpg` 2.1: `PHOTO;JPEG;ENCODING=BASE64:[base64-data]` 3.0: `PHOTO;TYPE=JPEG;VALUE=URI:http://example.com/photo.jpg` 3.0: `PHOTO;TYPE=JPEG;ENCODING=b:[base64-data]` 4.0: `PHOTO;MEDIATYPE=image/jpeg:http://example.com/photo.jpg` 4.0: `PHOTO:data:image/jpeg;base64,[base64-data]`
`PRODID`	Non défini	Optionnel	Optionnel	Identifiant (Product Identifier)		Unique champ texte	`PRODID:-//ONLINE DIRECTORY//NONSGML Version 1//EN`
`PROFILE`	Optionnel	Optionnel	Non défini	Profil (Profile)	Indique que la vCard est une vCard	Unique champ texte	`PROFILE:VCARD`
`RELATED`	Non défini	Non défini	Optionnel	Associé (Related)	Entité reliée à l'individu	Une unique URI (vers une vCard ou un "mailto")	`RELATED;TYPE=ami:urn:uuid:03a0e51f-d1aa-4385-8a53-e29025acd8af`
`REV`	Optionnel	Optionnel	Optionnel	Dernière révision (Last Revision)	Combinaison de la date du calendrier et l'heure du jour de la dernière mise à jour à l'objet vCard	Date/heure, par exemple 20171231T235900Z	`REV:20121201T134211Z`
`ROLE`	Optionnel	Optionnel	Optionnel	Fonction (Role or occupation)	Le rôle, la profession ou la catégorie de métier de l'objet vCard au sein d'une organisation	Unique champ texte	`ROLE:Directeur`
`SORT-STRING`	Non défini	Optionnel	Remplacé	Texte pour le tri (Sort string)	La chaîne qui sera utilisée pour trier le nom de l'objet (exemple : "Croix" pour "de la Croix") En 4.0, cette information est stockée dans le paramètre `SORT-AS` des propriétés `N` et/ou `ORG`	Unique champ texte	`SORT-STRING:Doe`
`SOUND`	Optionnel	Optionnel	Optionnel	Son (Sound)	Par défaut, si cette propriété n'est pas regroupée avec les autres propriétés, elle précise la prononciation de la propriété `FN` (Formatted Name) de l'objet vCard.	Une URI vers une ressource externe ou le contenu binaire du fichier (en précisant encodage et type)	2.1: `SOUND;OGG:http://example.com/sound.ogg` 2.1: `SOUND;OGG;ENCODING=BASE64:[base64-data]` 3.0: `SOUND;TYPE=OGG:http://example.com/sound.ogg` 3.0: `SOUND;TYPE=OGG;ENCODING=b:[base64-data]` 4.0: `SOUND;MEDIATYPE=audio/ogg:http://example.com/sound.ogg` 4.0: `SOUND:data:audio/ogg;base64,[base64-data]`
`SOURCE`	Optionnel	Optionnel	Optionnel	Source (Source)	URI vers la dernière version de la vCard	Une unique URI	`SOURCE:http://johndoe.com/vcard.vcf`
`TEL`	Optionnel	Optionnel	Optionnel	Téléphone (Telephone)	La chaîne du numéro de téléphone pour les appels vocaux associée à l'objet vCard	Unique champ texte	`TEL;TYPE=cell:(+33)612345678`
`TITLE`	Optionnel	Optionnel	Optionnel	Titre (Title)	Indique le titre du poste, de la fonction ou de la personne associée à l'objet vCard au sein d'une organisation	Unique champ texte	`TITLE:V.P. Recherche et développement`
`TZ`	Optionnel	Optionnel	Optionnel	Fuseau horaire (Time Zone)	Indication du fuseau horaire courant de l'objet vCard	Décalage à l'UTC au format +05:30 ou -02:00	2.1, 3.0: `TZ:-0500` 4.0: `TZ:America/New_York`
`UID`	Optionnel	Optionnel	Optionnel	Identifieur unique (Unique Identifier)	Indique une valeur qui représente un identifieur unique, persistant et global associé à l'objet vCard	Unique champ texte	`UID:urn:uuid:da418720-3754-4631-a169-db89a02b831b`
`URL`	Optionnel	Optionnel	Optionnel	URL (URL)	Le lien internet permettant d'obtenir les informations mises à jour en temps-réel de l'objet vCard	Une unique URI	`URL:http://www.johndoe.com`
`VERSION`	Requis	Requis	Requis	Version (Version)	Version de la spécification vCard	Unique champ texte	`VERSION:4.0`
`XML`	Non défini	Non défini	Optionnel	XML (XML)	Toute donnée XML attachée à la vCard. Utilisé si la vCard est codé en XML (xCard) et si le document XML contient des informations non spécifiées dans le standard xCard	Unique champ texte XML	`XML:<b>Ceci n'est pas un élément xCard</b>`

Voir aussi

ICalendar

Notes

↑ Appendix A. Differences from RFCs 2425 and 2426
↑ (en) Simon Perreault, « Request for Comments: 6350 » [html], sur Internet Engineering Task Force, août 2011 (consulté le 15 juin 2023)
↑ (en) Pedro Marques, « Request for Comments: 6368 » [html], sur Internet Engineering Task Force, septembre 2011 (consulté le 15 juin 2023)
↑ (en) Tim Howes, Mark Smith, Frank Dawson, « Request for Comments: 2425 » [html], sur Internet Engineering Task Force, septembre 1998 (consulté le 15 juin 2023)
↑ (en) Frank Dawson, Tim Howes, « Request for Comments: 2426 » [html], sur Internet Engineering Task Force, septembre 1998 (consulté le 15 juin 2023)
↑ https://web.archive.org/web/20000815081252/http://www.imc.org/pdi/vcard-21.txt
↑ « Wayback Machine », sur Internet Archive (consulté le 24 juin 2023).
↑ « PDI Transfer Press Release », sur Internet Archive (consulté le 24 juin 2023).
↑ (en) « Introduction », sur calconnect.org (consulté le 24 juin 2023).

Liens externes

(en) RFC 2425, obsolète
(en) RFC 2426, obsolète
(en) RFC 6350 (2011)
(fr) Exporter et Importer le Carnet d'adresses vCard d'un téléphone vers une autre application
(fr) RFC:6350, rfc:6350

Portail de l’informatique

[1] Appendix A. Differences from RFCs 2425 and 2426

[2] (en) Simon Perreault, « Request for Comments: 6350 » [html], sur Internet Engineering Task Force, août 2011 (consulté le 15 juin 2023)

[3] (en) Pedro Marques, « Request for Comments: 6368 » [html], sur Internet Engineering Task Force, septembre 2011 (consulté le 15 juin 2023)

[4] (en) Tim Howes, Mark Smith, Frank Dawson, « Request for Comments: 2425 » [html], sur Internet Engineering Task Force, septembre 1998 (consulté le 15 juin 2023)

[5] (en) Frank Dawson, Tim Howes, « Request for Comments: 2426 » [html], sur Internet Engineering Task Force, septembre 1998 (consulté le 15 juin 2023)

[6] ttps://web.archive.org/web/20000815081252/http://www.imc.org/pdi/vcard-21.txt

[7] « Wayback Machine », sur Internet Archive (consulté le 24 juin 2023).

[8] « PDI Transfer Press Release », sur Internet Archive (consulté le 24 juin 2023).

[9] (en) « Introduction », sur calconnect.org (consulté le 24 juin 2023).

[1]

[2]

[3]

[4]

[5]

[6]

[7]

[8]

[9]