Как собрать и установить плагин Postgres в FastReport .NET

Наш FastReport .NET имеет достаточно богатые возможности и широкий функционал. Сегодня мы рассмотрим подключение к базе посредством плагина FastReport для дизайнера отчетов.

Далее в качестве примера путь установки FastReport .NET будет следующим: C:\Program Files (x86)\FastReports\WinForms

1.    Переходим в папку установки и далее переходим по пути Extras\Core\FastReport.Data\FastReport.Data.Postgres

Важно! Путь должен быть именно такой, по другим путям могут быть устаревшие проекты.

2.    Находим там файл проекта FastReport.Data.Postgres.csproj в Visual Studio.

Важно! В этой папке находится несколько файлов, нужно открыть именно этот.

3.    В Visual Studio откроется несколько проектов. Выбираем FastReport.Data.Postgres и кликаем по нему правой кнопкой, а затем нажимаем в контекстном меню пункт «Назначить в качестве запускаемого проекта».

4.    Выбираем сборку «Release» и платформу «net462».

5.    В дереве решений разворачиваем проект -> Зависимости -> net462 -> Проекты и Пакеты. Обращаем внимание на восклицательные знаки в треугольниках.

6.    Удаляем «FastReport» в «Проекты». Больше в зависимостях (Dependencies) ничего не удаляем. Теперь нужно добавить nuget-пакеты FastReport.Net и Npgsql. 

Важно! FastReport.Net надо добавлять именно пакетом, так как способ с добавлением FastReport.dll больше не работает.

7.    В контекстном меню «Зависимости» выбираем пункт «Управление пакетами NuGet».

8.    Нужно добавить два источника пакетов (Package source): nuget.org и источник ссылающийся на наш Nuget Server, либо на локальную папку C:\ProgramFiles(x86)\FastReports\WinForms\Nugets.

9.    Выбираем источник nuget.org.

10.    На вкладке «Установлено» или «Обновления» находим пакет Npgsql и кликаем на него.

11.    Смотрим справа и видим следующую информацию: текущая привязанная к проекту версия 3.2.7, последняя версия пакета 8.0.3, кнопки Удалить и Обновить.

12.    Нажимаем на кнопку Обновить.

13.    Выбираем второй источник пакетов. В примере используется NuGet-сервер ООО "Быстрые отчеты".

14.    Переходим на вкладку Обзор и в поле поиска вводим fastreport.net

15.    Выбираем пакет FastReport.Net либо FastReport.Net.Demo для триальной версии. 

Важно! Именно один из этих двух пакетов, так как пакет FastReport.Net.Pro устарел и более не используется. 

16.    Внимательно смотрим на версию и выбираем ту, которая у нас установлена. В этой инструкции рассматривается версия 2024.2.12.

17.    Жмем кнопку "Установить". Принимаем лицензионное соглашение и дожидаемся установки пакета.

18.    Кликаем правой кнопкой на проект FastReport.Data.Postgres и в контекстном меню жмем Собрать.

19.    Слева внизу видим надпись «Сборка прошла успешно». Это значит, что плагин собран корректно, и Visual Studio можно закрыть.

20.    Переходим в папку где установлен FastReport .NET, как указано в начале инструкции это C:\Program Files (x86)\FastReports\WinForms. Здесь должен быть «Designer.exe».

21.    Переходим из этой папки в следующие папки ниже по пути: Extras\Core\FastReport.Data\FastReport.Data.Postgres\bin\Release 

22.    Находим 2 папки «net462» и «net6.0-windows7.0», заходим в папку net462.

23.    Копируем из этой папки следующие файлы: 

FastReport.Data.Postgres.dll, 
Npgsql.dll, 
Microsoft.Bcl.AsyncInterfaces.dll, 
Microsoft.Extensions.Logging.Abstractions.dll, 
System.Threading.Tasks.Extensions.dll, 
System.Memory.dll 

24.    Вставляем скопированные файлы в папку, в которой находится Designer.exe.

25.    Запускаем «Designer.exe», переходим в меню File->Options (View->Options если Ribbon-интерфейс отключен). Переходим на вкладку «Plugins».

26.    Если тут уже есть плагин FastReport.Data.Postgres, его надо удалить и повторить пункт 21.

27.    Нажимаем на кнопку «Добавить», переходим в папку дизайнере, в этом примере это C:\Program Files (x86)\FastReports\WinForms 

28.    Выбираем файл FastReport.Data.Postgres.dll и жмем кнопку «Открыть». Плагин появился в списке.

29.    Обращаем внимание на надпись слева внизу, которая говорит о том, что Дизайнер нужно перезапустить. Жмем кнопку OK. Закрываем дизайнер.

30.    Запускаем Designer.exe еще раз. Если все сделано по этой инструкции, то подключение к Postgres должно появиться в списке подключений.

31.    Если при попытке подключения появляются подобные ошибки:

То нужно закрыть дизайнер, скопировать файл указанный в ошибке из папки С:\Program Files(x86)\Fast Reports\WinForms \Extras\Core\FastReport.Data\FastReport.Data.Postgres\bin\Release\net462 в папку, где находится у вас Designer.exe.

В FastReport .NET очень просто собирать и подключать различные коннекторы к множеству баз данных.