DaData Lite

1. Установка

Установите модуль DaData Lite стандартными средствами 1С-Битрикс.

После установки откройте административный раздел:

Настройки → Настройки продукта → Модули → DaData Lite

и убедитесь, что модуль установлен и активирован.

Для работы модуля необходимы API-данные сервиса DaData.

2. Получение API-ключей DaData

Для работы подсказок необходимо получить API-токен DaData в личном кабинете сервиса DaData.

Для нормализации телефонных номеров дополнительно используется секретный ключ DaData.

Модуль не передает API-ключи в браузер. Запросы к DaData выполняются сервером сайта.

3. Настройка подключения

В настройках DaData Lite укажите:

• API-токен — токен доступа к API DaData;

• Секретный ключ — используется для операций нормализации телефона;

• Таймаут соединения — максимальное время установки соединения;

• Таймаут чтения — максимальное время ожидания ответа;

• Время жизни кеша — срок хранения результатов подсказок.

После сохранения настроек можно использовать кнопку «Проверить ключи», чтобы проверить подключение к API DaData.

4. Создание привязки поля

Перейдите в административном разделе в:

DaData Lite → Привязки полей

Создайте новую привязку.

Укажите:

• Сайт — сайт, на котором будет работать подсказка;

• Название — произвольное название привязки;

• Селектор CSS — CSS-селектор поля, к которому необходимо подключить подсказки;

• Тип подсказок — ФИО, адрес, организация / ИНН, банк или Email;

• Количество результатов — количество вариантов, отображаемых пользователю;

• Задержка запроса, мс — задержка перед отправкой запроса после ввода текста;

• Минимальная длина запроса — количество символов, после которого начинаются подсказки;

• Сортировка — порядок отображения привязок;

• Активность — включена или отключена привязка.

Сохраните привязку и убедитесь, что она имеет статус активна.

5. Пример CSS-селектора

Если поле имеет HTML:

<input type="text" name="address" id="address">

для привязки можно использовать селектор:

#address

Для поля:

<input type="text" class="js-address">

можно использовать:

.js-address

Один селектор может использоваться для нескольких элементов страницы, если это необходимо.

6. Проверка работы

После создания активной привязки откройте страницу сайта, на которой находится соответствующее поле.

Начните вводить текст. После достижения минимальной длины запроса модуль автоматически выполнит запрос и отобразит варианты подсказок.

Выберите нужный вариант — его значение будет подставлено в поле.

7. Нормализация телефона

Для телефона модуль не использует автоподсказки.

Нормализация номера выполняется отдельным серверным запросом к API DaData и вызывается сайтом явно при необходимости.

Для этой операции необходимы API-токен и секретный ключ DaData.

8. Кеширование

Результаты успешных запросов подсказок кешируются на стороне сервера.

Время хранения задается параметром «Время жизни кеша».

Если установить значение 0, кеширование подсказок будет отключено.

Нормализация телефонных номеров и проверка ключей в кеш не записываются.

9. Многосайтовая установка

Если на сервере используется несколько сайтов 1С-Битрикс, привязки создаются отдельно для каждого сайта.

Модуль загружает JavaScript только на тех сайтах, где существуют активные привязки.

10. Отключение

Чтобы временно отключить подсказки, достаточно отключить соответствующую привязку в разделе DaData Lite → Привязки полей.

Удаление привязки не требует изменения кода сайта.

Техническая поддержка

Техническая поддержка пользователей DaData Lite осуществляется разработчиком решения.

В рамках технической поддержки рассматриваются:

• вопросы установки и настройки модуля;

• вопросы подключения и настройки API DaData;

• проблемы с работой подсказок и привязок полей;

• ошибки, связанные с работой модуля;

• вопросы совместимости с поддерживаемыми версиями 1С-Битрикс и PHP.

Для обращения в техническую поддержку необходимо предоставить описание проблемы, версию 1С-Битрикс, версию PHP и, при необходимости, информацию о настройках модуля. Не передавайте в обращении API-токены, секретные ключи и другие конфиденциальные данные.

Контактные данные

Разработчик: ИП Захарченко АА
Email технической поддержки: info@asmart-group.ru
Сайт: https://asmart-group.ru/
Документация: https://bitrix.asmart-group.ru/docs/dadata-lite/

Поддержка осуществляется по электронной почте. Срок ответа зависит от сложности обращения.

Рабочее время 10.00-19.00 Пн-Пт (GMT+6)