vCard est un format numérique d'échange de données personnelles (abréviation de l'anglais visit card soit « carte de visite »), ouvert et défini par les RFC 6350 et 6868 (2011, version 4.0). Ce format est utilisé par les logiciels Contacts d'Apple, Mozilla Thunderbird de Mozilla, ou Outlook Express de Microsoft. vCard est également utilisé par les appareils mobiles (smartphones, téléphones mobiles, assistants personnels, GPS), ainsi que par les 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.
Historique +VersionAnnéePublication4.02011 (août) et 3.01998 (septembre) et 2.11996 (septembre)vCard 2.1 par – Source IMC : http://www.imc.org/pdi/vcard-21.txt – Source Internet Archive : vcard-21.txthttps://web.archive.org/web/20000815081252/http://www.imc.org/pdi/vcard-21.txt vcard-21.doc. (avec liens et mise en page) – Anecdote : Transfert de propriété de Versit à IMC.1.01990 – Source externe : CalConnect. Les différences entre les formats sont exposées en annexe de la RFC.
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:[email protected] 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:[email protected] 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:<nowiki>http://www.example.com/dir_photos/my_photo.gif</nowiki> 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:[email protected] REV:20080424T195243Z x-qq:21588891 END:VCARD
Un carnet d'adresses est constitué d'une suite de cartes commençant par BEGIN:VCARD et se terminant par END:VCARD.
Propriétés Le format vCard utilise 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.
NomPrésence Traduction Description PropriétésExemplev. 2.1v. 3.0v. 4.0ADR 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 PaysADR;TYPE=home:;;3 rus des Lys;Lyon;12;12345;FranceAGENT 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'AgentAGENT:http://mi6.gov.uk/007ANNIVERSARY Date de mariage (Anniversary)Date de mariage de l'individuDate au format AAAAMMJJ ou ISO 8601ANNIVERSARY:19901021BDAY Date de naissance (Birthday) Date de naissance de l'individu associé à la vCard Date au format AAAAMMJJ ou ISO 8601BDAY:19700310BEGIN Début (Begin)Toute vCard doit commencer par cette propriétéUnique champ texteBEGIN:VCARDCALADRURI URI de l'adresse du calendrier (Calendar adress URI)URL à utiliser pour envoyer une nouvelle planification sur le calendrier d'un individuUne unique URICALADRURI:http://example.com/calendar/jdoeCALURI URI du calendrier (Calendar URI)URL vers le calendrier de l'individuUne unique URICALURI:http://example.com/calendar/jdoeCATEGORIES Catégorie (Category) Catégories applicables à la vCard Champs textes séparés par des virgules représentant chacun une catégorieCATEGORIES:nageur, cyclisteCLASS Classe (Class)Sensibilité des informations contenues dans la vCardUnique champ texte (PUBLIC, PRIVATE ou CONFIDENTIAL)CLASS:publicCLIENTPIDMAP Carte PID client (Client PID map)Utilisé pour synchroniser différentes versions d'une même vCardEntier et URI séparés d'un point virguleCLIENTPIDMAP:1;urn:uuid:3df403f4-5924-4bb7-b077-3c711d9eb34bEMAIL Email (Email) L'adresse email associée à l'objet vCard Unique champ texteEMAIL:[email protected] Fin (End)Toute vCard doit finir par cette propriétéUnique champ texteEND:VCARDFBURL URL Dispo/Occupé (Free/Busy URL)URL montrant quand l'individu est "disponible" ou "occupé" sur son calendrierUne unique URIFBURL:http://example.com/fb/jdoeFN Nom formaté (Formatted Name) La chaîne formatée représentant le nom associé à l'objet vCard Unique champ texteFN:Dr. John DoeGENDER Genre (Gender)Genre de l'individuUnique caractère ('','M','F','O','N','U') puis unique champ texte facultatif séparés d'un point virguleGENDER:FGEO Géopositionnement (Global Positioning) Propriété indiquant la latitude et la longitude Latitude et Longitude en décimale séparées par un point-virgule2.1, 3.0: GEO:39.95;-75.1667
4.0: GEO:geo:39.95,-75.1667IMPP Messagerie Instantanée et Protocole de Présence (Instant Messaging and Presence Protocol)URL vers la messagerie instantanée de l'individuUne unique URIIMPP:aim:[email protected] Clé publique (Public Key) La clé publique de chiffrement associée à l'objet vCard Unique champ binaire ou texte2.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 Type (Kind)Le type d'objet représenté par la vCardUnique champ texte ('individual', 'group', 'organization' ou 'location')KIND:individualLABEL 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 texteLABEL;TYPE=HOME:123 Main St.\nSpringfield, IL 12345\nUSALANG Langue (Language)Langue utilisée par l'individuUnique champ langageLANG:fr-FRLOGO 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 Programme de mailing (Email Program) (Optionnel) Le type de programme de mailing utilisé Unique champ texteMAILER:ThunderbirdMEMBER 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 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) (, , ...), Suffixe(s) (, M.D.). Les champs peuvent contenir eux-mêmes plusieurs valeurs séparées par des virgules.N:Doe;John;;Dr;NAME Nom (Name)Une représentation textuelle de la propriété SOURCENICKNAME 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 virgulesNICKNAME:Jon,JohnnyNOTE Note (Note) Spécifie des informations supplémentaires ou un commentaire qui est associée à la vCard Unique champ texteNOTE: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 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 spamsPHOTO 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 Identifiant (Product Identifier)Unique champ textePRODID:-//ONLINE DIRECTORY//NONSGML Version 1//ENPROFILE Profil (Profile)Indique que la vCard est une vCardUnique champ textePROFILE:VCARDRELATED Associé (Related)Entité reliée à l'individuUne unique URI (vers une vCard ou un "mailto")RELATED;TYPE=ami:urn:uuid:03a0e51f-d1aa-4385-8a53-e29025acd8afREV 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 20171231T235900ZREV:20121201T134211ZROLE 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 texteROLE:DirecteurSORT-STRING 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 texteSORT-STRING:DoeSOUND 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