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

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

Создание макетов ПФ в 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. Все стандартные параметры передаются в верхнем регистре

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

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

  • В приложении Настройки Системы перейти в пункт меню Отчеты -> Печатные формы

  • Выполнить операцию создания, указать системное имя, наименование и модуль

  • Создать новую версию и выбрать тип шаблона. Загрузить файл с компьютера

  • Перейти в меню Сущности -> Типы объектов -> Типы объектов, найти требуемый, в разделе «Печатные формы» выполнить операцию добавления и выбрать требуемый шаблон ПФ

  • Сбросить кэш через меню Сервис -> Управление решением -> Очистить все кэши