Изменения документа Руководство разработчика | Отчёты
Редактировал(а) admin 2026/09/01 21:59
От версии 1.1
отредактировано pugachevskaya_elena
на 2026/01/16 20:16
на 2026/01/16 20:16
Изменить комментарий:
К данной версии нет комментариев
Сводка
-
Свойства страницы (3 изменено, 0 добавлено, 0 удалено)
-
Объекты (0 изменено, 1 добавлено, 0 удалено)
Подробности
- Свойства страницы
-
- Автор документа
-
... ... @@ -1,1 +1,1 @@ 1 -XWiki. pugachevskaya_elena1 +XWiki.admin - Язык по умолчанию
-
... ... @@ -1,1 +1,1 @@ 1 - en1 +ru - Содержимое
-
... ... @@ -1,12 +1,12 @@ 1 - (% style="color: rgb(51,51,51);" %)Данное руководство содержит теоретические сведения о расширении возможностей [[Платформы НЕЙРОСС>>doc:neyross.WebHome]] в части построения отчетов, в частности добавления в Платформу новых шаблонов отчётов.1 +Данное руководство содержит теоретические сведения о расширении возможностей [[Платформы НЕЙРОСС>>doc:neyross.WebHome]] в части построения отчетов, в частности добавления в Платформу новых шаблонов отчётов. 2 2 3 - (% style="color: rgb(51,51,51);" %)Пошаговая инструкция по созданию простого набора шаблонов приведена на странице [[doc:neyross.Настройка Платформы НЕЙРОСС.Настройка функций подготовки отчётов.Руководство разработчика | Отчёты.Как создать свой набор шаблонов.WebHome]].3 +Пошаговая инструкция по созданию простого набора шаблонов приведена на странице [[doc:neyross.Настройка Платформы НЕЙРОСС.Настройка функций подготовки отчётов.Руководство разработчика | Отчёты.Как создать свой набор шаблонов.WebHome]]. 4 4 5 5 {{info title="Требования к квалификации"}} 6 - (% style="color: rgb(51,51,51);" %)Квалификация разработчика, необходимая для выполнения описываемых в руководстве действий, зависит от решаемых задач. Для создания простых отчётов выборки данных из базы данных (SQL) или модификации существующих шаблонов средствами визуального редактора достаточно квалификации опытного пользователя ПК и знаний SQL. Для создания собственных форм или полей ввода параметров, для выборки данных не из базы данных, а, например, XML-файла, потребуется опыт разработчки программных средств и знание языка Scala (Java).6 +Квалификация разработчика, необходимая для выполнения описываемых в руководстве действий, зависит от решаемых задач. Для создания простых отчётов выборки данных из базы данных (SQL) или модификации существующих шаблонов средствами визуального редактора достаточно квалификации опытного пользователя ПК и знаний SQL. Для создания собственных форм или полей ввода параметров, для выборки данных не из базы данных, а, например, XML-файла, потребуется опыт разработчки программных средств и знание языка Scala (Java). 7 7 {{/info}} 8 8 9 -== {{id name="Руководстворазработчика|Отчёты-Общиесведения"/}} (% style="color: rgb(51,51,51);" %)Общие сведения(%%)==9 +== {{id name="Руководстворазработчика|Отчёты-Общиесведения"/}}Общие сведения == 10 10 11 11 В составе Платформы НЕЙРОСС присутствует веб-приложение «Отчеты», которое позволяет: 12 12 ... ... @@ -43,9 +43,9 @@ 43 43 Настоящее руководство ориентировано только на использование JasperReports Library и Jaspersoft Studio. Формирование отчётов средствам НЕ JasperReports возможно, но обычно не востребовано. Соответствующий сценарий выходит за рамки данного руководства. 44 44 {{/info}} 45 45 46 -== {{id name="Руководстворазработчика|Отчёты-Структуранаборашаблонов"/}} (% style="color: rgb(51, 51, 51); color: rgb(51, 51, 51)" %)Структура набора шаблонов\\(%%)==46 +== {{id name="Руководстворазработчика|Отчёты-Структуранаборашаблонов"/}}Структура набора шаблонов\\ == 47 47 48 - (% style="color: rgb(51, 51, 51); color: rgb(51, 51, 51); color: rgb(51, 51, 51); color: rgb(51, 51, 51)" %)Набор шаблонов — это zip-архив, который(% style="color: rgb(51, 51, 51); color: rgb(51, 51, 51)" %)должен содержать следующие папки и файлы:48 +Набор шаблонов — это zip-архив, который должен содержать следующие папки и файлы: 49 49 50 50 {{code language="none"}} 51 51 definitions/ // папка с шаблонами ... ... @@ -59,17 +59,16 @@ 59 59 deployment.conf // определение набора 60 60 {{/code}} 61 61 62 - (% style="color: rgb(51, 51, 51); color: rgb(51, 51, 51)" %)Файл {{code language="none"}}deployment.conf{{/code}} содержит определение набора, этот файл обязательно должен присутствовать в составе архива. Если файла нет, то Платформа НЕЙРОСС не примет загружаемый zip-архив. Подробное описание данного файла приведено в разделе [[#Определение набора шаблонов>>doc:||anchor="Руководстворазработчика|Отчёты-Определениенаборашаблонов"]].62 +Файл {{code language="none"}}deployment.conf{{/code}} содержит определение набора, этот файл обязательно должен присутствовать в составе архива. Если файла нет, то Платформа НЕЙРОСС не примет загружаемый zip-архив. Подробное описание данного файла приведено в разделе [[#Определение набора шаблонов>>doc:||anchor="Руководстворазработчика|Отчёты-Определениенаборашаблонов"]]. 63 63 64 - (% style="color: rgb(51, 51, 51); color: rgb(51, 51, 51); color: rgb(51, 51, 51)" %)Для каждого шаблона в наборе должна быть отдельная подпапка в директории {{code language="none"}}definitions{{/code}}.(% style="color: rgb(51, 51, 51); color: rgb(51, 51, 51); color: rgb(51, 51, 51); color: rgb(51, 51, 51)" %)В этой подпапке должен присутствовать файл определения шаблона — {{code language="none"}}reports.conf{{/code}}. Подробное описание поддиректории шаблона отчёта приведено в разделе [[#Шаблон отчёта>>doc:||anchor="Руководстворазработчика|Отчёты-Шаблонотчёта"]].64 +Для каждого шаблона в наборе должна быть отдельная подпапка в директории {{code language="none"}}definitions{{/code}}. В этой подпапке должен присутствовать файл определения шаблона — {{code language="none"}}reports.conf{{/code}}. Подробное описание поддиректории шаблона отчёта приведено в разделе [[#Шаблон отчёта>>doc:||anchor="Руководстворазработчика|Отчёты-Шаблонотчёта"]]. 65 65 66 - (% style="color: rgb(51, 51, 51); color: rgb(51, 51, 51); color: rgb(51, 51, 51); color: rgb(51, 51, 51)" %)В директории {{code language="none"}}libs{{/code}} могут размещаться jar-файлы, используемые в наборе. При использовании нестандартных компонентов ввода параметров или реализации собственной логики формирования отчёта на языке Scala / Java соответствующий код должен быть собран и в форме jar-файлов помещён в данную директорию. Подробная информация по использованию библиотек приведена в разделе [[#Программные компоненты>>doc:||anchor="Руководстворазработчика|Отчёты-Программныекомпоненты"]].66 +В директории {{code language="none"}}libs{{/code}} могут размещаться jar-файлы, используемые в наборе. При использовании нестандартных компонентов ввода параметров или реализации собственной логики формирования отчёта на языке Scala / Java соответствующий код должен быть собран и в форме jar-файлов помещён в данную директорию. Подробная информация по использованию библиотек приведена в разделе [[#Программные компоненты>>doc:||anchor="Руководстворазработчика|Отчёты-Программныекомпоненты"]]. 67 67 68 -=== {{id name="Руководстворазработчика|Отчёты-Определениенаборашаблонов"/}} (% style="color: rgb(51, 51, 51); color: rgb(51, 51, 51)" %)Определение набора шаблонов\\(%%)===68 +=== {{id name="Руководстворазработчика|Отчёты-Определениенаборашаблонов"/}}Определение набора шаблонов\\ === 69 69 70 - (% style="color: rgb(51, 51, 51); color: rgb(51, 51, 51)" %)Текстовый файл {{code language="none"}}deployment.conf{{/code}} должен состоять из пар {{code language="none"}}ключ=значение{{/code}}, размещённых на отдельных строках. При создании набора необходимо корректно задать в файле значения для следующих ключей:70 +Текстовый файл {{code language="none"}}deployment.conf{{/code}} должен состоять из пар {{code language="none"}}ключ=значение{{/code}}, размещённых на отдельных строках. При создании набора необходимо корректно задать в файле значения для следующих ключей: 71 71 72 -(% class="wrapped" %) 73 73 |=((( 74 74 Ключ 75 75 )))|=((( ... ... @@ -121,7 +121,7 @@ 121 121 0.6.0 122 122 ))) 123 123 124 -Пример файла {{code language="none"}}deployment.conf{{/code}} из набора [[типовых шаблонов СКУД ITRIUM>>doc:neyross.АРМ НЕЙРОСС Отчеты. Шаблоны отчетов.Шаблоны СКУД к ITRIUM.WebHome]] приведён ниже:123 +Пример файла {{code language="none"}}deployment.conf{{/code}} из набора [[типовых шаблонов СКУД ITRIUM>>doc:neyross.АРМ НЕЙРОСС Отчеты.templates.skud-itrium-logs.WebHome]] приведён ниже: 125 125 126 126 {{code language="none"}} 127 127 deployment.key=ultima.reports.itrium ... ... @@ -137,7 +137,6 @@ 137 137 138 138 Для каждого шаблона в наборе должна быть отдельная подпапка в директории definitions. В этой подпапке должен присутствовать файл определения шаблона — reports.conf. Текстовый файл {{code language="none"}}report.conf{{/code}} должен состоять из пар ключ=значение, размещённых на отдельных строках. При создании шаблона необходимо корректно задать в файле значения для следующих ключей: 139 139 140 -(% class="wrapped" %) 141 141 |=((( 142 142 Ключ 143 143 )))|=((( ... ... @@ -195,7 +195,6 @@ 195 195 196 196 Параметр {{code language="none"}}definition.class{{/code}} является ключевым. В данном параметре необходимо указать имя программного компонента, который будет отвечать за подготовку и формирование отчёта по создаваемому шаблону. Разработчику доступно несколько готовых реализаций / компонентов, которые он может использовать в своём шаблоне. Разработчик может выбрать одно из следующих значений {{code language="none"}}definition.class{{/code}}: 197 197 198 -(% class="wrapped" %) 199 199 |=((( 200 200 Значение 201 201 )))|=((( ... ... @@ -224,7 +224,7 @@ 224 224 extensions.reports.itrium.ReportDefinition 225 225 {{/code}} 226 226 )))|((( 227 -Стандартная реализация шаблона отчёта к базе данных Платформы ITRIUM. Используется в модуле [[doc:neyross.АРМ НЕЙРОСС Отчеты. Шаблоны отчетов.Шаблоны СКУД к ITRIUM.WebHome]], но также может использоваться и в других пользовательских модулях отчётов к ITRIUM.224 +Стандартная реализация шаблона отчёта к базе данных Платформы ITRIUM. Используется в модуле [[doc:neyross.АРМ НЕЙРОСС Отчеты.templates.skud-itrium-logs.WebHome]], но также может использоваться и в других пользовательских модулях отчётов к ITRIUM. 228 228 229 229 Обладает всеми возможностями базовой реализации (см. выше) и также позволяет использовать следующие поля ввода на форме ввода параметров: 230 230 ... ... @@ -246,7 +246,7 @@ 246 246 247 247 В зависимости от указанного значения {{code language="none"}}definition.class{{/code}} в файле {{code language="none"}}report.conf{{/code}} может потребоваться указать и другие параметры. См. описание конкретной реализации шаблонов. 248 248 249 -Пример файла {{code language="none"}}report.conf{{/code}} из [[модуля типовых шаблонов СКУД ITRIUM>>doc:neyross.АРМ НЕЙРОСС Отчеты. Шаблоны отчетов.Шаблоны СКУД к ITRIUM.WebHome]] приведён ниже:246 +Пример файла {{code language="none"}}report.conf{{/code}} из [[модуля типовых шаблонов СКУД ITRIUM>>doc:neyross.АРМ НЕЙРОСС Отчеты.templates.skud-itrium-logs.WebHome]] приведён ниже: 250 250 251 251 {{code language="none"}} 252 252 definition.class=extensions.reports.itrium.ReportDefinition ... ... @@ -286,7 +286,6 @@ 286 286 287 287 Для пунктов 1 и 2 выше разработчику необходимы определения классов API (программного интерфейса), используемых в Платформе НЕЙРОСС. Такие классы поставляются в артефакте (библиотеке) {{code language="none"}}ultima-reports-api{{/code}} вместе с исходным кодом. Каждая версия Платформы НЕЙРОСС использует свою версию API. Последнюю версию {{code language="none"}}ultima-reports-api{{/code}} можно загрузить по ссылке ниже. 288 288 289 -(% class="wrapped" %) 290 290 |=((( 291 291 Версия программы 292 292 )))|=((( ... ... @@ -308,8 +308,6 @@ 308 308 309 309 Список версий API для предыдущих версий программ приведён ниже. За получением ZIP-файлов просим обращаться к специалистам компании ИТРИУМ. 310 310 311 -{{expand title="Нажмите здесь, чтобы раскрыть список..."}} 312 -(% class="wrapped" %) 313 313 |=((( 314 314 Версия программы 315 315 )))|=((( ... ... @@ -346,7 +346,6 @@ 346 346 )))|((( 347 347 По запросу 348 348 ))) 349 -{{/expand}} 350 350 351 351 {{info}} 352 352 Библиотека API актуальной версии присутствует в составе Платформы НЕЙРОСС. ... ... @@ -354,4 +354,4 @@ 354 354 Включать её в модуль (в директорию {{code language="none"}}libs{{/code}}) дополнительно не требуется. 355 355 {{/info}} 356 356 357 -Классы [[базовой реализации шаблона отчёта с JasperReports Library>>doc:neyross.Настройка Платформы НЕЙРОСС.Настройка функций подготовки отчётов.Руководство разработчика | Отчёты.Базовый шаблон отчёта с JasperReports.WebHome]] входят в API, поэтому для базовой реализации дополнительных jar-файлов включать в директорию {{code language="none"}}libs{{/code}} не требуется. Но, например, реализация полей ввода, используемых в [[типовых шаблонах СКУД к ITRIUM>>doc:neyross.АРМ НЕЙРОСС Отчеты. Шаблоны отчетов.Шаблоны СКУД к ITRIUM.WebHome]], не входит в API. Соответствующие классы реализованы и упакованы в [[отдельный jar-файл>>doc:neyross.Настройка Платформы НЕЙРОСС.Настройка функций подготовки отчётов.Руководство разработчика | Отчёты.Шаблон отчёта к ITRIUM с JasperReports.WebHome]], который при их использовании необходимо поместить в директорию {{code language="none"}}libs{{/code}} в наборе шаблонов.350 +Классы [[базовой реализации шаблона отчёта с JasperReports Library>>doc:neyross.Настройка Платформы НЕЙРОСС.Настройка функций подготовки отчётов.Руководство разработчика | Отчёты.Базовый шаблон отчёта с JasperReports.WebHome]] входят в API, поэтому для базовой реализации дополнительных jar-файлов включать в директорию {{code language="none"}}libs{{/code}} не требуется. Но, например, реализация полей ввода, используемых в [[типовых шаблонах СКУД к ITRIUM>>doc:neyross.АРМ НЕЙРОСС Отчеты.templates.skud-itrium-logs.WebHome]], не входит в API. Соответствующие классы реализованы и упакованы в [[отдельный jar-файл>>doc:neyross.Настройка Платформы НЕЙРОСС.Настройка функций подготовки отчётов.Руководство разработчика | Отчёты.Шаблон отчёта к ITRIUM с JasperReports.WebHome]], который при их использовании необходимо поместить в директорию {{code language="none"}}libs{{/code}} в наборе шаблонов.
- XWiki.ShortUrlClass[0]
-
- Short URL code
-
... ... @@ -1,0 +1,1 @@ 1 +e8403 - Last known target (debug)
-
... ... @@ -1,0 +1,1 @@ 1 +neyross.Настройка Платформы НЕЙРОСС.Настройка функций подготовки отчётов.Руководство разработчика | Отчёты.WebHome