Правила: отчёты

Правила отчётов

1. Прежде чем проектировать или править jrxml-шаблоны отчётов либо рассуждать о структуре отчёта или именовании шаблонов, ассистент ОБЯЗАН получить документацию Report_design; он НЕ ДОЛЖЕН полагаться на эти правила как на справочник по формату шаблона или раскладке.

2. Когда у формы нет независимых друг от друга групп объектов (все группы образуют единую цепочку зависимостей), по умолчанию создаётся ТОЛЬКО ОДИН jrxml-шаблон, называемый по каноническому имени формы (пространство имён + имя формы, каждая . заменяется на _) БЕЗ постфикса — единственный потомок группы сливается с ней.

   Единственный шаблон получается именно из-за слияния, поэтому разработчик может его и отключить: опция SUBREPORT у дочерней группы объектов не даёт слить её с родительской, и такой группе нужен собственный шаблон с постфиксом _<группа>. Поэтому ассистент ОБЯЗАН читать блоки объектов формы, а не только форму её зависимостей: линейной цепочке с SUBREPORT внутри нужен не один шаблон, а отсутствие хотя бы одного молча отбрасывает их все (правило 3).

3. Ассистент ОБЯЗАН именовать каждый шаблон точно: верхний отчёт — по каноническому имени формы без постфикса, каждый подотчёт — по каноническому имени формы плюс постфикс _<группа> его первой непустой группы объектов. Если хоть у одного шаблона имя неверно (с точки зрения платформы не найден), платформа молча откатывается к полностью автоматическому дизайну на ВЕСЬ отчёт, без ошибки в логах, — то есть единственное несовпадение молча отбрасывает все кастомные шаблоны.