"Генератор PDF-отчетов"

Модуль генератора PDF-отчетов с визуальными построителем поставляется как дополнительная надстройка над функционалом стандартного генератора отчетов, входящего в поставку офисных версий, но со своим набором команд, не использующими принцип "встраивания" в html.

Назначение

Модуль генерации PDF-отчетов разработан для 4-й версии программного комплекса, чтобы решить следующие задачи пользователей с повышенными требованиями к функционированию документооборота на предприятии:

программное формирование pdf-отчетов без использования виртуальных pdf-принтеров с необходимостью ручного указания места сохранения и имени файла для каждого сформированного отчета для печати;

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

необходимость соблюдения точности при вывода информации по-странично без "съезжания" абзацев, теста и картинок на следующую страницу; например, сложное коммерческое предложение;

удобство авто создания отчетов с текстом и картинками в одном файле pdf-формата вместо сохранения в mht-архив или ручного разрыва связей картинок после открытия в MicroSoft Word'е;

создание очереди печати бирок с привязкой к программно-аппаратному принтеру без необходимости трудоемкого подгона по мм в зависимости от браузера и/или драйвера принтера;

формирование отчетов в рамке ГОСТ'а с изменением рамки под разные форматы бумаги на каждую страницу с возможностью вывода данных на первые страницы после формирования всего отчета; например, отчеты по отправочным маркам фасадов.

быстрое экспресс-создание дополнительных и служебных отчетов в визуальном построителе PDF-отчетов пользователями, не обладающими знанием html-синтаксисом и сложных команд генератора отчетов.

Описание

При наличии модуля генератора PDF-отчетов появляется возможность указать новые значения в столбце "Расширение", регламентирующие режим создания отчета:

1. "PDF" - создание отчета "*.pdf" в стандартном текстовом редакторе генератора отчетов, где подстановка команд в правильном синстаксисе осуществляется по кнопке "В отчет PDF": 
 
2. "VISUAL" - создание отчета "*.pdf" в новом визуальном построителе PDF-отчетов, вызываемом по кнопке "Визуально": 
 
К сведению
Любому сформированному выходному отчету, в исходном коде которого хотя бы один раз встречается команда ~PDF:...~, расширение будет автоматически переназначено на "*.pdf". 

Реализация

Для формирования PDF отчета введены специальные переменные и команды со следующим синтаксисом: ~PDF:команда:...~

В процессе формирования выходного отчетов генератор автоматически "ведет" свои внутренние системные переменные, такие как текущее и планируемое положение вертикального курсора и постоянно осуществляет проверку перехода на новую страницу при достижении курсора нижней границы отчета (одно из полей Margin). Кроме того, имеется отдельная переменная высоты для таблицы данных, которую пользователь также может использовать. 

Команды PDF

~PDF:VISUAL~ - глобальная системная команда, используется только в заголовке отчета, спроектированного визуальным методом. Включает режим относительных координта вывода полей в отчет. Все остальные PDF-команды не являются глобальными и могут быть изменены в нужном месте исходного текста отчета.

Команды установки форматов в начале отчетов

~PDF:PAGE:SIZE:210:297~ - определение формата страницы отчета с явным указанием размеров в мм 
~PDF:PAGE:SIZE:210:297:LandScape~ - определения формата страницы отчета с указаним альбомной ориентации страницы 
~PDF:PAGE:A1~ - определение формата страницы отчета по предопределенным шаблонам: A1,A2,A3,A4,A5,A6,A7,A8,A9,A10. 
~PDF:MARGIN:5:5:5:20~ - определение полей для страницы в мм, соответственно: снизу,справа,сверху,слева 
~PDF:INICURS~ - универсальная команды для инициализации полей и курсора при определении нового формата страницы (генератор PDF-отчётов поддерживает смену форматов страниц в рамках одного отчёта) 
~PDF:TABHEIGHT:12~ - установка высоты строки таблицы и, соответственно, ячеек для быстрой настройки кода 

Команды установки свойств выводимого текста

~PDF:FONT:NAME:Arial~ - установка шрифта по его названию в системе 
~PDF:FONT:SIZE:10~ - установка высоты (размера) шрифта текста 
~PDF:FONT:BOLD:YES~ - включение жирного шрифта (NO - выключение) 
~PDF:FONT:ITALIC:YES~ - включение наклонного шрифта (NO - выключение) 
~PDF:FONT:UNDERLINE:YES~ - включение подчеркивания текста (NO - выключение) 
~PDF:FONT:COLOR:RRGGBB~ - установка цвета шрифта в формате Red+Green+Blue 
~PDF:ALIGN:CENTER~ - установка выравнивания текста по центру (по ширине для абзаца) 
~PDF:ALIGN:RIGHT~ - установка выравнивания текста слева 
~PDF:ALIGN:LEFT~ - установка выравнивания текста справа 

Команды управления формированием отчетов

~PDF:NEWPAGE~ - принудительный переход на новую страницу. Обычно размещается в блоке "КОД" вместе с командами условных проверок 
~PDF:STRNEXT~ - переход курсора на строку вниз (на значение высоты строки TABHEIGHT) с проверкой перехода на новую страницу 
~PDF:ADDCURS:20~ - переход курсора вниз на указанное количество мм с проверкой перехода на новую страницу выходного отчета 
~PDF:VERCURS:50~ - проверка, что при текущем положении курсора на странице ещё умещается до конца страницы указанное количество мм с переходом на новую в противном случае 

Команды вывода данных в отчет

~PDF:TEXT:OffsetX:OffsetY:Width:Height:строка~ - вывод текста в ограниченное координатами место отчета 
~PDF:CEIL:OffsetX:OffsetY:Width:Height:строка~ - вывод текста с раскрой (ячейки таблицы) в ограниченное координатами место отчета 
~PDF:RECT:OffsetX:OffsetY:Width:Height~ - вывод рамки по указанным в команде координатам 
~PDF:LINE:OffsetX:OffsetY:Width:Height~ - вывод линии по указанным в команде координатам 
~PDF:WIDTHS:STANDART~ - указание толщины линии для команды 
~PDF:LINE:OffsetX:OffsetY:Width:Height~ 
~PDF:IMAGE:OffsetX:OffsetY:Width:Height:С?TempPic.png~ - вывод изображения из файла в ограниченное координатами место отчета 
~PDF:IMAGE:OffsetX:OffsetY:Width:Height:LAST~ - вывод последнего сформированного в генераторе отчётов изображения в ограниченное координатами место отчета, например сразу после получения эскиза командой ~ИЗДЕЛИЯ:ЧЕРТЕЖ~. 

Для команд вывода данных в отчет используются значения, прибавляемые у текущему вертикальному положению курсора:

OffsetX - горизонтальное смещение в мм для области вывода поля, прибавляемое к значению левого поля страницы;

OffsetY - вертикальное смещение в мм для области вывода поля, прибавляемое к значению верхнего поля страницы;

Width - длина области вывода поля в мм по горизонтали;

Height - высота области вывода поля в мм по вертикали;

LAST - универсальная подстановка последнего вычисленного параметра любого типа в генераторе отчётов, применяется в командах PDF последним параметром: TEXT, CELL, IMAGE; 

Учитывая, что постоянно вести пользовательский параметр вертикального смещения вниз по мере формирования выходного отчета - это написание дополнительного кода, в генератор для удобства вывода таблиц введена возможность следующих подстановок:
POS - текущее значение вертикального курсора
STR - значение высоты строки TABHEIGHT для ячейки таблицы
TAB - значение горизонтального смещений конца последней выводимой ячейки командой CEIL

Например, формирование заголовка таблицы спецификации с явным указанием только ширины столбцов:
~PDF:CEIL:0:POS:10:STR:п/п~
~PDF:CEIL:TAB:POS:20:STR:Артикул~
~PDF:CEIL:TAB:POS:30:STR:Название~
~PDF:CEIL:TAB:POS:20:STR:Текстура~
    

Сохранение PDF-отчета во внешнем файле PDF

В функционала генератора PDF-отчётов имеется команда для сохранения сформированного выходного PDF-отчёта во внешний файла формата PDF двумя способами:
1. ~PDF:FILE:D?ProfSegmentPicFilesИмяФайла.pdf~ - явное указание пути с именем файла
2. ~PDF:FILE:ИмяФайла.AsText~ - подстановка значения строкового параметра, ранее сформированного, например, с номером заказа

Эту команду можно помещать в любое место исходного текста, отчётов, так как её выполнение происходит только после завершения формирования PDF-отчёта.