![]() |
|
Отдел технической поддержки дата обновления 07.08.2024 |
|
"Генератор PDF-отчетов"Модуль генератора PDF-отчетов с визуальными построителем поставляется как дополнительная надстройка над функционалом стандартного генератора отчетов, входящего в поставку офисных версий, но со своим набором команд, не использующими принцип "встраивания" в html. НазначениеМодуль генерации PDF-отчетов разработан для 4-й версии программного комплекса, чтобы решить следующие задачи пользователей с повышенными требованиями к функционированию документооборота на предприятии: ОписаниеПри наличии модуля генератора 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~ - вывод последнего сформированного в генераторе отчётов изображения в ограниченное координатами место отчета, например сразу после получения эскиза командой ~ИЗДЕЛИЯ:ЧЕРТЕЖ~. Для команд вывода данных в отчет используются значения, прибавляемые у текущему вертикальному положению курсора: Учитывая, что постоянно вести пользовательский параметр вертикального смещения вниз по мере формирования выходного отчета - это написание дополнительного кода, в генератор для удобства вывода таблиц введена возможность следующих подстановок: 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-отчёта.
|