Теги параметров

Компоненты используют параметры, таких как ИД панели, строка и номера, для добавления информации в отчеты. Эти параметры задаются с помощью тегов fp:*Param.
Каждый компонент имеет обязательные и необязательные теги. Все теги параметров имеют атрибуты.
Табл. 1. Атрибуты и теги параметров
Имя Описание
Теги параметров
fp:attrParam Указывает атрибут. Например, Состояние в модуле Требования.
fp:checkboxParam Содержит булевское значение true или false.
fp:critParam Содержит целое значение. Например, (..., -2, -1, 0, 1, 2, ....).
fp:memberParam Задает участника. Например, Admin.
fp:stringParam Содержит строковое значение.
fp:viewParam Задает панель. Например, "Все требования".
Атрибуты тега параметра
changeable Обязательный атрибут, который определяет, когда изменяется параметр, и применяется ко всем тегам *Param. Атрибут может иметь одно из четырех значений:
  • Template: Изменяется во время создания или изменения типа отчета.
  • Runtime: Изменяется при создании отчета.
  • Never: Никогда не может быть изменен, если значение уже известно при создании шаблона. Значение читается из атрибута defaultvalue.
  • Выборка: Значение извлекается автоматически. Извлекаемое значение определяется значением атрибута "name":
    • currentdate: Текущая дата
    • currenttime: Текущее время
    • currentuser: Текущий пользователь
    • fortune: "Случайный cookie", который каждый раз изменяется. Это значение используется, если добавлены дополнительные файлы .jar.
    • numpages: Количество страниц в отчете. Это значение используется в верхних и нижних колонтитулах.
    • workspacename: Имя рабочей области
    • pageno: Текущий номер страницы. Это значение используется в верхних и нижних колонтитулах.
id Обязательный атрибут, который указывает ИД параметра и применяется ко всем тегам *Param. Каждый параметр имеет уникальный ИД. Можно использовать одинаковые ИД для нескольких параметров.

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

name Обязательный атрибут, который указывает имя параметра и применяется ко всем тегам *Param. В теге компонента имя является уникальным идентификатором, который используется при поиске параметров. Именами являются: viewId, attrId, elementId, pageno.
masterid ИД параметра, который управляет им. Этот атрибут является обязательным, но может не использоваться в зависимости от компонента. Этот атрибут применяется к attrParam. Обычно, главным параметром является viewParam. Необходимо сначала установить главный атрибут, чтобы знать, какие атрибуты и элементы доступны.
тип Определяет тип атрибута, разрешенный для этого параметра. Этот атрибут является обязательным, но может не использоваться в зависимости от компонента. Этот атрибут применяется к attrParam. Можно использовать следующие атрибуты типа:
  • choice: для атрибутов варианта
  • number: для атрибутов целых чисел и чисел с плавающей точкой
  • numbertext: для атрибутов целого числа, числа с плавающей точкой и таблицы
  • link: для атрибутов ссылки и списка ссылок
  • all: для всех типов атрибутов
defaultvalue Для параметра устанавливается defaultvalue при создании или первом изменении типа отчета или во время первой генерации отчета. Этот атрибут является необязательным и применяется ко всем тегам *Param. Значением по умолчанию является пустая строка: defaultvalue="".
descr Описание параметра. Это необязательный атрибут. Описание показывается во время создания и изменения типа отчета, а также при генерации отчета. По умолчанию описание не используется: descr="".

Комментарии