Состоялся выход версии 2022.1 в FastReport .NET. Было внесено большое количество новых возможностей и изменений.

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

Добавлен новый объект "Улучшенная матрица":

Вот список ключевых особенностей матрицы:

• заголовки строк и колонок могут содержать группы и простые элементы в произвольном порядке, что позволяет строить асимметричные отчеты;
• кнопки сворачивания позволяют интерактивно управлять видимостью отдельных элементов;
• кнопки сортировки позволяют интерактивно сортировать матрицу по выбранным значениям, в том числе по значениям итогов;
• группировка Top N позволяет отобразить N значений в заголовке, а остальные значения сгруппировать в отдельный элемент с возможностью разворачивания;
• вывод заголовков матрицы в ступенчатом виде;
• сортировка заголовков по значениям итогов;
• широкий набор агрегатных функций;
• поддержка пользовательских агрегатных функций;
• широкий набор специальных функций, позволяющих получить значения итогов, соседних ячеек, а также функции для расчета процентов;
• поддержка объектов "Искрографик" и "Индикатор прогресса" в ячейках данных.

Подробнее о возможностях объекта смотрите в документации.

Добавлены штрих-коды GS1 DataBar: Limited, Omnidirectional, Stacked и Stacked Omnidirectional.

Новые свойства: Config.CompilerSetting.ExceptionBehaviour и Config.CompilerSetting.Placeholder.

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

Config.CompilerSetting.Placeholder - строковая переменная, которая используется для замены выражений с несуществующими именами. По умолчанию, значение этой переменной - пустая строка.

Config.CompilerSetting.ExceptionBehaviour может иметь следующие значения: ExceptionBehaviour.Default - стандартное поведение, как и было ранее. При наличии ошибок с некорректными именами, выводится сообщение об ошибке. Подготовка отчета прерывается.

ExceptionBehaviour.ReplaceExpressionWithExceptionMessage - некорректные выражения заменяются на текст сообщения об исключении. Ошибки при этом не выводятся. Подготовка отчета не прерывается.

ExceptionBehaviour.ShowExceptionMessage- появляется сообщение с текстом исключения, после нажатия кнопки OK, подготовка отчета продолжается. При этом, неправильные выражения заменяются на значение переменной Placeholder.

ExceptionBehaviour.ReplaceExpressionWithPlaceholder - некорректные выражения просто заменяются на Placeholder. Сообщений об ошибках нет. Подготовка отчета не прерывается.

Пример при значениях переменных: ExceptionBehaviour = ExceptionBehaviour.ReplaceExpressionWithPlaceholder Placeholder = "НЕТ ДАННЫХ!"

Здесь видно, что в таблице есть поле с именем FirstName, однако в выражении оно указано некорректно.

А это результат подготовки такого отчета. Ранее его подготовить было бы невозможно из-за ошибок.

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

Преобразование RTF в объекты отчета оптимизировано. Добавлена трансляция RTF в ячейках таблиц. А также исправлено много ошибок.

Улучшения экспорта

Реализован экспорт водяных знаков в Word и RTF.

Добавлено масштабирование SVG изображений в матрице экспорта.

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

Реализован экспорт групп на отдельные листы в Excel 2007.

В Excel 2007 добавлена возможность экспорта свойства, определяющего размер и расположение изображения при экспорте.

Теперь можно определить как будет вести себя изображение в ячейке при изменении ее положения и размера. При этом изображение может:

• перемещаться и изменять свой размер вместе с ячейкой;
• перемещаться вместе с ячейкой, но не изменять свой размер;
• не перемещаться и не изменять размер;

Реализована возможность скрывать или показывать линии сетки при экспорте в Excel 97.

В HTML-экспорте добавлена опция "Не поворачивать альбомные страницы при печати".

Ранее мы принудительно поворачивали страницы с альбомной ориентацией при печати. Необходимо это было по причине того, что браузеры не умеют корректно печатать отчеты со страницами как в книжной, так и в альбомной ориентации. При печати таких документов, страницы с альбомной ориентацией обрезаются по ширине страниц с книжной ориентацией. Теперь, можно настроить, поворачивать страницы с альбомной ориентацией или нет. Кроме того, исправлена ошибка, при которой страницы с альбомной ориентацией поворачивались всегда, даже когда нет страниц с книжной ориентацией.

Поддержка .NET 6

Добавлена поддержка .NET 6 для FastReport.Core и FastReport.CoreWin.

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

Настройки экспортов

Добавлены возможности по настройке экспорта отчёта в необходимый формат из WebReport. При активации свойства webReport.Toolbar.Exports.EnableSettings рядом с кнопкой необходимого экспорта появится иконка настройки. При нажатии на эту кнопку отобразится окно со списком возможных настроек (экспортируемые страницы, свойства и др.).

Окно настроек экспорта можно кастомизировать, используя свойства webReport.Toolbar.Exports.Color и webReport.Toolbar.Exports.FontSettings.

Разделение разных страниц отчёта в закладки.

Добавлена возможность открыть разные страницы отчёта (ReportPage) в разных вкладках WebReport. Для активации этой возможности, необходимо включить опцию webReport.SplitReportPagesInTabs.

Статические стили в WebReport.

Для возможности переопределить стандартные стили тулбара, outline и других элементов для собственной кастомизации были добавлены статические имена классов. К ним относятся: fr-toolbar, fr-toolbar-item, fr-toolbar-narrow, fr-toolbar-dropdown-content, fr-toolbar-zoom-selected, fr-toolbar-pointer, fr-toolbar-notbutton, fr-toolbar-slash.

Полный список изменений

[Engine]

+ добавлен новый объект AdvMatrixObject;

+ добавлены штрих-коды GS1 Databar: Limited, Omnidirectional, Stacked и Stacked Omnidirectional;

+ добавлены новые свойства: Config.CompilerSetting.ExceptionBehaviour и Config.CompilerSetting.Placeholder. Эти свойства дают возможность настраивать поведение при возникновении исключений с некорректными именами полей и таблиц баз данных;

+ добавлена трансляция RichObject внутри TableCell;

* переработана трансляция RichObject в объекты отчёта;

- исправлен ShiftMode транслированных из RTF текста объектов;

- исправлена ошибка с двумя параметрами с одним именем приводящая к исключению System.ArgumentException;

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

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

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

- исправлена трансляция RichObject если документ назначается из скрипта;

- исправлена ошибка с шрифтами, добавляемыми в Config.PrivateFontCollection;

[.NET Core]

+ добавлена поддержка .NET 6;

- исправлен некорректный поиск Bold-Italic шрифтов;

[Designer]

+ добавлена проверка вводимых данных в окне редактирования QR-кода СберБанка;

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

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

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

- исправлена ошибка с окном "Дерево отчета";

- исправлена ошибка приводящая к System.NullReferenceException и падению дизайнера во время его запуска при включенной опции Авто-направляющие;

[Preview]

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

[Exports]

+ реализован экспорт водяных знаков в Word;

+ реализован экспорт водяных знаков в RTF;

+ добавлена опция "Не поворачивать альбомные страницы при печати" при экспорте в HTML;

+ добавлена возможность изменять имя прикрепляемого файла при отправке по Email;

+ добавлено масштабирование SVG изображений в матрице экспорта;

+ добавлена возможность экспорта свойства, определяющего размер и расположение изображения при экспорте в Excel 2007;

+ реализована возможность скрывать или показывать линии сетки при экспорте в Excel 97;

+ реализован экспорт групп на отдельные листы в Excel;

+ реализован экспорт уровня прозрачности изображений водяных знаков в Word;

+ реализован экспорт размера изображения водяного знака в RTF;

- исправлена ошибка, приводившая к System.NullReferenceException при экспорте в текст, таблиц с количеством строк меньше одной;

- исправлен некорректный левый отступ таблиц при экспорте в Word;

- исправлена ошибка со шрифтом Wingdings в тегах HTML при экспорте в HTML;

- исправлен баг с экспортом шрифтов Wingdings и Webdings в HTML;

- исправлена ошибка с шириной фреймов при экспорте в PowerPoint;

- исправлена ошибка экспорта объектов с прозрачной заливкой в RTF;

- исправлена ошибка экспорта объектов с прозрачной заливкой в Word;

- исправлена ошибка, приводящая к System.OutOfMemoryException при экспорте в PDF;

- исправлено неправильное отображение переноса строки при экспорте в HTML;

- исправлено переполнение памяти при экспорте в PDF;

- исправлены ошибки в PDF-экспорте на системах, отличных от Windows;

- исправлена ошибка с экспортом таблиц с количеством столбцов больше 63 в Word 2007;

- исправлена ошибка приводящая к утечке памяти и исключению System.OutOfMemoryException в PDF-экспорте при включенной опции "Текст в кривых";

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

[WebReport]

- исправлена ошибка с символом новой строки при использовании шрифта Wingdings;

[WebReport Core/Blazor Server]

+ добавлены возможности настраивать свойства экспорта отчёта из WebReport. При активации свойства webReport.Toolbar.Exports.EnableSettings рядом с кнопкой необходимого экспорта появится иконка настройки;

+ добавлено свойство webReport.SplitReportPagesInTabs, которое позволяет разделить разные страницы отчёта (ReportPage) в разных вкладках WebReport;

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

- исправлено обновление WebReport при вводе значения с клавиатуры в поле DateTimePicker;

- исправлена ширина табов (tabs) при нестандартных размерах страницы отчёта;

[Demos]

+ добавлена демо использования WebReport Core для .NET 5;

+ добавлена демо использования WebReport Core для Angular;

+ добавлена демо использования WebReport Blazor для Blazor Server;