vCard | |
---|---|
Rozšíření | .vcardnebo.vcf |
MIME typ | text/vcard [1] |
Vývojář | Konsorcium internetové pošty |
Typ formátu | elektronická vizitka |
Obsahuje | kontaktní informace |
vCard je textový formát pro výměnu elektronických vizitek . Soubor vCard se skládá ze záznamů vCard, z nichž každý obsahuje informace o jedné vizitce. Záznam vCard může obsahovat jméno, adresu, telefonní čísla, URL , logo, video a audio fragmenty atd.
Soubor vCard má obvykle příponu .vcf .
Formát vCard nebo Versitcard , jak jej anglicky mluvící uživatelé nazývají, byl vyvinut v roce 1995 konsorciem Versit , které zahrnovalo Apple Computer , AT&T (později Lucent ), IBM a Siemens . V prosinci 1996 přešla všechna práva na tento formát na Internet Mail Consortium .
Verze 2.1 získala podporu ve většině e-mailových klientů. Verze 3.0 je popsána v RFC 2425 a RFC 2426 .
Formát vCard popsaný v RFC 2426 je rozšířením formátu MIME-DIR popsaného v RFC 2425 .
Podle RFC 2425 jsou data MIME-DIR text sestávající z řádků ve tvaru <typ atributu>:<hodnota atributu> . Typ atributu může zahrnovat parametry s informacemi o jazyce, kódování a další informace o službě. Hodnota atributu je reprezentována v jednom nebo druhém formátu hodnoty .
Je možné libovolné seskupování atributů, například atributy lze seskupit do skupin DOMOV (domov) a PRÁCE (práce). V tomto případě se název skupiny zadává před název typu každého atributu oddělený tečkou. Skupinu buď aplikace čtečky ignoruje, nebo má za následek zobrazení atributů označených stejnou skupinou vedle sebe. Formát vCard neznamená žádné jiné použití takových skupin.
Kromě formátů hodnot atributů uri, date, date-time a float definovaných pro MIME-DIR jsou pro vCard zavedeny binární formáty, formáty telefonního čísla, utc-offset a vcard. Kromě hodnotových parametrů ENCODING, VALUE, CHARSET, LANGUAGE a CONTEXT je také přidán parametr TYPE, který objasňuje význam atributů některých typů. Před servisními znaky, jako jsou čárky, středníky, zalomení řádků atd., musí v hodnotách předcházet \ . Řádky delší než 75 znaků jsou při ukládání nebo přenosu souboru speciálně přerušeny a pro interpretaci je nutné je obrátit.
V rámci jednoho souboru může být jedna nebo více vizitek, z nichž každá začíná řádkem s atributem BEGIN:VCARD a končí řádkem s atributem END:VCARD . Mezi těmito řádky jsou řádky atributů vCard, mezi nimiž musí být přítomny atributy typu VERSION, FN a N.
Kromě typů atributů BEGIN, END, SOURCE, NAME a PROFILE definovaných v RFC 2425 definuje RFC 2426 následující typy atributů pro formát vCard : FN, N, NICKNAME, PHOTO, BDAY, ADR, LABEL, TEL, EMAIL , MAILER, TZ, GEO, TITLE, ROLE, LOGO, AGENT, ORG, KATEGORIE, NOTE, PRODID, REV, SORT-STRING, ZVUK, URL, UID, VERZE, TŘÍDA, KLÍČ [1] .
Níže je uvedena tabulka pro verzi 3.0 (aktuálně relevantní je verze 4.0):
název | Popis | Sémantika | Příklad |
---|---|---|---|
VERZE | verze | Verze specifikace vCard. Musí přijít ihned po ZAČÁTKU | VERSION:3.0 |
FN | formátovaný název | Celé jméno jako jeden řetězec | FN:к.м.н., пр. Nikita0503 |
N | název | Strukturovaná reprezentace jména. Hodnoty musí být uvedeny oddělené středníkem v následujícím pořadí: příjmení; název; patronymus (doplňková jména); předpony; přípony. Každá z hodnot může být také vícenásobná, v takovém případě musí být prvky odděleny čárkou. Seznam nemusí být úplný, například patronymie a předpony lze vynechat. | N:Иванов;Иван;Иванович |
PŘEZDÍVKA | Přezdívka | Přezdívka ( přezdívka ) objektu vizitky | NICKNAME:Nikita0503 |
FOTOGRAFIE | fotograf | Obrázek nebo fotografie. Hodnota v binárním formátu |
PHOTO;VALUE=uri:http://www.abc.com/pub/photos/jqpublic.gif FOTOGRAFIE;KÓDOVÁNÍ=b;TYP=JPEG:MIICajCCAdOgAwIBAgICBEUwDQYJKoZIhvc NAQEEBQAwdzELMAkGA1UEBhMCVVMxLDAqBgNVBAoTI05ldHNjYXBlIENvbW11b mljYXRpb25zIENvcnBvcmF0aW9uMRwwGgYDVQQLExNJbmZvcm1hdGlvbiBTeXN0 <...zbytek "B" kódovaných binárních dat...> |
BDAY | Narozeniny | Datum narození |
BDAY:1970-12-31 BDAY:1970-12-31T23:10:00Z BDAY:1970-12-31T08:30:00-06:00 |
ADR | doručovací adresa | Strukturovaná reprezentace adresy. V hodnotě oddělené středníkem musí být součásti adresy uvedeny v následujícím pořadí: P.O. box; rozšířená adresa; dům a ulice; lokalita; region (stát, region); PSČ; země. Na rozdíl od atributu N musí být v adrese všechny středníky, i když nejsou vyplněny všechny prvky. Hodnoty více komponent lze oddělit čárkami.
Typ adresy lze zadat pomocí parametru TYPE, který může obsahovat jednu nebo více z následujících hodnot:
Mohou být specifikovány i jiné typy od IANA registrované nebo začínající na „X-“ . Výchozí hodnota je TYP=mezinárodní, pošta, balík, práce |
ADR;TYPE=dom,home,postal,parcel:;;123 Main Street;Any Town;CA;91921-1234;usa |
OZNAČENÍ | Adresní štítek | Celé jméno a adresa příjemce jako jeden řádek, jak by měly být uvedeny na dopise nebo balíku. Typ adresy lze zadat parametrem TYPE stejně jako u atributů typu ADR. | LABEL;TYPE=dom, home, postal, parcel:Nikita0503\n 0000-1234 \n123 Main Street, at Any Town, CA |
TEL | Telefon | Telefonní číslo ve formátu definovaném standardem X.500. Typ telefonního čísla lze zadat pomocí parametru TYPE, který může obsahovat jednu nebo více z následujících hodnot:
Mohou být specifikovány i jiné typy od IANA registrované nebo začínající na „X-“ . Ve výchozím nastavení je typ telefonu považován za hlas. |
TEL;TYPE=work, voice, pref, msg:+1-213-555-1234 |
e-mailem | E-mailem | Emailová adresa. Typ adresy lze zadat pomocí parametru TYPE, který může obsahovat jednu nebo více z následujících hodnot:
Mohou být specifikovány i jiné typy od IANA registrované nebo začínající na „X-“ . Ve výchozím nastavení je typ e-mailové adresy internet. |
EMAIL;TYPE=INTERNET:[email protected] |
MAILER | E-mailový program | Typ použitého poštovního serveru, podobný atributu X-Mailer z hlaviček e-mailů. | MAILER:PigeonMail 2.1 |
TZ | časové pásmo | Časové pásmo | TZ:-05:00
TZ;VALUE=text:-05:00; EST; Raleigh/North Россия |
GEO | globální umístění | Zeměpisná šířka a zeměpisná délka | GEO:93.657415,-122.082932 |
TITUL | Titul | Pracovní pozice | TITLE:Director\, Research and Development |
ROLE | Role nebo povolání | Pozice v souladu s vysvětlujícím standardem obchodní kategorie X.520. Zavedeno proto, aby bylo možné automaticky interpretovat pozici bez ohledu na zvláštnosti zápisu názvu pozice do atributu TITLE. Nesprávné použití tohoto atributu není vítáno. | ROLE:Programmer |
LOGO | Logo | Logo organizace |
LOGO;VALUE=uri:http://www.abc.com/pub/logos/abccorp.jpg LOGO;ENCODING=b;TYPE=JPEG:MIICajCCAdOgAwIBAgICBEUwDQYJKoZIhvcN AQEEBQAwdzELMAkGA1UEBhMCVVMxLDAqBgNVBAoTI05ldHNjYXBlIENvbW11bm ljYXRpb25zIENvcnBvcmF0aW9uMRwwGgYDVQQLExNJbmZvcm1hdGlvbiBTeXN0 <...zbytek "B" kódovaných binárních dat...> |
ČINIDLO | činidlo | Kolega (producent, sekretářka, asistentka atd.). Hodnota typu vcard, což je stejná elektronická vizitka dané osoby, shromážděná na jednom řádku odděleném \n |
AGENT:BEGIN:VCARD\nFN:Susan Thomas\nTEL:+1-919-555-1234\nEMAIL\;INTERNET:[email protected]\nEND:VCARD\n AGENT;VALUE=uri:CID:[email protected] |
ORG | Název organizace nebo organizační jednotka | Název organizace | ORG:ABC\, Inc.;North American Division;Marketing
ORG:Рога и Копыта |
KATEGORIE | Kategorie | Seznam kategorií oddělených čárkami. | CATEGORIES:TRAVEL AGENT
CATEGORIES:INTERNET,IETF,INDUSTRY,INFORMATION TECHNOLOGY |
POZNÁMKA | Poznámka | Další informace nebo komentář | NOTE:This fax number is operational 0800 to 1715 EST\, Mon-Fri. |
PRODID | ID produktu | Určuje ID produktu, který vytvořil vizitku objektu. Vývojáři by měli použít metodu, jako je metoda zavedená pro formální veřejné identifikátory v ISO 9070, aby zajistili, že textová hodnota je jedinečná. |
PRODID:-//ONLINE DIRECTORY//NONSGML Version 1//EN |
REV | Poslední revize | Kombinace data a času poslední aktualizace vCard | REV:1995-10-31T22:27:10Z
REV:1997-11-15 |
SORT-STRING | Řetězec řazení | Určuje příjmení nebo text, který se má použít pro třídění podle národního prostředí typů FN a N. | FN: René van der Harten N:van der Harten;Rene;J.;Pane;RDON SORT-STRING:Harten FN: Robert Pau Shou Chang N:Pau;Shou Chang;Robert SORT-STRING:Pau FN: Osamu Koura N: Koura; Osamu SORT-STRING: Koura FN: Oscar del Pozo N:del Pozo Triscon; Oscar SORT-STRING:Pozo FN:Chistine d'Aboville N:d'Aboville; Christine SORT-STRING:Aboville |
ZVUK | zvuk | Digitální zvuk obsahující výslovnost názvu vizitky nebo může obsahovat nějaký aspekt vizitky. Hodnota v binárním formátu. | SOUND;TYPE=BASIC;VALUE=uri:CID:[email protected] ZVUK;TYP=ZÁKLADNÍ;KODOVÁNÍ=b:MIICajCCAdOgAwIBAgICBEUwDQ... <...zbytek "B" kódovaných binárních dat...> |
UID | Unikátní identifikátor | Globálně jedinečný identifikátor odpovídající osoby nebo zdroje spojeného s vizitkou. | UID:19950401-080045-40000F192713-0052 |
URL | URL | URL (adresa webu) | URL:http://ru.wikipedia.org/Nikita0503 |
TŘÍDA | Klasifikace přístupu | Určuje přístup klasifikace objektů vCard | CLASS:PUBLIC
CLASS:PRIVATE CLASS:CONFIDENTIAL |
klíč | veřejný klíč | Určuje veřejný klíč spojený s objektem vizitky | KEY;ENCODING=b:MIICajCCAdOgAwIBAgICBEUwDQYJKoZIhvcN... |
vCard podporuje soukromá rozšíření s předponou „X-“. Řada z nich se běžně používá.
Někteří z nich:
Rozšíření | použit jako | Data | Sémantika |
---|---|---|---|
Rozšíření podporovaná velkým množstvím různých programů | |||
X-ABUID | vlastnictví | čára | UUID adresáře Apple |
VÝROČÍ X | vlastnictví | YYYY-MM-DD | jakékoli výročí, kromě BDAY = narozeniny |
X-ASISTENT | vlastnictví | čára | jméno asistenta (místo Agent ) |
X-MANAGER | vlastnictví | čára | jméno manažera |
X-SPOUSE | vlastnictví | čára | jméno manžela |
X-AIM X-ICQ X-JABBER X-MSN X-SKYPE X-YAHOO X-GADUGADU X-GROUPWISE |
vlastnictví | čára | kontaktní informace pro rychlé zasílání zpráv (IM); Parametr TYPE jako u TEL (například PRÁCE/DOMOV/JINÉ) |
X-MS-IMADDRESS | vlastnictví | čára | kontaktní informace pro rychlé zasílání zpráv (IM); parametr používá Microsoft Outlook |
X-MS-CARDPICTURE | vlastnictví | čára | Stejné jako FOTO nebo LOGO. parametr používá Microsoft Outlook |
X-PHONETIC-FIRST-NAME, X-PHONETIC-FRIST-NAME |
vlastnictví | čára | Fonetický záznam jména a příjmení; používané v operačních systémech Android a IOS . |
Implementováno a používáno Mozillou , také používá Evolution | |||
X-MOZILLA-HTML | vlastnictví | PRAVDA/NEPRAVDA | Chce příjemce pošty dostávat e-maily ve formátu HTML? |
Implementováno a používáno společností Evolution | |||
X-EVOLUCE-VÝROČÍ | vlastnictví | YYYY-MM-DD | jakékoli výročí, kromě BDAY = narozeniny |
X-EVOLUTION-ASSISTENT | vlastnictví | čára | jméno asistenta (místo Agent ) |
X-EVOLUTION-BLOG-URL | vlastnictví | řetězec/URL | Adresa URL blogu |
X-EVOLUTION-FILE-AS | vlastnictví | čára | soubor s jiným názvem (kromě N = název komponenty a FN = celý název ) |
X-EVOLUTION-MANAGER | vlastnictví | čára | jméno manažera |
X-EVOLUTION-MANŽEL | vlastnictví | čára | jméno manžela |
X-EVOLUTION-VIDEO-URL | vlastnictví | řetězec/URL | adresu videochatu |
X-EVOLUTION-CALLBACK | Hodnota parametru TEL TYPE | - | telefonní číslo pro zpětnou vazbu |
X-EVOLUTION-RÁDIO | Hodnota parametru TEL TYPE | - | kontaktní informace rádia |
X-EVOLUTION-TELEX | Hodnota parametru TEL TYPE | - | Kontaktní informace telexu |
X-EVOLUTION-TTYTDD | Hodnota parametru TEL TYPE | - | Kontaktní informace TTY (dálnopis). |
Implementováno a používáno Funambolem | |||
X-FUNAMBOL-VÝROČÍ | |||
X-FUNAMBOL-FAKTURAČNÍ INFORMACE | |||
X-FUNAMBOL-CALLBACK | telefonní číslo pro zpětnou vazbu | ||
X-FUNAMBOL-DĚTI | |||
SPOLEČNOSTI X-FUNAMBOL | |||
X-FUNAMBOL-CUSTOMERID | |||
X-FUNAMBOL-FOLDER | |||
X-FUNAMBOL-GENDER | |||
X-FUNAMBOL-GOVERNMENTID | |||
X-FUNAMBOL-HOBBIES | |||
X-FUNAMBOL-INSTANTMESSENGER | jedna adresa pro rychlé zasílání zpráv (jako Microsoft Outlook ) | ||
X-FUNAMBOL-INITIALS | |||
X-FUNAMBOL-JAZYKY | |||
X-FUNAMBOL-MANAGER | |||
X-FUNAMBOL-NAJEDENÉ KM | |||
X-FUNAMBOL-ORGANIZAČNÍ | |||
X-FUNAMBOL-RÁDIO | |||
X-FUNAMBOL-SPOUSE | |||
X-FUNAMBOL-PŘEDMĚT | |||
X-FUNAMBOL-TELEX | |||
X-FUNAMBOL-YOMICOMPANYNAME | |||
X-FUNAMBOL-YOMIFIRSTNAME | |||
X-FUNAMBOL-YOMILASTNAME | |||
Implementováno a používáno WebMoney | |||
X-WEBMONEY-ID | vlastnictví | číslo | Jedinečná 12místná digitální sekvence, což je adresa účastníka v systému WebMoney |