VCard

{{#ifeq:||Un article de Ziki, l'encyclopédie libre.|Une page de Ziki, l'encyclopédie libre.}}

Modèle:Minuscule Modèle:Infobox Format de données 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<ref>Appendix A. Differences from RFCs 2425 and 2426</ref>.

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<ref>Modèle:Lien web</ref> et 6868<ref>Modèle:Lien web</ref>
3.0 1998 (septembre) RFC 2425<ref>Modèle:Lien web</ref> et 2426<ref>Modèle:Lien web</ref>
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<ref>https://web.archive.org/web/20000815081252/http://www.imc.org/pdi/vcard-21.txt</ref> vcard-21.doc<ref>Modèle:Lien web.</ref> (avec liens et mise en page)

Anecdote : Transfert de propriété de Versit à IMC <ref>Modèle:Lien web.</ref>

1.0 1990 versit consortium

Source externe : CalConnect <ref>Modèle:Lien web.</ref>

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
v. 2.1 v. 3.0 v. 4.0
ADR Modèle:Optional Modèle:Optional Modèle:Optional 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 Modèle:Optional Modèle:Optional Modèle:Non1 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 Modèle:Non1 Modèle:Optional Modèle:Optional Date de mariage (Anniversary) Date de mariage de l'individu Date au format AAAAMMJJ ou ISO 8601 ANNIVERSARY:19901021
BDAY Modèle:Optional Modèle:Optional Modèle:Optional Date de naissance (Birthday) Date de naissance de l'individu associé à la vCard Date au format AAAAMMJJ ou ISO 8601 BDAY:19700310
BEGIN Modèle:Yes Modèle:Yes Modèle:Yes Début (Begin) Toute vCard doit commencer par cette propriété Unique champ texte BEGIN:VCARD
CALADRURI Modèle:Non1 Modèle:Non1 Modèle:Optional 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 Modèle:Non1 Modèle:Non1 Modèle:Optional URI du calendrier (Calendar URI) URL vers le calendrier de l'individu Une unique URI CALURI:http://example.com/calendar/jdoe
CATEGORIES Modèle:Optional Modèle:Optional Modèle:Optional 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 Modèle:Non1 Modèle:Optional Modèle:Non1 Classe (Class) Sensibilité des informations contenues dans la vCard Unique champ texte (PUBLIC, PRIVATE ou CONFIDENTIAL) CLASS:public
CLIENTPIDMAP Modèle:Non1 Modèle:Non1 Modèle:Optional 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 Modèle:Optional Modèle:Optional Modèle:Optional Email (Email) L'adresse email associée à l'objet vCard Unique champ texte EMAIL:johndoe@hotmail.com
END Modèle:Yes Modèle:Yes Modèle:Yes Fin (End) Toute vCard doit finir par cette propriété Unique champ texte END:VCARD
FBURL Modèle:Non1 Modèle:Non1 Modèle:Optional 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 Modèle:Optional Modèle:Yes Modèle:Yes 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 Modèle:Non1 Modèle:Non1 Modèle:Optional 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 Modèle:Optional Modèle:Optional Modèle:Optional 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 Modèle:Non1 Modèle:Non1 Modèle:Optional 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 Modèle:Optional Modèle:Optional Modèle:Optional 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 Modèle:Non1 Modèle:Non1 Modèle:Optional Type (Kind) Le type d'objet représenté par la vCard Unique champ texte ('individual', 'group', 'organization' ou 'location') KIND:individual
LABEL Modèle:Optional Modèle:Optional Modèle:NC 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 Modèle:Non1 Modèle:Non1 Modèle:Optional Langue (Language) Langue utilisée par l'individu Unique champ langage LANG:fr-FR
LOGO Modèle:Optional Modèle:Optional Modèle:Optional 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 Modèle:Optional Modèle:Optional Modèle:Non1 Programme de mailing (Email Program) (Optionnel) Le type de programme de mailing utilisé Unique champ texte MAILER:Thunderbird
MEMBER Modèle:Non1 Modèle:Non1 Modèle:Optional 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 Modèle:Yes Modèle:Yes Modèle:Optional 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) (Modèle:Dr, Modèle:Pr, ...), Suffixe(s) (Modèle:Jr, M.D.). Les champs peuvent contenir eux-mêmes plusieurs valeurs séparées par des virgules. N:Doe;John;;Dr;
NAME Modèle:Non1 Modèle:Optional Modèle:Non1 Nom (Name) Une représentation textuelle de la propriété SOURCE
NICKNAME Modèle:Non1 Modèle:Optional Modèle:Optional 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 Modèle:Optional Modèle:Optional Modèle:Optional 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 Modèle:Optional Modèle:Optional Modèle:Optional 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 Modèle:Optional Modèle:Optional Modèle:Optional 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 Modèle:Non1 Modèle:Optional Modèle:Optional Identifiant (Product Identifier) Unique champ texte PRODID:-//ONLINE DIRECTORY//NONSGML Version 1//EN
PROFILE Modèle:Optional Modèle:Optional Modèle:Non1 Profil (Profile) Indique que la vCard est une vCard Unique champ texte PROFILE:VCARD
RELATED Modèle:Non1 Modèle:Non1 Modèle:Optional 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 Modèle:Optional Modèle:Optional Modèle:Optional 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 Modèle:Optional Modèle:Optional Modèle:Optional 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 Modèle:Non1 Modèle:Optional Modèle:NC 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 Modèle:Optional Modèle:Optional Modèle:Optional 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 Modèle:Optional Modèle:Optional Modèle:Optional Source (Source) URI vers la dernière version de la vCard Une unique URI SOURCE:http://johndoe.com/vcard.vcf
TEL Modèle:Optional Modèle:Optional Modèle:Optional 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 Modèle:Optional Modèle:Optional Modèle:Optional 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 Modèle:Optional Modèle:Optional Modèle:Optional 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 Modèle:Optional Modèle:Optional Modèle:Optional 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 Modèle:Optional Modèle:Optional Modèle:Optional 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 Modèle:Yes Modèle:Yes Modèle:Yes Version (Version) Version de la spécification vCard Unique champ texte VERSION:4.0
XML Modèle:Non1 Modèle:Non1 Modèle:Optional 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

Notes

Modèle:Références

Liens externes

Modèle:Portail