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:vasya.pupkin@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].

Название Описание Семантика Пример
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;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.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...

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

См. также[править | править вики-текст]

Ссылки[править | править вики-текст]