12 | Документация

Формирование отчета

Формирование отчетов - одна из серьёзных функциональных возможностей в CoGIS (см. п. 7.8 ). Под отчетами подразумеваются различные docx или xlsx документы - акты, справки, разрешения, заключения, сводные таблицы, перечни и реестры, паспорта объектов и пр. Отчеты может формировать пользователь картографического приложения по кнопке (см. п. 7.8.6 ). Но бывают сценарии, когда это нужно выполнять автоматически.
Задача по формированию отчета может быть запущена в двух вариантах:
  • формирование отчета по выборке слоев картографических сервисов;
  • формирование отчета по каждому из объектов выбранного слоя картографического сервиса.
Отчеты настраиваются в Конструкторе (см. п. 7.8 ). Для задачи формирования отчетов по расписанию, помимо общих настроек (см. п. 9.1.1 ), можно задать следующие настройки (см. Рисунок 659 ):
  • Переопределить авторизацию - задайте логин и пароль пользователя, с правами которого будет запускаться задача по расписанию (раздел Настройки запуска ). Пароль можно скрыть, нажав на . По умолчанию используется логин и пароль администратора ГИС-сервера.
    При сохранении настроек логин и пароль могут быть зашифрованы. Для этого отметьте опцию Шифровать логин-пароль при сохранении настроек .
  • Продолжать выполнение задачи для всех входных объектов (если заданы) - если опция отмечена ( раздел Настройки запуска > В случае ошибки ), то в случае возникновения ошибки при обновлении какого-либо объекта в слое, выполнение задачи не прервется, выполнение будет продолжено для других объектов слоя выбранного картографического сервиса. По умолчанию опция отмечена.
  • Карта - выберите из выпадающего списка одно из картографических приложений из Каталога Конструктора CoGIS Portal. Будет формироваться один из отчетов, настроенных именно для этого приложения.
  • Отчет - выберите из выпадающего списка один из настроенных отчетов выбранного картографического приложения. В скобках указывается версия отчета.
  • Сервис - необязательный параметр. Выберите из выпадающего списка картографический сервис, по объектам слоя которого будут сформированы отчеты в рамках задачи по расписанию. Вы также можете вписать URL сервиса вручную в текстовое поле или вставить его из буфера обмена. Вы можете перейти к Rest API выбранного сервиса по кнопке .
    Указав картографический сервис, укажите и слой (следующий параметр), по объектам которого будет формировать отчет.
  • Слой - необязательный параметр. Выберите из выпадающего списка слой картографического сервиса, указанного в предыдущем параметре, по объектам которого будут сформированы отчеты в результате выполнения задачи по расписанию. При необходимости задайте атрибутивный SQL-фильтр, определяющий, по каким объектам выбранного слоя должны быть сформированы отчеты, по кнопке .
  • Поля для обновления - необязательный параметр. Задайте атрибутивные поля текущего обрабатываемого объекта выбранного слоя для обновления по результату формирования отчетов.
    Нажмите на кнопку и добавьте пару поле-значение. Выберите из выпадающего списка атрибутивное поле, задайте для него новое значение. В качестве значения можно указать фиксированное значение или макросы (см. п. 9.1.3 ).
  • Рисунок 659 - Настройка задачи формирования отчетов по расписанию
По завершении выполнения задачи по расписанию дополнительно к действиям из п. 9.1.2 можно настроить (раздел По результату выполнения ):
  • копирование выходного файла отчета в указанную папку (параметр В случае успешного выполнения копировать выходной файл );
    Укажите в текстовой строке путь до папки, куда необходимо сохранять сформированные отчеты.
  • отправление email с отчетом (параметр Отправить email с отчетом , см. Рисунок 660 );
    Сформированный файл отчета будет приложен к письму в качестве вложения.
    Выберите Тип получателя - Электронная почта , Логин пользователя или Имя группы пользователей . Письмо отправится на указанную электронную почту. В случае выбора логина пользователя или группы пользователей письмо отправится на электронную почту, указанную при регистрации пользователя.
    Укажите адресатов (параметр Кому ). Нажимая на , добавьте строковое поле, в котором укажите корректный адрес электронной почты, логин пользователя или выберите из выпадающего списка нужную группу пользователей, согласно выбранному типу получателя. Можно добавлять несколько адресатов.
    Укажите тему сообщения (параметр Тема ). Напишите текст сообщения (параметр Текст ).
    В полях для ввода адресатов, темы и текста сообщений можно использовать макросы (см. п. 9.1.3 ).
  • обновление атрибутов текущего объекта в случае возникновения ошибки при выполнении задачи по формированию отчета (параметр В случае ошибки обновить текущий объект ). Опция доступна при формировании отчетов по объектам слоя выбранного картографического сервиса (для задачи заполнены параметры Сервис и Слой ).
    Нажмите на кнопку и добавьте пару поле-значение (параметр Поля для обновления ). Выберите из выпадающего списка атрибутивное поле, задайте для него новое значение (см. Рисунок 657 ). В качестве значения можно указать фиксированное значение или макросы (см. п. 9.1.3 ).
  • Рисунок 660 - Настройка отправления письма с отчетом по результату выполнения задачи по расписанию
Обратите внимание, что если в настройках отчета в Конструкторе отмечена опция Прикреплять к текущему объекту (см. п. 7.8.5 ), то файл отчета, сформированный в результате работы задачи по расписанию добавится к объекту как вложение. При этом если в настройках отчета в Конструкторе указан шаблон карточки, где через Дополнительные инструменты добавлена кнопка для генерации отчета с указанием опции Блоки с файлами (см. п. 7.4.3.2.3 ), то именно этот блок будет использован для прописывания атрибутов отчета как файлового вложения.