Шаблоны документов для печати

Ключ
Эта строка удалена.
Это слово было удалено. Это слово было добавлено.
Эта строка добавлена.

Изменения (34)

просмотр истории страницы
Необходимо зайти в веб-интерфейс администратора Carbon Billing 5, раздел *Настройки* и выбрать *Шаблоны печати*.
{widget:url=https://www.youtube.com/watch?v=nWWWG6l6aRA}

Здесь находятся шаблоны, которые используются для распечатки в системе. 
h1. Шаблоны печати
Шаблоны документов для печати находятся в разделе "*Настройки*" \-> "*Шаблоны печати*".

!pech1.JPG|border=1!
!print_templates1.png|border=1,width=800!

{toc}
h21. Добавление шаблона

При добавлении шаблона заполняем вкладки Основные и Расширенные настройки.
При добавлении достаточно указать наименование файл шаблона (при нажатии кнопки "Обзор" можно будет выбрать нужный файл на Вашем компьютере ). Движок отображения рекомендуется оставить "По умолчанию".

Создадим шаблон для модели Услуга. Зайдя в Услуги, мы увидим новый шаблон, для него будет активна кнопка Печать.
# Вкладка *"Основные"*
Заполните название и выберите файл. Если Вы готовите шаблон на замену стандартному, укажите соответствующие параметры.
\\
\\ !print_template_add_main.png|border=1,width=609,height=388!\\
\\
# Вкладка *"Опции"*
Настройки параметров формирования PDF документа - размер листа и положение страницы.
\\
\\ !print_template_add_options.png|border=1,width=611,height=244!


!pech5.JPG|border=1!
h1. Редактирование шаблонов печати

!pech6.JPG|border=1!
В редакторе шаблона печати доступны все те же опции, что и при создании, а так же история изменений. Старые версии файлов шаблонов Вы можете найти в резервных копиях биллинга.

На сервере файлы располагаются в следующей папке:
{code}/app/asr_billing/var/print_tmpl/{code}

h2. Вкладка "Основные"

* *Наименование* \- название шаблона
* *Файл шаблона* \- название файла шаблона генерируется на основе имени загружаемого с добавлением случайного набора букв. Важно, чтобы название шаблона была написано латиницей.
* *Привязка к модели* \- указывает к какой [модели API REST v2.0|CarbonBilling:API REST v2.0] будет привязан шаблон. Это влияет на то, какие данные будут передаваться для печати.
* *Дополнительная привязка* \- необходимо для финансовых операций. Влияет на то, к какому типу операции будет отнесён шаблон и как отобразиться в биллинге (печать акта, счета и тд.)
* *Движок отображения* \- описан далее
* *Ключ быстрой печати* \- описан далее
* *Тип шаблона* \- +html+ или +docx+, должен соответствовать загружаемому файлу шаблона
\\
\\ !print_templates_settings1.png|border=1,width=446,height=265!

h3. Привязка к модели, дополнительная привязка

h2. Редактирование шаблона
Модель и привязка к модели влияют на данные, которые попадут в документ. В архитектуре Carbon Billing 5 можно создать только один шаблон для модели, либо сочетание модели и дополнительной привязки.

Шаблоны можно редактировать. В редакторе есть Основные и Расширенные настройки.
Основные настройки:
*Наименование* \- название шаблона
*Имя шаблона* \- название файла шаблона
*Привязка к модели* \- указывает к какому функционалу привязан данный шаблон !pech2.JPG|border=1!
h4. Abonents

Расширенные настройки:
Здесь шаблон отображен в виде HTML, его можно изменять. В фигурных скобках отображены параметры. !pech3.JPG|border=1!
Используется для печати карточки абонента - данных вкладки "Информация" (включая данные лицевого счета) и свойств учетных записей.

h2. Дополнительная привязка
h4. FinanceOperations

У некоторых шаблонов есть дополнительная привязка. Эта функция предназначена для конкретизации использования шаблона. !pech4.JPG|border=1!
Эта модель используется для финансовых операций, таких как акт, счет и тд. При создании шаблонов этой модели необходимо использование дополнительной привязки.
При печати финансовых операций может быть автоматический создана сама операция - в случае если на момент печати на еще не существовала.
Возможные дополнительные привязки модели *FinanceOperations*:

h2. Ключ быстрой печати
|| Дополнительная привязка || Документ ||
| op_type_id=1 | Акт |
| op_type_id=2 | Приход |
| op_type_id=5 | Счет по услугам |
| op_type_id=3 | Баланс подвести |
| op_type_id=6 | Документы |
| op_type_id=7 | Бланк заказа |
| op_type_id=8 | Исправить баланс |
| op_type_id=9 | Счет на оплату |
| op_type_id=10 | Памятка абоненту |
| op_type_id=11 | Агентский счет |
| op_type_id=12 | Конвертация баллов |
| op_type_id=13 | Перевод другому абоненту |

Для того, чтобы шаблон печати был доступен в окне "Печать" у абонента, необходимо выставить флаг в поле "Ключ быстрой печати" в настройках шаблона печати.    !key.png|border=1!
h4. CardSeries

[CarbonBilling:Карты оплаты]

h4. Hdsk

[Заявки HelpDesk и задачи CRM|CarbonBilling:CRM. HelpDesk]

h3. Движок отображения

Для корректной работы шаблонов печати необходимо выбрать Движок рендеринга - По умолчанию (wkhtmltopdf). xhtml2pdf оставлен для совместимости.
\\
\\ !print_templates_engine.png|border=1!

h3. Ключ быстрой печати

Для того, чтобы шаблон печати был доступен из карточки абонента, необходимо выставить флаг в поле "Ключ быстрой печати" в настройках шаблона.
\\
\\ !print_templates_key.png|border=1,width=410,height=63!\\
\\
Шаблоны с настроенным ключом быстрой печати отображаются в карточке абонента при нажатии кнопки *"Печать"*
\\
\\ !print_templates_key_abon.png|border=1,width=412,height=232!

h2. Вкладка "Опции"

На вкладке настраиваются параметры формирования PDF.