vCard

Un article de Wikipédia, l'encyclopédie libre.
vCard
Vcard-big-transp.png
Caractéristiques
Extension
.vcf ou .vcard
Type MIME
text/vcard[1],[2]
PUID
Développé par
Internet Mail Consortium (en)Voir et modifier les données sur Wikidata
Type de format
sérialisation d'informations
Spécification

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[3].

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[modifier | modifier le code]

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.

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

Exemple : Jean_Dupont.vcf

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 :

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 :

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[modifier | modifier le code]

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
v. 2.1 v. 3.0 v. 4.0
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 synchronisé 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) (Dr, Pr, ...), 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[modifier | modifier le code]

Notes[modifier | modifier le code]

Liens externes[modifier | modifier le code]