FastReport

Что такое ФастРепорт?

FastReport предоставляет бесплатный генератор отчетов с открытым исходным кодом для .NET 6/.NET Core/.NET Framework. Вы можете использовать FastReport с открытым исходным кодом в MVC, веб-API, консольных приложениях.

Функции

FastReport написан на C# и совместим с .NET Standard 2.0 и выше. Расширяемая архитектура FastReport позволяет создавать собственные объекты, фильтры экспорта, мастера и механизмы БД.

Объекты отчета

• FastReport — генератор отчетов, ориентированный на диапазоны. Доступно 13 типов полос: заголовок отчета, сводка отчета, заголовок страницы, нижний колонтитул страницы, заголовок столбца, нижний колонтитул столбца, заголовок данных, данные, нижний колонтитул данных, заголовок группы, нижний колонтитул группы, дочерний элемент и наложение. Кроме того, полностью поддерживаются вложенные отчеты.

• Широкий выбор типов бэндов позволяет создавать любые виды отчетов: список, основной-подробный, групповой, многоколоночный, основной-подробный-подробный и многие другие.

• Широкий спектр доступных объектов отчета: текст, изображение, линия, фигура, штрих-код, матрица, таблица, флажок.

• Отчеты могут состоять из нескольких страниц дизайна, что позволяет отчетам содержать обложку, данные и заднюю обложку в одном файле.

• Объект «Таблица» позволяет построить табличный отчет с переменным количеством строк и/или столбцов, как в MS Excel. Также доступны агрегатные функции.

• Мощный, полностью настраиваемый объект Matrix, который можно использовать для печати сводных таблиц.

• Сообщить о наследстве. Для создания множества отчетов с общими элементами, такими как заголовки, логотипы или нижние колонтитулы, вы можете поместить все общие элементы в базовый отчет и наследовать все остальные отчеты из этой базы.

Источники данных

• Вы можете получать данные из XML, CSV, Json, MS SQL, MySql, Oracle, Postgres, MongoDB, Couchbase, RavenDB, SQLite.

• FastReport имеет возможность получать данные из бизнес-объектов типа IEnumerable.

• Отчет может содержать источники данных (таблицы, запросы, соединения с БД).

• Таким образом, вы можете не только использовать наборы данных, определенные приложением, но также подключаться к любой базе данных и использовать таблицы и запросы непосредственно в отчете.

Внутренние сценарии

FastReport имеет встроенный механизм сценариев, поддерживающий два языка .NET: C# и VB.NET. Вы можете использовать всю мощь .NET в своих отчетах для выполнения сложной обработки данных и многого другого.

Работа с шаблонами отчетов

Создать шаблон отчета можно несколькими способами:

• Создание отчета из кода.

• Разработка шаблона отчета в виде XML-файла.

• Использование онлайн-конструктора FastReport.

• Использование FastReport Designer Community Edition (бесплатное ПО). Его можно скачать со страницы релизов FastReport.

Экспорт

FastReport Open Source может сохранять документы в форматах HTML, BMP, PNG, JPEG, GIF, TIFF, EMF.

Экспорт PDF доступен в виде плагина. Посмотреть пример его использования можно здесь. Если вам этого экспорта недостаточно и вам нужен полноценный PDF-экспорт с шифрованием, цифровой подписью и встраиванием шрифтов — обратите внимание на FastReport .NET Core.

Сообщество дизайнера отчетов

Для редактирования отчетов мы сделали специальную сборку дизайнера отчетов — FastReport Designer Community Edition. Программа предназначена для использования в операционной системе Windows и содержит все ограничения версии с открытым исходным кодом. Мы не предоставляем исходный код редактора, поскольку он является частью коммерческого продукта FastReport .NET. Публикация этой программы – наша добрая воля и наше желание. Лицензия MIT не распространяется на исходный код.

Установка

FastReport можно скомпилировать из исходников или установить из пакетов NuGet.

Сборник

1. Установите .NET 5 SDK для вашей ОС с https://www.microsoft.com/net/download.

2. Следуйте командам

 # для пользователей Windows git clone https://github.com/FastReports/FastReport.gitcd FastReport
пакет.bat

 # для пользователей Linuxgit clone https://github.com/FastReports/FastReport.gitcd FastReport
chmod 777 package.sh && ./pack.sh

Пакет находится в каталоге fr_packages .

NuGet

Вы можете добавить FastReport в свой текущий проект через менеджер пакетов NuGet:

Install-Package FastReport.OpenSource
Install-Package FastReport.OpenSource.Web

Дополнительно

В папке Extras находятся дополнительные модули, расширяющие функциональность FastReport:

• Core/FastReport.Data — коннекторы к различным базам данных;

• OpenSource/FastReport.OpenSource.Export.PdfSimple — простой экспорт в формат PDF;

• ReportBuilder — простой построитель отчетов из кода без использования шаблонов.

Примеры

В папке Demos вы можете увидеть примеры использования FastReport.

Отчеты об ошибках

См. раздел «Проблемы» на веб-сайте. При описании проблемы прикрепите скриншоты или примеры, которые помогут воспроизвести проблему.

Авторы

Этот проект существует благодаря всем людям, которые внесли свой вклад и продолжают работать над проектом:

@ATZ-FR, @Detrav, @fediachov, @8VAid8, @КириллКорниенко, @mandrookin, @ekondur, @Gromozekaster, @daviddesmet, @mjftechnology, @jonny-xhl, @radiodeer, @Des1re7, @araujofrancisco, @conqu1stador, @ пьетро29.

Содействие

Пожалуйста, прочтите CONTRIBUTING.md для получения подробной информации о нашем кодексе поведения и процессе отправки нам запросов на включение.

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

Вы можете прочитать документацию FastReport с открытым исходным кодом на сайте github или прочитать документацию коммерческого продукта, вносящую поправки в ограничения функциональности.

Лицензия

Лицензировано по лицензии MIT. Подробности смотрите на LICENSE.md. Лицензия MIT не распространяется на FastReport Designer Community Edition.

Ресурсы

• Блог FastReport с открытым исходным кодом со статьями и практическими рекомендациями

• Таблица сравнения функций FastReport с открытым исходным кодом, FastReport Core, FastReport .NET

• Онлайн-демо FastReport Core

• Онлайн-конструктор FastReport

• Домашняя страница быстрых отчетов