Как инициализировать базу данных ФИАС? — различия между версиями

Материал из Wiki Re:Doc
Перейти к: навигация, поиск
[непроверенная версия][непроверенная версия]
(Новая страница: «Category:Re:Doc МФЦ Category:Требует актуализации Для того, чтобы инициализировать базу данны…»)
 
Строка 2: Строка 2:
 
[[Category:Требует актуализации]]
 
[[Category:Требует актуализации]]
  
−
Для того, чтобы инициализировать базу данных ФИАС нужно перейти в раздел настроек '''"Сервис ФИАС"''', нажать кнопку '''"Инициализировать"''', дождаться, пока база загрузится с сервера обновлений и начнет инициализироваться.
+
=Настройка плагина и добавление обновлений=
  
−
По окончании инициализации в строках появятся данные о количестве записей в базе и дата версии базы данных.
+
Плагин называется Nvx.ReDoc.DynamicFormsFiasControl. В нем реализованы:
  
−
Базу ФИАС также можно перенести вручную, поместив файл базы и XML-документ в папку \ReDoc\PluginsData\FiasStorage. В этом случае потребуется только провести инициализацию базы.
+
* э/у динамических форм для ввода адреса,
 +
* процедура автоматической первичной установки БД с доступных экземпляров РеДок,
 +
* процедура синхронизации списка обновлений с доступных экземпляров РеДок,
 +
* процедура автоматического применения обновлений.
 +
 
 +
=Установка БД ФИАС=
 +
==Ручная установка БД ФИАС==
 +
Для установки базы данных адресов ФИАС нам потребуется файл БД ФИАС 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).
 +
 
 +
Пример содержания файла конфигурации
 +
<div class="toccolours mw-collapsible" style="width:800px">
 +
{
 +
  "DbDate": "2013-09-16"
 +
}
 +
 
 +
</div>
 +
 
 +
==Автоматическая установка БД ФИАС==
 +
 
 +
При автоматической установке БД ФИАС, копирование файла базы данных выполняется с одного из доступных по сети экземпляров РеДок на котором база уже установлена.
 +
 
 +
Автоматическая установка запускается пользователем на странице настроек плагина "Сервис ФИАС". Пользователю необходимо нажать кнопку Инициализировать базу данных и дождаться окончания процедуры инициализации.
 +
 
 +
[[Файл:Инициализировать_базу_данных.png|800px]]
 +
 
 +
После установки страница настроек плагина показывает текущее количество записей адресов в базе данных, версию базы, а также доступный локально список примененных обновлений.
 +
 
 +
[[Файл:Текущее_количество_записей_адресов_в_базе_данных.png|800px]]
 +
 
 +
==Распространение обновлений БД==
 +
===Ручная установка обновления БД ФИАС===
 +
Для установки обновления базы ФИАС со стороны пользователя потребуется выполнить два действия.
 +
 
 +
1. Подготовить файл обновления "xml fias_delta_xml_<дата обновления в формате yyyyMMdd>.xml" (процедура описана на странице Подготовка БД ФИАС и файлов обновлений).
 +
2. Скопировать файл в директорию ReDocAppRoot\PluginsData\FiasStorage
 +
 
 +
Разбор и импорт записей обновления будет выполнен плагином в автоматическом режиме.
 +
 
 +
Очевидно, важно соблюдать очередность добавления обновлений. Можно сразу скопировать несколько файлов последовательных обновлений, плагин установит их в правильном порядке.
 +
 
 +
===Автоматическая установка обновления БД ФИАС===
 +
 
 +
Экземпляр РеДок с установленной базой данных ФИАС в автоматическом режиме опрашивает доступные по сети РеДок`и, загружает с них свежие обновления и интегрирует в БД.
 +
 
 +
===Обновление с сервера при изменении структуры БД.===
 +
 
 +
Для сообщения пользователям сети о необходимости обновить текущую версию из-за изменений внутри БД, необходимо на одной из машин в сети (например, сервере) указать, что на ней установлена принципиально новая версия, и соответственно, инкрементальный механизм обновлений описанный выше не поможет. Также данная БД должна обладать актуальными записями на момент публикации (должна быть обновлена дата версии БД).
 +
 
 +
[[Файл:Сообщение_об_обновлении_версии_БД.png|800px]]
 +
 
 +
Пользователи сети, у которых инициализирована БД ФИАС автоматически получат обновление. В случае, если БД не инициализирована она будет выбрана в момент установки.

Версия 19:02, 26 декабря 2014


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

Плагин называется 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

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

Источник — «https://wiki.egspace.ru/w-mfc/index.php?title=Как_инициализировать_базу_данных_ФИАС%3F&oldid=5355»