Интерфейс

Для работы в Дизайнере документов используются два окна:

• Приветственное окно
• Основное окно

Приветственное окно

Приветственное окно - стартовое окно для работы с шаблонами документов, которое разделено на две функциональные зоны:

• панель основных действий (слева)
• список истории (справа)

Панель основных действий

• Новый шаблон - Команда для создания абсолютно нового бланка или формы «с нуля».
• Открыть шаблон с компьютера - Позволяет выбрать файл шаблона, который уже сохранен в памяти вашего ПК или на флешке.
• Открыть шаблон из базы - Загрузка шаблона из общего сетевого хранилища или встроенной библиотеки программы.

Список истории

• Недавние - Список файлов, с которыми осуществлялась работа в последнее время.

Основное окно

Основное окно утилиты "Дизайнер документов" имеет следующие блоки элементов интерфейса:

1 - Главное меню 2 - Вкладки 3 - Панель инструментов 4 - Данные / Дерево отчета 5 - Панель объектов отчета

6 - Структура бэндов 7 - Макет отчёта 8 - Свойства объектов 9 - Скрипт / Закладки страниц и диалоговых форм 10 - Панель масштабирования макета отчёта

Главное меню

Главное меню - типовое меню с перечнем основных команд для работы с документами.

Справа от названий команд указаны «горячие клавиши» (сочетания клавиш на клавиатуре), которые позволяют выполнять эти действия мгновенно, не заходя в меню.

Слева расположены иконки, визуально облегчающие поиск нужной функции.

Состоит из разделов: Файл, Параметры и Помощь.

Меню «Файл»

• Новая вкладка (Ctrl+N) - создает новую вкладку;
• Новый шаблон отчёта (Ctrl+Alt+N) - создает новый шаблон отчета;
• Открыть (Ctrl+O) - позволяет выбрать и загрузить уже существующий файл с диска;
• Сохранить (Ctrl+S) - перезаписывает текущий открытый файл с внесенными изменениями;
• Сохранить как... (Ctrl+Alt+S) - сохраняет копию файла под новым именем или в другую папку;
• Выход (Alt+F4) - завершение работы программы.

Меню «Параметры»

• Параметры - открывает диалоговое окно настройки подключений.

Меню «Помощь»

• О программе - содержит основные сведения о программном продукте.

Данные

Окно "Данные" - позволяет:

• управлять всеми элементами данных;
• вставлять элементы данных в отчет путем перетаскивания их на страницу отчета.

Окно содержит:

• разделы Системные переменные, Итоги, Параметры и Функции - доступны по умолчанию при открытии новой вкладки;
• раздел Источники данных - появляется только после создания источника данных (подключения к БД).

Все операции с элементами окна выполняются с помощью панели инструментов и меню "Действия":

Часть этих операций дублируется в контекстном меню элементов окна "Данные".

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

Дерево объектов

Внимание!
Это описание - для старой версии дизайнера документов (AR).
В ближайшее время страница будет обновлена на описание настройки в FastReports.

Дерево объектов (Report Explorer, проводник отчета) - панель с древовидной структурой, которая служит центром управления всеми элементами отчета.

Позволяет:

• выбирать любой элемент в этом дереве, чтобы мгновенно увидеть и изменить его настройки в панели свойств (Properties);
• добавлять новые ресурсы на узлах (например, новые параметры или источники данных), через контекстное меню (правой кнопкой мыши).

Report

Report (отчет) - корневой узел, представляющий весь отчет.

При его выборе в панели свойств (Properties) можно изменять глобальные настройки отчета.

Document Outline

Document Outline (структура документа) - иерархический список всех визуальных элементов (текстовых полей, таблиц, графиков), добавленных в отчет.

Позволяет быстро находить и выделять объекты на холсте дизайнера.

ReportSection1

ReportSection1 (название основной секции по умолчанию) - представляет конкретную секцию или страницу отчета.

Внутри находится узел Body, который содержит основные элементы дизайна текущей секции.

Data Sources

Data Sources (источники данных) - отображаются подключения к базам данных и наборы данных (datasets).

Позволяет добавлять новые источники и перетаскивать поля данных прямо в отчет.

Parameters

Parameters (параметры) - список параметров отчета, используемых для фильтрации данных при запуске.

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

Embedded Images

Embedded Images (внедренные изображения) - список изображений, которые хранятся внутри самого файла отчета.

Это удобно, так как не нужно хранить отдельные графические файлы.

Embedded StyleSheets

Embedded StyleSheets (внедренные таблицы стилей) - коллекции стилей оформления.

Позволяют централизованно управлять внешним видом элементов (цвета, шрифты), применяя именованные стили к объектам.

Common Values

Common Values (общие значения) - обычно содержит системные константы и глобальные переменные (например, номера страниц, текущая дата или общее количество страниц), которые можно использовать в выражениях.

Панель вкладок

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

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

Описание элементов

• Название вкладки - Отображает имя открытого файла. Например, «Новый шаблон» или «Без названия» (присваивается автоматически, если файл ещё не был сохранён).
• Активная вкладка - Выделена белым фоном и рамкой (в данном случае — «Без названия»). Это означает, что содержимое именно этого документа сейчас отображается на основном экране.
• Неактивная вкладка - Имеет серый фон (в данном случае - «Новый шаблон»). Она открыта в фоновом режиме.
• Кнопка закрытия (красный крестик) - Расположена справа на каждой вкладке. Позволяет закрыть конкретный документ, не завершая работу всей программы.

Панель инструментов

Внимание!
Это описание - для старой версии дизайнера документов (AR).
В ближайшее время страница будет обновлена на описание настройки в FastReports.

BandedList (Секционный список)

BandedList (Секционный список) - это область данных с разделами произвольной формы, в которой можно размещать элементы управления отчетом.

Благодаря «Деталям» (Detail), которые дублируются для каждой строки набора данных, этот элемент по структуре напоминает классический конструктор отчетов.

BarCode (Штрих-код)

BarCode (Штрих-код) - сканируемые штрих-коды в любом из 39 популярных стандартов (символик).

Поддерживает привязку к данным, настройку ширины полос, вращение, «тихие зоны», управление подписями и автоматический расчет контрольной суммы.

Bullet (Пуля)

Bullet (Пуля) - простой в использовании линейный индикатор, который является хорошей альтернативой использованию панели мониторинга для визуализации данных.

Позволяет визуализировать прогресс относительно цели, задавая качественные диапазоны (плохо, удовлетворительно, хорошо) и настраивая метки.

Chart (Диаграмма)

Chart (Диаграмма) - представляет собой область графических данных для визуализации данных в различных стилях с поддержкой 3D-эффектов.

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

CheckBox (Флажок)

CheckBox (Флажок) - может отображать логические значения (истина/ложь) или состояние свойства Checked.

Позволяет выводить рядом статический текст для пояснения значения.

Container (Контейнер)

Container (Контейнер) - графический элемент, служащий логической и визуальной оболочкой для группировки других компонентов.

Сам контейнер не имеет прямой привязки к данным.

FormattedText (Форматированный текст)

FormattedText (Форматированный текст) - элемент отображения текстовых данных со сложным оформлением (например, в формате HTML).

Позволяет выводить данные, сохраняя исходное форматирование шрифтов, стилей и списков.

Image (Изображение)

Image (Изображение) - позволяет указать любой файл изображения для отображения из

• внешнего источника
• базы данных
• встроенного изображения

Поддерживаемые форматы: png, jpg, gif, svg.

Не поддерживаются: webp.

InputField (Поле ввода)

InputField (Поле ввода) - предназначено для создания заполняемых полей в отчетах, которые становятся интерактивными при экспорте в формат PDF.

Основное назначение:

• Создание PDF-форм: В экспортированном PDF-файле эти поля превращаются в формы, в которые пользователь может вводить данные или ставить отметки.
• Поведение в просмотре: В стандартном окне просмотра элемент отображается как обычный текст; редактируемым он становится только после экспорта.

Line (Линия)

Line (Линия) - декоративный элемент для визуального разделения областей отчета.

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

List (Список)

List (Список) - область данных произвольной формы, выступающая контейнером для других элементов.

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

Map (Карта)

Map (Карта) - визуализирует бизнес-данные на географическом фоне.

Поддерживает различные типы карт для наглядного отображения информации в привязке к локациям.

Shape (Форма)

Shape (Форма) - графический элемент ля визуального выделения зон.

В отличие от Контейнера, не предназначен для размещения других элементов управления внутри себя.

Sparkline (Спарклайн)

Sparkline (Спарклайн) - отображает динамику данных с течением времени на графике, который достаточно мал для использования в качестве встроенного, и имеет высоту, соответствующую окружающему тексту.

Можно выбрать один из типов спарклайнов: линейный, площадной, столбчатый и усиковый.

Subreport (Вложенный отчет)

Subreport (Вложенный отчет) - позволяет встроить отдельный отчет в основной.

Поддерживает передачу параметров из главного отчета для фильтрации данных во вложенном.

Table (Таблица)

Table (Таблица) - классическая область данных для представления информации в строгом табличном формате.

Позволяет структурировать отчет с помощью строк и столбцов с четкой сеткой.

TableOfContents (Таблица содержаний)

TableOfContents (Таблица содержаний) - автоматически формирует иерархическую схему документа на основе закладок и меток.

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

Tablix (Табликс)

Tablix (Табликс) - гибкий элемент, сочетающий в себе возможности таблицы и матрицы.

Позволяет отображать данные в ячейках с динамическим расширением как по горизонтали (столбцы), так и по вертикали (строки).

TextBox (Текстовое поле)

TextBox (Текстовое поле) - базовый элемент для вывода текста и данных.

Является компонентом по умолчанию для ячеек таблиц и табликсов, поддерживающим форматирование и выражения.

Панель группировки

Внимание!
Это описание - для старой версии дизайнера документов (AR).
В ближайшее время страница будет обновлена на описание настройки в FastReports.

Панель группировки (Group Editor) - позволяет визуально настраивать, как данные будут группироваться и повторяться в отчете.

Row Groups (Группы строк)

Определяют вертикальную структуру отчета.

Каждая добавленная сюда группа заставляет соответствующие строки таблицы или табликса повторяться для каждого уникального значения поля группировки.

Column Groups (Группы столбцов)

Определяют горизонтальную структуру (актуально для табликсов).

Столбцы будут динамически создаваться слева направо для каждого значения в группе.

Панель слоев

Внимание!
Это описание - для старой версии дизайнера документов (AR).
В ближайшее время страница будет обновлена на описание настройки в FastReports.

Панель слоев - инструмент для организации элементов отчета в логические группы, управления их видимостью и поведением как на этапе проектирования, так и при выполнении.

Верхняя панель (иконки)

• Зеленый плюс (+) — добавить новый слой в отчет.
• Черный крестик (x) — удалить выбранный слой (слой default удалить нельзя).
• Иконка с одним желтым квадратом на первом плане — перемещение выбранного слоя выше.
• Иконка с двумя белыми квадратами на первом плане — перемещение выбранного слоя ниже.

Колонки в таблице слоев

• Layer (Слой) - название слоя. Выделенная синим строка (в данном случае default) указывает на активный слой. Все новые элементы, добавляемые на холст, будут привязаны именно к нему.
• Visibility (Видимость) - управляет свойством Designer Visible. Если галочка снята, все элементы этого слоя станут невидимыми в дизайнере, что удобно при работе с многослойными макетами.
• Lock (Блокировка) - управляет свойством Designer Lock. При активации элементы этого слоя нельзя будет случайно переместить или изменить их размер мышкой на холсте.
• Field Selector Availability (Доступность выбора полей) - включает или отключает выпадающий список выбора полей (Field Selector) для текстовых полей (TextBox), принадлежащих этому слою. По умолчанию эта функция включена.

Основные правила работы

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

Холст

Внимание!
Это описание - для старой версии дизайнера документов (AR).
В ближайшее время страница будет обновлена на описание настройки в FastReports.

Холст (рабочее поле, дизайнер макета) - визуальный редактор, предназначенный для размещения элементов управления и настройки структуры отчета.

Основные компоненты рабочего поля

• Сетка - фоновая разметка, которая помогает точно позиционировать элементы; параметры сетки (шаг, привязка) можно настроить для удобства выравнивания объектов.
• Линейки - расположены сверху и слева от рабочего поля; используются для измерения размеров элементов и установки отступов.
• Секции - в стандартном макете поле разделено на логические области; по умолчанию создается секция ReportSection1 и отображается кнопка для создания новой вкладки New.
• Page Header и Page Footer - содержимое, которое повторяется в начале и конце каждой страницы.
• Detail - основная область данных, которая дублируется для каждой записи из источника.

Взаимодействие

• Перетаскивание - элементы управления (текстовые поля, таблицы, графики) переносятся из панели инструментов прямо на рабочее поле.

Нижняя панель

Внимание!
Это описание - для старой версии дизайнера документов (AR).
В ближайшее время страница будет обновлена на описание настройки в FastReports.

Нижняя панель (строка состояния, панель режимов) - содержит инструменты для переключения рабочих пространств и управления визуализацией макета.

Вкладки режимов работы (кнопки слева)

• Designer - основной визуальный редактор, где проектируется структура отчета.
• Script - окно для написания программного кода на VB.NET, который позволяет динамически изменять данные или оформление в процессе генерации отчета.
• Preview - режим предварительного просмотра, отображающий отчет с реальными данными (наподобие того, как он будет выглядеть при печати или экспорте).

Группа инструментов визуализации (центральные кнопки)

• Dimension Lines (размерные линии) - отображает вспомогательные линии с размерами отступов и расстояний между элементами при их перемещении.
• Hide Grid (скрыть сетку) - полностью отключает отображение сетки на рабочем поле.
• Show Dots (показать точки) - отображает сетку в виде отдельных точек на пересечении линий.
• Show Lines (показать линии) - отображает сетку в виде сплошных горизонтальных и вертикальных линий.
• Snap Lines (привязка к линиям) - включает/выключает направляющие, которые помогают выравнивать элементы относительно границ других объектов.
• Snap to Grid (привязка к сетке) - заставляет границы элементов автоматически «примагничиваться» к узлам сетки при перемещении или изменении размера.
• Select Mode (режим выделения) - стандартный режим курсора, позволяющий выбирать, перемещать и редактировать элементы макета.
• Pan Mode (режим панорамирования) - инструмент «Рука», позволяющий быстро перемещаться (прокручивать) по рабочему полю, «захватывая» его мышью.

Инструмент масштабирования (справа)

Позволяет быстро увеличивать или уменьшать рабочую область для детальной проработки мелких элементов. Включает в себя:

• Числовое значение (например, 130%)
• Ползунок с кнопками + и – .

Preview

Внимание!
Это описание - для старой версии дизайнера документов (AR).
В ближайшее время страница будет обновлена на описание настройки в FastReports.

Когда пользователь нажимает кнопку Preview (Предварительный просмотр), открывается окно предварительного просмотра.

Окно предварительного просмотра состоит из следующих управляющих элементов.

Боковая панель в WEB-браузере

• Search - открывает панель для поиска любого слова или фразы.
• Export - открывает панель экспорта отчета в различные форматы (pdf, xlsx, xls, docx, tiff, mht, csv, json, xml).
• Parameters - открывает панель выбора параметров, доступных для данного шаблона отчета.

Верхняя панель в WEB-браузере

• First Page - переход на первую страницу отчета.
• Previous Page - переход на предыдущую страницу. Номер страницы: переход на указанную страницу отчета.
• Next Page - переход на следующую страницу.
• Last Page - переход на последнюю страницу отчета.
• Refresh - обновление отчета.
• Back - вернуться к дизайнеру.
• Backward - переход на страницу, с которой вы открыли отчет до текущей страницы.
• Forward - переход на страницу, с которой вы открыли текущую страницу.
• Move tool - навигация по отчету с помощью перетаскивания вверх или вниз.
• Zoom Support - изменяет масштаб области проектирования с помощью кнопок увеличения + и уменьшения - или сочетаний клавиш [Ctrl] + [+] для увеличения и [Ctrl] + [-] для уменьшения.
• Toggle Fullscreen - полноэкранный режим.
• Print - вывод отчета на печать.
• Single Page - отображается одна страница отчета за раз.
• Continuous - отображаются все страницы отчета друг под другом.
• Galley - отображаются отчеты RDLX без автоматических разрывов страниц, данные отображаются на одной странице с возможностью прокрутки.

Верхняя панель в дизайнере документов

• Toggle Sidebar - включение/выключение отображения боковой панели Page thumbnails.
• Print - вывод отчета на печать.
• Galley mode - отображаются отчеты RDLX без автоматических разрывов страниц, данные отображаются на одной странице с возможностью прокрутки.
• Copy - копировать.
• Find - открывает окно поиска, в котором можно найти любое слово или фразу.
• Zoom Support - изменяет масштаб области проектирования с помощью кнопок увеличения + и уменьшения - или сочетаний клавиш [Ctrl] + [+] для увеличения и [Ctrl] + [-] для уменьшения.
• Fit width - масштабирование ширины страницы отчета по ширине рабочей области дизайнера.
• Fit page - масштабирование высоты страницы отчета по высоте рабочей области дизайнера.
• Single page view - отображается одна страница отчета за раз.
• Continuous view - отображаются все страницы отчета друг под другом.
• Multipage view - отображает несколько страниц в табличном формате.
• First page - переход на первую страницу отчета.
• Previous page - переход на предыдущую страницу. Номер страницы: переход на указанную страницу отчета.
• Next page - переход на следующую страницу.
• Last page - переход на последнюю страницу отчета.
• Backward - переход на страницу, с которой вы открыли отчет до текущей страницы.
• Forward - переход на страницу, с которой вы открыли текущую страницу.
• Back to parent report - вернуться к основному отчету.
• Refresh - обновление отчета.
• Pan mode - навигация по отчету с помощью перетаскивания вверх или вниз.
• Selection mode - выберите элемент(ы) отчета.
• Snapshot mode - скриншот экрана в буфер обмена.

Script

Внимание!
Это описание - для старой версии дизайнера документов (AR).
В ближайшее время страница будет обновлена на описание настройки в FastReports.

Script (скрипт) - предназначена для написания логики на языках VB.NET, которая сохраняется непосредственно внутри файла определения отчета.

Основные возможности и назначение

• Автономность отчетов - скрипты позволяют создавать «самодостаточные» отчеты. В отличие от стандартного подхода с использованием «code-behind» (файлов .vb или .cs), код во вкладке Script компилируется в момент выполнения отчета, что позволяет изменять логику без пересборки всего приложения.
• Событийно-ориентированная модель - скрипты привязываются к конкретным событиям отчета или его секций. Для этого в редакторе предусмотрены выпадающие списки Object (объект) и Event (событие).
• Управление данными и макетом - через скрипты можно динамически изменять свойства элементов (например, скрывать поля, менять цвет текста), выполнять расчеты или программно подключать источники данных.

Работа с объектами и событиями

Во вкладке Script доступны следующие ключевые элементы управления:

• Object (объекты) - можно выбрать сам отчет (Report) или конкретные секции (например, Detail, PageHeader, GroupFooter).
• Event (события) - список событий зависит от выбранного объекта.
• Для секций часто используются: Format (подготовка данных), BeforePrint и AfterPrint.
• Для отчета в целом: ReportStart, DataInitialize, FetchData и ReportEnd.

Особенности использования VB.NET

• Синтаксис - используется стандартный синтаксис VB.NET.
• Типы отчетов - скрипты на VB.NET поддерживаются как в Section Reports, так и в Page/RDLX Reports.
• Интеграция с выражениями - в Page-отчетах методы, написанные во вкладке Script, можно вызывать напрямую из свойств контролов через конструкцию =Code.ИмяМетода().