Адресная книга CardDAV#
- Основные понятия
- Добавление книги CardDAV
- Редактирование книги CardDAV
- Удаление книги CardDAV
- Возможные ошибки
Основные понятия#
CardDAV — это открытый интернет-протокол для синхронизации и управления контактами, основанный на стандарте vCard. Протокол обеспечивает централизованное хранение контактной информации на сервере и её доступ с различных устройств и приложений.
Принцип работы#
- Подключение к серверу: КриптоАРМ использует учетную запись пользователя для доступа к серверу CardDAV.
- Получение контактов: приложение получает список контактов в формате vCard и отображает их в интерфейсе.
- Синхронизация: изменения, внесённые локально или на сервере, синхронизируются по выбранному интервалу и направлению.
- Двусторонняя или односторонняя синхронизация: данные могут синхронизироваться в обе стороны (локально ↔ сервер) или только с сервера на локальное устройство.
💡 CardDAV работает поверх защищённого соединения HTTPS, что обеспечивает безопасную передачу данных между клиентом и сервером.
Добавление книги CardDAV#
Шаг 1. Создание пароля#
В качестве пароля может выступать обычный пароль или специальный пароль приложения, который необходимо создать в настройках сервиса, на котором размещена адресная книга.
Шаг 2. Создание подключения в КриптоАРМ#
-
Откройте форму подключения:
-
Перейдите в раздел Контакты. Откройте окно со списком адресных книг. Для этого нажмите на название активной адресной книги в верхнем правом углу окна. Выберите действие Добавить учётную запись CardDAV.
-
Перейдите в раздел Настройки → проверка Адресные книги. Нажмите на кнопку Добавить
в верхней части окна и выберите действие Добавить учётную запись CardDAV.
-
-
Откроется форма добавления адресной книги.
-
Укажите настройки подключения.
- Нажмите Сохранить.
После подключения появится новая адресная книга. Чтобы увидеть её контакты, переключитесь на неё.
Описание параметров подключения#
| Название поля | Описание |
|---|---|
| Название адресной книги | Произвольное название, которое будет отображаться в приложении |
| Адрес сервера | Адрес сервера, на котором размещена книга |
| Имя пользователя | Учетная запись для подключения к серверу |
| Пароль | Пароль для учетной записи |
| Интервал обновления | Частота синхронизации адресной книги с почтовым сервисом. По умолчанию «Никогда» |
| Порядок синхронизации | По умолчанию выставлено значение «В обе стороны» |
| Сохранять новые контакты в учетную запись CardDAV | По умолчанию настройка неактивна |
Редактирование книги CardDAV#
- Перейдите в раздел Контакты.
- Откройте окно со списком адресных книг. Для этого нажмите на название активной адресной книги в верхнем правом углу окна.
- Наведите курсор на панель с профилем, настройки которого необходимо отредактировать.
- Нажмите на кнопку Настройки.
- Откроется окно с предпросмотром настроек.
- Нажмите на кнопку Редактировать.
- Откроется форма для редактирования настроек адресной книги.
- Внесите изменения и нажмите кнопку Сохранить.
Удаление книги CardDAV#
- Перейдите в раздел Контакты.
- Откройте окно со списком адресных книг. Для этого нажмите на название активной адресной книги в верхнем правом углу окна.
- Наведите курсор на панель с профилем, настройки которого необходимо отредактировать.
- Нажмите на кнопку Настройки.
- Откроется окно с предпросмотром настроек.
- Нажмите на кнопку Удалить.
- Подтвердите действие в модальном окне.
Возможные ошибки#
При возникновении ошибки вы увидите уведомление в правом верхнем углу. Для детального анализа откройте список уведомлений и перейдите в Журнал.
| Ошибка | Описание | Рекомендуемые действия |
|---|---|---|
| Ошибка синхронизации аккаунта CardDAV | Возможно, указаны некорректные параметры подключения | Проверьте правильность заполнения данных |
| Ошибка получения контактов | Возможно, указаны некорректные параметры подключения, либо отсутствует подключение к сети Интернет | 1. Проверьте подключение к сети Интернет, 2. Проверьте правильность заполнения данных. |