Что нового в версии 2021.4 продукта FastReport .NET?

Важно! Изменения в редакциях

Редакции WinForms и Win+WebForms с этой версии перестают существовать. Вместо них добавлена новая редакция Standard, включающая Windows Forms компоненты, ASP.NET компоненты, а также поддержку .NET Core / .NET 5 / Blazor.

Новые возможности

Добавлены новые иконки в стиле Visual Studio. Вы можете переключаться между наборами иконок в окне дизайнера "Вид/Настройки/Интерфейс" (или "Файл/Настройки/Интерфейс" в случае использования ribbon-интерфейса):

Новые иконки представлены в нескольких размерах и отлично подходят для работы на мониторах высокого разрешения (hiDPI).

Добавлена возможность сброса настроек среды FastReport, которые хранятся в конфигурационном файле FastReport.config. Это можно сделать в окне дизайнера "Вид/Настройки/Интерфейс", кнопка "Сброс настроек". Для вступления изменений в силу требуется перезапуск дизайнера.

Добавлена возможность упрощенного отображения полей БД в объекте "Текст" в режиме дизайна. Эта настройка доступна в окне дизайнера "Вид/Настройки/Внешний вид объектов". По умолчанию настройка отключена; при ее включении объекты "Текст", содержащие одно поле БД, отображаются в упрощенном виде:

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

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

Добавлена возможность подключения к ElasticSearch. Подключение доступно в мастере подключения к данным и из кода.

Добавлен штрих-код Japanese Post 4 - State Code.

Добавлены кнопки свернуть все/развернуть все, и поле поиска для дерева отчетов и дерева данных в дизайнере. При нажатии на + дерево будет развернуто. На - дерево будет свернуто.

Эти изменения должны упростить работу с отчетами, содержащими много объектов и/или источников данных.

Значительно улучшен и оптимизирован конвертор RicthText в объекты отчета.

Количество доступных экспортов в WebReport Core/Blazor Server значительно увеличено.

Добавлены объекты интеграции с FastReport Business Graphics (\Extras\Objects\FastReportBGObjects).

Универсальные плагины FastReport.Data

Обновлены пакеты с плагинами-коннекторами FastReport.Data. Теперь они включают в себя плагины для разных редакций FastReport (.NET, Core, CoreWin, OpenSource) и автоматически подключают нужную библиотеку, в зависимости от используемого продукта. Для корректной работы необходима редакция FastReport версии 2021.3.0 и выше.

Плагины-коннекторы FastReport.Core.Data, FastReport.CoreWin.Data, FastReport.OpenSource.Data объявлены как устаревшие и более не поддерживаются.

Улучшения в публикации пользовательских приложений с использованием FastReport

Для пользовательских приложений на .NET Core 3.0+ и .NET 5+, использующих FastReport.Core, FastReport.CoreWin, FastReport.OpenSource была добавлена поддержка Single File Applications (SFA).

Также, добавлена поддержка публикации приложения с обрезанием неиспользуемых библиотек - свойство MSBuild - PublishTrimmed*.

Внимание! В некоторых случаях, возможно, придётся явно указывать список сборок, которые .NET не должен обрезать. Это может понадобится, если в скрипте отчёта используются эти библиотеки, однако в коде вашего приложения они не задействуются.

Делается это с помощью свойства TrimmerRootAssembly. В данном случае, например, явно указывается, что библиотеку System.Security обрезать не нужно:

1
2
3

<ItemGroup>
 <TrimmerRootAssembly Include="System.Security" />
</ItemGroup>

Локализации

В логике смены локализации были сделаны небольшие изменения.

Добавлен пакет FastReport.Localization. Данный пакет содержит файлы локализации для продуктов FastReport.NET, FastReport.Core, FastReport.CoreWin, FastReport.Mono, FastReport.OpenSource и при добавлении этого пакета создает директорию Localization в выходной директории пользовательского проекта.

Добавлен новый API для смены локализации используя тип CultureInfo - FastReport.Utils.Res.LoadLocale(CultureInfo culture).

При вызове данного метода, FastReport ищет подходящую локализацию для выбранной культуры. Загруженные локализации кэшируются. Для корректной работы этого метода, необходимо установить в свой проект пакет FastReport.Localization из п.1 или установить путь к папке с файлами локализации в свойстве FastReport.Utils.Res.LocaleFolder.

Изменения и улучшения в тулбаре WebReport Core/Blazor

Настройки тулбара были вынесены из класса WebReport в свойство WebReport.Toolbar класса ToolbarSettings.

Добавлена возможность настройки тулбара: Положение, цвет выпадающего меню, шрифт, прозрачность иконок, изменение цвета иконок, изменение положения контента. Данные свойства доступны в webReport.Toolbar

Во время загрузки отчёта тулбар теперь не отображается.

У объекта Toolbar было добавлено свойство ShowOnDialogPage (по умолчанию true), которое позволит отключить отрисовку тулбара, если в данный момент открыто диалоговое окно

Добавлено больше экспортов в выпадающем меню тулбара. Данные свойства доступны в webReport.Toolbar.Exports.ExportTypes. Список добавленных экспортов: HTML, Hpgl, Dxf, Json, LaTeX, Ppml, PS, Xaml, Zpl, Excel97, Svg.

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17

 ToolbarSettings toolbar = new ToolbarSettings()
 {
 Color = Color.LightBlue,
 DropDownMenuColor = Color.LightBlue,
 ShowOnDialogPage = false,
 DropDownMenuTextColor = Color.Black,
 IconColor = IconColors.Black,
 Position = Positions.Right,
 FontSettings = new Font("Arial", 14, FontStyle.Bold),
 Exports = new ExportMenuSettings()
 {
 ExportTypes = Exports.Pdf | Exports.Excel97 | Exports.Rtf
 }
 // or
 //Exports = ExportMenuSettings.All
 };
 webReport.Toolbar = toolbar;

Улучшения WebReport Core/Blazor Server

Добавлена поддержка Blazor Server компонентов для пакета FastReport.Core3.Web (CoreWin).

Улучшена поддержка компонентов диалоговых отчетов:

DateTimePicker был улучшен. В режиме DateTimePicker.Format.Time он отображает только время, в режиме DateTimePicker.Format.Short - только дату, DateTimePicker.Format.Long - и дату и время

Добавлена поддержка свойства MaxLength для TextBox

Добавлена поддержка свойства Enabled

Добавлена поддержка background-color

Исправления
Исправлена ошибка, связанная с работой свойств Dock и Anchor у объектов, которые находятся внутри ячеек таблицы или матрицы.

Исправлена ошибка, приводящая к переполнению стека, при размещении объекта "Вложенный отчет" на подвале страницы.

Исправлена ошибка при экспорте в формат SVG, если в системе используется нестандартная настройка DPI.

Более подробная информация об изменениях:

[Engine]

+ добавлено подключение к ElasticSearch;

+ добавлен новый штрих-код - Japanese PostNet;

+ добавлен метод Res.LoadLocale(CultureInfo), который изменяет выбранную локаль по аргументу CultureInfo. Загруженные локали кэшируются. Для корректной работы требуется добавленный пакет FastReport.Localization;

* оптимизирован и унифицирован конвертор RichText в объекты отчёта;

- исправлена ошибка с неправильной шириной табуляции при TextObject.TextRenderType = TextRenderType.HtmlTextRenderer;

- исправлена ошибка с объектом "Вложенный отчет" на бэнде "Подвал страницы", приводящая к переполнению стека;

- исправлена ошибка со свойствами Dock и Anchor у объектов внутри ячеек таблицы/матрицы;

- исправлена ошибка, приводящая к System.ArgumentException при отрисовке PictureObject расположенными за пределами бэнда;

- исправлена ошибка с некорректной работой правого якоря (Anchor = AnchorStyles.Right) при неограниченной ширине страницы;

- исправлена ошибка с заменой пользовательского шрифта, на шрифт по умолчанию при подготовке отчета;

- исправлена ошибка с выравниванием по вертикали при конвертации RTF (по умолчанию теперь Top вместо Center);

- исправлена ошибка конвертации таблиц RTF в объекты отчета.

[Designer]

+ добавлено упрощенное отображение имен полей БД в дизайнере;

+ добавлена кнопка свернуть все/развернуть все, и поле поиска для дерева отчетов и дерева данных;

+ добавлены новые иконки. Вы можете выбрать их в окне дизайнера "Вид/Настройки/Интерфейс";

- исправлена ошибка, приводящая к падению дизайнера отчётов, при некорректной таблице в источнике данных.

[Preview]

- исправлена ошибка сохранения подготовленных отчётов, содержащих сконвертированный RichObject.

[Exports]

+ добавлена опция при экспорте в Word 2007 "Не добавлять разрывы разделов при разрывах страниц". По умолчанию добавляются и разрывы страниц, и разрывы разделов;

- исправлен разрыв страницы в Html экспорте (свойство PageBreaks);

- исправлен SVG экспорт с параметром "Экспорт в несколько файлов";

- исправлена ошибка в SVG экспорте на мониторах с высоким разрешением;

- исправлены имена фалов, сохраняемых в zip архив;

- исправлена ширина табуляции при экспорте RichObject;

- исправлена ошибка XPS-экспорта при которой документы, экспортированные на Linux, не открывались на Windows;

- исправлены ошибки некорректной работы свойств Anchor и Dock при экспорте страниц с бесконечной шириной;

- исправлена ошибка экспорта текстовых объектов в Excel 2007 с включенным типом рендеринга HtmlParagraph. Отключите параметр экспорта WYSIWYG, чтобы экспортировать текст вместо изображений.

[WebReport]

+ добавлена поддержка Blazor компонентов для пакета FastReport.Core3.Web;

+ для диалогов в WebReport добавлена поддержка background-color;

+ для диалогов в WebReport добавлена поддержка свойства Enabled;

+ для диалогового компонента TextBox в WebReport добавлена поддержка свойства MaxLength;

* оптимизирована загрузка локализации для Toolbar;

- исправлен некорректный вывод мультистрочного текста в Blazor (Interactive Forms & TextBox)

- исправлен некорректный фоновый цвет страницы при HTML/Blazor экспорте на браузерах Safari;

- для диалогового компонента Label в WebReport исправлено отсутствие переносов строк;

- исправлена ошибка с зависанием обратного вызова сохранения онлайн-дизайнера в WebReport с сессиями;

- исправлены ошибки некорректной работы свойств Anchor и Dock на страницах с бесконечной шириной.

[Online Designer]

- исправлено сохранение/вызов превью из Онлайн-Дизайнера со страницей в Landscape ориентации.

[.NET Core]

+ добавлена поддержка Single File Application;

* обновлены зависимости к FastReport.Compat и FastReport.DataVisualization. FastReport.Compat теперь правильно определяет возможность использования WinForms API. FastReport.DataVisualization теперь не имеет зависимость к System.Data.SqlClient и System.Drawing.Common;

- исправлена ошибка, при которой отчет не работал с данными из пользовательской библиотеки, хотя она была зарегистрирована в ReferencedAssemblies в CoreWin;

- исправлен вылет приложения при загрузке отчета с неизвестным шрифтом в нескольких потоках на Linux;

- исправлена ошибка "Could not load type 'System.Drawing.Design.UITypeEditor'";

- исправлена загрузка имен таблиц в XmlDataConnection;

- исправлена ошибка, из-за которой не загружался отчёт и ресурсы при публикации/отладки используя IIS/IIS Express. Для корректной работы, необходимо вызывать метод `UseFastReport()` перед 'UseMvc/UseEndpoints'.

[WebReport Core]

+ добавлены xml комментарии (DocumentationFile) к Web библиотекам;

+ добавлено свойство для отключения отображения тулбара на диалоговой странице отчета: webReport.Toolbar.ShowOnDialogPage;

+ добавлено больше экспортов в выпадающем меню тулбара. Данные свойства доступны в webReport.Toolbar.Exports;

+ добавлена возможность настройки тулбара: Положение, цвет выпадающего меню, шрифт, прозрачность иконок, изменение цвета иконок, изменение положения контента. Данные свойства доступны в webReport.Toolbar;

+ диалоговый DateTimePicker для WebReport был улучшен. В режиме DateTimePicker.Format.Time он отображает только время, в режиме DateTimePicker.Format.Short - только дату, DateTimePicker.Format.Long - и дату, и время.

[Extras]

+ добавлен пакет 'FastReport.Localization', который включает в ваш проект файлы локализации FastReport для работы с разными языками;

+ добавлены объекты интеграции с FastReport Business Graphics (\Extras\Objects\FastReportBGObjects).

[Demos]

+ реализован переход к списку отчетов, при нажатии на стрелку на папке в новом демо;

* изменен target framework для нового демо на 4.7.2;

* изменен цвет неактивных кнопок в режиме отображения миниатюр нового демо;

* изменен цвет фона ползунка масштабирования в новом демо;

* изменен цвет фона при отображении диалоговых форм в новом демо;

* изменен цвет фона вкладок интерактивных отчетов в новом демо;

* изменено расположение папки с миниатюрами отчетов для демонстрационного приложения. Теперь эта папка располагается не в Program Files а в AppData\Local;

- исправлены проблемы с отображением элементов интерфейса нового демонстрационного приложения;

- исправлена ошибка, вызывающая сохранение подготовленного отчета при нажатии на раскрывающиеся элементы в меню сохранения нового демонстрационного приложения;

- исправлена ошибка с выравниванием отчетов в окне предварительного просмотра нового демо;

- исправлена ошибка двойного запуска диалоговых форм при выборе отчета в новом демо;

- исправлена ошибка с растяжением миниатюр в новом демо;

- исправлена ошибка, приводящая к задержке при перемещении окна нового демо;

- исправлена ошибка нового демо с одновременным отображением миниатюр в панели папок и в панели отчета.

[Plugins]

* обновлены пакеты с плагинами-коннекторами FastReport.Data.**. Теперь они включают в себя плагины для разных редакций FastReport (.NET, Core, CoreWin, OpenSource) и автоматически подключают нужную библиотеку, в зависимости от используемого продукта;

* postgres npgsql понижение версии с 4.0.3 до 3.2.7.