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.

Пример

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 http://tools.ietf.org/html/rfc2426#section-3.1 .

Далее таблица для версии 3.0(актуальным на данный момент является версия 4.0):

Название !! Описание !! Семантика !! Пример
VERSIONVersionВерсия Спецификации vCard. Должен идти сразу после BEGINVERSION:3.0
FNFormatted NameПолное имя в виде единой строкиFN:к.м.н., пр. Nikita0503
NNameСтруктурированное представление имени. Через точку с запятой должны быть перечислены значения в следующем порядке: фамилия; имя; отчество (дополнительные имена); префиксы; суффиксы. Каждое из значений может быть также множественным, тогда элементы должны разделяться запятой. Список не обязан быть полным, например отчество и префиксы можно не указывать.N:Иванов;Иван;Иванович
NICKNAMENicknameПрозвище (никнейм) объекта визитной карточкиNICKNAME:Nikita0503
PHOTOPhotographИзображение или фотография. Значение в формате binary
BDAYBirthdayДата рождения
ADRDelivery AddressСтруктурированное представление адреса. В значении через точку с запятой должны быть представлены компоненты адреса в следующем порядке: абонентский ящик; расширенный адрес; дом и улица; населённый пункт; регион (штат, область); почтовый индекс; страна. В отличие от атрибута N, в адресе должны быть все точки с запятой, даже если заполнены не все элементы. Множественные значения компонента могут быть разделены запятыми.ADR;TYPE=dom, home, postal, parcel:;;123 Main Street;Any Town;CA;91921-1234
LABELAddress LabelПолные имя и адрес получателя в виде единой строки, как они должны быть представлены на письме или посылке. Тип адреса может быть уточнён параметром TYPE так же, как и у атрибутов типа ADR.LABEL;TYPE=dom, home, postal, parcel:Nikita0503\n 0000-1234 \n123 Main Street, at Any Town, CA
TELTelephoneТелефонный номер в формате, определяемом стандартом X.500. Тип телефонного номера может быть уточнён параметром TYPE, который может включать одно или несколько следующих значений:TEL;TYPE=work, voice, pref, msg:+1-213-555-1234
EMAILEmailАдрес электронной почты. Тип адреса может быть уточнён параметром TYPE, который может включать одно или несколько следующих значений:EMAIL;TYPE=INTERNET:vasya.pupkin@example.com
MAILEREmail ProgramТип используемой почтовой программы, аналогично атрибуту X-Mailer из заголовков электронных писем.MAILER:PigeonMail 2.1
TZTime ZoneЧасовой поясTZ:-05:00
GEOGlobal PositioningШирота и долгота93.657415,-122.082932
TITLETitleДолжностьTITLE:Director\, Research and Development
ROLERole or occupationДолжность, в соответствии со стандартом X.520 Business Category explanatory. Введена для того, чтобы можно было автоматически интерпретировать должность, невзирая на особенности написания названия должности в атрибуте TITLE. Некорректное использование данного атрибута не приветствуется.ROLE:Programmer
LOGOLogoЛоготип организации
AGENTAgentКоллега (продюсер, секретарь, ассистент и т. п.). Значение типа vcard, представляющее собой такую же электронную визитку того человека, собранную в одну строку через \n
ORGOrganization Name or Organizational unitНазвание организацииORG:ABC\, Inc.;North American Division;Marketing
CATEGORIESCategoryПеречень категорий, через запятую.CATEGORIES:TRAVEL AGENT
NOTENoteДополнительная информация или комментарийNOTE:This fax number is operational 0800 to 1715 EST\, Mon-Fri.
PRODIDProduct IDУказание идентификатора продукта, который создал визитную карточку объекта.
Разработчикам следует использовать такой метод, как установленный для формальных общественных идентификаторов (Formal Public Identifiers) в ISO 9070, чтобы гарантировать, что текстовое значение является уникальным.
PRODID:-//ONLINE DIRECTORY//NONSGML Version 1//EN
REVLast RevisionКомбинация даты и времени последнего обновления vCardREV:1995-10-31T22:27:10Z
SORT-STRINGSort StringУказывает фамилию или текст, который будет использоваться для национально-языковой сортировки FN и N типов.
SOUNDSoundЦифровой звук, содержащий произношение имени визитной карточки, либо может содержать некоторые аспекты визитной карточки. Значение в формате binary.SOUND;TYPE=BASIC;VALUE=uri:CID:JOHNQPUBLIC.part8.19960229T080000.yihont2011@gmail.com
UIDUnique IdentifierГлобальный уникальный идентификатор соответствующего лица или ресурса, связанного с визитной карточкой.UID:19950401-080045-40000F192713-0052
URLURLURL (адрес сайта)URL:http://ru.wikipedia.org/Nikita0503
CLASSAccess ClassificationУказывает доступ классификации визитной карточки объектаCLASS:PUBLIC
KEYPublic KeyУказывает открытый ключ, связанный с объектом визитной карточки

Расширения 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свойствострока/URLURL блога
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

См. также

Примечания

    Ссылки