vCard
vCard
| Rozšíření | .vcf nebo .vcard |
|---|---|
| Typ MIME | text / vcard |
| PUID | fmt / 395 |
| Vyvinul | Konsorcium internetové pošty ( in ) |
| Typ formátu | serializace informací |
| Specifikace | Otevřený formát |
vCard je standardní otevřený formát pro výměnu osobních údajů ( vizitka nebo vizitka ).
VCard verze 4.0 z roku 2011 je definována v RFC 6350 a 6868 . Předchozí verzí je vCard 3.0 z roku 1998. Rozdíly mezi těmito formáty jsou popsány v příloze RFC.
Jeden nebo druhý z těchto formátů používá softwarový adresář od společnosti Apple nebo softwarový e-mail jako Mozilla Thunderbird nebo Outlook Express . vCard také používají mobilní zařízení ( mobilní telefony , osobní asistenti , GPS ) k výměně položek adresáře, ale také software pro rychlé zasílání zpráv, jako je Jabber nebo Skype .
Formát
Soubor vCard je formát adresáře, který může obsahovat jednu nebo více adres. Pokud obsahuje pouze jednu, mluvíme přirozeněji o vizitce .
Soubor vCard má příponu vcf (zkratka pro soubor virtuální karty). Jeho obsah je čitelný jakýmkoli textovým editorem.
Je to užitečné pro poskytnutí osobních nebo obchodních kontaktních údajů vztahu.
Následující příklad je soubor s jedinečnou adresou.
Příklad: 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:[email protected] UID: END:VCARDvCard 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:[email protected] REV:20080424T195243Z END:VCARDvCard 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:[email protected] REV:20080424T195243Z x-qq:21588891 END:VCARDAdresář by pokračoval s novými kartami počínaje BEGIN: VCARD a konče END: VCARD.
Vlastnosti
Formát vCard implementuje následující typy vlastností. Všechny vCard začínají BEGIN:VCARDa končí END:VCARD. Jakákoli vCard musí obsahovat vlastnost VERSION, která definuje verzi vCard. VERSIONby se mělo objevit bezprostředně poté BEGIN, s výjimkou standardu vCard 2.1, kde se může objevit kdekoli. Všechny ostatní vlastnosti jsou volitelné v závislosti na verzi a lze je nastavit v libovolném pořadí.
| Příjmení | Přítomnost | Překlad | Popis | Vlastnosti | Příklad | ||
|---|---|---|---|---|---|---|---|
| proti. 2.1 | proti. 3.0 | proti. 4.0 | |||||
| ADR | Volitelný | Volitelný | Volitelný | Dodací adresa ( doručovací adresa ) | Strukturovaná reprezentace fyzické doručovací adresy přidružené k objektu vCard | Textová pole oddělená středníky: P.O. Box, rozšířená adresa, název ulice, město, region (nebo stát / provincie), PSČ a země | ADR;TYPE=home:;;3 rus des Lys;Lyon;12;12345;France |
| AGENT | Volitelný | Volitelný | Není definovaný | Agent ( agent ) | Informace o jiné osobě, která bude jednat jménem osoby spojené s vCard. Obvykle to může být správce, asistent nebo sekretář jednotlivce vCard. | Další vCard nebo URI na agentovu vCard | AGENT:http://mi6.gov.uk/007 |
| ANNIVERSARY | Není definovaný | Volitelný | Volitelný | Datum svatby ( výročí ) | Datum svatby jednotlivce | Datum ve formátu RRRRMMDD nebo ISO 8601 | ANNIVERSARY:19901021 |
| BDAY | Volitelný | Volitelný | Volitelný | Datum narození ( narozeniny ) | Datum narození osoby spojené s vizitkou vCard | Datum ve formátu RRRRMMDD nebo ISO 8601 | BDAY:19700310 |
| BEGIN | Požadované | Požadované | Požadované | Začátek ( začátek ) | Všechny vCard musí začínat touto vlastností | Jedno textové pole | BEGIN:VCARD |
| CALADRURI | Není definovaný | Není definovaný | Volitelný | URI adresa kalendáře ( adresa URL kalendáře ) | URL pro použití k odeslání nového plánu do kalendáře jednotlivce | Unikátní URI | CALADRURI:http://example.com/calendar/jdoe |
| CALURI | Není definovaný | Není definovaný | Volitelný | URI kalendáře ( URI kalendáře ) | URL do kalendáře jednotlivce | Unikátní URI | CALURI:http://example.com/calendar/jdoe |
| CATEGORIES | Volitelný | Volitelný | Volitelný | Kategorie ( kategorie ) | Kategorie platné pro vCard | Textová pole oddělená čárkami, z nichž každé představuje kategorii | CATEGORIES:nageur, cycliste |
| CLASS | Není definovaný | Volitelný | Není definovaný | Třída ( třída ) | Citlivost informací obsažených na vCard | Jedno textové pole (VEŘEJNÉ, SOUKROMÉ nebo DŮVĚRNÉ) | CLASS:public |
| CLIENTPIDMAP | Není definovaný | Není definovaný | Volitelný | Zákazník PID karty ( mapa zákazníka PID ) | Používá se k synchronizaci různých verzí stejné vCard | Celé číslo a URI oddělené středníkem | CLIENTPIDMAP:1;urn:uuid:3df403f4-5924-4bb7-b077-3c711d9eb34b |
| Volitelný | Volitelný | Volitelný | E-mail ( e - mail ) | E-mailová adresa přidružená k objektu vCard | Jedno textové pole | EMAIL:[email protected] | |
| END | Požadované | Požadované | Požadované | Konec ( Konec ) | Všechny vCard musí končit touto vlastností | Jedno textové pole | END:VCARD |
| FBURL | Není definovaný | Není definovaný | Volitelný | Dipo URL / Busy ( Free / Busy URL ) | URL zobrazující, když je jedinec ve svém kalendáři „k dispozici“ nebo „zaneprázdněn“ | Unikátní URI | FBURL:http://example.com/fb/jdoe |
| FN | Volitelný | Požadované | Požadované | Formátovaný název ( formátovaný název ) | Naformátovaný řetězec představující název přidružený k objektu vCard | Jedno textové pole | FN:Dr. John Doe |
| GENDER | Není definovaný | Není definovaný | Volitelný | Pohlaví ( Pohlaví ) | Pohlaví jednotlivce | Jeden znak ('', 'M', 'F', 'O', 'N', 'U'), poté jedno volitelné textové pole oddělené středníkem | GENDER:F |
| GEO | Volitelný | Volitelný | Volitelný | Geo ( globální umístění ) | Vlastnost označující zeměpisnou šířku a délku | Zeměpisná šířka a délka v desítkové soustavě oddělené středníkem |
2.1 , 3.0 :GEO:39.95;-75.1667
4,0 :GEO:geo:39.95,-75.1667 |
| IMPP | Není definovaný | Není definovaný | Volitelný | Protokol okamžitých zpráv a přítomnosti (protokoly okamžitých zpráv a přítomnosti ) | URL na okamžité zprávy jednotlivce | Unikátní URI | IMPP:aim:[email protected] |
| KEY | Volitelný | Volitelný | Volitelný | Veřejný klíč ( Public Key ) | Veřejný klíč šifrování přidružený k objektu vCard | Jedno binární nebo textové pole |
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 | Není definovaný | Není definovaný | Volitelný | Typ ( druh ) | Typ objektu představovaný vCard | Jedno textové pole („jednotlivec“, „skupina“, „organizace“ nebo „umístění“) | KIND:individual |
| LABEL | Volitelný | Volitelný | Nahrazeno | Způsob adresy (adresa štítku ) | Štítek fyzické doručovací adresy osoby nebo objektu přidruženého k vizitce vCard.
V 4.0 jsou tyto informace uloženy jako parametr vlastnosti ADR |
Jedno textové pole | LABEL;TYPE=HOME:123 Main St.\nSpringfield, IL 12345\nUSA |
| LANG | Není definovaný | Není definovaný | Volitelný | Jazyk ( jazyk ) | Jazyk používaný jednotlivcem | Jedinečné jazykové pole | LANG:fr-FR |
| LOGO | Volitelný | Volitelný | Volitelný | Logo ( Logo ) | Ilustrace nebo logo organizace spojené s jednotlivcem objektu vCard | URI na externí zdroj nebo binární obsahu obrazu (s uvedením kódování a typu) |
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 | Volitelný | Volitelný | Není definovaný | Poštovní program ( e-mailový program ) (volitelný) | Typ použitého poštovního programu | Jedno textové pole | MAILER:Thunderbird |
| MEMBER | Není definovaný | Není definovaný | Volitelný | Člen ( člen ) | Člen skupiny.
Vlastnost použitelná pouze v případě, že KINDje nastavena na „skupinu“ |
Unikátní URI (na vCard nebo „mailto“) | MEMBER:urn:uuid:03a0e51f-d1aa-4385-8a53-e29025acd8af |
| N | Požadované | Požadované | Volitelný | Jméno ( Jméno ) | Strukturovaná reprezentace jména osoby, místa nebo věci spojené s objektem vCard | Textová pole oddělená středníky: Příjmení, Jméno (jména), Další jméno (jména), Titul (y) ( D r , P r , ...), Přípony ( Jr. , MD). Samotná pole mohou obsahovat více hodnot oddělených čárkami. | N:Doe;John;;Dr; |
| NAME | Není definovaný | Volitelný | Není definovaný | Jméno ( Jméno ) | Textové znázornění vlastnosti SOURCE | ||
| NICKNAME | Není definovaný | Volitelný | Volitelný | Přezdívka ( Přezdívka ) | Popisné nebo známé jméno dané místo nebo vedle jména osoby, místa nebo věci spojené | Jedno nebo více textových polí oddělených čárkami | NICKNAME:Jon,Johnny |
| NOTE | Volitelný | Volitelný | Volitelný | Poznámka ( Poznámka ) | Určuje další informace nebo komentář, který je přidružen k vizitce vCard | Jedno textové pole | 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 | Volitelný | Volitelný | Volitelný | Název nebo organizační oddělení ( název organizace nebo organizační jednotka ) | Název a volitelně oddělení spojené s objektem vCard. Tato vlastnost je založena na vlastnostech Název organizace a Oddělení ve standardu X.520 . | Textová pole oddělená středníky: od nejobsáhlejší entity vlevo po nejpřesnější entitu v organizaci vpravo. | ORG:Google;Équipe GMail;Détection des spams |
| PHOTO | Volitelný | Volitelný | Volitelný | Fotografie ( fotografie ) | Ilustrace nebo fotografie osoby spojené s vizitkou vCard | URI na externí zdroj nebo binární obsahu obrazu (s uvedením kódování a typu) |
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 | Není definovaný | Volitelný | Volitelný | Identifikátor ( identifikátor produktu ) | Jedno textové pole | PRODID:-//ONLINE DIRECTORY//NONSGML Version 1//EN | |
| PROFILE | Volitelný | Volitelný | Není definovaný | Profil ( Profil ) | Označuje, že vCard je vCard | Jedno textové pole | PROFILE:VCARD |
| RELATED | Není definovaný | Není definovaný | Volitelný | Přidružený ( související ) | Subjekt spojený s jednotlivcem | Unikátní URI (na vCard nebo „mailto“) | RELATED;TYPE=ami:urn:uuid:03a0e51f-d1aa-4385-8a53-e29025acd8af |
| REV | Volitelný | Volitelný | Volitelný | Poslední revize ( Poslední revize ) | Kombinace kalendářního data a času dne poslední aktualizace objektu vCard | Datum / čas, například 20171231T235900Z | REV:20121201T134211Z |
| ROLE | Volitelný | Volitelný | Volitelný | Funkce ( role nebo zaměstnání ) | Role, profese nebo obchodní kategorie objektu vCard v organizaci | Jedno textové pole | ROLE:Directeur |
| SORT-STRING | Není definovaný | Volitelný | Nahrazeno | Text pro řazení ( Řazení řetězce ) | Řetězec, který bude použit k řazení názvu objektu (příklad: „Croix“ pro „de la Croix“)
Ve verzi 4.0 jsou tyto informace uloženy v parametru SORT-ASvlastnosti Na / neboORG |
Jedno textové pole | SORT-STRING:Doe |
| SOUND | Volitelný | Volitelný | Volitelný | Zvuk ( Zvuk ) | Ve výchozím nastavení, pokud tato vlastnost není seskupena s jinými vlastnostmi, určuje výslovnost vlastnosti FN( Formatted Name ) objektu vCard. | URI k externímu zdroji nebo binárního obsahu souboru (s uvedením kódování a typ) |
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 | Volitelný | Volitelný | Volitelný | Zdroj ( Zdroj ) | URI na nejnovější verzi vCard | Unikátní URI | SOURCE:http://johndoe.com/vcard.vcf |
| TEL | Volitelný | Volitelný | Volitelný | Telefon ( Telefon ) | Řetězec telefonního čísla pro hlasová volání spojená s objektem vCard | Jedno textové pole | TEL;TYPE=cell:(+33)612345678 |
| TITLE | Volitelný | Volitelný | Volitelný | Název ( Název ) | Označuje název pozice, funkce nebo osoby přidružené k objektu vCard v organizaci | Jedno textové pole | TITLE:V.P. Recherche et développement |
| TZ | Volitelný | Volitelný | Volitelný | Časové pásmo ( Časové pásmo ) | Indikace aktuálního časového pásma objektu vCard | Offset UTC ve formátu +05: 30 nebo -02: 00 |
2.1 , 3.0 :TZ:-0500
4,0 :TZ:America/New_York |
| UID | Volitelný | Volitelný | Volitelný | Jedinečný identifikátor ( jedinečný identifikátor ) | Označuje hodnotu, která představuje jedinečný, trvalý a globální identifikátor přidružený k objektu vCard | Jedno textové pole | UID:urn:uuid:da418720-3754-4631-a169-db89a02b831b |
| URL | Volitelný | Volitelný | Volitelný | URL ( URL ) | Internetový odkaz umožňující získat aktualizované informace o objektu vCard v reálném čase | Unikátní URI | URL:http://www.johndoe.com |
| VERSION | Požadované | Požadované | Požadované | Verze ( Verze ) | Verze specifikace VCard | Jedno textové pole | VERSION:4.0 |
| XML | Není definovaný | Není definovaný | Volitelný | XML ( XML ) | Jakákoli data XML připojená k vCard. Používá se, pokud je vCard kódována v XML (xCard) a pokud dokument XML obsahuje informace, které nejsou uvedeny ve standardu xCard | Jedno textové pole XML | XML:<b>Ceci n'est pas un élément xCard</b> |
Podívejte se také
Poznámky
externí odkazy
- (en) RFC 2425 , zastaralé
- (en) RFC 2426 , zastaralé
- (v) RFC 6350 (2011)
- (en) Export a import adresáře vCard z telefonu do jiné aplikace
- (fr) RFC: 6350, rfc: 6350