Skip to Content

Поля ввода параметров для отчётов JasperReports

Last modified by superadmin on 2026/06/15 21:57

На данной странице собраны классы полей ввода, которые разработчик может использовать в своём шаблоне отчёта на основе JasperReports Library.

Способ привязки полей ввода к параметрам отчёта JasperReports описан здесь, в разделе «Привязка полей ввода».

Поле ввода

Описание

Свойства

Мин. версия API
или библиотеки

Базовые поля ввода

Предназначены для использования в любых отчётах.
Определены в API, реализация входит в состав Платформы НЕЙРОСС.
Не требуют для использования включения дополнительных *.jar-файлов в набор шаблонов.
Поддерживаются базовой реализацией шаблона и всеми производными реализациями.

Текстовое поле

Для ввода произвольного однострочного текста

Класс: extensions.reports.generic.InputFormFieldТип данных: {{code language="none"}}
java.lang.String
{{/code}}

ru.itrium.ultima.reports.form.field.inputType
Значение: text

Числовое поле

Для ввода произвольного целого числа

Класс: extensions.reports.generic.InputFormFieldТип данных: java.lang.Integer

ru.itrium.ultima.reports.form.field.inputType
Значение: number

Поле ввода даты / времени

Для выбора даты, времени или даты и времени в форме диалога с календарём и часами

Класс: extensions.reports.generic.DateTimeFormFieldТип данных: java.sql.Timestamp

  1. ru.itrium.ultima.reports.form.field.pickDate
    Значение: true (по умолчанию) — с выбором даты, false — без выбора даты
  2. ru.itrium.ultima.reports.form.field.pickTime
    Значение: true (по умолчанию) — с выбором времени, false — без выбора времени
  3. ru.itrium.ultima.reports.form.field.jsFormat
    Значение: строка формата ввода даты / времени для JavaScript-компонента; по умолчанию dd.MM.yyyy hh:mm:ss для pickDate=true и pickTime=true, dd.MM.yyyy для pickTime=false, hh:mm:ss для pickDate=false
  4. ru.itrium.ultima.reports.form.field.javaFormatЗначение: строка формата ввода даты / времени для Java-кода; по умолчанию dd.MM.YYYY HH:mm:ss для pickDate=true и pickTime=true, dd.MM.YYYY для pickTime=false, HH:mm:ss для pickDate=false
  5. ru.itrium.ultima.reports.form.field.timeOfDay
    Значение: только для pickDate=false, позволяет установить время выбранного дня в форме XX:YY:ZZ (XX часов, YY минут, ZZ секунд), по умолчанию 00:00:00.

Поле поиска и выбора пропуска(-ов)

Для поиска и выбора одного или нескольких пропусков Платформы НЕЙРОСС. В отчёт передаются идентификаторы пропусков (id) через запятую — в форме строки.

Класс: extensions.reports.generic.PassFormFieldТип данных: java.lang.String

  1. ru.itrium.ultima.reports.form.field.multiple
    Значение: true — разрешить множественный выбор, false (по умолчанию) — запретить множественный выбор
  2. ru.itrium.ultima.reports.form.field.skipDeleted
    Значение: true — не позволять искать / выбирать удалённые поиска, false (по умолчанию) — разрешить поиск / выборку всех пропусков, в том числе и удалённых

Поле выбора значений из списка

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

Класс: extensions.reports.generic.SQLChoiceFormFieldТип данных: java.lang.String

  1. ru.itrium.ultima.reports.form.field.sqlQuery
    Значение: строка SQL-запроса к базе (источнику) данных, по которой строится отчёт; SQL-запрос должен возвращать данные в две колонки id и name — в результате в раскрывающемся списке будут отображены значения name, а в значение параметра будут подставлены id через запятую
  2. ru.itrium.ultima.reports.form.field.nullName
    Значение: строка, которая будет выведена в раскрывающемся списке для значений с name==NULL; значение по умолчанию — NULL
  3. ru.itrium.ultima.reports.form.field.multiple
    Значение: true — разрешить множественный выбор, false (по умолчанию) — запретить множественный выбор

Поле передачи корневого URL (origin)

Для передачи в отчёт корневого URL сервера, на котором формируется отчёт. Для формирования в отчёте ссылок на веб-страницы сервера. В параметр будет подставлено значение вида http://[адрес-сервера]:[?порт], например http://10.1.30.3.

Совет: для того, чтобы поле не отображалось в форме ввода параметров — оставить его название в jasper-шаблоне пустым.

Класс: extensions.reports.generic.OriginFormFieldТип данных: java.lang.String


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

Для передачи в отчёт времени суток (от 00:00 до 23:59).

Класс: extensions.reports.generic.TimeFormFieldТип данных: java.lang.String


Поля ввода ITRIUM

Предназначены для ввода параметров отчётов к PostgreSQL базе данных платформы ITRIUM.
Определены в отдельной библиотеке компонентов, требуется включение файла ultima-reports-itrium_<версия>.jar в директорию libs набора шаблонов.
Поддерживаются реализацией шаблона к ITRIUM.

Поле выбора элемента по типу

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

  • Список возможных вариантов формируется в соответствии с заданными в свойствах критериями.
  • В случае одиночного выбора в шаблон передаётся числовой идентификатор элемента в ITRIUM.
  • В случае множественного выбора в шаблон передаётся строка из идентификаторов элементов в ITRIUM, разделённых запятой.

Класс: extensions.reports.itrium.ElementFormFieldТип данных: java.lang.Integer
Тип данных (множественный выбор): {{code language="none"}}
java.lang.String
{{/code}}

  1. ru.itrium.ultima.reports.form.field.elementType
    Значение: числовой идентификатор типа в ITRIUM
  2. ru.itrium.ultima.reports.form.field.useTypeHierarchy
    Значение: true — использовать элементы этого и всех производных от этого типов, false (по умолчанию) — использовать только элементы данного типа
  3. ru.itrium.ultima.reports.form.field.multiple
    Значение: true — разрешить множественный выбор, false (по умолчанию) — запретить множественный выбор

ultima-reports-itrium:0.7.3

Поле выбора значения перечислимого свойства

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

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

Класс: extensions.reports.itrium.EnumeratedPropertyFormFieldТип данных: java.lang.Integer
Тип данных (множественный выбор): {{code language="none"}}
java.lang.String
{{/code}}

  1. ru.itrium.ultima.reports.form.field.enumeratedPropertyId
    Значение: числовой идентификатор перечислимого свойства в ITRIUM (ID свойства в ITRIUM, в котором сохраняется ссылка на ID элемента-значения перечислимого свойства)
  2. ru.itrium.ultima.reports.form.field.multiple
    Значение: true — разрешить множественный выбор, false (по умолчанию) — запретить множественный выбор

ultima-reports-itrium:0.7.3

Поле выбора узла сети НЕЙРОСС

Позволяет пользователю выбирать один или несколько узлов сети НЕЙРОСС в конфигурации ITRIUM из списка.

  • В случае одиночного выбора в шаблон передаётся числовой идентификатор элемента в ITRIUM.
  • В случае множественного выбора в шаблон передаётся строка из идентификаторов элементов в ITRIUM, разделённых запятой.

Класс: extensions.reports.itrium.NeyrossNodeFormFieldТип данных: java.lang.Integer
Тип данных (множественный выбор): java.lang.String

ru.itrium.ultima.reports.form.field.multiple
Значение: true — разрешить множественный выбор, false (по умолчанию) — запретить множественный выбор

ultima-reports-itrium:0.7.3

Поле выбора организации и подразделений

Позволяет пользователю выбирать организацию и, дополнительно, одно или несколько подразделений.

В шаблон передаётся структура данных, содержащая отдельно идентификатор организации, а отдельно строку с идентификаторами элементов-подразделений в ITRIUM, разделённых запятой.

Класс: extensions.reports.itrium.OrganizationFormFieldТип данных: dto.reports.itrium.OrganizationDto

  1. ru.itrium.ultima.reports.form.field.notLinked
    Значение: true — использовать несвязанные с организациями подразделения, false (по умолчанию) — использовать только связанные с выбранной организацией подразделения
  2. ru.itrium.ultima.reports.form.field.multipleDepartments
    Значение: true — разрешить множественный выбор подразделений, false (по умолчанию) — запретить множественный выбор подразделений

ultima-reports-itrium:0.7.3

Поле выбора пропуска

Позволяет выбирать один или несколько пропусков, осуществляя их поиск по ФИО владельца, номеру карты или пинкоду.

  • В случае одиночного выбора в шаблон передаётся числовой идентификатор элемента пропуска в ITRIUM.
  • В случае множественного выбора в шаблон передаётся строка из идентификаторов элементов пропусков в ITRIUM, разделённых запятой.

Класс: extensions.reports.itrium.PassFormFieldТип данных: java.lang.Integer
Тип данных (множественный выбор): {{code language="none"}}
java.lang.String
{{/code}}

ru.itrium.ultima.reports.form.field.multiple
Значение: true — разрешить множественный выбор, false (по умолчанию) — запретить множественный выбор

ultima-reports-itrium:0.7.3