Интеграция с ГИС «Стройкомплекс.РФ»#

ГИС «Стройкомплекс.РФ» (ранее – ГИСОГД РФ) – это единая система обеспечения градостроительной деятельности Российской Федерации, которая объединяет на единой платформе всю градостроительную информацию в России. Передача сведений из ГИСОГД регионов в Единую систему осуществляется посредством сервиса для передачи сведений через API Стройкомплекс.РФ.

Ранее модуль назывался «Интеграция с ГИСОГД РФ».

Целью сервиса является передача сведений из ГИСОГД регионов в ГИС «Стройкомплекс.РФ».

Сервис позволяет:

  • передавать размещаемые документы из Diamond и GeoMeta в Стройкомплекс.РФ (API Стройкомплекс.РФ);

  • массово передавать размещенные документы в Стройкомплекс.РФ (API Стройкомплекс.РФ), используя утилиту MassProcessor;

  • отправлять сведения, которые были размещены после размещения документа (векторные данные 5,7 разделов ГИСОГД + градостроительные регламенты со связанными объектами);

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

Важно

Для настройки сервиса необходимо вносить правки в .env файл в каталоге /opt/gisogdrf.

Логирование#

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

Логирование ведется в таблицах БД Diamond – gisogd_schema:

  • gisogd_schema.gisogd_rf_log_document_bucket;

  • gisogd_schema.gisogd_rf_log_document_bucket_elements.

Таблица gisogd_schema.gisogd_rf_log_document_bucket#

Таблица содержит информацию об успешности/неуспешности отправки пакета данных документа целиком:

../../_images/document_bucket.png

Столбцы содержат в себе информацию:

  • [id] – идентификационный номер документа в таблице;

  • [scheme] – наименование схемы проекта;

  • [gisogd_registration_number] – регистрационный номер документа;

  • [send_date] – время и дата направления в ГИСОГД;

  • [success] – отметка успешной\неуспешной отправки (true\false);

  • [error_text] – текст ошибки при неудачной отправке документа в Стройкомплекс.РФ;

  • [service_name] – наименование сервиса, которым был отправлен документ;

  • [last_send_date] – дата последней отправки документа в Стройкомплекс.РФ;

  • [attemp_count] – количество попыток отправки документа в Стройкомплекс.РФ.

Таблица gisogd_schema.gisogd_rf_log_document_bucket_elements#

Таблица содержит информацию об отправке частей пакета данных каждого документа, то есть сведения об отправке всех составляющих объектов документа:

../../_images/document_bucket_elementst.png

Столбцы содержат в себе информацию:

  • [bucket_id] – идентификационный номер пакета в таблице;

  • [xml_type] – наименование типа объекта;

  • [guid] – уникальный идентификационный номер объекта в составе пакета;

  • [send_date] – время и дата отправки в Стройкомплекс.РФ;

  • [success] – отметка успешной\неуспешной отправки (true\false);

  • [xml] – содержимое xml, отправленного в Стройкомплекс.РФ;

  • [error_text] – текст ошибки при неудачной отправке в Стройкомплекс.РФ.

В случае ошибок отправки в таблицах заполняется поле в столбце [error_text].

В таблице gisogd_schema.v_gisogd_rf_errors_from_api отображается информация о тех запросах в API Стройкомплекс.РФ, данные которых отправить не удалось.

В таблице error_text gisogd_rf_log_document_bucket отображается информация, если есть ошибка формирования пакета:

  • извлечение данных из БД;

  • валидация данных на корректность.

В ходе логирования формируются файлы лога в папках /var/log/gems/gisogd-rf/service и /var/log/gems/gisogd-rf/massprocessor.

При получении результата отправки документа в ГИС «Стройкомплекс.РФ», сервис производит поиск записи о последней неуспешной попытке отправки этого документа в логах в таблице gisogd_rf_log_document_bucket, после чего сервис:

  1. Увеличивает счетчик попыток отправки на единицу в столбце attempt_count.

  2. Проставляет актуальный статус результата отправки вместо неуспешного в столбце [success].

  3. Удаляет записи обо всех элементах старой отправки и переписывает их элементами этой отправки.

  4. Проставляет текущее время как время последней попытки отправки в столбце [last_send_date].

  5. Перезаписывает текст ошибки и название сервиса, если оно отличается.

Если запись о последней неуспешной попытке отправки не найдена – будет создана стандартная запись лога.

Как посмотреть информацию о статусе отправки#

Посмотреть информацию о статусе отправки конкретного документа по регистрационному номеру ГИСОГД, в том числе об объектах, входящих в его состав, можно с помощью запроса:

select b.scheme,
    b.gisogd_registration_number,
    b.success as all_success,
    b.error_text as make_package_error,
    e.send_date,
    e.xml_type,
    e.guid,
    e.xml,
    e.success as request_success,
    e.error_text as request_error,
    b.service_name
from gisogd_schema.gisogd_rf_log_document_bucket b
left join gisogd_schema.gisogd_rf_log_document_bucket_elements e
on e.bucket_id = b.id
where b.gisogd_registration_number = '05657000-10-2022-54' - номер документа
order by e.send_date desc;

Часто задаваемые вопросы#

Если документ ГИСОГД не отправляется в Стройкомплекс.РФ и не отображается ни в аудите, ни в списке документов Стройкомплекс.РФ в технологическом окне, на это может быть ряд причин.

Сценарии передачи сведений в ГИС «Стройкомплекс.РФ»#