Генератор vCard

Цифрове керування контактами та формат vCard

Файли vCard (із розширенням .vcf) є загальноприйнятим стандартом для обміну контактною інформацією між різними операційними системами, поштовими клієнтами та мобільними пристроями. Вони дозволяють зберігати текстові дані, такі як імена, номери телефонів, адреси електронної пошти та фізичні адреси, у структурованому вигляді, який автоматично розпізнається адресними книгами.

Використання цифрових карток контактів спрощує взаємодію у багатьох сферах. Організатори заходів, фахівці з продажів, рекрутери, розробники та приватні особи застосовують цей формат для швидкої передачі точних даних без ризику помилок при ручному введенні. Завдяки стандартизованій структурі, файл .vcf можна надіслати через месенджер, електронну пошту або розмістити на веб-ресурсі для миттєвого імпорту одержувачем.

Структура файлу та відмінності між vCard 3.0 і vCard 4.0

Формат vCard розвивався протягом багатьох років, що призвело до появи кількох версій стандарту. Найбільш вживаними сьогодні є версії 3.0 та 4.0. Вибір правильної версії безпосередньо впливає на сумісність файлу з різними програмами для роботи з контактами:

• vCard 4.0 є сучасним чинним стандартом.
• vCard 3.0 використовується для забезпечення ширшої сумісності зі старішими застосунками, поштовими клієнтами або застарілими мобільними пристроями.

Технічна структура згенерованого файлу залежить від обраної версії та має такі особливості:

• У версії vCard 3.0 для позначення полів використовуються специфічні типи: телефон записується як TEL;TYPE=VOICE, електронна пошта — як EMAIL;TYPE=INTERNET, а фізична адреса — як ADR;TYPE=POSTAL. Також файли версії 3.0 містять порожнє структуроване ім'я (N).
• Під час завантаження готового файлу .vcf для розділення рядків застосовується стандарт CRLF (Carriage Return Line Feed).
• Довгі рядки у кодуванні UTF-8 автоматично розбиваються (згортаються) у фізичні рядки, довжина яких не перевищує 75 октетів.
• У вікні попереднього перегляду в браузері для розділення рядків використовується символ LF (Line Feed).

Правила заповнення полів та обмеження

Для коректного створення файлу контакту необхідно дотримуватися встановлених правил валідації та обмежень на довжину полів:

1. Повне ім'я (Повне ім'я): Це єдине обов'язкове поле для генерації файлу. Ім'я зберігається саме в тому порядку відображення, в якому його ввів користувач. Максимальна довжина становить 200 символів. Якщо поле залишити порожнім, система покаже помилку: "Введіть повне ім'я.". При перевищенні ліміту з'явиться повідомлення: "Повне ім'я має містити не більше ‹max› символів.".
2. Телефон (Телефон): Необов'язкове поле, яке приймає цифри, звичні знаки оформлення номера (пробіли, дефіси, дужки) та за потреби додатковий номер. Максимальна довжина — 80 символів. Порушення формату викликає помилку: "Використовуйте цифри, звичні знаки оформлення номера та за потреби додатковий номер.", а перевищення довжини — "Номер телефону має містити не більше ‹max› символів.".
3. Електронна пошта (Електронна пошта): Необов'язкове поле, що приймає одну адресу у правильному форматі. Максимальна довжина — 254 символи. Помилки валідації: "Введіть одну адресу електронної пошти у правильному форматі." або "Адреса електронної пошти має містити не більше ‹max› символів.".
4. Адреса (Адреса): Необов'язкове багаторядкове поле обсягом до 1 000 символів. Усі переноси рядків зберігаються у файлі контакту та залишаються одним блоком. Перевищення ліміту викликає помилку: "Адреса має містити не більше ‹max› символів.".

Будь-які керівні символи або неочікувані переноси рядків у полях введення заборонені та викликають помилку: "Вилучіть із цього поля керівні символи або неочікувані переноси рядків.". Якщо хоча б одне поле заповнено невірно, генерація блокується з повідомленням: "Виправте виділені поля перед створенням файлу.".

Процес генерації та завантаження

Генератор працює за чітким алгоритмом, що виключає передачу даних на сторонні сервери. Процес створення складається з кількох кроків:

• Введення даних: Користувач заповнює необхідні поля. Будь-яке необов'язкове поле, залишене порожнім, повністю виключається з підсумкового файлу .vcf.
• Генерація: Після натискання кнопки "Створити vCard" інструмент формує вміст файлу та показує його у полі "Попередній перегляд контакту". Будь-яка зміна версії vCard, редагування полів або очищення форми миттєво анулює раніше створений попередній перегляд.
• Аналіз метаданих: Інструмент виводить інформацію про розмір файлу у байтах ("‹count› байтів") та кількість задіяних полів ("Полів контакту: ‹count›").
• Завантаження: Натискання кнопки "Завантажити.vcf" зберігає файл на пристрій, після чого з'являється підтвердження: "Файл ‹filename› завантажено.".

Конфіденційність та обробка даних

При роботі з персональними контактними даними питання конфіденційності є пріоритетним. Обробка всієї інформації, що вводиться у форму, відбувається виключно у браузері користувача. Ваші контактні дані залишаються у браузері. BroBroGo нічого не надсилає й не зберігає.

Часті запитання (FAQ)

Яку версію вибрати: vCard 3.0 чи 4.0?

Виберіть 4.0 для чинного стандарту. Виберіть 3.0, якщо потрібна ширша сумісність зі старими застосунками чи пристроями; якщо одна версія імпортується некоректно, спробуйте іншу.

Які поля контакту обов'язкові?

Обов'язкове лише повне ім'я. Телефон, електронна пошта й адреса необов'язкові, а порожні необов'язкові поля не додаються до файлу.

Як зберігаються ім'я й адреса?

Повне ім'я зберігається у вказаному порядку відображення. Багаторядкова адреса залишається одним блоком, тому після імпорту перевірте контакт, якщо застосунок розділяє адресу на окремі частини.

Чи перевіряє інструмент реальність введених даних?

Ні. Перевіряються лише формат полів і синтаксис файлу. Інструмент не підтверджує особу, дозвіл, доступність телефону, власника електронної пошти, точність адреси або імпорт у всіх застосунках для контактів.