PDF шаблоны

В системе имеется возможность работы с шаблонами в PDF формате. Для работы с PDF файлами нужно установить в системе модуль Perl PDF::API2.
Шаблоны PDF состоят из 2 частей сам шаблон - файл с расширением .pdf и описание шаблона файл с расширением .dsc.
Для преобразования документов с формата MS Word в PDF лучше всего использовать программу OpenOffice Writer из пакета OpenOffice.

Для PDF шаблонов

/usr/ACP/ACP/templates/Cards_cards_print.pdf
/usr/ACP/ACP/templates/Cards_cards_print.dsc

Если используете индивидуальные pdf шаблоны обязательно нужно создать индивидуальный текстовый шаблон (.tpl) данного вида чтобы созданные pdf шаблоны отображались.

Редактор шаблонов

Нужно загрузить pdf файл в abills/Abills/templates/ и в пункте меню настройки -> другое -> шаблоны, внизу страницы нажать на иконку изменения возле нужного pdf файла.

После открытия файлы dsc и tpl создаются автоматически или подгружаются уже создание.

Слева можно добавлять переменные на pdf файл, используя кнопку добавить, после нужная переменная появиться справа, тут можно изменить цвет, размер шрифта и удалить переменною:

Нажав на название нужной переменной можно изменять расположение на странице, вибронная для размещения переменная отмечается галочкой:

и можно нажимать на место где нужно расположить переменною.

После завершения роботы нужно сохранить изменения!

Про параметры

Система учитывает практически все общие переменные, и информационные поля.
(переменные с других модулей не учитывает, кроме Docs)

Особые примечание по переменным:

Если информационное поле имеет тип "Список", то расстановка происходит:

Само название поля — результат из списка, которая присвоена пользователю
Название поле_id — ид выбора результата списка, которая присвоена пользователю

Формат файла .dsc

VARIABLE:DESCRIBE:LANGUAGE:PARAMETЕRS:DEFAULT_VALUE:EXPRATION:

VARIABLE	Переменная подставляемая в шаблоне
DESCRIBE	Описание переменной
LANGUAGE	Язык вставки, если шаблоны на нескольких языках
PARAMETЕRS	Дополнительные параметры
DEFAULT_VALUE	Значение по умолчанию (опциональный параметр)
EXPRATION	Выражение преобразует входящее значение (опциональный параметр). Выражения в формате perl expression Пример: Удалить буквенный префикс [a-zA-Z]/

Параметры используемые в шаблонах

Параметры шаблона разделяются точкой с запятой (;). Если нужно установить требуемую метку на нескольких страницах параметры шаблона берутся в кавычки и описание каждой метки разделяется запятой (,)
Пример:

FIO:Ф.И.О.:russian:(x=105;y=645,x=200;y=578;page=2)

Общие параметры

x,y=	Координаты метки x,y. Если координаты не заданы - метка игнорируется
page=	Страница документа. (по умолчанию 1)
font_name=	Название шрифта

Система поддерживает встроенные Adobe Core Fonts:

    Courier
    Courier-Bold
    Courier-BoldOblique
    Courier-Oblique
    Helvetica
    Helvetica-Bold
    Helvetica-BoldOblique
    Helvetica-Oblique
    Symbol
    Times-Bold
    Times-BoldItalic
    Times-Italic
    Times-Roman
    ZapfDingbats

также 'Windows Fonts':

    Georgia
    Georgia,Bold
    Georgia,BoldItalic
    Georgia,Italic
    Verdana
    Verdana,Bold
    Verdana,BoldItalic
    Verdana,Italic
    Webdings
    Wingdings

и True-Type Fonts

которые нужно загружать в папку /usr/abills/Abills/templates/fonts/

font_size=	Размер шрифта
font_color=	Цвет шрифта (black, green, blue, yellow, red, #rrggbb, !hhssvv, %ccmmyykk)
encode=	Кодировка шрифта (по умолчанию windiws-1251)
align=	Выравнивание текста
step=	Иногда возникает необходимость отображать слова с интервалами между буквами. Расстояние указывается в пикселях

для загруженных шрифтов нужно указывать полный путь:

font_name=/usr/abills/Abills/templates/fonts/ArianAMU.ttf

Вставка текста из файла

text	Название текстового файла. Файл должен быть размещён в каталоге $conf{TPL_DIR}. При отсутствии файла система сообщает об ошибке
text_height	Высота текстового поля
text_width	Ширина текстового поля

Вставка изображений в формате .jpg

img	Название графического файла. Файл должен быть размещён в каталоге $conf{TPL_DIR}. При отсутствии файла система сообщает об ошибке
img_height	Высота картинки
img_width	Ширина картинки

Дополнительные параметры шаблонов писем

Если шаблон письма нужно дополнить какой то служебной информацией (Subject, X-Priority и т.д.), нужно в самом верху шаблона указать данные переменные по одной в каждой строке. После дополнительных переменных нужно отступить два пробела и только тогда начинать тело письма. Если строка начинается на решётку # её система не обрабатывает. Переменные указанные в шаблоне имеют более высокий приоритет чем эти же значения в системе.
Пример
Нужно изменить тему писем:

Subject: Новая тема

Здравствуйте %FIO%,
Ваш депозит %DEPOSIT%

Дерево страниц