Знаймо

Додати знання

приховати рекламу

Цей текст може містити помилки.

vCard



План:


Введення

vCard - текстовий формат для обміну електронними візитними картками. vCard-файл складається з vCard-записів, кожна з яких містить інформацію однієї візитної картки. vCard-запис може містити ім'я, адресу, номери телефонів, URL, логотип, відео та аудіо фрагменти і пр.

Зазвичай файл vCard має розширення .vcf.

Формат vCard або Versitcard, як його називають англомовні користувачі, розроблений в 1995 консорціумом Versit, в який увійшли Apple Computer, AT & T (пізніше Lucent), IBM і Siemens. У грудні 1996 всі права на формат перейшли до Internet Mail Consortium.

Версія 2.1 отримала підтримку в більшості поштових клієнтів. Версія 3.0 описана в RFC 2425 і RFC 2426.


1. Приклад

 BEGIN: VCARD VERSION: 3.0 FN: к.м.н., пр. Василь Іванович Пупкін N: Пупкін; Василь; Іванович; пр., к.м.н. ORG: Роги та Копита URL: http://ru.wikipedia.org/ EMAIL; TYPE = INTERNET: vasya.pupkin @ example.com END: VCARD 

2. Формат

Формат vCard, описаний в RFC 2426, є розширенням формату MIME-DIR, описаного в RFC 2425.

Згідно RFC 2425, дані MIME-DIR являють собою текст, що складається з рядків виду <тип атрибута>: <значення атрибута>. Тип атрибута може включати в себе параметри з відомостями про мову, кодуванні та іншої службовою інформацією. Значення атрибута представляється в тому чи іншому форматі значення.

Можлива довільна угруповання атрибутів, наприклад атрибути можна об'єднати в групи HOME (будинок) і WORK (робота). При цьому назва групи вписується перед назвою типу кожного атрибуту, відділяючись від нього крапкою. Група або ігнорується читаючою додатком, або призводить до відображення атрибутів, помічених однаковою групою, поруч один з одним. Іншого використання таких груп формат vCard не припускає.

На додаток до визначуваним для MIME-DIR форматів значень атрибутів uri, date, date-time і float, для vCard вводиться формати binary, phone-number, utc-offset і vcard. Так само, на додаток до параметрів значень ENCODING, VALUE, CHARSET, LANGUAGE і CONTEXT додається параметр TYPE, який дозволяє уточнити зміст атрибутів деяких типів. Службові символи, такі як коми, крапки з комою, переноси рядків і т. п. в значеннях повинні бути передуючи знаком \. Рядки довгою більше 75 знаків особливим чином розриваються при збереженні або передачі файлу, і повинні бути розгорнуті назад для інтерпретації.

В рамках одного файлу може бути одна або кілька візиток, кожна з яких починається з рядка з атрибутом BEGIN: VCARD і закінчується рядком з атрибутом END: VCARD. Між цих рядків розташовують рядки атрибутів vCard, серед яких атрибути типів VERSION, FN і N повинні бути присутнім обов'язково.


2.1. Типи атрибутів

На додаток до визначуваним в RFC 2425 типам атрибутів BEGIN, END, SOURCE, NAME і PROFILE, для формату vCard в RFC 2426 визначаються наступні типи атрибутів: FN, N, NICKNAME, PHOTO, BDAY, ADR, LABEL, TEL, EMAIL, MAILER, TZ, GEO, TITLE, ROLE, LOGO, AGENT, ORG, CATEGORIES, NOTE, PRODID, REV, SORT-STRING, SOUND, URL, UID, VERSION, CLASS, KEY [1].

Назва Опис Семантика Приклад
VERSION Version Версія Специфікації vCard. Повинен бути зазначений і мати значення 3.0 VERSION:3.0
FN Formatted Name Повне ім'я у вигляді єдиної рядки FN:к.м.н., пр. Василий Иванович Пупкин
N Name Структуроване представлення імені. Через крапку з комою повинні бути перераховані значення в наступному порядку: прізвище; ім'я; батькові (додаткові імена); префікси; суфікси. Кожне із значень може бути також множинним, тоді елементи повинні розділятися комою. Список не зобов'язаний бути повним, наприклад батькові та префікси можна не вказувати. N:Пупкин;Василий;Иванович;пр., к.м.н.

N:Пупкин;Василий

NICKNAME Nickname Прізвище ( нікнейм) об'єкта візитної картки NICKNAME:Robbie

NICKNAME:Jim,Jimmie

PHOTO Photograph Зображення або фотографія. Значення у форматі binary

PHOTO;VALUE=uri:http://www.abc.com/pub/photos/jqpublic.gif

 PHOTO; ENCODING = b; TYPE = JPEG: MIICajCCAdOgAwIBAgICBEUwDQYJKoZIhvc NAQEEBQAwdzELMAkGA1UEBhMCVVMxLDAqBgNVBAoTI05ldHNjYXBlIENvbW11b mljYXRpb25zIENvcnBvcmF0aW9uMRwwGgYDVQQLExNJbmZvcm1hdGlvbiBTeXN0 <... remainder of "B" encoded binary data ...> 
BDAY Birthday Дата народження

BDAY:1996-04-15

BDAY:1953-10-15T23:10:00Z

BDAY:1987-09-27T08:30:00-06:00

ADR Delivery Address Структуроване представлення адреси. У значенні через крапку з комою повинні бути представлені компоненти адреси у наступному порядку: абонентська скринька; розширений адресу; будинок і вулиця; населений пункт; регіон (штат, область); поштовий індекс; країна. На відміну від атрибута N, в адресі повинні бути всі крапки з комою, навіть якщо заповнені не всі елементи. Множинні значення компонента можуть бути розділені комами.

Тип адреси може бути уточнений параметром TYPE, який може включати одне або кілька наступних значень:

  • dom - місцевий
  • intl - міжнародний
  • postal - для листів
  • parcel - для посилок
  • home - місце проживання
  • work - місце роботи
  • pref - бажаний, якщо відомо більше однієї адреси

Також можуть бути вказані й інші типи з зареєстрованих IANA, або починаються з "X-"

За замовчуванням вважається, що TYPE = intl, postal, parcel, work

ADR;TYPE=dom, home, postal, parcel:;;123 Main Street;Any Town;CA;91921-1234
LABEL Address Label Повні ім'я та адресу одержувача у вигляді єдиної рядки, як вони повинні бути представлені на листі або посилці. Тип адреси може бути уточнений параметром TYPE так само, як і у атрибутів типу ADR. LABEL;TYPE=dom, home, postal, parcel:Пупкину Василию\n 91921-1234 \n123 Main Street, at Any Town, CA
TEL Telephone Телефонний номер у форматі, визначеному стандартом X.500. Тип телефонного номера може бути уточнений параметром TYPE, який може включати одне або кілька наступних значень:
  • home - за місцем проживання;
  • msg - підтримує передачу голосових повідомлень
  • work - за місцем роботи
  • pref - бажаний, якщо відомо більше одного телефону
  • voice - для голосового спілкування
  • fax - для передачі факсів
  • cell - стільниковий
  • video - підтримує відеоконференції
  • pager - для передачі повідомлень на пейджер
  • bbs - обслуговує електронну дошку оголошень
  • modem - за цим номером працює модем
  • car - в автомобілі
  • isdn - надає послуги ISDN
  • pcs - personal communication services

Також можуть бути вказані й інші типи з зареєстрованих IANA, або починаються з "X-"

За замовчуванням вважається, що тип телефону - voice.

TEL;TYPE=work, voice, pref, msg:+1-213-555-1234
EMAIL Email Адреса електронної пошти. Тип адреси може бути уточнений параметром TYPE, який може включати одне або кілька наступних значень:
  • internet - адреса в форматі інтернету
  • x400 - адреса в форматі X.400
  • pref - бажаний, якщо відомо більше одного адреси електронної пошти

Також можуть бути вказані й інші типи з зареєстрованих IANA, або починаються з "X-"

За замовчуванням вважається, що типу адреси електронної пошти - internet

EMAIL;TYPE=INTERNET:vasya.pupkin@example.com
MAILER Email Program Тип використовуваної поштової програми, аналогічно атрибуту X-Mailer із заголовків електронних листів. MAILER:PigeonMail 2.1
TZ Time Zone Часовий пояс TZ:-05:00

TZ;VALUE=text:-05:00; EST; Raleigh/North America

GEO Global Positioning Широта і довгота GEO:37.386013;-122.082932
TITLE Title Посада TITLE:Director\, Research and Development
ROLE Role or occupation Посада, у відповідності зі стандартом X.520 Business Category explanatory. Введена для того, щоб можна було автоматично інтерпретувати посаду, не дивлячись на особливості написання назви посади в атрибуті TITLE. Некоректне використання даного атрибута не вітається. ROLE:Programmer
LOGO Logo Логотип організації

LOGO;VALUE=uri:http://www.abc.com/pub/logos/abccorp.jpg

 LOGO; ENCODING = b; TYPE = JPEG: MIICajCCAdOgAwIBAgICBEUwDQYJKoZIhvcN AQEEBQAwdzELMAkGA1UEBhMCVVMxLDAqBgNVBAoTI05ldHNjYXBlIENvbW11bm ljYXRpb25zIENvcnBvcmF0aW9uMRwwGgYDVQQLExNJbmZvcm1hdGlvbiBTeXN0 <... the remainder of "B" encoded binary data ...> 
AGENT Agent Колега (продюсер, секретар, асистент і т. п.). Значення типу vcard, що представляє собою таку ж електронну візитку того людини, зібрану в один рядок через \ n

AGENT:BEGIN:VCARD\nFN:Susan Thomas\nTEL:+1-919-555-1234\nEMAIL\;INTERNET:sthomas@host.com\nEND:VCARD\n

AGENT;VALUE=uri:CID:JQPUBLIC.part3.960129T083020.xyzMail@host3.com

ORG Organization Name or Organizational unit Назва організації ORG:ABC\, Inc.;North American Division;Marketing

ORG:Рога и Копыта

CATEGORIES Category Перелік категорій, через кому. CATEGORIES:TRAVEL AGENT

CATEGORIES:INTERNET,IETF,INDUSTRY,INFORMATION TECHNOLOGY

NOTE Note Додаткова інформація чи коментар NOTE:This fax number is operational 0800 to 1715 EST\, Mon-Fri.
PRODID Product ID Вказівка ​​ідентифікатора продукту, який створив візитну картку об'єкта.
Розробникам слід використовувати такий метод, як встановлений для формальних громадських ідентифікаторів (Formal Public Identifiers) в ISO 9070, щоб гарантувати, що текстове значення є унікальним.
PRODID:-//ONLINE DIRECTORY//NONSGML Version 1//EN
REV Last Revision Комбінація дати і часу останнього оновлення vCard REV:1995-10-31T22:27:10Z

REV:1997-11-15

SORT-STRING Sort String Зазначає прізвище або текст, який буде використовуватися для національно-мовної сортування FN і N типів.
 FN: Rene van der Harten N: van der Harten; Rene; J.; Sir; 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 
SOUND Sound Цифровий звук, що містить вимова імені візитної картки, або може містити деякі аспекти візитної картки. Значення у форматі binary. SOUND;TYPE=BASIC;VALUE=uri:CID:JOHNQPUBLIC.part8.19960229T080000.xyzMail@host1.com
 SOUND; TYPE = BASIC; ENCODING = b: MIICajCCAdOgAwIBAgICBEUwDQ ... <... The remainder of "B" encoded binary data ...> 
UID Unique Identifier Глобальний унікальний ідентифікатор відповідної особи або ресурсу, пов'язаного з візитною карткою. UID:19950401-080045-40000F192713-0052
URL URL URL (адресу сайту) URL:http://ru.wikipedia.org/
CLASS Access Classification Вказує доступ класифікації візитної картки об'єкта CLASS:PUBLIC

CLASS:PRIVATE

CLASS:CONFIDENTIAL

KEY Public Key Вказує відкритий ключ, пов'язаний з об'єктом візитної картки
 KEY; ENCODING = b: MIICajCCAdOgAwIBAgICBEUwDQYJKoZIhvcN ... 

2.2. Розширення vCard

vCard підтримує приватні розширення з префіксом "X-". Деякий їх число знаходиться в загальному користуванні.

Деякі з них:

Розширення Використовується як Дані Семантика
Розширення, підтримувані великим числом різних програм
X-ABUID властивість рядок Apple Address Book UUID
X-ANNIVERSARY властивість YYYY-MM-DD будь-яка річниця, на додаток до BDAY = День народження
X-ASSISTANT властивість рядок ім'я асистента (замість Agent)
X-MANAGER властивість рядок ім'я керуючого
X-SPOUSE властивість рядок ім'я чоловіка
X-AIM
X-ICQ
X-JABBER
X-MSN
X-SKYPE
X-YAHOO
X-GADUGADU
X-GROUPWISE
властивість рядок контактна інформація служби миттєвих повідомлень (IM); параметр TYPE як для TEL (наприклад, WORK / HOME / OTHER)
X-MS-IMADDRESS властивість рядок "(IM address in VCF attachment from Outlook (right click Contact, Send Full Contact, Internet Format.)
X-MS-CARDPICTURE властивість рядок Works as PHOTO or LOGO. Contains an image of the Card in Outlook.
X-PHONETIC-FIRST-NAME,
X-PHONETIC-LAST-NAME
властивість рядок alternative spelling of name, used for Japanese names by Android and iPhone
Впроваджені і використовувані Mozilla, також використовуються Evolution
X-MOZILLA-HTML властивість TRUE / FALSE поштовий адресат бажає приймати листи в HTML-форматі
Впроваджені і використовувані Evolution
X-EVOLUTION-ANNIVERSARY властивість YYYY-MM-DD будь-яка річниця, на додаток до BDAY = День народження
X-EVOLUTION-ASSISTANT властивість рядок ім'я асистента (замість Agent)
X-EVOLUTION-BLOG-URL властивість рядок / URL URL блогу
X-EVOLUTION-FILE-AS властивість рядок файл під іншим ім'ям (на додаток до N = компоненти імені та FN = повне ім'я)
X-EVOLUTION-MANAGER властивість рядок ім'я керуючого
X-EVOLUTION-SPOUSE властивість рядок ім'я чоловіка
X-EVOLUTION-VIDEO-URL властивість рядок / URL адресу відео-чату
X-EVOLUTION-CALLBACK значення параметра TEL TYPE - телефонний номер для зворотного зв'язку
X-EVOLUTION-RADIO значення параметра TEL TYPE - контактна інформація радіо
X-EVOLUTION-TELEX значення параметра TEL TYPE - контактна інформація Telex
X-EVOLUTION-TTYTDD значення параметра TEL TYPE - контактна інформація TTY (телетайп)
Впроваджені і використовувані Funambol
X-FUNAMBOL-ANNIVERSARY
X-FUNAMBOL-BILLINGINFO
X-FUNAMBOL-CALLBACK телефонний номер для зворотного зв'язку
X-FUNAMBOL-CHILDREN
X-FUNAMBOL-COMPANIES
X-FUNAMBOL-CUSTOMERID
X-FUNAMBOL-FOLDER
X-FUNAMBOL-GENDER
X-FUNAMBOL-GOVERNMENTID
X-FUNAMBOL-HOBBIES
X-FUNAMBOL-INSTANTMESSENGER одиночний адресу служби миттєвих повідомлень (як у Microsoft Outlook)
X-FUNAMBOL-INITIALS
X-FUNAMBOL-LANGUAGES
X-FUNAMBOL-MANAGER
X-FUNAMBOL-MILEAGE
X-FUNAMBOL-ORGANIZATIONALID
X-FUNAMBOL-RADIO
X-FUNAMBOL-SPOUSE
X-FUNAMBOL-SUBJECT
X-FUNAMBOL-TELEX
X-FUNAMBOL-YOMICOMPANYNAME
X-FUNAMBOL-YOMIFIRSTNAME
X-FUNAMBOL-YOMILASTNAME

Цей текст може містити помилки.

Схожі роботи | скачати
© Усі права захищені
написати до нас