Курс. Часть 5

Менеджер отчетов

Краткое содержание
Пятая часть курса посвящена Менеджеру отчетов первого раздела плагина — инструменту для управления и обновления данных в отчетах, которые были ранее созданы и выгружены на листы с помощью Менеджера SQL (Часть 3 Курса).

Ниже рассмотрим ключевые особенности данного модуля:
Интерфейс и назначение:
Описан запуск и структура Менеджера отчетов, который предоставляет централизованный список всех отчетов, созданных в текущей книге Р7-Офис.
Интерфейс позволяет видеть, на каких листах расположены отчеты и какие SQL-запросы лежат в их основе.

Обновление данных:
Менеджер отчетов является ключевым инструментом для поддержания актуальности данных. Рассмотрены три основных сценария обновления:
- Обновить все отчеты: Глобальное обновление всех отчетов в документе одной кнопкой.
- Обновить выделенные отчеты: Позволяет выбрать несколько конкретных отчетов и обновить только их, экономя время.
- Обновление одного отчета: При выборе конкретного отчета можно просмотреть его данные и обновить его индивидуально.

Редактирование и предпросмотр:
При выборе отчета в правой части окна отображается его исходный SQL-запрос.
Важная функция: Этот SQL-запрос можно отредактировать прямо на месте, например, изменить поля выборки (SELECT), добавить фильтры (WHERE) и т.д.
Кнопка «Предпросмотр» позволяет увидеть результат измененного запроса до его выгрузки на лист, что очень удобно для проверки гипотез и внесения правок.
После подтверждения изменений отчет на листе будет обновлен в соответствии с новым SQL-запросом.

Практические примеры:
Наглядно демонстрируется, как после ручного удаления строк или столбцов в выгруженном отчете, Менеджер отчетов полностью восстанавливает исходные данные при обновлении, гарантируя целостность информации.
Этот инструмент превращает статичные выгрузки в динамические отчеты, которые можно легко поддерживать в актуальном состоянии.
1. Запуск Менеджера отчетов. Элементы управления
Менеджер отчетов предназначен для управления отчетами, созданными в Менеджере SQL (см. Часть 3).
Как запустить:
Нажмите кнопку Менеджер отчетов в меню первого раздела плагина Слайдер данные для Р7-Офис.
Ниже приведен пример интерфейса.
Окно Менеджера отчетов

Верхняя часть:
Кнопки:
  • Скрыть/Показать боковую панель — для управления видимостью левой области.
  • Обновить выделенные отчеты — становится активной при выборе отчета.
  • Обновить все отчеты — обновляет все отчеты в книге.

Средняя часть:
Левая область (дерево объектов):
  • Раздел "Текущий документ"
  • Переменные пользователя.
  • Список листов с отчетами.
Правая область (запросы):
  • Редактор SQL-запроса.
  • Предпросмотр отчета с кнопкой «Предпросмотр».
2. Элементы управления верхней части Менеджера отчета
Кнопка «Скрыть боковую панель» предназначена для того, чтобы убрать левую область.
Это позволяет расширить область запросов при необходимости.
После нажатия на кнопку «Скрыть боковую панель» окно Менеджера отчета будет выглядеть следующим образом:
Кнопка «Скрыть боковую панель» изменится на кнопку «Показать боковую панель».
При нажатии на неё окно менеджера отчетов вернется к исходному виду.
Кнопка «Обновить выделенные отчеты» изначально, пока не выбраны отчеты, неактивна.
При выделении отчетов кнопка запускает их обновление.
  • Кнопка «Обновить все отчеты» вызывает обновление всех отчетов. При большом количестве отчетов, сформированных в книге, следует подождать, пока все отчеты не будут обновлены.
3. Примеры работы с Менеджером отчетов
Создадим в Менеджере SQL несколько отчетов.
3.1. Соединение PostgreSQL
Запустите Менеджер SQL. Выберите запрос. Нажмите кнопку Предпросмотр.
Результат:
В подобласти предпросмотра будут выведены первые 10000 строк данных.
Прокрутите область отображения ниже и нажмите кнопку «Выгрузить в документ»
В появившемся окне выберите опцию выгрузки и нажмите кнопку «Выгрузить».
Выгрузим в текущий документ
3.2. Соединение MS SQL – mssql. Запрос mssql.
Создадим и сохраним отчет tablmssql для соединения MS SQL.
Выгрузили данные на тот же лист, таблица располагается через 1 колонку после предыдущей выгрузки.
3.3. Проверка Менеджера отчетов.
·       На листах очистите строки, столбцы, значения в отчетах чтобы проверить как они обновляются.
·       Например, ниже на скриншотах видно как удалены данные в отчетах
3.4. Обновление отдельных отчетов.
  • Запустите Менеджер отчетов.
  • Слева в дереве показаны созданные отчеты.
  • При клике на любой можно просмотреть запрос и вызвать его для просмотра.
  • Установите чек-бокс только для одного из отчетов, нажмите кнопку «Обновить выделенные отчеты».
  • Подтвердите выбор
  • Запускается процесс обновления
  • Появится информационное окно о том, что 2 отчета обновлено
  • После того, как Менеджер отчетов закроется, проведите проверку данных на листах.
  • Проверяем, и видим, что был обновлен только 1 отчет, как и было запланировано
3.5. Обновление всех отчетов.
  • Опять частично очистите данные у всех отчетов.
  • Запустите Менеджер отчетов.
  • Нажмите кнопку «Обновить все отчеты»
  • Наблюдаем, что все отчеты были обновлены
4. Редактирование отчета «на лету»
Имеется возможность редактирования и просмотра результата SQL-запроса. Например, вместо запроса с выводом всех столбцов можно вывести только несколько. Например, для отчета «pg» вместо
SELECT * from person.address limit 100

можно ввести измененный запрос (вывод только 1-го и 2-го столбца)
SELECT addressid, addressline1 from person.address limit 100

По кнопке Предпросмотр должны быть выведены 1-й и 2-й столбцы, только они будут обновлены в отчете.
То есть, удаляем данные из нескольких столбцов
Затем обновляем запрос в редакторе отчетов и запускаем предпросмотр
Затем выбираем отчет pg (ставим галочку) и обновляем его – нажимаем обновить выделенный отчет.
Видим, что были обновлены только первые 2 колонки – из обновленного запроса.