Плагин ФИАС
Плагин предназначен для интеграции адресного справочника с ФИАС (государственный адресный реестр).
Механизм работы
Плагин обеспечивает получение и хранение идентификатора ФИАС для следующих сущностей адресного справочника:
-
Город
-
Улица
-
Дом
Данные обновляются при изменении сущностей при условии, что не заполнен идентификатор ФИАС или изменено наименование адреса. Для этого имеется подписка на события добавления или изменения параметра
адреса в адресном справочнике (AddressAddedEvent
и AddressChangingEvent
соответственно). События обрабатываются слушателем FiasAddressListener
. При получении события слушатель добавляет его в очередь erp.fias
, если включен
параметр mqEnabled
в конфигурации плагина. Иначе, событие обрабатывается в тот же момент без добавления в очередь.
Обработка события подразумевает получение информации по адресам и ее сохранение.
Информация может быть получена в одном из двух источников: DaData и ФИАС (ГАР). Источник настраивается в параметре dataSource
конфигурации.
Сохранение информации по адресам может быть выполнено в параметр адресного справочника (в дальнейшем планируется добавить стратегии сохранения в бд и файл). Хранилище настраивается в параметре saveDestination
конфигурации.
Конфигурация плагина ФИАС
Настройка плагина происходит в основном конфиге (ID
= 6)
#Плагин ФИАС
plugin.fias.enabled=<boolean>
plugin.fias.dataSource=<string>
plugin.fias.saveDestination=<string>
plugin.fias.mqEnabled=<boolean>
plugin.fias.checkEnabled=<boolean>
plugin.fias.parameter.address.type.city=<int>
plugin.fias.parameter.address.type.street=<int>
plugin.fias.parameter.address.type.house=<int>
plugin.fias.parameter.blob.address.type.city=<int>
plugin.fias.parameter.blob.address.type.street=<int>
plugin.fias.parameter.blob.address.type.house=<int>
-
enabled
- включение плагина -
dataSource
- источник получения данных (fias, gar) -
saveDestination
- путь сохранения (parameter, (db, file)) -
mqEnabled
- включение очереди событий -
checkEnabled
- включение проверки на необходимость обновления данных ФИАС
Параметры адресного справочника:
-
parameter.address.type.city
- идентификатор параметра 'fiasId' города -
parameter.address.type.street
- идентификатор параметра 'fiasId' улицы -
parameter.address.type.house
- идентификатор параметра 'fiasId' дома -
parameter.blob.address.type.city
- идентификатор параметра 'fiasInfo' города -
parameter.blob.address.type.street
- идентификатор параметра 'fiasInfo' улицы -
parameter.blob.address.type.house
- идентификатор параметра 'fiasInfo' дома