# 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.
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 et 6868 |
| 3.0 | 1998 (septembre) | RFC 2425 et 2426 |
| 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 vcard-21.doc (avec liens et mise en page) Anecdote : Transfert de propriété de Versit à IMC |
| 1.0 | 1990 | versit consortium Source externe : CalConnect |

### Exemples

L'exemple suivant est un fichier avec une adresse unique.
Exemples : Jean_Dupont.vcf
vCard 2.1 (1996) :
vCard 3.0 (1998) :
vCard 4.0 (2011) :
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 | Présence | 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 Dispo/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> |