1.3. Внешние параметры отчета

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

Для описания внешних параметров служит вкладка Parameters and Formats редактора отчета. Рассмотрим форму добавления параметра:

report parameter

Вкладка Properties:

  • Parameter name - имя параметра, как оно будет отображено в форме ввода параметров при старте отчета.

  • Parameter alias - алиас параметра, который нужно использовать для обращения к нему в наборах данных.

  • Parameter type - тип параметра.

  • Required parameter - признак того, что параметр должен быть обязательно передан в отчет.

  • Entity - если указан тип параметра Entity или List of entities, то в данном поле необходимо выбрать тип сущности.

  • Enumeration - если указан тип параметра Enumeration, то в данном поле необходимо выбрать тип перечисления.

  • Entity selection screen - необязательный идентификатор экрана, который будет использоваться для выбора экземпляров сущности. Если экран не указан, выбор будет осуществляться через специальный общий для всех сущностей экран.

На вкладке Localization можно определить названия параметра для различных локалей. Для этого в отдельных строках текстового поля следует ввести пары имя_локали = имя_параметра, например:

ru = Книга