Печатные формы#

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

Создание макетов печатных форм в Word, Excel, Txt#

При создании макетов печатных форм в Word, Excel, rtf, txt источником данных служат SQL-запросы, встроенные в макет. Чтобы правильно сформировать макет отчета следует придерживаться следующих правил:

Весь контент отчёта размещается между открывающим и закрывающим тегами.
Открывающий тег формируется по шаблону: [#&SqlSelect=select 1 as sField#] где «SqlSelect» - условное обозначение тега; select 1 as sField - SQL-текст запроса.
Закрывающий тег формируется по шаблону [#/SqlSelect#] где «SqlSelect» - условное обозначение тега.
Если требуется создать отчет с несколькими уровнями вложенности, то допускается добавление тега внутри другого тега.
Чтобы в текст макета вставлять значение из запроса используется специальный маркер: [#sField#] где «sField» - имя атрибута из SQL-запроса. При этом в случае, если в запросе отсутствует атрибут с таким именем, то в сформированной печатной форме поле останется пустым.
Если из вложенного уровня (уровень «деталь») необходимо получить значение атрибута из запроса верхнего уровня (уровень «мастер»), то следует использовать маркер следующего вида: [#super$sField#] где «sField» - имя атрибута из SQL-запроса верхнего уровня. При этом стоит отметить, что маркер [#sField#] тоже сработает, если атрибут «sField» присутствует только в запросе верхнего уровня. Если же он встречается в запросе нижнего уровня, то в печатной форме будет выведено значение из него.
В качестве параметра может использоваться любой атрибут интерфейса, из которого будет формироваться печатная форма. Для этого необходимо в текст запроса или маркер добавить следующее значение: :id, где – «id» системное имя атрибута из интерфейса.
Форматируйте документ средствами редактора (стили, отступы, выравнивание и т.д.).

Создание макетов печатных форм с использованием Jaspersoft Studio#

Jaspersoft Studio – это графический дизайнер отчетов, который позволяет:

создавать сложные макеты, содержащие вложенные отчеты;
перекрестные таблицы;
изображение;
диаграммы и многое другое.

В качестве источника данных может использовать:

JDBC;
TableModels;
JavaBeans;
XML;
Hibernat;
CSV;
XML/A;
JSON.

Сформированный макет может быть визуализирован непосредственно в Jaspersoft Studio в режиме предпросмотра. Также в Jaspersoft Studio есть возможность редактирования XML-разметки макета отчета.

Параметры, используемые при построении печатных форм#

При построении из системы Global в печатную форму передаются следующие стандартные параметры:

IDSRCOJECT – идентификатор объекта (документа), от которого формируется печатная форма.
IDSRCCLASS - идентификатор класса объекта, от которого формируется печатная форма.
IDUSER – идентификатор пользователя, который формирует печатную форму.
SIGNDATA_DZ – блок в формате JSON с информацией о подписях, настроенных для объекта, от которого формируется печатная форма.

В системе Global в настройках печатной формы можно настроить дополнительные параметры, которые пользователь может заполнить перед формированием документа, и которые также будут передаваться в формируемый отчет.

Примечание

Регистр системных имен параметров в макетах Jaspersoft Studio должен совпадать с регистром параметров, передаваемых из Global. Все стандартные параметры передаются в верхнем регистре

Публикация печатных форм в Системе#

Для присоединения созданного шаблона печатной формы к типу объекта необходимо:

В приложении Настройки Системы перейдите в пункт меню Отчеты > Печатные формы
Выполните операцию создания, укажите системное имя, наименование и модуль.
Создайте новую версию и выберитеь тип шаблона. Загрузите файл с компьютера
Перейдите в меню Сущности > Типы объектов > Типы объектов, найдите требуемый, в разделе «Печатные формы» выполните операцию добавления и выберите требуемый шаблон печатной формы.
Сбросьте кэш через меню Сервис > Управление решением > Очистить все кэши