=====Создание собственного  шаблона документа в 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 шаблон будет использоваться системой при формировании печатной формы документа, поэтому обратите внимание на корректное название файла. Наименование файла должны быть представлено в формате **НазваниеМодуля_название_шаблона**
При создании DSC-файла –описания наибольшую трудность представляет определение  координат точки начала вывода переменной.
Подробное описание системы координат для PDF представлено в статье 
http://www.leadtools.com/help/leadtools/v175/dh/to/leadtools.topics.pdf~pdf.topics.pdfcoordinatesystem.html 

**Шаг3**  Сконвертируйте PDF шаблон  в формат  изображения  
{{ :abills:docs:docs:photoshop:1.png?direct&900 |}}

**Шаг4**  Откройте   файл изображения в  Adobe Photoshop 

**Шаг5**   Настроить  формат отображения линейки в  points
{{ :abills:docs:docs:photoshop:2.png?direct&900 |}}
{{ :abills:docs:docs:photoshop:3.png?direct&900 |}}

Значение координат для записи  в DSC файле :
  * X = x
  * Y = 792 – y //(792 - координата верхнего правого угла PDF страницы формата A4)//

**Шаг 6**   создание DSC файла 

**Шаг 7**   Загрузка шаблона

===== Пример. Шаблон инвойса =====

Рассмотрим,  как задать  отображение даты:

1) Выберем координаты точки для начала вывода даты инвойса
{{ :abills:docs:docs:photoshop:4.png?direct&900 |}}

В системе координат PDF координаты точки будут следующими:
''X = 485; Y = 792 - 91 = 701''

2)	Зафиксируем этот параметр в DSC –файле 
''DATE:Дата создания счета:russian:(x=485;y=701 font_size=9)''

3)	Обновим шаблоны и проверим

{{ :abills:docs:docs:photoshop:5.png?direct&900 |}}