Как инициализировать базу данных ФИАС?

Материал из Wiki Re:Doc
Перейти к: навигация, поиск


Настройка плагина и добавление обновлений

Плагин называется Nvx.ReDoc.DynamicFormsFiasControl. В нем реализованы:

  • э/у динамических форм для ввода адреса,
  • процедура автоматической первичной установки БД с доступных экземпляров РеДок,
  • процедура синхронизации списка обновлений с доступных экземпляров РеДок,
  • процедура автоматического применения обновлений.

Установка БД ФИАС

Ручная установка БД ФИАС

Для установки базы данных адресов ФИАС нам потребуется файл БД ФИАС FiasMinifiedDb.sdf известной версии. Описание подготовки этого файла можно найти на странице Подготовка БД ФИАС и файлов обновлений.

Алгоритм установки бд

1. Файл базы данных FiasMinifiedDb.sdf необходимо скопировать в директорию ReDocAppRoot\PluginsData\FiasStorage.

2. Создать пустой файл в той же директории с именем "xml fias_delta_xml_<дата обновления в формате yyyyMMdd>.xml".

3. В файле конфигурации плагина ReDocAppRoot\config\FiasServicesConfig.json указать версию установленной базы данных DbDate в формате yyyy-MM-dd (первоначальное значение - null).

Пример содержания файла конфигурации

{

 "DbDate": "2013-09-16"

}

Автоматическая установка БД ФИАС

При автоматической установке БД ФИАС, копирование файла базы данных выполняется с одного из доступных по сети экземпляров РеДок на котором база уже установлена.

Автоматическая установка запускается пользователем на странице настроек плагина "Сервис ФИАС". Пользователю необходимо нажать кнопку Инициализировать базу данных и дождаться окончания процедуры инициализации.

Инициализировать базу данных.png

После установки страница настроек плагина показывает текущее количество записей адресов в базе данных, версию базы, а также доступный локально список примененных обновлений.

Текущее количество записей адресов в базе данных.png

Распространение обновлений БД

Ручная установка обновления БД ФИАС

Для установки обновления базы ФИАС со стороны пользователя потребуется выполнить два действия.

1. Подготовить файл обновления "xml fias_delta_xml_<дата обновления в формате yyyyMMdd>.xml" (процедура описана на странице Подготовка БД ФИАС и файлов обновлений).

2. Скопировать файл в директорию ReDocAppRoot\PluginsData\FiasStorage

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

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

Автоматическая установка обновления БД ФИАС

Экземпляр РеДок с установленной базой данных ФИАС в автоматическом режиме опрашивает доступные по сети РеДок`и, загружает с них свежие обновления и интегрирует в БД.

Обновление с сервера при изменении структуры БД.

Для сообщения пользователям сети о необходимости обновить текущую версию из-за изменений внутри БД, необходимо на одной из машин в сети (например, сервере) указать, что на ней установлена принципиально новая версия, и соответственно, инкрементальный механизм обновлений описанный выше не поможет. Также данная БД должна обладать актуальными записями на момент публикации (должна быть обновлена дата версии БД).

Сообщение об обновлении версии БД.png

Пользователи сети, у которых инициализирована БД ФИАС автоматически получат обновление. В случае, если БД не инициализирована она будет выбрана в момент установки.