Автоматизация печати в корпоративных системах или как подружить свой «велосипед» с принтером

Привет, хабражитель! Хочу поделиться с тобой наболевшим опытом, надеюсь, будет полезен. Сегодня расскажу о том, как разрабатывали систему печати документов в корпоративной системе.

С чего все начиналось

А началось все с разработки ERP-платформы в одной торговой компании примерно 2 года назад. Был выбран Linux, стек С++/Qt, PostgreSql и фронт под web. На C++/Qt был реализован сервер приложений и там же, через прослойку JS интерпретатора писалась бизнес логика. Почему так — это отдельная история, здесь рассмотрим, как разрабатывалась система печати.

Первые пробы пера

HTML

Изначально, пока все документы печатались из 1С (используем связку 1С + своя «ERP» для управленческого учета в компании) все было хорошо, а в планах был переход на свою систему. Тут то и понадобилось прикручивать печать к системе.

Первая идея была верстать форму html, программно заполнять данные, пользователю html-ку в браузер и пусть оттуда печатает.

Сразу выяснились некоторые нюансы:

1. Под все документы придется с 0 верстать шаблон
2. Конечный пользователь не в состоянии подредактировать html
3. Менеджеры вели некоторую аналитику в excel
4. Проблемы с переносом строк при печати многостраничных файлов

В итоге был сделан только один шаблон для печати заявки в логистику (одностраничная форма) которым до сих пор успешно пользуются

XLSX

Вторая идея была работать с XLSX документами. Гугл быстро подсказал про библиотеку QtXlsxWriter. Были еще варианты, но в итоге остановились на QtXlsxWriter.

Что умела библиотека:

• Открывать/Создавать xlsx и считывать значение ячеек
• Изменять значение ячеек, сохранять файл
• Работа с форматом ячейки (в том числе обрамление)
• Высота/ширина строк/столбцов
• Объединение ячеек
• Группировка строк/столбцов
• Вставка изображений

Это позволило сразу скоммуниздить взять шаблоны документов в xlsx формате из других систем (Привет 1С), заполнить нужными данными и статикой отдать пользователю xlsx файл, с которым он уже может работать как его душе угодно.

Сразу же появились подводные камни, QtXlsxWriter «некачественно» обрабатывала загрузку документа из шаблона, терялись форматы ячеек (wrap/aling и т.д.). После часов копания «xlsx формата (если кто не знает, xlsx представляет собой zip архив с набором xml документов) выяснили что, в разных версиях boolean атрибуты в xml файлах сохраняются по-разному, либо

<t a="0" b="1" /> 

либо

<t a="true" b="false" /> 

а QtXlsxWriter местами парсил только 1/0, местами только true/false, а местами и то и то. Но ничего, руки есть, пофиксили.

Еще был неприятный момент, после формирования xlsx файла через QtXlsxWriter, если его открыть в MS Office, тот начинал ругаться.

В книге „test1.xlsx“ было обнаружено содержимое, которое не удалось прочитать. Попробовать восстановить содержимое книги? Если вы доверяете источнику …

При этом, после открытия, визуально, все данные были на месте. При этом многие рядовые пользователи (наши клиенты) могли пугаться такого сообщения при открытии наших прайс листов.

После многих часов втыкания в xml файлы MS Office и QtXlsxWriter и поиска того не знаю чего, что MS не нравилось, был придуман костыль. Если взять файл, сгенерированный QtXlsxWriter, и обработать его с помощью LibreOffice получается валидный xlsx файл, со всеми данными первоначального, но на него не ругается MS Office:

libreoffice --headless --invisible --quickstart --convert-to xlsx test.xlsx --outdir valid_xlsx

И жить стало хорошо, под нужные отчеты писался небольшой код по формированию xlsx документа, выгружался пользователям, они с ним работали, если надо печатали и MS Office их больше не пугал. Даже смогли реализовать выгрузку OLAP отчетов в xlsx с группировками и куртизанками.

Автоматизация

Компания росла, клиентов больше, документов еще больше ( заявки, реализации, накладные и т.д. ), печать стала отнимать очень много рабочего времени. При этом часть документов печаталась из 1С часть из нашей системы. Решили это дело как-то автоматизировать. До этого (лет 5-7 назад) был опыт печати через Windows OLE контейнеры (создавался контейнер с Excel, открывался файл, задавались настройки печати и отправлялся на печать), но с этим не очень хотелось связываться, да и платформа крутится на Linux и тащить сюда виндовый модуль не хотелось (хотя как крайний вариант рассматривали принт-сервер на винде).

Все в PDF

В Linux есть CUPS и с этим вроде как все хорошо, командой lpr можно легко отправить на печать pdf файл. Вот только pdf генерировать мы не умеем. Решение было найдено быстро.

libreoffice --convert-to pdf  1.xlsx --headless

Но не все так просто оказалось. Файлы конвертировались со 100% масштабом и ни как не подгонялись к размеру страниц (А4/А3, книжная/альбомная, отступы), точнее все подгонялось по стандартным параметрам (А4, книжная). Выяснилось, что если задать эти настрой через LibreOffice(руками открыть LibreOffice Calc), сохранить в xlsx и конвертировать через libreoffice —convert-to pdf, все работало почти отлично.

1. Отступы и настройки страницы обрабатывались корректно.
2. Если надо было подгонять по масштабу, то этот параметр игнорировался и конвертировало с масштабом 100%.
3. Если стояли настройки подгонять по размеру/ числу страниц, все работало

По поводу пункта 2 отписался в поддержку LibreOffice, жду от них ответа.

Благо пункт 3 работает правильно, решили отталкиваться от него. Теперь надо научить QtXlsxWriter работать с настройками страницы. Расковыряв xml файлы в xlsx документах нашли места, отвечающие за это дело

xl/worksheets/sheet1.xml

<worksheet>   <sheetPr filterMode="false">     <pageSetUpPr fitToPage="false"/>   </sheetPr> ... ... <pageMargins  left="0.7875"  right="0.7875"  top="1.05277777777778"  bottom="1.05277777777778"  header="0.7875" footer="0.7875"/>  <pageSetup    paperSize="9"    scale="50"    firstPageNumber="0"    fitToWidth="1"    fitToHeight="1"    pageOrder="downThenOver"    orientation="portrait"    usePrinterDefaults="false"    blackAndWhite="false"    draft="false"    cellComments="none"    useFirstPageNumber="false"    horizontalDpi="300"    verticalDpi="300"    copies="1"/> ...  </worksheet> 

Что здесь есть интересного:
pageMargins — думаю с этим все понятно
fitToPage — подгонять под размеры/кол-во страниц или использовать масштаб
fitToWidth — кол-во страниц по ширине
fitToHeight — кол-во страниц по высоте
scale — масштаб в %
paperSize — размер листа (9=А4)
orientation — книжная/альбомная

Добавили работу с этими параметрами в QtXlsxWriter. Осталось только сформировать xlsx документ с отступами в нужных местах, чтобы не печатались куски незавершенного контента на разных листах. С этим не совсем все просто оказалось.

Печать

Рассмотрим ситуацию когда печатаем маршрутный лист на листе А4 книжной ориентации, без отступов.

При этом необходимо чтоб по ширине документ вмещался в 1 страницу. Ставим настройки:

fitToPage=false
fitToWidth=1
fitToHeight=100
pageMargins — все по 0

При таких условиях fitToHeight должно быть заведомо больше числа предполагаемых страниц при печати.

Маршрутный лист представляет собой заголовок с указанием маршрута и список клиентов с доп. информацией, по которым будет производиться доставка.

Если оставить все как есть, велика вероятность что часть блока с информацией о клиенте, попадающие на конец листа будут разбиваться, часть будет в конце первого и часть в начале второго, а это неприемлемо для нас.

В итоги родился следующий подход (возможно костыль).

Нам изначально известен размер листа А4:
Ширина 21 см
Высота 29.7 см

И мы знаем, что наш контент будет подогнан под ширину листа, т.о. можно посчитать относительную степень сжатия контента:

scale = ширина листа / ширину контента

Тут нас ждал сюрприз, чтоб посчитать ширину контента, необходимо сложить ширину всех столбцов, это сделать не сложно

double  QXlsx::Document::columnWidth(int column);

Вот только было совершенно непонятно, в каких единицах измерения получается результат. Возможно, правильное решение можно найти тут, но не смогли, в итоги эмпирическим путем было найдено магическое число 5.10238
1 см = 5.10238 е.и.ш.к. (единица измерения ширины колонки)

scale = А4_ширина * 5.10238 / sum(columnWidth) 

далее посчитаем размер контента, который мы способны вмести по ширине листа

height=А4_высота * 28.3464567 / scale

Появилось еще одно магическое число, как Вы уже догадались, это для перевода высоты строки в из см. в е.и.в.с (единица измерения высоты строки, на просторах интернета нашел такую информацию „r.Height = ht * 28.3464567 // Convert CM to postscript points“ )

Высоту строки можно найти через:

double  QXlsx::Document::rowHeight(int column);

Используя параметр height, мы забиваем контент в xlsx файл пока высота контента <=height. Если при добавлении нового блока Б, мы выходим за границы height, то перед Б вставляем пустую строчку необходимой высоты, чтобы блок Б печатался с новой строки. Высоту пустой строчки можно посчитать зная высоту контента( sum (rowHeight) ) вставленного до блока Б.

Не рассматриваю тут расчет разбивки по страницам с использованием отступов (pageMargins), скажу лишь что в xml данных хранятся значения этих переменных в дюймах (1 дюйм = 2.54 см ).

Таким образом, получается xlsx файл с готовыми настройками и разбивкой по строка для печати. Далее с помощью libreoffice —convert-to pdf конвертируем в pdf и наш документ готов к печати.

Осталось напечатать:

lpr -pFS-4300DN test.pdf

Сейчас делаем автоматизацию печати на МФУ с финишером (степлирование). Уже немного поиграли с тестовым аппаратом и под Linux, оказалось все просто для степлирования.

Печать со степлированием c одной скрепкой в левом верхнем углу:

lpr -P printer_name -o StapleLocation="UpperLeft" order.pdf

Конец

На этом все. Буду рад узнать другие подходы к реализации этой задачи.

Спасибо за внимание )
ссылка на оригинал статьи https://habrahabr.ru/post/325586/