vCard — текстовый формат для обмена электронными визитными карточками. Файл vCard состоит из записей типа vCard, каждая из которых содержит информацию одной визитной карточки. Запись vCard может содержать имя, адрес, номера телефонов, URL сайта, логотип, фотографию и другую информацию. vCard имеет расширение .vcf – это текстовый файл в виде контейнера, который и хранит всю вашу контактную информацию: ФИО, номера телефонов, адрес почты, наименование компании, вашу должность и прочее.
Формат 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.
Далее таблица для версии 3.0(актуальным на данный момент является версия 4.0):
| Название | Описание | Семантика | Пример |
|---|---|---|---|
| VERSION | Версия | Версия Спецификации vCard. Должен идти сразу после BEGIN | VERSION:3.0 |
| FN | Formatted Name | Полное имя в виде единой строки | FN:к.м.н., пр. Nikita0503 |
| N | Имя | Структурированное представление имени. Через точку с запятой должны быть перечислены значения в следующем порядке: фамилия; имя; отчество (дополнительные имена); префиксы; суффиксы. Каждое из значений может быть также множественным, тогда элементы должны разделяться запятой. Список не обязан быть полным, например отчество и префиксы можно не указывать. | N:Иванов;Иван;Иванович |
| NICKNAME | Прозвище | Прозвище (никнейм) объекта визитной карточки | NICKNAME:Nikita0503 |
| PHOTO | Фото | Изображение или фотография. Значение в формате binary |
PHOTO;ENCODING=b;TYPE=JPEG:MIICajCCAdOgAwIBAgICBEUwDQYJKoZIhvc NAQEEBQAwdzELMAkGA1UEBhMCVVMxLDAqBgNVBAoTI05ldHNjYXBlIENvbW11b mljYXRpb25zIENvcnBvcmF0aW9uMRwwGgYDVQQLExNJbmZvcm1hdGlvbiBTeXN0 <...remainder of "B" encoded binary data...> |
| BDAY | Дата рождения |
|
|
| ADR | Delivery Address | Структурированное представление адреса. В значении через точку с запятой должны быть представлены компоненты адреса в следующем порядке: абонентский ящик; расширенный адрес; дом и улица; населённый пункт; регион (штат, область); почтовый индекс; страна. В отличие от атрибута N, в адресе должны быть все точки с запятой, даже если заполнены не все элементы. Множественные значения компонента могут быть разделены запятыми.
Тип адреса может быть уточнён параметром TYPE, который может включать одно или несколько следующих значений:
Также могут быть указаны и другие типы из зарегистрированных IANA, либо начинающиеся с «X-» По умолчанию считается, что TYPE=intl, postal, parcel, work |
ADR;TYPE=dom,home,postal,parcel:;;123 Main Street;Any Town;CA;91921-1234;usa |
| LABEL | Address Label | Полные имя и адрес получателя в виде единой строки, как они должны быть представлены на письме или посылке. Тип адреса может быть уточнён параметром TYPE так же, как и у атрибутов типа ADR. | LABEL;TYPE=dom, home, postal, parcel:Nikita0503\n 0000-1234 \n123 Main Street, at Any Town, CA |
| TEL | Telephone | Телефонный номер в формате, определяемом стандартом X.500. Тип телефонного номера может быть уточнён параметром TYPE, который может включать одно или несколько следующих значений:
Также могут быть указаны и другие типы из зарегистрированных IANA, либо начинающиеся с «X-» По умолчанию считается, что тип телефона — voice. |
TEL;TYPE=work, voice, pref, msg:+1-213-555-1234 |
| Электронная почта | Тип адреса может быть уточнён параметром TYPE, который может включать одно или несколько следующих значений:
Также могут быть указаны и другие типы из зарегистрированных IANA, либо начинающиеся с «X-» По умолчанию считается, что типа адреса электронной почты — internet |
EMAIL;TYPE=INTERNET:vasya.pupkin@example.com |
|
| MAILER | Email Program | Тип используемой почтовой программы, аналогично атрибуту X-Mailer из заголовков электронных писем. | MAILER:PigeonMail 2.1 |
| TZ | Часовой пояс | TZ:-05:00
|
|
| GEO | Координаты по схеме geo-URI | Широта и долгота | GEO:93.657415,-122.082932 |
| TITLE | Должность | TITLE:Director\, Research and Development |
|
| ROLE | Role or occupation | Должность, в соответствии со стандартом X.520 Business Category explanatory. Введена для того, чтобы можно было автоматически интерпретировать должность, невзирая на особенности написания названия должности в атрибуте TITLE. Некорректное использование данного атрибута не приветствуется. | ROLE:Programmer |
| LOGO | Logo | Логотип организации |
LOGO;ENCODING=b;TYPE=JPEG:MIICajCCAdOgAwIBAgICBEUwDQYJKoZIhvcN AQEEBQAwdzELMAkGA1UEBhMCVVMxLDAqBgNVBAoTI05ldHNjYXBlIENvbW11bm ljYXRpb25zIENvcnBvcmF0aW9uMRwwGgYDVQQLExNJbmZvcm1hdGlvbiBTeXN0 <...the remainder of "B" encoded binary data...> |
| AGENT | Agent | Коллега (продюсер, секретарь, ассистент и т. п.). Значение типа vcard, представляющее собой такую же электронную визитку того человека, собранную в одну строку через \n |
|
| ORG | Organization Name or Organizational unit | Название организации | ORG:ABC\, Inc.;North American Division;Marketing
|
| CATEGORIES | Category | Перечень категорий, через запятую. | CATEGORIES:TRAVEL AGENT
|
| 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
|
| 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:JOHNQPUBLIC.part8.19960229T080000.yihont2011@gmail.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/Nikita0503 |
| CLASS | Access Classification | Указывает доступ классификации визитной карточки объекта | CLASS:PUBLIC
|
| KEY | Public Key | Указывает открытый ключ системы PKI, связанный с объектом визитной карточки |
KEY;ENCODING=b:MIICajCCAdOgAwIBAgICBEUwDQYJKoZIhvcN... |
Данные в атрибутах vcard могут быть представлены в следующих форматах:
1. Текстовый формат: в этом формате данные могут быть представлены как обычный текст, например, имя, адрес или описание.
2. Числовой формат: данные могут быть представлены в виде чисел, например, номер телефона или дата рождения.
3. Формат даты и времени: данные также могут быть представлены в формате даты и времени, например, для указания дня рождения или времени встречи.
4. Фотография: в атрибутах vcard можно также включить ссылку на фотографию контакта.
5. URL-адрес: данные могут быть представлены в виде ссылки на веб-сайт (http, https или Gopher)или электронную почту (UUCP, X.400 или почта интернет)
6. Географические координаты: в некоторых случаях данные могут быть представлены в формате географических координат, которые используют геоинформационные технологии, например, для указания местоположения офиса или встречи.