vCard — текстовый формат для обмена электронными визитными карточками. Файл vCard состоит из записей типа vCard, каждая из которых содержит информацию одной визитной карточки. Запись vCard может содержать имя, адрес, номера телефонов, URL сайта, логотип, фотографию и другую информацию. vCard имеет расширение .vcf – это текстовый файл в виде контейнера, который и хранит всю вашу контактную информацию: ФИО, номера телефонов, адрес почты, наименование компании, вашу должность и прочее.
Формат 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. Необязательные атрибуты:
– FN (Full Name) – полное имя контакта.
– ORG (Organization) – организация, к которой принадлежит контакт.
– TITLE (Title) – должность контакта в организации.
– ROLE (Role) – роль контакта в организации.
– BDAY (Birthday) – день рождения контакта.
– ADR (Address) – адрес контакта.
– EMAIL (Email) – электронная почта контакта.
– TEL (Telephone) – телефонный номер контакта.
– NOTE (Note) – примечание о контакте.
– URL (URL) – веб-сайт контакта.
2. Обязательные атрибуты:
– N (Name) – имя контакта.
– VERSION – версия формата vCard.
– REV – дата последнего изменения контакта.
3. Другие типы атрибутов:
– NICKNAME – псевдоним контакта.
– PHOTO – фотография контакта.
– GENDER – пол контакта.
– IMPP – мгновенное сообщение контакта.
4. Тип атрибутов для организации:
– LOGO – логотип организации.
– MEMBER – член организации.
– RELATED – связанный контакт.
5. Тип атрибутов для геолокации:
– GEO – географические координаты контакта.
6. Тип атрибутов для мультимедиа:
– SOUND – аудиофайл контакта.
– IMPP – мгновенное сообщение контакта.
– VIDEO – видео контакта.
7. Тип атрибутов для социальных сетей:
– FBURL – профиль на Facebook.
– CALADRURI – календарь контакта.
8. Тип атрибутов для документов:
– SOURCE – источник информации о контакте.
Данные в атрибутах vcard могут быть представлены в следующих форматах:
1. Текстовый формат: в этом формате данные могут быть представлены как обычный текст, например, имя, адрес или описание.
2. Числовой формат: данные могут быть представлены в виде чисел, например, номер телефона или дата рождения.
3. Формат даты и времени: данные также могут быть представлены в формате даты и времени, например, для указания дня рождения или времени встречи.
4. Фотография: в атрибутах vcard можно также включить ссылку на фотографию контакта.
5. URL-адрес: данные могут быть представлены в виде ссылки на веб-сайт (http, https или Gopher)или электронную почту (UUCP, X.400 или почта интернет)
6. Географические координаты: в некоторых случаях данные могут быть представлены в формате географических координат, которые используют геоинформационные технологии, например, для указания местоположения офиса или встречи.