Отчёт из PostgreSQL в приложении .NET 5 под управлением Astra Linux
Сегодня мы поговорим о российской операционной системе Astra Linux. Эта система получила в последнее время довольно широкое распространение. Разработкой и сопровождением Astra Linux занимается АО «НПО РусБИТех». Существуют разные редакции системы, в том числе и специального назначения. Мы будем рассматривать систему общего назначения Astra Linux Орёл 2.12 в связке с СУБД PostgreSQL 9.6.15 и платформой .NET 5, с помощью которых мы попробуем сделать простое веб-приложение с использованием генератора отчётов FastReport .NET Core. Стоит отметить, что большинство моментов, которые мы будем применять на практике далее, также будут работать и в редакциях Astra Linux специального назначения (Смоленск, Новороссийск, Севастополь и других).
Начнем с установки операционной системы Astra Linux
Скачать ISO образ Astra Linux можно с официального сайта.
Подробно процесс установки и первоначальной настройки рассказывать нет смысла – есть очень подробная документация на сайте производителя. Вся процедура проста и понятна – достаточно следовать инструкциям на экране.
Если вы планируете установить систему для экспериментов в качестве виртуальной машины Hyper-V (входит в состав Windows Professional и Enterprise), то следует обратить внимание на следующие моменты:
- Виртуальная машина должна быть первого поколения;
- Нужно использовать IDE контроллер для жесткого диска и DVD-ROM;
- Поддерживается legacy сетевой адаптер;
- При старте инсталляции на первом экране нужно выбрать опцию установки acpi=off;
После установки системы нужно скачать с помощью браузера пакет поддержки Hyper-V и затем установить его командой в консоли:
sudo dpkg -i hyperv-daemons_5.3.9-2_amd64_signed.deb
после этого нужно перезагрузить систему.
Для экспериментов нам нужен фреймворк .NET 5
Открываем консоль и выполняем следующие команды:
wget -O - https://packages.microsoft.com/keys/microsoft.asc | gpg --dearmor > microsoft.asc.gpg sudo mv microsoft.asc.gpg /etc/apt/trusted.gpg.d/ wget https://packages.microsoft.com/config/debian/9/prod.list sudo mv prod.list /etc/apt/sources.list.d/microsoft-prod.list sudo chown root:root /etc/apt/trusted.gpg.d/microsoft.asc.gpg sudo chown root:root /etc/apt/sources.list.d/microsoft-prod.list
После этого нужно обновить репозиторий пакетов и установить .NET 5 следующими командами:
sudo apt-get update sudo apt-get install -y apt-transport-https sudo apt-get install -y dotnet-sdk-5.0
Правильность установки .NET 5 можно проверить, выполнив команду запроса версии в консоли (5.0.100 на момент написания статьи):
dotnet --version
Если вы планируете всерьез заниматься разработкой программ на Astra Linux, то вам понадобится редактор Visual Studio Code. Для того, чтобы его установить, нужно скачать пакет с официального сайта. Далее пакет нужно установить (имя файла пакета может отличаться, указано актуальное на момент написания статьи):
sudo dpkg -i code_1.51.1-1605051630_amd64.deb
Для дальнейшей работы нам нужны Git и библиотека libgdiplus, ставим их с помощью команд:
sudo apt install git sudo apt install libgdiplus
Переходим в домашнюю папку и выполняем команду клонирования репозитория с примером приложения и дампом тестовой базы данных, которые нам понадобятся позже:
git clone https://github.com/fediachov/FastReportSamples
Настало время установить и настроить СУБД PostgreSQL
Вероятно, вы всё уже установили в процессе выбора компонентов операционной системы. Если нет, то выполняем команду в консоли:
sudo apt install postgresql-astra postgresql-contrib
Ждем завершения установки. Убедимся, что установлена нужная нам версия – выполним в консоли команду запуска утилиты psql (важный момент - она должна работать от имени пользователя postgres):
sudo -u postgres psql
Далее вводим команду получения номера версии:
SELECT version();
Выходим из psql (клавиши Ctrl+D) и переходим к настройке СУБД. Если предполагается доступ к СУБД с других компьютеров (или хостовой системы в случае с Hyper-V), то необходимо добавить нужную подсеть в файл конфигурации /etc/postgresql/9.6/main/pg_hba.conf:
host all all 192.168.1.0/24 md5
Также нужно внести изменения в файл конфигурации /etc/postgresql/9.6/main/postgresql.conf:
# - Connection Settings - listen_addresses = '*' # what IP address(es) to listen on;
После изменений нужно перезапустить Postgres:
sudo systemctl restart postgresql
Теперь нужно создать тестовую базу данных и пользователя с нужными правами для доступа к ней. Для этого снова запускаем утилиту psql и выполняем в ней следующие команды:
CREATE DATABASE frdemo; create user fastreport with encrypted password 'fastreport'; grant all privileges on database frdemo to fastreport;
Выходим из psql и импортируем тестовую базу из дампа примера (дамп находится в папке ~/FastReportSamples/PostgreSQL/database):
cd ~/FastReportSamples/PostgreSQL/database sudo -u postgres psql frdemo < fr-pg-demo.sql
Чтобы убедиться, что все наши таблицы созданы и доступны, запускаем psql и выполняем там команды (назначение прав, подключение к базе frdemo, вывод списка таблиц, вывод содержимого таблицы):
GRANT ALL ON ALL TABLES IN SCHEMA public TO fastreport; \c frdemo \dt SELECT customerid, companyname, contactname FROM customers;
Вы уже скачали готовый пример программы и отчёта с GitHub и самое время сделать отступление, чтобы рассказать, как они были созданы после аналогичных операций, которые мы с вами проделали выше.
Собственно, создание отчёта из PostgreSQL
Для создания и редактирования шаблона отчёта был использован продукт FastReport for DBA – в него уже встроен плагин для доступа к PostgreSQL. Если же вы планируете работать с PostgreSQL из FastReport .NET, то вам предварительно нужно скомпилировать плагин из папки установки FastReport .NET \Extras\Connections\FastReport.Postgres, затем зарегистрировать полученную сборку в настройках дизайнера. Также возможно использование дизайнера FastReport Designer Community Edition из комплекта поставки FastReport Open Source, но следует помнить, что этот дизайнер сильно ограничен по возможностям.
Вся работа с шаблоном отчёта на данном этапе проводилась в операционной системе Windows с подключением к СУБД PostgreSQL, работающей на Astra Linux. Упреждая вопросы, сразу скажу, что можно было бы вести разработку шаблона в графическом интерфейсе Linux, но на данный момент есть единственный продукт способный это делать – FastReport Mono. Настройка и использование фреймворка Mono на Astra Linux выходит за рамки данной статьи. Другой вариант – использование FastReport Online Designer, но он требует приобретения лицензии и не подходит для наших примеров в демонстрационной редакции.
Итак, запускаем дизайнер отчётов FastReport, выбираем создание нового отчёта и переходим к настройке подключения к СУБД PostgreSQL:
Далее выбираем таблицу для экспериментов, в нашем случае это employees:
Далее переходим к разработке шаблона отчёта. Простые руководства как сделать простой отчёт, можно посмотреть на Youtube канале. В результате мы получили такой результат:
После создания шаблона отчёта можно его протестировать – вызвать предварительный просмотр:
В нашем случае именно этот шаблон отчёта попал к вам вместе с демонстрационным примером, который вы скачали ранее с GitHub.
Строим отчёт в Astra Linux
Возвращаемся к сборке примера веб-приложения. В качестве прототипа послужил стандартный шаблон MVC приложения, который создается командой:
dotnet new mvc
После создания проекта была добавлена модель /Models/HomeModel.cs:
public class HomeModel { public WebReport WebReport { get; set; } }
Затем были внесены правки в контроллер /Controllers/HomeController.cs - добавлен следующий код:
public IActionResult Index() { var model = new HomeModel(); model.WebReport = new WebReport(); model.WebReport.Report.Load( Path.Combine("Reports", "postgres.frx")); model.WebReport.DesignerLocale = "ru"; model.WebReport.Width = "100%"; model.WebReport.Height = "800"; // model.WebReport.Mode = WebReportMode.Designer; return View(model); }
В файле Startup.cs в функцию Configure добавлен вызов:
app.UseFastReport();
Затем зарегистрирован плагин для подключения к PostgreSQL:
FastReport.Utils.RegisteredObjects.AddConnection( typeof(FastReport.Data.PostgresDataConnection));
Чтобы была возможность обращаться к запущенному приложению с других компьютеров в подсети, в файле Program.cs изменена функция CreateHostBuilder:
1 2 3 4 5 6 7 |
public static IHostBuilder CreateHostBuilder(string[] args) => Host.CreateDefaultBuilder(args) .ConfigureWebHostDefaults(webBuilder => { webBuilder.UseStartup<Startup>(); webBuilder.UseUrls("http://0.0.0.0:8080"); }); |
В папке Reports размещен тестовый шаблон отчёта, который был сделан ранее.
В проекте использованы Nuget пакеты FastReport .NET, они будут автоматически скачаны в момент начала сборки. Перечень пакетов хранится в файле core.csproj. Эти пакеты можно заменить на аналогичные по функционалу от продукта FastReport Open Source, если вам будет достаточно его возможностей.
Для сборки и запуска веб-приложения нужно выполнить следующие команды:
cd ~/FastReportSamples/PostgreSQL/dotnet-5 dotnet build dotnet run
Запускаем браузер и открываем адрес http://localhost:8080
Если у вас есть другой компьютер под рукой (например, хостовый компьютер в случае с Hyper-V), запускаем браузер там и обращаемся к серверу под управлением Astra Linux:
Открываем отчёт для редактирования в Web
Если внимательно изучить код тестового приложения, то можно заметить закомментированную строку в файле /Controllers/HomeController.cs:
// model.WebReport.Mode = WebReportMode.Designer;
Если убрать этот комментарий, наш отчёт будет открыт в режиме редактирования в FastReport Online Designer. В нашем примере его код должен находиться в папке /wwwroot/WebReportDesigner/. В данный момент там находится заглушка в виде файла index.html. Если у вас возникнет желание попробовать тестовый вариант FastReport Online Designer в этом или любом другом проекте, то вам необходимо написать соответствующий запрос в службу техподдержки компании Fast Reports support@fastreport.ru
Таким образом, редактирование будет доступно из любого современного браузера на любой платформе (включая планшеты, фаблеты и т.д.)
Нюансы
- Нужно использовать идентичные шрифты в системе, где ведется разработка шаблонов отчётов и на сервере (или веб-приложении, если используются шрифты приложения) – это позволит избежать проблем с внешним видом веб-отчётов и PDF документов;
- При работе с Astra Linux в консоли системы виртуализации Hyper-V интерфейс довольно сильно тормозит – лучше установить VNC или настроить x-server на хостовом компьютере (например Xming);
- Если есть необходимость запустить тестовое приложение под управлением .NET Core 2.2, то тестовый пример можно найти в папке ~/FastReportSamples/PostgreSQL/dotnet-core-2.2;
- Есть возможность разработки не только веб-приложений, но и консольных программ - это позволит строить отчёты в PDF (и других форматах) путем вызова таких программ из других приложений;
- Если вам нужна работа с отчётами в графическом интерфейсе Linux, то следует воспользоваться библиотекой FastReport Mono, так как поддержки интерфейса Linux в .NET 5 пока нет.
Подведем итоги
- У нас есть возможность разработки полноценного веб-приложения на платформе .NET 5 под управлением операционной системы Astra Linux;
- FastReport работает в связке с PostgreSQL;
- Продукты семейства FastReport могут работать в кросс-платформенных решениях и объединять в инфраструктуре разные платформы;
- Библиотеки Fast Reports имеют варианты поставки в комплекте с исходными кодами, что делает возможной последующую сертификацию.
