Исходный код вики Поля ввода параметров для отчётов JasperReports

Редактировал(а) admin 2026/09/01 21:59

Управление
- Копировать
Действия
- Экспорт
- Предварительный просмотр
Просмотр

version	line-number	content
1.1	1	На данной странице собраны классы полей ввода, которые разработчик может использовать в своём шаблоне отчёта на основе JasperReports Library.
	2
3.20	3	Способ привязки полей ввода к параметрам отчёта JasperReports описан [[здесь>>doc:neyross.setup.report-control.dev-reports.jasper-base-template.WebHome]], в разделе «Привязка полей ввода».
1.1	4
	5	\|(((
	6	Поле ввода
	7	)))\|(((
	8	Описание
	9	)))\|(((
	10	Свойства
	11	)))\|(((
	12	Мин. версия API
	13	или библиотеки
	14	)))
	15	\|=(% colspan="4" %)(((
	16	Базовые поля ввода
	17	)))
	18	\|(% colspan="4" %)(((
3.3	19	Предназначены для использования в любых отчётах.
	20	Определены в API, реализация входит в состав Платформы НЕЙРОСС.
	21	Не требуют для использования включения дополнительных *.jar-файлов в набор шаблонов.
3.20	22	Поддерживаются [[базовой реализацией шаблона>>doc:neyross.setup.report-control.dev-reports.jasper-base-template.WebHome]] и всеми производными реализациями.
1.1	23	)))
	24	\|(((
	25	Текстовое поле
	26	)))\|(((
	27	Для ввода произвольного однострочного текста
	28
3.3	29	Класс: {{code language="none"}}extensions.reports.generic.InputFormField{{/code}}Тип данных: {{code language="none" source="string:{{code language=~"none~"~}~}
1.1	30	java.lang.String
	31	{{/code~}~}"/}}
	32	)))\|(((
3.2	33	{{code language="text"}}ru.itrium.ultima.reports.form.field.inputType{{/code}}
	34	Значение: ##text##
1.1	35	)))\|(((
3.30	36	[[ultima-reports-api:1.1.7>>doc:neyross.setup.report-control.dev-reports.ultima-reports-api-117.WebHome]]
1.1	37	)))
	38	\|(((
	39	Числовое поле
	40	)))\|(((
	41	Для ввода произвольного целого числа
	42
3.3	43	Класс: {{code language="none"}}extensions.reports.generic.InputFormField{{/code}}Тип данных: ##java.lang.Integer##{{code language="none"}}{{/code}}
1.1	44	)))\|(((
3.2	45	{{code language="text"}}ru.itrium.ultima.reports.form.field.inputType{{/code}}
	46	Значение: ##number##
1.1	47	)))\|(((
3.30	48	[[ultima-reports-api:1.1.7>>doc:neyross.setup.report-control.dev-reports.ultima-reports-api-117.WebHome]]
1.1	49	)))
	50	\|(((
	51	Поле ввода даты / времени
	52	)))\|(((
	53	Для выбора даты, времени или даты и времени в форме диалога с календарём и часами
	54
3.3	55	Класс: {{code language="none"}}extensions.reports.generic.DateTimeFormField{{/code}}Тип данных: ##java.sql.Timestamp##{{code language="none"}}{{/code}}
1.1	56	)))\|(((
3.2	57	1. ##ru.itrium.ultima.reports.form.field.pickDate##
	58	Значение: ##true## (по умолчанию) — с выбором даты, ##false## — без выбора даты
	59	1. ##ru.itrium.ultima.reports.form.field.pickTime##
	60	Значение: ##true## (по умолчанию) — с выбором времени, ##false## — без выбора времени
	61	1. ##ru.itrium.ultima.reports.form.field.jsFormat##
	62	Значение: строка формата ввода даты / времени для [[JavaScript-компонента>>url:http://www.eyecon.ro/bootstrap-datepicker\|\|shape="rect"]]; по умолчанию ##dd.MM.yyyy hh:mm:ss## для ##pickDate=true## и ##pickTime=true##, ##dd.MM.yyyy## для ##pickTime=fals##e, ##hh:mm:ss## для ##pickDate=false##
3.3	63	1. {{code language="none"}}ru.itrium.ultima.reports.form.field.javaFormat{{/code}}Значение: строка формата ввода даты / времени для [[Java-кода>>url:http://www.joda.org/joda-time/\|\|shape="rect"]]; по умолчанию ##dd.MM.YYYY HH:mm:ss## для ##pickDate=true## и ##pickTime=true##, ##dd.MM.YYYY## для ##pickTime=fals##e, ##HH:mm:ss## для ##pickDate=false##
3.2	64	1. ##ru.itrium.ultima.reports.form.field.timeOfDay##
	65	Значение: только для ##pickDate=false##, позволяет установить время выбранного дня в форме XX:YY:ZZ (XX часов, YY минут, ZZ секунд), по умолчанию ##00:00:00##.
1.1	66	)))\|(((
3.30	67	[[ultima-reports-api:1.1.7>>doc:neyross.setup.report-control.dev-reports.ultima-reports-api-117.WebHome]]
1.1	68	)))
	69	\|(((
	70	Поле поиска и выбора пропуска(-ов)
	71	)))\|(((
	72	Для поиска и выбора одного или нескольких пропусков Платформы НЕЙРОСС. В отчёт передаются идентификаторы пропусков (id) через запятую — в форме строки.
	73
3.3	74	Класс: {{code language="none"}}extensions.reports.generic.PassFormField{{/code}}Тип данных: ##java.lang.String##
1.1	75	)))\|(((
3.2	76	1. ##ru.itrium.ultima.reports.form.field.multiple##
	77	Значение: ##true## — разрешить множественный выбор, ##false## (по умолчанию) — запретить множественный выбор
	78	1. ##ru.itrium.ultima.reports.form.field.skipDeleted##
	79	Значение: ##true## — не позволять искать / выбирать удалённые поиска, ##false## (по умолчанию) — разрешить поиск / выборку всех пропусков, в том числе и удалённых
1.1	80	)))\|(((
3.30	81	[[ultima-reports-api:1.4.2>>doc:neyross.setup.report-control.dev-reports.ultima-reports-api-142.WebHome]]
1.1	82	)))
	83	\|(((
	84	Поле выбора значений из списка
	85	)))\|(((
	86	Для выбора одного или нескольких значений из раскрывающегося списка. Набор доступных значений загружается из базы данных в соответствии с заданным SQL-запросом.
	87
3.3	88	Класс: {{code language="none"}}extensions.reports.generic.SQLChoiceFormField{{/code}}Тип данных: ##java.lang.String##
1.1	89	)))\|(((
3.2	90	1. ##ru.itrium.ultima.reports.form.field.sqlQuery##
	91	Значение: строка SQL-запроса к базе (источнику) данных, по которой строится отчёт; SQL-запрос должен возвращать данные в две колонки ##id## и ##name## — в результате в раскрывающемся списке будут отображены значения ##name##, а в значение параметра будут подставлены ##id## через запятую
	92	1. ##ru.itrium.ultima.reports.form.field.nullName##
	93	Значение: строка, которая будет выведена в раскрывающемся списке для значений с ##name==NULL##; значение по умолчанию — NULL
	94	1. ##ru.itrium.ultima.reports.form.field.multiple##
	95	Значение: ##true## — разрешить множественный выбор, ##false## (по умолчанию) — запретить множественный выбор
1.1	96	)))\|(((
3.30	97	[[ultima-reports-api:1.2.2>>doc:neyross.setup.report-control.dev-reports.ultima-reports-api-122.WebHome]]
1.1	98	)))
	99	\|(((
	100	Поле передачи корневого URL (origin)
	101	)))\|(((
3.3	102	Для передачи в отчёт корневого URL сервера, на котором формируется отчёт. Для формирования в отчёте ссылок на веб-страницы сервера. В параметр будет подставлено значение вида ##http://[адрес-сервера]:[?порт]##, например ##http://10.1.30.3##.##
1.1	103
	104	Совет: для того, чтобы поле не отображалось в форме ввода параметров — оставить его название в jasper-шаблоне пустым.
	105
3.3	106	Класс: {{code language="none"}}extensions.reports.generic.OriginFormField{{/code}}Тип данных: ##java.lang.String##
1.1	107	)))\|(((
	108	\\
	109	)))\|(((
3.30	110	[[ultima-reports-api:1.2.2>>doc:neyross.setup.report-control.dev-reports.ultima-reports-api-122.WebHome]]
1.1	111	)))
	112	\|(((
	113	Поле ввода времени суток
	114	)))\|(((
	115	Для передачи в отчёт времени суток (от 00:00 до 23:59).
	116
3.3	117	Класс: {{code language="none"}}extensions.reports.generic.TimeFormField{{/code}}Тип данных: ##java.lang.String##
1.1	118	)))\|(((
	119	\\
	120	)))\|(((
3.30	121	[[ultima-reports-api:1.4.2>>doc:neyross.setup.report-control.dev-reports.ultima-reports-api-142.WebHome]]
1.1	122	)))
	123	\|=(% colspan="4" %)(((
	124	Поля ввода ITRIUM
	125	)))
	126	\|(% colspan="4" %)(((
3.3	127	Предназначены для ввода параметров отчётов к PostgreSQL базе данных платформы [[ITRIUM>>itrium.WebHome]].
	128	Определены в отдельной библиотеке компонентов, требуется включение файла ##ultima-reports-itrium_<версия>.jar## в директорию ##libs## набора шаблонов.
3.21	129	Поддерживаются [[реализацией шаблона к ITRIUM>>doc:neyross.setup.report-control.dev-reports.jasper-itrium-template.WebHome]].
1.1	130	)))
	131	\|(((
	132	Поле выбора элемента по типу
	133	)))\|(((
	134	Позволяет пользователю выбирать один или несколько элементов ITRIUM из списка.
	135
	136	* Список возможных вариантов формируется в соответствии с заданными в свойствах критериями.
	137	* В случае одиночного выбора в шаблон передаётся числовой идентификатор элемента в ITRIUM.
	138	* В случае множественного выбора в шаблон передаётся строка из идентификаторов элементов в ITRIUM, разделённых запятой.
	139
3.3	140	Класс: {{code language="none"}}extensions.reports.itrium.ElementFormField{{/code}}Тип данных: java.lang.Integer##
1.1	141	##Тип данных (множественный выбор): {{code language="none" source="string:{{code language=~"none~"~}~}
	142	java.lang.String
	143	{{/code~}~}"/}}
	144	)))\|(((
3.2	145	1. ##ru.itrium.ultima.reports.form.field.elementType##
1.1	146	Значение: числовой идентификатор типа в ITRIUM
3.2	147	1. ##ru.itrium.ultima.reports.form.field.useTypeHierarchy##
	148	Значение: ##true## — использовать элементы этого и всех производных от этого типов, ##false## (по умолчанию) — использовать только элементы данного типа
	149	1. ##ru.itrium.ultima.reports.form.field.multiple##
	150	Значение: ##true## — разрешить множественный выбор, ##false## (по умолчанию) — запретить множественный выбор
1.1	151	)))\|(((
	152	ultima-reports-itrium:0.7.3
	153	)))
	154	\|(((
	155	Поле выбора значения перечислимого свойства
	156	)))\|(((
	157	Позволяет пользователю выбирать одно или несколько значений заданного перечислимого свойства ITRIUM из списка.
	158
	159	* В случае одиночного выбора в шаблон передаётся числовой идентификатор элемента-значения перечислимого свойства в ITRIUM.
	160	* В случае множественного выбора шаблон передаётся строка из идентификаторов элементов-значений перечислимого свойства в ITRIUM, разделённых запятой.
	161
3.3	162	Класс: {{code language="none"}}extensions.reports.itrium.EnumeratedPropertyFormField{{/code}}Тип данных: java.lang.Integer##
1.1	163	##Тип данных (множественный выбор): {{code language="none" source="string:{{code language=~"none~"~}~}
	164	java.lang.String
	165	{{/code~}~}"/}}
	166	)))\|(((
3.2	167	1. ##ru.itrium.ultima.reports.form.field.enumeratedPropertyId##
1.1	168	Значение: числовой идентификатор перечислимого свойства в ITRIUM (ID свойства в ITRIUM, в котором сохраняется ссылка на ID элемента-значения перечислимого свойства)
3.2	169	1. ##ru.itrium.ultima.reports.form.field.multiple##
	170	Значение: ##true## — разрешить множественный выбор, ##false## (по умолчанию) — запретить множественный выбор
1.1	171	)))\|(((
	172	ultima-reports-itrium:0.7.3
	173	)))
	174	\|(((
	175	Поле выбора узла сети НЕЙРОСС
	176	)))\|(((
	177	Позволяет пользователю выбирать один или несколько узлов сети НЕЙРОСС в конфигурации ITRIUM из списка.
	178
	179	* В случае одиночного выбора в шаблон передаётся числовой идентификатор элемента в ITRIUM.
	180	* В случае множественного выбора в шаблон передаётся строка из идентификаторов элементов в ITRIUM, разделённых запятой.
	181
3.3	182	Класс: {{code language="none"}}extensions.reports.itrium.NeyrossNodeFormField{{/code}}Тип данных: ##java.lang.Integer##
	183	Тип данных (множественный выбор): ##java.lang.String##{{code language="none"}}{{/code}}
1.1	184	)))\|(((
3.2	185	{{code language="text"}}ru.itrium.ultima.reports.form.field.multiple{{/code}}
	186	Значение: ##true## — разрешить множественный выбор, ##false## (по умолчанию) — запретить множественный выбор
1.1	187	)))\|(((
	188	ultima-reports-itrium:0.7.3
	189	)))
	190	\|(((
	191	Поле выбора организации и подразделений
	192	)))\|(((
	193	Позволяет пользователю выбирать организацию и, дополнительно, одно или несколько подразделений.
	194
	195	В шаблон передаётся структура данных, содержащая отдельно идентификатор организации, а отдельно строку с идентификаторами элементов-подразделений в ITRIUM, разделённых запятой.
	196
3.3	197	Класс: {{code language="none"}}extensions.reports.itrium.OrganizationFormField{{/code}}Тип данных: {{code language="none"}}dto.reports.itrium.OrganizationDto{{/code}}
1.1	198	)))\|(((
3.2	199	1. ##ru.itrium.ultima.reports.form.field.notLinked##
	200	Значение: ##true## — использовать несвязанные с организациями подразделения, ##false## (по умолчанию) — использовать только связанные с выбранной организацией подразделения
	201	1. ##ru.itrium.ultima.reports.form.field.multipleDepartments##
	202	Значение: ##true## — разрешить множественный выбор подразделений, ##false## (по умолчанию) — запретить множественный выбор подразделений
1.1	203	)))\|(((
	204	ultima-reports-itrium:0.7.3
	205	)))
	206	\|(((
	207	Поле выбора пропуска
	208	)))\|(((
	209	Позволяет выбирать один или несколько пропусков, осуществляя их поиск по ФИО владельца, номеру карты или пинкоду.
	210
	211	* В случае одиночного выбора в шаблон передаётся числовой идентификатор элемента пропуска в ITRIUM.
	212	* В случае множественного выбора в шаблон передаётся строка из идентификаторов элементов пропусков в ITRIUM, разделённых запятой.
	213
3.3	214	Класс: {{code language="none"}}extensions.reports.itrium.PassFormField{{/code}}Тип данных: java.lang.Integer##
1.1	215	##Тип данных (множественный выбор): {{code language="none" source="string:{{code language=~"none~"~}~}
	216	java.lang.String
	217	{{/code~}~}"/}}
	218	)))\|(((
3.2	219	{{code language="text"}}ru.itrium.ultima.reports.form.field.multiple{{/code}}
	220	Значение: ##true## — разрешить множественный выбор, ##false## (по умолчанию) — запретить множественный выбор
1.1	221	)))\|(((
	222	ultima-reports-itrium:0.7.3
	223	)))