vCard
vCard — текстовый формат для обмена электронными визитными карточками. Файл vCard состоит из записей типа vCard, ��аждая из которых содержит информацию одной визитной карточки. Запись vCard может содержать имя, адрес, номера телефонов, URL сайта, логотип, фотографию и другую информацию.
vCard | |
---|---|
![]() |
|
Расширение |
.vcard или .vcf |
MIME-тип | text/vcard[1] |
Разработчик | Internet Mail Consortium[2] |
Тип формата | электронная визитная карточка |
Содержит | контактную информацию |
Обычно файл vCard имеет расширение .vcf
(Virtual Contact File), тип MIME text/vcard
.
Формат vCard или Versitcard, как его называют англоговорящие пользователи, разработан в 1995 консорциумом Versit[англ.], в который вошли Apple Computer, AT&T (позднее Lucent Technologies), 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:Denis.Kojokar@example.com 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].
Далее таблица для версии 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 | Указывает открытый ключ, связанный с объектом визитной карточки |
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); параметр используется программой Microsoft Outlook |
X-MS-CARDPICTURE | свойство | строка | То же самое, что и параметр PHOTO или LOGO. параметр используется программой Microsoft Outlook |
X-PHONETIC-FIRST-NAME, X-PHONETIC-LAST-NAME |
свойство | строка | Фонетическая запись имени и фамилии; используется в операционных системах Android и IOS. |
Внедрённые и используемые 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 | |||
Внедрённые и используемые WebMoney | |||
X-WEBMONEY-ID | свойство | число | Уникальная 12-ти значная цифровая последовательность, которая является адресом участника в системе WebMoney |
См. также
правитьПримечания
правитьСсылки
править- Internet mail Consortium:
- Request for Comments (RFC):
- XML VCard specification (расширение XMPP)
- hCard specification
- W3C vCard RDF/XML specification
- Конвертер Windows Address Book в .vcf файлы
- vCard.cam