Как использовать редактор “FRX” в дизайнере FastReport .NET

05.09.2022

Шаблоны отчетов FastReport .NET хранятся в файлах с расширением frx, а их внутренний формат основан на XML. Это позволяет редактировать отчет вручную в любом текстовом редакторе.

Обычно этим не пользуются, но бывают ситуации, когда это нужно. Например, при поиске ошибок в отчете, которые сложно обнаружить в дизайнере. Это могут быть объекты с отрицательными координатами. По сути, такой объект находится за пределами страницы и увидеть его в дизайнере невозможно. Его конечно можно найти в дереве отчета, но придется перебрать все объекты. А в текстовом редакторе координаты со знаком минус, найти гораздо легче. Иногда бывает так, что при повреждении файла отчета, дизайнер его вообще не сможет открыть. Эта крайне неприятная проблема на первый взгляд решается только созданием отчета заново, что в свою очередь может занять очень много времени. Но можно попробовать открыть файл в текстовом редакторе и исправить отчет вручную.

Некоторые пользователи, хотели бы иметь возможность редактировать XML отчета прямо в дизайнере. Это конечно не поможет, когда отчет настолько сильно поврежден, что не открывается. Но очень удобно, когда нужно сразу видеть изменения в дизайнере отчета. Ведь при использовании стороннего редактора нужно: внести изменения в текст, сохранить файл, перейти в дизайнер и загрузить шаблон отчета.

Поэтому и была добавлена новая вкладка «FRX» в дизайнер отчетов. Здесь можно внести изменения, которые сразу отразятся на страницах отчета. При изменении страниц и объектов отчета обычным методом (с помощью дизайнера), все изменения так же мгновенно подхватываются и на вкладке «FRX». Кроме того, как и на странице «Код», здесь есть подсветка синтаксиса.

На странице «FRX» отображается весь XML-текст отчета. Наглядный пример содержимого вкладки «FRX» для пустого только что созданного отчета:

Пример содержимого вкладки «FRX» для пустого отчета

Текст этого отчета небольшой и состоит всего лишь из несколько строк, так как в отчете почти ничего нет.

Во второй строке – описание свойств отчета (дата создания и изменения, язык скрипта и т.д.). Далее пустой словарь (Dictionary), но в этом разделе описываются подключения к базам данных, параметры отчета, переменные, итоги и тому подобное. Потом идут описания страниц отчета, в данном случае страница всего одна. Описание страницы состоит из описания свойств самой страницы и ее бэндов. А сами описания бэндов, в свою очередь, могут содержать описания объектов, расположенных на них.

По умолчанию данная вкладка отключена и в дизайнере не отображается, так как далеко не все ей будут пользоваться. Её можно включить в настройках дизайнера. Для этого необходимо перейти в меню «Файл», затем внизу появившегося списка выбрать «Настройки», после перейти на вкладку «Страница «FRX»». При включении, вкладка будет отображаться внизу дизайнера, слева от вкладки «Код». Кроме включения и отключения самой вкладки, здесь можно настроить ширину символа табуляции (по умолчанию два пробела), а также включить замену символов табуляции на пробелы.

Настройки страницы “FRX”

2 сентября 2024

Обзор облачного решения для создания и управления отчетами

МоиОтчеты Облако — это мощное облачное решение для создания и управления отчетами, обеспечивающее широкий спектр возможностей, от создания документов в различных форматах до интеграции с корпоративными системами.
12 августа 2024

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

В этой статье описывается подключение к базе посредством плагина FastReport .NET для дизайнера отчетов из Visual Studio через NuGet-сервер.
8 августа 2024

Как установить FastReport .NET и его компоненты в Windows

Пошаговая инструкция по онлайн и ручной установке через регистрационный код FastReport .NET и его компонентов в Windows.