Как инициализировать базу данных ФИАС? — различия между версиями
| [непроверенная версия] | [непроверенная версия] |
G.blinov (обсуждение | вклад) (Новая страница: «Category:Re:Doc МФЦ Category:Требует актуализации Для того, чтобы инициализировать базу данны…») |
|||
| (не показана одна промежуточная версия этого же участника) | |||
| Строка 2: | Строка 2: | ||
[[Category:Требует актуализации]] | [[Category:Требует актуализации]] | ||
| − | + | =Настройка плагина и добавление обновлений= | |
| − | + | Плагин называется 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). | ||
| + | |||
| + | Пример содержания файла конфигурации | ||
| + | <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]] | ||
| + | |||
| + | Пользователи сети, у которых инициализирована БД ФИАС автоматически получат обновление. В случае, если БД не инициализирована она будет выбрана в момент установки. | ||
Текущая версия на 12:14, 29 декабря 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"
}
Автоматическая установка БД ФИАС
При автоматической установке БД ФИАС, копирование файла базы данных выполняется с одного из доступных по сети экземпляров РеДок на котором база уже установлена.
Автоматическая установка запускается пользователем на странице настроек плагина "Сервис ФИАС". Пользователю необходимо нажать кнопку Инициализировать базу данных и дождаться окончания процедуры инициализации.
После установки страница настроек плагина показывает текущее количество записей адресов в базе данных, версию базы, а также доступный локально список примененных обновлений.
Распространение обновлений БД
Ручная установка обновления БД ФИАС
Для установки обновления базы ФИАС со стороны пользователя потребуется выполнить два действия.
1. Подготовить файл обновления "xml fias_delta_xml_<дата обновления в формате yyyyMMdd>.xml" (процедура описана на странице Подготовка БД ФИАС и файлов обновлений).
2. Скопировать файл в директорию ReDocAppRoot\PluginsData\FiasStorage
Разбор и импорт записей обновления будет выполнен плагином в автоматическом режиме.
Очевидно, важно соблюдать очередность добавления обновлений. Можно сразу скопировать несколько файлов последовательных обновлений, плагин установит их в правильном порядке.
Автоматическая установка обновления БД ФИАС
Экземпляр РеДок с установленной базой данных ФИАС в автоматическом режиме опрашивает доступные по сети РеДок`и, загружает с них свежие обновления и интегрирует в БД.
Обновление с сервера при изменении структуры БД.
Для сообщения пользователям сети о необходимости обновить текущую версию из-за изменений внутри БД, необходимо на одной из машин в сети (например, сервере) указать, что на ней установлена принципиально новая версия, и соответственно, инкрементальный механизм обновлений описанный выше не поможет. Также данная БД должна обладать актуальными записями на момент публикации (должна быть обновлена дата версии БД).
Пользователи сети, у которых инициализирована БД ФИАС автоматически получат обновление. В случае, если БД не инициализирована она будет выбрана в момент установки.
