Интеграция с сервисом «DaData»
«DaData.ru» — сервис, предоставляющий через API данные о геопозиции объектов в систему Бипиум для проверки корректности их заполнения и их единого форматированного ввода в систему.
1. Принцип работы
При создании поля типа «Адрес» и его заполнении уникальным токеном сервиса «DaData.ru» в структуре каталога, система настраивается на работу с сервисом «DaData.ru». Далее, при заполнении поля «Адрес», система обращается к сервису «DaData.ru» по заполненному ранее токену и выводит перечень подходящих адресов в виде списка. При выборе значения из списка, Бипиум автоматически заполняет поле в корректно отформатированном виде.
2. Реализация
2.1. Получение токена сервиса «DaData.ru»
Перейдите на страницу сервиса «DaData.ru». Нажмите на кнопку «Войти»:
Далее, кликните по ссылке «Зарегистрируйтесь»:
Заполните все необходимые поля для регистрации в открывшейся форме и нажмите на кнопку «Зарегистрироваться»:
Завершите процесс регистрации и авторизуйтесь под данными своей учетной записи. Далее прокликайте шапку страницы в следующем порядке:
В поле «API-ключ» секции «Ключи» хранится уникальное значение API-ключа для доступа к сервису, которое необходимо использовать в Бипиуме в дальнейшем. Поле, значение которого необходимо сохранить:
2.2. Заполнение данных в структуре Бипиума
Откройте в вашей системе Бипиума каталог, в котором необходимо зафиксировать адрес и добавьте в него поле типа «Адрес». Добавленное в структуру каталога поле выглядит следующим образом:
На место плейсхолдера «токен DaData.ru» вставьте токен сервиса «DaData.ru», полученный на предыдущем этапе. Пример заполнения:
Сохраните изменения в каталоге.
3. Тестирование
Откройте карточку создания записи в измененном на предыдущем шаге каталоге. В созданное поле с типом «Адрес» начните писать существующее местоположение. Под полем для ввода откроется список с предложенными вариантами адреса:
Выделите подходящий вариант из списка и кликните на него. Система автоматически заполнит поле нужным адресом в правильном формате:
Last updated