Создание собственного шаблона документа в Abills
Функционал получения печатных форм в системе построен на технологии использования шаблонов. Для работы с PDF шаблонами должен быть установлен модуль PDF::API2. Шаблон печатной формы каждого объекта состоит из 2-х файлов:
PDF -файл, непосредственно сам шаблон печатной формы,
DSC-файл, в котором указаны данные для корректного заполнения PDF –шаблона данными из системы.
В описательном файле перечислены переменные, которые должны быть выведены в шаблоне и формат вывода. Формат вывода включает в себя:
Значение координат точки, с которой начинается вывод переменной;
Тип шрифта, размер, цвет;
Для каждого объекта в системе реализован свой набор переменных, доступных для вывода на печать. В DSC-файле нет возможности задания переменной в формате математического выражения, вычисляющего значение этой переменной. В системе уже реализован стандартный набор шаблонов печатных форм, но у пользователей есть возможность загружать свои шаблоны. В системе реализованы 2 опции загрузки пользовательских шаблонов:
Через веб-интерфейс
Непосредственно в папку abills/Abills/templates
Если у пользователя возникает необходимость использования стандартного набора системных шаблонов, то ему достаточно удалить (переименовать) шаблоны, сохраненные в папке abills/Abills/templates. Используемые для отображения переменных, прописанных в DSC-файле, должны быть сохранены в папку abills/Abills/templates/fonts. Пользовательские шаблоны необходимо под названием в следующем формате Название Модуля_название_шаблона Рассмотрим пошаговое создание шаблона:
Шаг 1. Создайте шаблон документа с применением редактирования в MS Word.
Шаг 2. Сконвертируйте шаблон в PDF . Именно этот PDF шаблон будет использоваться системой при формировании печатной формы документа, поэтому обратите внимание на корректное название файла. Наименование файла должны быть представлено в формате НазваниеМодуля_название_шаблона
пример: Docs_docs_invoice.tpl
При создании DSC-файла – описания наибольшую трудность представляет определение координат точки начала вывода переменной. Подробное описание системы координат для PDF представлено в статье:
Шаг 3. Сконвертируйте PDF шаблон в формат изображения.
Шаг 4. Откройте файл изображения в Adobe Photoshop.
Шаг 5. Настроить формат отображения линейки в points.
Значение координат для записи в DSC файле :
X = x
Y = 792 – y (792 - координата верхнего правого угла PDF страницы формата A4)
Шаг 6. Создание DSC файла.
Шаг 7. Загрузка шаблона.
Пример. Шаблон инвойса
Рассмотрим, как задать отображение даты:
1) Выберем координаты точки для начала вывода даты инвойса:
В системе координат PDF координаты точки будут следующими: X = 485; Y = 792 - 91 = 701
2) Зафиксируем этот параметр в DSC –файле DATE:Дата создания счета:russian:(x=485;y=701 font_size=9)
3) Обновим шаблоны и проверим:
