В тексте объектов отчета используется как обычный текст, так и выражения.

Выражение – строка кода, которая при выполнении отчета возвращает какое-либо значение. Обозначается с помощью квадратных скобок. Например, объект с текстом 2 * 2 = [2 * 2] в отчете отображается как 2 * 2 = 4.

В выражениях используются:

•системные переменные. Например, выражение [Page] возвращает номер текущей страницы отчета. В выражении содержится системная переменная Page;

•поля источников данных. Для отображения используется формат записи: [Имя источника.Имя поля]. Например, выражение [Employees.Name] возвращает имя сотрудника;

•параметры отчета. Например, выражение [BeginDate] возвращает дату формирования отчета. В выражении содержится параметр BeginDate;

•математические функции. Например, выражение [FormatPercent(0.15)] возвращает указанное значение в процентах, то есть 15%. В выражении содержится функция FormatPercent();

•программный код. Например:

// Получение ссылки на сущность и приведение ссылки к нижнему регистру.

[Hyperlinks.Get([DocumentRegister]).ToLower()]

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

Также выражения могут использоваться:

•вместе с обычным текстом. Например, Страница [Page]. В результате в отчете на первой странице отобразится: Страница 1;

•в качестве аргументов других выражений. Например, Следующая страница [[Page] + 1]. В результате в отчете на первой странице отобразится: Следующая страница 2.

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

Редактор выражения вызывается:

•по кнопке , например на панели «Свойства»:

•по кнопке , например в редакторе группы данных отчета:

Редактор имеет вид:

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

Редактор текста вызывается при двойном щелчке левой кнопкой мыши по объектам «Текст» и «Таблица». Редактор имеет вид:

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

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

1.В редакторе отчета перейдите в узел «Дизайнер».

2.Добавьте объект «Текст» на бэнд «Заголовок отчета» с помощью кнопки Текст на панели объектов.

3.Щелкните два раза левой кнопкой мыши по добавленному объекту «Текст».

4.В редакторе текста добавьте текст за период с [BeginDate] по [EndDate], где BeginDate и EndDate – параметры, соответствующие датам начала и завершения периода формирования отчета. Для этого воспользуйтесь одним из способов:

•переместите параметры BeginDate и EndDate из правой части в левую часть редактора с помощью механизма Drag&Drop. Допишите остальной текст;

•в правой части редактора дважды щелкните левой кнопкой мыши на параметрах BeginDate и EndDate. Параметры будут добавлены в левую часть редактора в текущую позицию курсора. Допишите остальной текст;

•вручную добавьте текст и выражения в левую часть окна редактора.

5.Нажмите на кнопку ОК.

В результате выполнения отчета в заголовке указывается период, за который формируется отчет:

СМ. ТАКЖЕ

© Компания Directum, 2024