vCard
| Расширение имени файла | .vcf,.vcard |
|---|---|
| Тип интернет-СМИ | текст/визитная карточка |
| Код типа | vCrd |
| Единый идентификатор типа (UTI) | публичная.vcard |
| Разработано | Создано Versit Consortium , все права переданы в 1996 году Internet Mail Consortium , все права переданы в 2004 году CalConnect |
| Тип формата | Электронная визитная карточка |
| Контейнер для | Контактная информация |
| Стандарт | RFC6350 |
vCard , также известный как VCF (Virtual Contact File), — это стандартный формат файла для электронных визитных карточек . Карточки vCard можно прикреплять к сообщениям электронной почты , отправлять через службу мультимедийных сообщений (MMS), через World Wide Web , мгновенные сообщения , NFC или через QR-код . Они могут содержать имя и адрес , номера телефонов , адреса электронной почты , URL-адреса , логотипы , фотографии и аудиоклипы.
vCard используется как формат обмена данными в контактах смартфонов , персональных цифровых помощниках (PDA), персональных информационных менеджерах (PIM) и системах управления взаимоотношениями с клиентами (CRM). Для реализации этих приложений обмена данными были использованы и предложены другие «варианты vCard» в качестве «стандартов вариантов», каждый для своей конкретной ниши: представление XML , представление JSON или веб-страницы .
Обзор
Стандартный тип интернет-носителя ( тип MIME ) для vCard менялся с каждой версией спецификации. [1]
Карточки vCard можно встраивать в веб-страницы .
RDFa с онтологией vCard может использоваться в HTML и различных языках семейства XML, например, SVG, MathML.
Связанные форматы
jCard, « Формат JSON для vCard» — стандартное предложение 2014 года в RFC 7095. RFC 7095 описывает метод представления экземпляров vCard в формате JSON без потерь с использованием массивов пар тег-значение, зависящих от последовательности. jCard был включен в несколько других протоколов, включая RDAP , протокол доступа к базам данных с неиспользуемым пространством (PAWS, описанный в RFC 7545), и SIP , который (через RFC 8688) использует его для предоставления контактной информации оператору посредника, который отклонил вызов.
hCard — это микроформат, позволяющий встраивать vCard в HTML-страницу. Он использует имена классов CSS для идентификации каждого свойства vCard. Обычная разметка HTML и стили CSS могут использоваться вместе с именами классов hCard, не влияя на способность веб-страницы анализироваться парсером hCard. h-card — это обновление microformats2 для hCard.
MeCard — это вариация vCard, созданная NTT DoCoMo для смартфонов с использованием QR-кодов . Она использует очень похожий синтаксис, но в более консолидированном виде, поскольку место для хранения QR-кодов ограничено. Она также ограничена объемом данных, которые могут быть сохранены, не только стандартом, но и размером QR-кодов.
Пример
Пример простой vCard (из RFC 6350 от августа 2011 г., сокращенно):
НАЧАЛО:VCARD ВЕРСИЯ:4.0 FN:Симон Перро N:Перро;Саймон;инж. младший,магистр наук. ДЕНЬ РОЖДЕНИЯ:--0203 ПОЛ:М EMAIL;TYPE=work:simon.perreault@viagenie.ca КОНЕЦ:VCARD
Это визитная карточка «Симона Перро» (автора RFC 6350) с указанием его дня рождения (без года), адреса электронной почты и пола.
Характеристики
vCard определяет следующие типы свойств.
Все vCards начинаются с BEGIN:VCARDи заканчиваются на END:VCARD. Все vCards должны содержать VERSIONсвойство, которое указывает версию vCard. VERSIONдолжно идти сразу после BEGIN, за исключением стандартов vCard 2.1 и 3.0, которые позволяют ему находиться в любом месте vCard. В противном случае свойства могут быть определены в любом порядке.
| Имя | Наличие собственности | Описание | Пример | ||
|---|---|---|---|---|---|
| т. 2.1 [2] | версия 3.0 | версия 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.16674.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.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 | Неопределенный | Неопределенный | Необязательный | Определяет тип сущности, которую представляет эта vCard: «приложение», «индивидуум», «группа», «местоположение» или «организация»; значения «x-*» могут использоваться в экспериментальных целях. [3] [4] | KIND:individual |
LABEL | Необязательный | Необязательный | Включено без | Представляет собой фактический текст, который должен быть помещен на почтовую этикетку при доставке физической посылки лицу/объекту, связанному с vCard (связанному с ADRнедвижимостью).Не поддерживается в версии 4.0. Вместо этого эта информация хранится в | LABEL;TYPE=HOME:123 Main St.\nSpringfield, IL 12345\nUSA |
LANG | Упоминается [2] : 34 | Неопределенный | Необязательный | Определяет язык, на котором говорит человек. | LANG:fr-CA |
LOGO | Необязательный | Необязательный | Необязательный | Изображение или графика логотипа организации, которая связана с лицом, которому принадлежит vCard. Может указывать на внешний URL или может быть встроена в vCard как закодированный Base64 блок текста. | 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 | Необязательный | Необязательный | Неопределенный | Тип используемой почтовой программы. | MAILER:Thunderbird |
MEMBER | Неопределенный | Неопределенный | Необязательный | Определяет члена, который является частью группы, которую представляет эта vCard. Допустимые значения включают:
KINDДля использования этого свойства необходимо установить значение «group» . | MEMBER:urn:uuid:03a0e51f-d1aa-4385-8a53-e29025acd8af |
N | Необходимый | Необходимый | Необязательный | Структурированное представление имени человека, места или вещи, связанной с объектом vCard. Структура распознает, в порядке, разделенном точкой с запятой: Фамилия, Имя, Дополнительные/Отчества, Почетные префиксы и Почетные суффиксы [5] | N:Doe;John;;Dr; |
NAME | Неопределенный | Необязательный | Неопределенный | Предоставляет текстовое представление объекта SOURCEнедвижимости. | |
NICKNAME | Неопределенный | Необязательный | Необязательный | Одно или несколько описательных/знакомых названий объекта, представленного этой vCard. | NICKNAME:Jon,Johnny |
NOTE | Необязательный | Необязательный | Необязательный | Указывает дополнительную информацию или комментарий, связанный с vCard. | NOTE:I am proficient in Tiger-Crane Style,\nand I am more than proficient in the exquisite art of the Samurai sword. |
ORG | Необязательный | Необязательный | Необязательный | Имя и, необязательно, подразделение(я) организации, связанной с объектом vCard. Это свойство основано на атрибуте X.520 Organization Name и атрибуте X.520 Organization Unit. | ORG:Google;GMail Team;Spam Detection Squad |
PHOTO | Необязательный | Необязательный | Необязательный | Изображение или фотография человека, связанного с vCard. Может указывать на внешний URL или может быть встроена в vCard как закодированный в Base64 блок текста. | 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 | Неопределенный | Необязательный | Необязательный | Идентификатор продукта, создавшего объект 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 | Необязательный | Необязательный | Необязательный | Роль, род занятий или бизнес-категория объекта vCard в организации. | ROLE:Executive |
SORT-STRING | Неопределенный | Необязательный | Включено без | Определяет строку, которая должна использоваться, когда приложение каким-либо образом сортирует эту vCard. Не поддерживается в версии 4.0. Вместо этого эта информация хранится в | SORT-STRING:Doe |
SOUND | Необязательный | Необязательный | Необязательный | По умолчанию, если это свойство не сгруппировано с другими свойствами, оно определяет произношение свойства FNобъекта vCard. Оно может указывать на внешний URL или может быть встроено в vCard как закодированный в Base64 блок текста. | 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 | Неопределенный | Необязательный | Необязательный | URL-адрес, который можно использовать для получения последней версии этой vCard. | SOURCE:http://johndoe.com/vcard.vcf |
TEL | Необязательный | Необязательный | Необязательный | Каноническая строка номера телефона для телефонной связи с объектом vCard. | TEL;TYPE=cell:(123) 555-5832 |
TITLE | Необязательный | Необязательный | Необязательный | Указывает должность, функциональную позицию или функцию лица, связанного с объектом vCard в организации. | TITLE:V.P. Research and Development |
TZ | Необязательный | Необязательный | Необязательный | Часовой пояс объекта vCard. | 2.1 , 3.0 : TZ:-05004.0 : TZ:America/New_York |
UID | Необязательный | Необязательный | Необязательный | Указывает значение, представляющее постоянный, глобальный уникальный идентификатор, связанный с объектом. | UID:urn:uuid:da418720-3754-4631-a169-db89a02b831b |
URL | Необязательный | Необязательный | Необязательный | URL-адрес, указывающий на веб-сайт, который каким-либо образом представляет человека. | URL:http://www.johndoe.com |
VERSION | Необходимый | Необходимый | Необходимый | Версия спецификации vCard. В версии 4.0 это должно идти сразу после BEGINсвойства. | VERSION:3.0 |
XML | Неопределенный | Неопределенный | Необязательный | Любые XML-данные, прикрепленные к vCard. Используется, если vCard был закодирован в XML (стандарт xCard) и XML-документ содержал элементы, которые не являются частью стандарта xCard. | XML:<b>Not an xCard XML element</b> |
Смотрите также
Ссылки
- ^ RFC 6350, раздел 10.1 «Регистрация типа носителя»
- ^ ab "vCard version 2.1 Specification". Internet Mail Consortium . версит. 1996-09-18 . Получено 2024-08-31 .
- ^ "Спецификация формата vCard: 6.1.4. KIND". IETF . Август 2011 г.
- ^ "vCard KIND:application". IETF. Декабрь 2011.
- ^ «RFC 2426: Каталог vCard MIME, раздел 3.1.2».
Внешние ссылки
- vCard 4.0 у разработчика CalConnect
- RFC 6350, описывающий формат vCard версии 4
- vCard и vCalendar (старые версии) из Internet Mail Consortium в Архиве Интернета
