vCard: Стандарт формата электронных визиток

Введение

Стандарт формата файла для электронных визитных карточек.

vCard, также известный как VCF (Virtual Contact File), является стандартом формата файла для электронных визитных карточек. vCard можно прикреплять к электронным письмам, отправлять через мультимедийные сообщения (MMS), публиковать в сети World Wide Web, передавать в мгновенных сообщениях, с помощью NFC или через QR-коды. Они могут содержать информацию об имени и адресе, номера телефонов, адреса электронной почты, URL-адреса, логотипы, фотографии и аудиофрагменты. vCard используется как формат обмена данными в контактах смартфонов, персональных цифровых помощниках (PDA), персональных информационных менеджерах (PIM) и системах управления взаимоотношениями с клиентами (CRM). Для реализации этих функций обмена данными использовались и предлагались различные "варианты vCard" как "вариантные стандарты", каждый для своей специфической области применения: представление в формате XML, представление в формате JSON или веб-страницы.

Обзор

Стандартный тип интернет-медиа (тип MIME) для vCard различался в зависимости от версии спецификации. vCard можно встраивать в веб-страницы. RDFa с онтологией vCard может использоваться в HTML и различных языках семейства XML, например, SVG и MathML.

Связанные форматы

jCard, "Формат JSON для vCard" – это стандартное предложение 2014 года. Это предложение пока не получило широкого распространения как стандарт. RFC 7095 не использует настоящие объекты JSON, а вместо этого применяет массивы пар тегов, зависящих от последовательности (подобно XML-файлу). hCard – это микроформат, позволяющий встраивать vCard внутрь HTML-страницы. Он использует имена классов CSS для идентификации каждого свойства vCard. Обычная HTML-разметка и CSS-стили могут использоваться вместе с классами hCard, не влияя на возможность разбора веб-страницы парсером hCard. hCard – это обновление микроформатов2 для hCard. MeCard – это вариант vCard, разработанный NTT DoCoMo для смартфонов с использованием QR-кодов. Он использует очень похожий синтаксис, но в более компактном виде, поскольку объем памяти на QR-кодах ограничен. Количество данных, которое можно сохранить, также ограничено не только стандартом, но и размером QR-кодов.

Свойства

vCard определяет следующие типы свойств. Все vCard начинаются с BEGIN:VCARD и заканчиваются с END:VCARD. Все vCard должны содержать свойство VERSION, которое определяет версию vCard. VERSION должно следовать сразу за BEGIN, за исключением стандартов vCard 2.1 и 3.0, которые допускают его размещение в любом месте vCard. В противном случае свойства могут быть определены в любом порядке.

vCard defines the following property types. All vCards begin with BEGIN:VCARD and end with END:VCARD. All vCards must contain the VERSION property, which specifies the vCard version. VERSION must come immediately after BEGIN, except in the vCard 2.1 and 3.0 standards, which allows it to be anywhere in the vCard. Otherwise, properties can be defined in any order. Name Property presence Description Example v. (version) 2.1 v. (version) 3.0 v. (version) 4.0 ADR A structured representation of the physical delivery address for the vCard object. ADR;TYPE=home:;;123 Main St.;Springfield;IL;12345;USA AGENT Information about another person who will act on behalf of the vCard object. Typically this would be an area administrator, assistant, or secretary for the individual. Can be either a URL or an embedded vCard. AGENT:http://mi6. gov. uk/007 ANNIVERSARY Defines the person's anniversary. ANNIVERSARY:19901021 BDAY Date of birth of the individual associated with the vCard. BDAY:19700310 BEGIN All vCards must start with this property. BEGIN:VCARD CALADRURI A URL to use for sending a scheduling request to the person's calendar. CALADRURI:http://example. com/calendar/jdoe CALURI A URL to the person's calendar. CALURI:http://example. com/calendar/jdoe CATEGORIES A list of "tags" that can be used to describe the object represented by this vCard. CATEGORIES:swimmer,biker CLASS Describes the sensitivity of the information in the vCard. CLASS:public CLIENTPIDMAP Used for synchronizing different revisions of the same vCard. CLIENTPIDMAP:1;urn:uuid:3df403f4 5924 4bb7 b077 3c711d9eb34b EMAIL The address for electronic mail communication with the vCard object. EMAIL:johndoe@hotmail. com END All vCards must end with this property. END:VCARD FBURL Defines a URL that shows when the person is "free" or "busy" on their calendar. FBURL:http://example. com/fb/jdoe FN The formatted name string associated with the vCard object. FN:Dr. John Doe GENDER Defines the person's gender. GENDER:F GEO Specifies a latitude and longitude. 2.1, 3.0: GEO:39.95; 75.16674.0: GEO:geo:39.95, 75.1667 IMPP Defines an instant messenger handle. This property was introduced in a separate RFC when the latest vCard version was 3.0. Therefore, 3.0 vCards might use this property without otherwise declaring it. IMPP:aim:johndoe@aol. com KEY The public encryption key associated with the vCard object. It may point to an external URL, may be plain text, or may be embedded in the vCard as a Base64 encoded block of text. 2.1: KEY;PGP:http://example. com/key. pgp2.1: KEY;PGP;ENCODING=BASE64:[base64 data]3.0: KEY;TYPE=PGP:http://example. com/key. pgp3.0: KEY;TYPE=PGP;ENCODING=b:[base64 data]4.0: KEY;MEDIATYPE=application/pgp keys:http://example. com/key. pgp4.0: KEY:data:application/pgp keys;base64,[base64 data] KIND Defines the type of entity that this vCard represents: 'application', 'individual', 'group', 'location' or 'organization'; 'x *' values may be used for experimental purposes. KIND:individual LABEL Represents the actual text that should be put on the mailing label when delivering a physical package to the person/object associated with the vCard (related to the ADR property). Not supported in version 4.0. Instead, this information is stored in the LABEL parameter of the ADR property. Example: ADR;TYPE=home;LABEL="123 Main St\nNew York, NY 12345":;;123 Main St;New York;NY;12345;USA LABEL;TYPE=HOME:123 Main St.\nSpringfield, IL 12345\nUSA LANG Defines a language that the person speaks. LANG:fr CA LOGO An image or graphic of the logo of the organization that is associated with the individual to which the vCard belongs. It may point to an external URL or may be embedded in the vCard as a Base64 encoded block of text. 2.1: LOGO;PNG:http://example. com/logo. png2.1: LOGO;PNG;ENCODING=BASE64:[base64 data]3.0: LOGO;TYPE=PNG:http://example. com/logo. png3.0: LOGO;TYPE=PNG;ENCODING=b:[base64 data]4.0: LOGO;MEDIATYPE=image/png:http://example. com/logo. png4.0: LOGO;ENCODING=BASE64;TYPE=PNG:[base64 data] MAILER Type of email program used. MAILER:Thunderbird MEMBER Defines a member that is part of the group that this vCard represents. Acceptable values include:The KIND property must be set to "group" in order to use this property. MEMBER:urn:uuid:03a0e51f d1aa 4385 8a53 e29025acd8af N A structured representation of the name of the person, place or thing associated with the vCard object. Structure recognizes, in order separated by semicolons: Family Name, Given Name, Additional/Middle Names, Honorific Prefixes, and Honorific Suffixes N:Doe;John;;Dr; NAME Provides a textual representation of the SOURCE property. NICKNAME One or more descriptive/familiar names for the object represented by this vCard. NICKNAME:Jon,Johnny NOTE Specifies supplemental information or a comment that is associated with the vCard. NOTE:I am proficient in Tiger Crane Style,\nand I am more than proficient in the exquisite art of the Samurai sword. ORG The name and optionally the unit(s) of the organization associated with the vCard object. This property is based on the X.520 Organization Name attribute and the X.520 Organization Unit attribute. ORG:Google;GMail Team;Spam Detection Squad PHOTO An image or photograph of the individual associated with the vCard. It may point to an external URL or may be embedded in the vCard as a Base64 encoded block of text. 2.1: PHOTO;JPEG:http://example. com/photo. jpg2.1: PHOTO;JPEG;ENCODING=BASE64:[base64 data]3.0: PHOTO;TYPE=JPEG;VALUE=URI:http://example. com/photo. jpg3.0: PHOTO;TYPE=JPEG;ENCODING=b:[base64 data]4.0: PHOTO;MEDIATYPE=image/jpeg:http://example. com/photo. jpg4.0: PHOTO;ENCODING=BASE64;TYPE=JPEG:[base64 data] PRODID The identifier for the product that created the vCard object. PRODID: //ONLINE DIRECTORY//NONSGML Version 1//EN PROFILE States that the vCard is a vCard. PROFILE:VCARD RELATED Another entity that the person is related to. Acceptable values include: RELATED;TYPE=friend:urn:uuid:03a0e51f d1aa 4385 8a53 e29025acd8af REV A timestamp for the last time the vCard was updated. REV:20121201T134211Z ROLE The role, occupation, or business category of the vCard object within an organization. ROLE:Executive SORT STRING Defines a string that should be used when an application sorts this vCard in some way. Not supported in version 4.0. Instead, this information is stored in the SORT AS parameter of the N and/or ORG properties. SORT STRING:Doe SOUND By default, if this property is not grouped with other properties it specifies the pronunciation of the FN property of the vCard object. It may point to an external URL or may be embedded in the vCard as a Base64 encoded block of text. 2.1: SOUND;OGG:http://example. com/sound. ogg2.1: SOUND;OGG;ENCODING=BASE64:[base64 data]3.0: SOUND;TYPE=OGG:http://example. com/sound. ogg3.0: SOUND;TYPE=OGG;ENCODING=b:[base64 data]4.0: SOUND;MEDIATYPE=audio/ogg:http://example. com/sound. ogg4.0: SOUND:data:audio/ogg;base64,[base64 data] SOURCE A URL that can be used to get the latest version of this vCard. SOURCE:http://johndoe. com/vcard. vcf TEL The canonical number string for a telephone number for telephony communication with the vCard object. TEL;TYPE=cell:(123) 555 5832 TITLE Specifies the job title, functional position or function of the individual associated with the vCard object within an organization. TITLE:V. P. Research and Development TZ The time zone of the vCard object. 2.1, 3.0: TZ: 05004.0: TZ:America/New York UID Specifies a value that represents a persistent, globally unique identifier associated with the object. UID:urn:uuid:da418720 3754 4631 a169 db89a02b831b URL A URL pointing to a website that represents the person in some way. URL:http://www. johndoe. com VERSION The version of the vCard specification. In version 4.0, this must come right after the BEGIN property. VERSION:3.0 XML Any XML data that is attached to the vCard. This is used if the vCard was encoded in XML (xCard standard) and the XML document contained elements which are not part of the xCard standard. XML:<b>Not an xCard XML element</b>

Название | Свойство | Наличие | Описание | Пример
------- | -------- | -------- | -------- | --------
v. (версия) | 2.1 | | |
v. (версия) | 3.0 | | |
v. (версия) | 4.0 | | |
ADR | | | Структурированное представление физического адреса доставки для объекта vCard. | ADR;TYPE=home:;;123 Main St.;Springfield;IL;12345;USA
AGENT | | | Информация о другом лице, действующем от имени объекта vCard. Обычно это администратор, помощник или секретарь. Может быть URL или встроенной vCard. | AGENT:http://mi6.gov.uk/007
ANNIVERSARY | | | Дата годовщины. | ANNIVERSARY:19901021
BDAY | | | Дата рождения лица, связанного с vCard. | BDAY:19700310
BEGIN | | | Все vCard должны начинаться с этого свойства. | BEGIN:VCARD
CALADRURI | | | URL для отправки запроса на планирование в календарь человека. | CALADRURI:http://example.com/calendar/jdoe
CALURI | | | URL-адрес календаря человека. | CALURI:http://example.com/calendar/jdoe
CATEGORIES | | | Список "тегов" для описания объекта, представленного vCard. | CATEGORIES:swimmer,biker
CLASS | | | Описывает конфиденциальность информации в vCard. | CLASS:public
CLIENTPIDMAP | | | Используется для синхронизации различных версий одной и той же vCard. | CLIENTPIDMAP:1;urn:uuid:3df403f4-5924-4bb7-b077-3c711d9eb34b
EMAIL | | | Адрес электронной почты для связи с объектом vCard. | EMAIL:johndoe@hotmail.com
END | | | Все vCard должны заканчиваться этим свойством. | END:VCARD
FBURL | | | URL, показывающий статус "свободен" или "занят" в календаре. | FBURL:http://example.com/fb/jdoe
FN | | | Форматированная строка имени, связанная с объектом vCard. | FN:Dr. John Doe
GENDER | | | Пол человека. | GENDER:F
GEO | | | Широта и долгота. 2.1, 3.0: GEO:39.95;75.1667 4.0: GEO:geo:39.95,75.1667 |
IMPP | | | Адрес мгновенных сообщений. Введено в RFC отдельно от vCard 3.0, поэтому vCard 3.0 может использовать его без явного объявления. | IMPP:aim:johndoe@aol.com
KEY | | | Публичный ключ шифрования, связанный с объектом vCard. Может быть URL, обычным текстом или встроенным в vCard в формате Base64. 2.1: KEY;PGP:http://example.com/key.pgp 2.1: KEY;PGP;ENCODING=BASE64:[base64 data] 3.0: KEY;TYPE=PGP:http://example.com/key.pgp 3.0: KEY;TYPE=PGP;ENCODING=b:[base64 data] 4.0: KEY;MEDIATYPE=application/pgp-keys:http://example.com/key.pgp 4.0: KEY:data:application/pgp-keys;base64,[base64 data] |
KIND | | | Тип сущности, представленной vCard: 'application', 'individual', 'group', 'location' или 'organization'; 'x*' для экспериментов. | KIND:individual
LABEL | | | Текст для почтовой этикетки при доставке посылки. Не поддерживается в версии 4.0. Информация хранится в параметре LABEL свойства ADR. | ADR;TYPE=home;LABEL="123 Main St\nNew York, NY 12345":;;123 Main St;New York;NY;12345;USA LABEL;TYPE=HOME:123 Main St.\nSpringfield, IL 12345\nUSA
LANG | | | Язык, на котором говорит человек. | LANG:fr
LOGO | | | Логотип организации, связанной с vCard. Может быть URL или встроенным в vCard в формате Base64. 2.1: LOGO;PNG:http://example.com/logo.png 2.1: LOGO;PNG;ENCODING=BASE64:[base64 data] 3.0: LOGO;TYPE=PNG:http://example.com/logo.png 3.0: LOGO;TYPE=PNG;ENCODING=b:[base64 data] 4.0: LOGO;MEDIATYPE=image/png:http://example.com/logo.png 4.0: LOGO;ENCODING=BASE64;TYPE=PNG:[base64 data] |
MAILER | | | Тип используемой почтовой программы. | MAILER:Thunderbird
MEMBER | | | Член группы, представленной vCard. Свойство KIND должно быть установлено в "group". | MEMBER:urn:uuid:03a0e51f-d1aa-4385-8a53-e29025acd8af
N | | | Структурированное представление имени: Фамилия;Имя;Отчество;Префикс;Суффикс. | N:Doe;John;;Dr;
NAME | | | Текстовое представление свойства SOURCE. |
NICKNAME | | | Альтернативные имена. | NICKNAME:Jon,Johnny
NOTE | | | Дополнительная информация или комментарий. | NOTE:I am proficient in Tiger Crane Style,\nand I am more than proficient in the exquisite art of the Samurai sword.
ORG | | | Название и подразделения организации, связанной с vCard. | ORG:Google;GMail Team;Spam Detection Squad
PHOTO | | | Фотография человека. Может быть URL или встроенным в vCard в формате Base64. 2.1: PHOTO;JPEG:http://example.com/photo.jpg 2.1: PHOTO;JPEG;ENCODING=BASE64:[base64 data] 3.0: PHOTO;TYPE=JPEG;VALUE=URI:http://example.com/photo.jpg 3.0: PHOTO;TYPE=JPEG;ENCODING=b:[base64 data] 4.0: PHOTO;MEDIATYPE=image/jpeg:http://example.com/photo.jpg 4.0: PHOTO;ENCODING=BASE64;TYPE=JPEG:[base64 data] |
PRODID | | | Идентификатор продукта, создавшего vCard. | PRODID://ONLINE DIRECTORY//NONSGML Version 1//EN
PROFILE | | | Указывает, что vCard является vCard. | PROFILE:VCARD
RELATED | | | Связанная сущность. | RELATED;TYPE=friend:urn:uuid:03a0e51f-d1aa-4385-8a53-e29025acd8af
REV | | | Дата последнего обновления vCard. | REV:20121201T134211Z
ROLE | | | Роль, должность или категория в организации. | ROLE:Executive
SORT-STRING | | | Строка для сортировки vCard. Не поддерживается в версии 4.0. Информация хранится в параметре SORT-AS свойств N и/или ORG. |
SOUND | | | Произношение имени (FN). Может быть URL или встроенным в vCard в формате Base64. 2.1: SOUND;OGG:http://example.com/sound.ogg 2.1: SOUND;OGG;ENCODING=BASE64:[base64 data] 3.0: SOUND;TYPE=OGG:http://example.com/sound.ogg 3.0: SOUND;TYPE=OGG;ENCODING=b:[base64 data] 4.0: SOUND;MEDIATYPE=audio/ogg:http://example.com/sound.ogg 4.0: SOUND:data:audio/ogg;base64,[base64 data] |
SOURCE | | | URL для получения последней версии vCard. | SOURCE:http://johndoe.com/vcard.vcf
TEL | | | Номер телефона. | TEL;TYPE=cell:(123) 555-5832
TITLE | | | Должность в организации. | TITLE:V. P. Research and Development
TZ | | | Часовой пояс. 2.1, 3.0: TZ:0500 4.0: TZ:America/New York |
UID | | | Уникальный идентификатор объекта. | UID:urn:uuid:da418720-3754-4631-a169-db89a02b831b
URL | | | URL веб-сайта. | URL:http://www.joh...