Расширенные данные местоположений

Модуль «Расширенные данные местоположений» tidx.location — новая переработанная версия ранее выпущенного модуля hooli.location.

Решение дополняет стандартную базу местоположений 1С-Битрикс сведениями, необходимыми для интеграции со службами доставки, обработки адресов и прикладной логики интернет-магазина.

Модуль не создаёт отдельный справочник и не дублирует местоположения. Все сведения записываются в штатные сущности модуля «Интернет-магазин» (sale).

В поставку входят сопоставления для 12 219 кодов местоположений:

• ФИАС — 12 219;
  
• КЛАДР — 12 219;
  
• ОКАТО — 12 219;
  
• ОКТМО — 12 219;
  
• часовые пояса — 12 219;
  
• географические координаты — 11 226;
  
• короткие русские названия — 10 941;
  
• почтовые индексы — 10 067;
  
• идентификаторы СДЭК — 6 907;
  
• идентификаторы DPD — 3 281;
  
• идентификаторы Boxberry — 789.
  

Фактическое количество импортированных значений зависит от состава и версии базы местоположений, установленной на сайте.

Данные уже включены в модуль. Подключение к внешним сервисам и автоматическое скачивание справочников не требуется.

Импорт выполняется небольшими пакетами, размер которых можно настроить в административном интерфейсе.

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

Во время работы отображаются:

• количество местоположений в установленной базе Битрикс;
  
• количество строк в каждом наборе;
  
• количество уже заполненных значений;
  
• текущий прогресс импорта;
  
• количество обработанных строк;
  
• количество существующих значений;
  
• количество значений, пропущенных из-за отсутствия соответствующего местоположения;
  
• количество строк с некорректным форматом.
  

Импорт можно остановить после завершения текущего пакета без потери уже сохранённых данных.

Внешние идентификаторы сохраняются штатными средствами 1С-Битрикс.

Координаты записываются в стандартные поля широты и долготы местоположения. Короткие названия сохраняются в русское представление местоположения.

Собственные таблицы для хранения импортированных данных модуль не создаёт.

Новая версия модуля продолжает назначение прежнего модуля hooli.location, но использует обновлённую архитектуру и административный интерфейс:

• пакетный импорт с отображением прогресса;
  
• безопасный повторный запуск без перезаписи данных;
  
• статистика по каждому набору;
  
• отдельные права на просмотр и импорт;
  
• штатные Engine Controller, CSRF-защита и авторизация Битрикс;
  
• журналирование непредвиденных ошибок;
  
• проверка формата импортируемых данных.
  

Значения, ранее импортированные модулем hooli.location в штатные таблицы sale, сохраняются. При повторном импорте новая версия распознает заполненные значения и пропустит их.

Требования:

• PHP 8.1 или новее;
  
• установленный модуль «Интернет-магазин» (sale);
  
• предварительно загруженная штатная база местоположений 1С-Битрикс.