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

1

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

2

3

Способ привязки полей ввода к параметрам отчёта JasperReports описан [[здесь>>doc:neyross.setup.report-control.dev-reports.jasper-base-template.WebHome]], в разделе «Привязка полей ввода».

|(((

Поле ввода

)))|(((

Описание

)))|(((

Свойства

)))|(((

Мин. версия API

или библиотеки

)))

|=(% colspan="4" %)(((

16

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

17

)))

18

|(% colspan="4" %)(((

19

Предназначены для использования в любых отчётах.

20

Определены в API, реализация входит в состав Платформы НЕЙРОСС.

21

Не требуют для использования включения дополнительных *.jar-файлов в набор шаблонов.

22

Поддерживаются [[базовой реализацией шаблона>>doc:neyross.setup.report-control.dev-reports.jasper-base-template.WebHome]] и всеми производными реализациями.

)))

|(((

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

)))|(((

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

28

29

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

java.lang.String

{{/code~}~}"/}}

)))|(((

{{code language="text"}}ru.itrium.ultima.reports.form.field.inputType{{/code}}

34

Значение: ##text##

35

)))|(((

36

[[ultima-reports-api:1.1.7>>doc:neyross.setup.report-control.dev-reports.ultima-reports-api-117.WebHome]]

)))

|(((

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

)))|(((

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

42

43

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

44

)))|(((

45

{{code language="text"}}ru.itrium.ultima.reports.form.field.inputType{{/code}}

46

Значение: ##number##

47

)))|(((

48

[[ultima-reports-api:1.1.7>>doc:neyross.setup.report-control.dev-reports.ultima-reports-api-117.WebHome]]

49

)))

50

|(((

51

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

52

)))|(((

53

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

54

55

Класс: {{code language="none"}}extensions.reports.generic.DateTimeFormField{{/code}}Тип данных: ##java.sql.Timestamp##{{code language="none"}}{{/code}}

56

)))|(((

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##

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##

64

1. ##ru.itrium.ultima.reports.form.field.timeOfDay##

65

Значение: только для ##pickDate=false##, позволяет установить время выбранного дня в форме XX:YY:ZZ (XX часов, YY минут, ZZ секунд), по умолчанию ##00:00:00##.

66

)))|(((

67

[[ultima-reports-api:1.1.7>>doc:neyross.setup.report-control.dev-reports.ultima-reports-api-117.WebHome]]

68

)))

69

|(((

70

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

71

)))|(((

72

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

73

74

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

75

)))|(((

76

1. ##ru.itrium.ultima.reports.form.field.multiple##

77

Значение: ##true## — разрешить множественный выбор, ##false## (по умолчанию) — запретить множественный выбор

78

1. ##ru.itrium.ultima.reports.form.field.skipDeleted##

79

Значение: ##true## — не позволять искать / выбирать удалённые поиска, ##false## (по умолчанию) — разрешить поиск / выборку всех пропусков, в том числе и удалённых

80

)))|(((

81

[[ultima-reports-api:1.4.2>>doc:neyross.setup.report-control.dev-reports.ultima-reports-api-142.WebHome]]

82

)))

83

|(((

84

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

85

)))|(((

86

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

87

88

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

89

)))|(((

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## (по умолчанию) — запретить множественный выбор

96

)))|(((

97

[[ultima-reports-api:1.2.2>>doc:neyross.setup.report-control.dev-reports.ultima-reports-api-122.WebHome]]

98

)))

99

|(((

100

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

101

)))|(((

102

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

103

104

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

105

106

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

)))|(((

\\

)))|(((

[[ultima-reports-api:1.2.2>>doc:neyross.setup.report-control.dev-reports.ultima-reports-api-122.WebHome]]

111

)))

112

|(((

113

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

114

)))|(((

115

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

116

117

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

)))|(((

\\

)))|(((

[[ultima-reports-api:1.4.2>>doc:neyross.setup.report-control.dev-reports.ultima-reports-api-142.WebHome]]

122

)))

123

|=(% colspan="4" %)(((

124

Поля ввода ITRIUM

125

)))

126

|(% colspan="4" %)(((

127

Предназначены для ввода параметров отчётов к PostgreSQL базе данных платформы [[ITRIUM>>itrium.WebHome]].

128

Определены в отдельной библиотеке компонентов, требуется включение файла ##ultima-reports-itrium_<версия>.jar## в директорию ##libs## набора шаблонов.

129

Поддерживаются [[реализацией шаблона к ITRIUM>>doc:neyross.setup.report-control.dev-reports.jasper-itrium-template.WebHome]].

130

)))

131

|(((

132

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

133

)))|(((

134

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

135

136

* Список возможных вариантов формируется в соответствии с заданными в свойствах критериями.

137

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

138

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

139

140

Класс: {{code language="none"}}extensions.reports.itrium.ElementFormField{{/code}}Тип данных: java.lang.Integer##

141

##Тип данных (множественный выбор): {{code language="none" source="string:{{code language=~"none~"~}~}

java.lang.String

{{/code~}~}"/}}

)))|(((

1. ##ru.itrium.ultima.reports.form.field.elementType##

146

Значение: числовой идентификатор типа в ITRIUM

147

1. ##ru.itrium.ultima.reports.form.field.useTypeHierarchy##

148

Значение: ##true## — использовать элементы этого и всех производных от этого типов, ##false## (по умолчанию) — использовать только элементы данного типа

149

1. ##ru.itrium.ultima.reports.form.field.multiple##

150

Значение: ##true## — разрешить множественный выбор, ##false## (по умолчанию) — запретить множественный выбор

151

)))|(((

152

ultima-reports-itrium:0.7.3

153

)))

154

|(((

155

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

156

)))|(((

157

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

158

159

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

160

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

161

162

Класс: {{code language="none"}}extensions.reports.itrium.EnumeratedPropertyFormField{{/code}}Тип данных: java.lang.Integer##

163

##Тип данных (множественный выбор): {{code language="none" source="string:{{code language=~"none~"~}~}

java.lang.String

{{/code~}~}"/}}

)))|(((

1. ##ru.itrium.ultima.reports.form.field.enumeratedPropertyId##

168

Значение: числовой идентификатор перечислимого свойства в ITRIUM (ID свойства в ITRIUM, в котором сохраняется ссылка на ID элемента-значения перечислимого свойства)

169

1. ##ru.itrium.ultima.reports.form.field.multiple##

170

Значение: ##true## — разрешить множественный выбор, ##false## (по умолчанию) — запретить множественный выбор

171

)))|(((

172

ultima-reports-itrium:0.7.3

173

)))

174

|(((

175

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

176

)))|(((

177

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

178

179

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

180

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

181

182

Класс: {{code language="none"}}extensions.reports.itrium.NeyrossNodeFormField{{/code}}Тип данных: ##java.lang.Integer##

183

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

184

)))|(((

185

{{code language="text"}}ru.itrium.ultima.reports.form.field.multiple{{/code}}

186

Значение: ##true## — разрешить множественный выбор, ##false## (по умолчанию) — запретить множественный выбор

187

)))|(((

188

ultima-reports-itrium:0.7.3

189

)))

190

|(((

191

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

192

)))|(((

193

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

194

195

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

196

197

Класс: {{code language="none"}}extensions.reports.itrium.OrganizationFormField{{/code}}Тип данных: {{code language="none"}}dto.reports.itrium.OrganizationDto{{/code}}

198

)))|(((

199

1. ##ru.itrium.ultima.reports.form.field.notLinked##

200

Значение: ##true## — использовать несвязанные с организациями подразделения, ##false## (по умолчанию) — использовать только связанные с выбранной организацией подразделения

201

1. ##ru.itrium.ultima.reports.form.field.multipleDepartments##

202

Значение: ##true## — разрешить множественный выбор подразделений, ##false## (по умолчанию) — запретить множественный выбор подразделений

203

)))|(((

204

ultima-reports-itrium:0.7.3

205

)))

206

|(((