====== Администратор. Документы ======

===== Шаблоны документов =====

Шаблон документа обладает следующей структурой: места, где в шаблон при выгрузке будет вставляться индивидуальная для этого документа информация оформляются в текстовом виде. Такие места должны начинаться и оканчиваться на три подряд идущих символа "+". Внутри такого "блока" располагается название подставляемой переменной через "=". Переменная состоит из класса и атрибута, разделенных ".". Например, текущий год в шаблоне будет иметь вид: "+++=date.year+++", т.е. будет подставляться атрибут year (год) класса date (дата). Форматирование текста не влияет на распознавание вставок, можно использовать любой шрифт, в т.ч. **жирный** или //курсив//.

В шаблоне документа могут встретиться следующие атрибуты:
  * Атрибуты класса listener (слушатель):
    * listener.FIO - Фамилия Имя Отчество (при наличии)
    * listener.surname - Фамилия
    * listener.name - Имя
    * listener.midname - Отчество
    * listener.initials - Инициалы
    * listener.birthday - Дата рождения
    * listener.birthdayAge - Дата рождения, возраст
    * listener.gender - Пол
    * listener.snils - СНИЛС
    * listener.nationality - Гражданство
    * listener.education - Образование (какое и когда окончил учебное заведение, № диплома, когда выдан)
    * listener.eduSpecialty - Специальность по образованию
    * listener.educationOrganization - Образование и квалификация (когда и какую образовательную организацию окончил)
    * listener.educationOrganizationName - Образование (название учебного учреждения)
    * listener.educationDiploma - Реквизиты документа об образовании (серия, номер, рег.N., дата выдачи)
    * listener.workOrganization - Место работы
    * listener.positionExperience - Занимаемая должность и стаж работы в занимаемой должности
    * listener.workOrganizationAddress - Адрес организации (с индексом)
    * listener.factAddress - Адрес места жительства (фактический)
    * listener.snils - Номер СНИЛС
    * listener.phone - Контактный телефон
    * listener.email - Адрес электронной почты
    * listener.userUniversity - Текущий университет слушателя
    * listener.suffix - ?
  * Атрибуты класса passport (паспорт):
    * passport.seriesNumber - Серия и номер
    * passport.dateOrganization - Дата выдачи, кем выдан
    * passport.registration - Адрес регистрации
    * passport.all - Данные паспорта (Серия, Номер, Кем и когда выдан)
  * Атрибуты класса date (дата):
    * date.day - День
    * date.month - Месяц
    * date.year - Год
  * Атрибуты класса program (Программа повышения квалификации)
    * program.title - Название
    * program.hours - Длительность (академ. часов)
  * Атрибуты без класса:
    * contractNumber - номер Договора ИНО
    * agreementNumber - номер согласия для программ Цифровой кафедры

Структура Учебного плана программы повышения квалификации:

{{ dpo:admin:templates:table.png }}

Строки заполняются с помощью конструкции FOR. В таблице в строке между командами **FOR row IN realValues** и **END-FOR row** располагаются вставки вида **+++=$row[i]+++**, где row - строка таблицы учебного плана, i - номер элемента строки (если i = 0, то это № п/п, если i = 1, то это Наименование раздела, дисциплины (модуля) и т.д.).

Строка **Итого:** называется resultValues1.

Строка **Итоговая аттестация.** называется resultValues2.

Строка **Всего:** называется resultValues3.

Индексация resultValues отражает номер столбца. Т.е. если индекс равен 1, то это значение в столбце "Трудоемкость, час". Если индекс равен 2, то это значение в столбце "Всего, час".

После изменения шаблона и загрузки его в систему с помощью кнопки "Загрузить", рекомендуется проверить выгрузку нажатием на кнопку "Проверить". **В случае, если в шаблон был введен класс, которого не существует в системе, экспорт проходить не будет.** Система сообщит об ошибке с указанием, какие классы не удалось найти:

{{ dpo:admin:templates:error.png }}

Атрибуты не выдают ошибку, экспорт будет проходить. В случае, если был введен несуществующий атрибут, в шаблон вставится пустая строка "".