курс. часть 2

Запуск плагина и настройка соединений

Вторая часть курса посвящена первым шагам работы с плагином «Слайдер Данные» в Р7-Офис. Она охватывает запуск, первоначальную конфигурацию и настройку подключений к различным источникам данных.

Запуск и базовая настройка:

• Описывается процедура запуска плагина через интерфейс Р7-Офис после активации прокси-сервера.
• Даются рекомендации по первоначальной настройке, включая (в первом разделе плагина) указание URL прокси-сервера, таймаутов и параметров логирования.

Менеджер соединений:

• Представлен как центральный узел для управления всеми подключениями.
• Рассматриваются его основные функции: создание, удаление, проверка, а также экспорт и импорт конфигураций соединений в файл (.con или .json), что упрощает их перенос и резервное копирование.

Настройка подключений к источникам данных:

• СУБД (на примере PostgreSQL): Приводится пошаговая инструкция по подключению к реляционной базе данных, включая ввод учетных данных и параметров сервера.

Файловые каталоги:

• Разбирается работа с локальными файлами. Описаны нюансы подключения к различным форматам:
• CSV и TXT(CSV): с настройкой разделителей и обработкой заголовков.
• XLSX: с указанием индекса листа.
• JSON, Parquet: как более простые варианты подключения.

Просмотр структуры:
Демонстрируется, как просмотреть структуру таблиц в базах данных или список
полей в файлах прямо из менеджера соединений.

Сравнение с Excel Power Query:
В завершение проводится анализ преимуществ плагина Слайдер Данные по сравнению со встроенным инструментом Excel.
Подчеркивается, что централизованное управление соединениями, повышенная безопасность, кроссплатформенность (поддержка Linux) и возможность выполнять гетерогенные запросы делают «Слайдер Данные» более мощным и гибким решением для корпоративных сред.

Выберите один из разделов плагина – Структурированные/реляционные данные, Аналитические базы данных, Анализ XLSX файлов, Настройки, О программе

• Примечание: Раздел выбирается только при запуске плагина. Чтобы выбрать другой раздел понадобится перезапуск плагина (необходимо нажать 2 раза на кнопку плагина на панели).

После старта плагина и вызова главной формы пользователь может перейти в один из разделов плагина.

Меню первого раздела плагина содержит:

• Менеджер соединений
• Менеджер SQL
• Менеджер отчетов
• Историю запросов
• Журнал

Меню второго раздела плагина включает:

• Сводные отчеты
• Статичные отчеты
• Менеджер соединений
• Настройки
• История запросов

Для вывода окна сравнения таблиц необходимо нажать кнопку «Сравнение таблиц».

Для вывода окна анализа источников необходимо нажать кнопку «Анализ источников».

Менеджер соединений
Для настройки или проверки соединений нажмите кнопку Менеджер соединений меню первого раздела.
Появится окно Менеджера соединений.

Вверху окна имеются кнопки «Новое соединение» и «Проверить все соединения». Их назначение следует из их названий.
Внизу окна расположены две кнопки «Экспорт в файл» и «Загрузить из файла». Эти кнопки предназначены для сохранения настроек соединений в локальный файл с расширением (.con) и при необходимости загрузки их из ранее сохраненного файла
или файла, полученного иным образом (например, от другого пользователя или администратора). При сохранении файла возможно сохранение запросов (для этого необходимо проставить соответствующую галочку).

Средняя часть окна Менеджера соединений разбита на левую и правую область.
В левой области находится список заданных соединений. Справа - область параметров выбранного соединения.

Нажмите кнопку «Новое соединение».
Ниже приведен вид правой области (область ввода параметров) для типа СУБД PostgreSQL.
Для других типов вид области ввода и список параметров может быть другим.

Например:

У любых типов СУБД, в том числе файловых каталогов правая область содержит кнопки «Проверить» и «Отменить».
После нажатия кнопки «Новое соединение» нужно выбрать Тип СУБД (PostgreSQL)

Очистятся поля ввода параметров соединения.

• Имя соединения: ms sql connection
• Адрес сервера СУБД: xxx.xxx.xxx.xxx
• Порт сервера СУБД: 51433
• Имя СУБД: AdventureWorksDW
• Схема БД: dbo
• Логин: sa
• Пароль:******

После ввода параметров нажмите кнопку Проверить. При корректных параметрах появится окно подтверждения

Нажмите кнопку Ok. В списке соединений (область слева) появится новое соединение.

Работа с файловыми каталогами отличается от работы с СУБД. К файловым источникам относятся пункты списка типов СУБД: CSV, XLSX, Parquet, JSON, HTML.

• Нажмите кнопку «Новое соединение».  Выберите один из файловых типов, например, Excel – XLSX files

Можно модифицировать процесс обработки файлов данных с помощью чек-боксов в области параметров соединения.

• Если требуется обработка вложенных каталогов, нужно пометить чек-бокс «Включить поддиректории».
• Чтобы объединить данные из файлов с одинаковой структурой, нужно пометить чек-бокс «Объединить файлы одного формата».

После ввода пути к каталогу с файлами нажимаем «Проверить» и после подтверждения слева в списке появляется соединение

В соединении можно раскрыть узел и увидеть названия файлов из каталога

Далее это соединение

CSV files – файлы с разделителями между данными в строках. Файл данных должен иметь расширение (.csv).
Поля для заполнения аналогичны файлам Excel.

Помимо поля выбора каталога и модификаторов процесса обработки файлов данных добавлены:

• чек-бокс Автоопределение
• поле Разделитель
• поле Пропустить строк
• список Заголовок.

Можно выбрать свой разделитель в поле Разделитель, обычно это запятая, но может быть и точка с запятой или другой символ. Возможно, подойдет и автоопределение, в этом случае пометьте чек-бокс Автоопределение (при этом значение в поле Разделитель не используется).

Файлы данных бывают с заголовками или без них. Для выбора вариантов обработки заголовков используйте список Заголовок.

Выберите AutoDetect (Автоопределение заголовков) или явно задайте их наличие или отсутствие.

Поле Пропустить строк предназначено для указания строки (начиная с 0), с какой нужно обрабатывать данные.

Нажмите кнопку «Проверить все соединения».
При успешной проверке область со списком соединений не должна измениться.
В случае проблем с соединением рядом с его значком появится иконка

Запустим проверку для текущих соединений.

Для проверки отдельного соединения выберите это соединение в области соединений, нажмите кнопку Проверить.
При успешном тесте появится соответствующее сообщение.
Если перед проверкой были изменены параметры соединения, то они сохранятся автоматически после проверки.

Для сохранения файла соединений нажмите кнопку «Экспорт в файл», подтвердите (нажмите галочку), если хотите выгрузить все запросы вместе с соединениями, введите необходимое имя файла и сохраните в выбранной директории.

●      Для загрузки файла соединений необходимо нажать кнопку «Загрузка из файла».

В области соединений значки соединений содержат слева серые треугольники.

При нажатии серого треугольника соединения откроется структура Tables, Views с серыми треугольниками.
Далее будет уровень, содержащий структуру таблиц и представлений.

В области соединений значки (Папки) соединений с файловыми каталогами содержат слева серые треугольники, как и для СУБД.

Чтобы вернуться в меню первого раздела плагина закройте и заново откройте плагин через верхнее меню-ленту.

Для настройки или проверки соединений нажмите кнопку Менеджер соединений меню второго раздела.
Появится окно Менеджера соединений.

Вверху окна имеются две кнопки «Новое соединение», «Удалить соединение». Внизу окна расположены две кнопки
«Экспорт в файл» и «Импорт из файла». Эти кнопки предназначены для сохранения настроек соединений в локальный файл .json и при необходимости загрузки их из ранее сохраненного файла или файла, полученного иным образом.
При сохранении файла возможно сохранение паролей соединений. Для этого нужно пометить чек-бокс «С паролями».

Средняя часть окна Менеджера соединений разбита на левую и правую область. В левой области находится список заданных соединений. Справа - область параметров выбранного соединения с кнопками «Сохранить» и «Проверить».

1. Откройте "Менеджер соединений".
2. Заполните следующие поля для нового соединения:

• Имя соединения: Уникальное имя для идентификации соединения (например, `fm`, `fad`).
• URL: Адрес OLAP-сервера (например, http://89.169.162.67:58888/emondrian/xmla` или `https://olap.flexmonster.com/olap/msmdpump.dll`).
• Источник данных: Строка подключения к источнику данных (например, Foodmart).
• Каталог: Имя каталога (например, `FoodMart` или `Adventure Works DW Standard Edition`).
• Username (опционально): Имя пользователя для аутентификации.
• Password (опционально): Пароль для аутентификации.

3.Нажмите кнопку "Проверить" для проверки соединения.

Нажмите кнопку Ok. Нажмите кнопку Сохранить.
В списке соединений (область слева) появится новое соединение – fm, если его не было.

MS Excel Power Query — это встроенный инструмент MS Excel для извлечения, преобразования и загрузки данных из источников данных.
В PowerQuery (PQ) для настройки подключений используется мастер подключения. Покажем его работу на примере подключения к SQL серверу. Интерфейс мастера подключения выглядит так:

Подключение к источнику в PQ для PostgreSQL выполняется через пошаговый мастер:
1.Вкладка "Данные" → "Получить данные" → "Из базы данных" → PostgreSQL.
2.Указание сервера, базы, логина и пароля
3.Возможность использовать SQL-запрос (опционально).

Неудобства такого подхода:

• Учётные данные хранятся локально: логины и пароли часто приходится вводить вручную, многие хранят их на бумаге или в файлах на рабочем столе.
• Нет централизованного хранилища подключений: нельзя легко делиться настройками подключения между коллегами или командами.
• Отсутствует проверка соединения в момент настройки: вы узнаете об ошибке только при попытке загрузки.
• ODBC-драйверы требуют ручной установки и часто администраторских прав, что вызывает проблемы, особенно в организациях с ограниченным доступом пользователей.
• Настройка ODBC в Excel — отдельный квест: ручное добавление источников в панели управления Windows, учёт архитектуры (32/64 бит), нестабильное поведение при обновлениях.

Для стабильной и безопасной работы с базами в Excel требуется значительная техническая подготовка.
Каждое подключение в Power Query настраивается отдельно — для запроса требуется вручную ввести параметры, выбрать таблицу и указать источник. Это означает, что даже при работе с одной и той же базой пользователь вынужден тратить по 10–15 минут на повторную настройку.

Если в организации включена политика регулярной смены паролей (раз в 3–6 месяцев), то после каждого изменения пароля необходимо заново открыть и перенастроить все связанные отчёты. В условиях корпоративной работы это создаёт высокий риск ошибок и потери времени.

В Power Query отсутствует централизованный контроль за тем, насколько актуальны данные в отчёте. Обновление данных происходит вручную или при открытии файла. Пользователь не получает уведомлений о неудачном обновлении. В результате часть отчётов может базироваться на устаревших данных, что особенно критично в бухгалтерии и управленческом учёте. Это вызывает ограничения — особенно при работе с безопасными или нестандартными источниками.

Плагин «Слайдер Данные» в Р7-Офис построен на более гибкой, хотя и менее визуальной архитектуре через систему Менеджера соединений с сохранением конфигурации подключений во внешнем файле с возможностью восстановления подключений из него. Для новичков это, возможно, менее удобно, но зато обеспечивает полный контроль над соединениями. Это более безопасно, а также способствует повторяемости среды в многопользовательских системах.

Дополнительно плагин «Слайдер Данные» в Р7-Офис в первом разделе позволяет объединять таблицы из различных источников (гетерогенные запросы), имеет Менеджер отчетов для автоматизированного обновления отчетов и макросы, обеспечивающие расширяемость применения. В средах с ограниченным доступом к интернету возможна работа через внутренние шлюзы.

Такой уровень управления плагина даёт преимущество в корпоративных ИТ-средах, особенно в связке с регламентированными отчётами.

Если вы работаете в организации с ограничениями на ПО, защищёнными каналами или нестандартными источниками — плагин Слайдер Данные Р7-Офис будет мощным и гибким решением, более предпочтительным, чем Power Query.

В части 3 курса по использованию плагина Слайдер данные в табличном редакторе Р7-Офис рассмотрим работу с Менеджером SQL первого раздела плагина.