vCard

vCard

Расширение	.vcf, .vcard
MIME	text/x-vcard text/directory;profile=vCard text/directory
Разработан	Internet Mail Consortium
Тип формата	электронная визитная карточка
Содержит	контактную информацию

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.

Пример

BEGIN:VCARD
VERSION:3.0
FN:к.м.н., пр. Василий Иванович Пупкин
N:Пупкин;Василий;Иванович;пр.,к.м.н.
ORG:Рога и Копыта
URL:http://ru.wikipedia.org/
EMAIL;TYPE=INTERNET:[e-mail]
END:VCARD

Формат

Формат 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 должны присутствовать обязательно.

Типы атрибутов

В дополнение к определяемым в 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:[phone]
EMAIL	Email	Адрес электронной почты. Тип адреса может быть уточнён параметром TYPE, который может включать одно или несколько следующих значений: internet — адрес в формате интернета x400 — адрес в формате X.400 pref — предпочитаемый, если известно более одного адреса электронной почты Также могут быть указаны и другие типы из зарегистрированных IANA, либо начинающиеся с «X-» По умолчанию считается, что типа адреса электронной почты — internet	EMAIL;TYPE=INTERNET:[e-mail]
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:[phone]\nEMAIL\;INTERNET:[e-mail]\nEND:VCARD\n AGENT;VALUE=uri:CID:[e-mail]
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;R.D.O.N. 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:[e-mail] 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...

Расширения 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

См. также

• Geek-код
• hCard
• iCalendar
• vCalendar

Ссылки

• Internet mail Consortium:
  • Personal Data Interchange
  • vCard 2.1 specification
• Request for Comments (RFC):
  • RFC 2425 — A MIME Content-Type for Directory Information
  • RFC 2426 — vCard MIME Directory Profile
  • RFC 4770 — vCard Extensions for Instant Messaging (IM)
• XML VCard specification (расширение XMPP)
• hCard specification
• W3C vCard RDF/XML specification
• Конвертер Windows Address Book в .vcf файлы