Загрузка и редактирование шаблонов

Где живут шаблоны

Шаблоны хранятся на сервере в защищённом storage (MEDIA_TEMPLATES_PATH). К каждому типу заявки (Справочники → Виды заявок) и виду журнала (Справочники → Виды журналов) может быть привязан один файл .docx или .dotx.

Если шаблона нет — кнопки «Скачать акт» / «Скачать журнал» вернут ошибку «Шаблон не загружен».

Какие форматы поддерживаются

Размер файла: до 10 MB.

Как залить шаблон через интерфейс

Для актов заявок

1. Зайди в Справочники → Виды заявок.
2. Открой нужный тип (например «Аварийная», «Плановая ТО»).
3. В детальной странице — секция «Шаблон документа»:
   • Если шаблона ещё нет — кнопка «Загрузить».
   • Если есть — имя файла + кнопка «Удалить» / «Заменить».
4. Выбери файл .docx или .dotx с компьютера.
5. После загрузки система покажет имя файла, дату загрузки и тебя как админа, который залил.

⚠️ Требуется право: spec_order_modify.

Для журналов объектов

Аналогично:

1. Справочники → Виды журналов.
2. Открой нужный вид (например «Журнал технического обслуживания»).
3. В детальной странице — секция «Шаблон документа» с тремя действиями:
   • 📥 Скачать — забрать текущий файл для правки в Word
   • ↻ Заменить / 📤 Загрузить — залить обновлённую версию
   • 🗑 Удалить — снять привязку

⚠️ Требуется право: spec_journal_modify для загрузки/удаления, spec_journal_read для просмотра и скачивания.

Как скачать акт по заявке

1. Открой заявку (раздел Заявки → клик по строке в таблице).
2. В шапке детальной страницы — две кнопки:
   • 📄 Акт (DOCX) — мгновенно, открывается в Word.
   • 📑 Акт (PDF) — медленнее (~3-5 секунд, конвертация на сервере).
3. Файл скачивается с именем act_order_<номер>.docx.

Как скачать журнал по объекту

1. Открой объект (раздел Объекты → клик по строке).
2. Сверху рядом с заголовком — кнопка-выбор «Скачать журнал» (если у объекта есть привязанный договор и хотя бы один вид журнала имеет шаблон).
3. Выбери вид журнала и формат (DOCX / PDF).

Массовое скачивание

В списке заявок (/orders):

1. Выдели несколько строк чекбоксами (или «Выбрать все на странице» в шапке таблицы).
2. В верхней панели — кнопки «📄 Акты DOCX (N)» и «📑 Акты PDF (N)».
3. Скачивается ZIP-архив со всеми актами.

Лимит: 100 заявок за один запрос. Каждая заявка рендерится по своему шаблону (если в выборке смешанные типы — каждой подберётся её шаблон).

Если у части заявок шаблона нет — они не блокируют остальные, а попадают в errors.txt внутри архива со списком причин.

Алгоритм правки существующего шаблона

1. Скачай текущий шаблон через интерфейс справочника (или попроси админа).
2. Открой в Word, правь / добавляй метки (см. статью «Метки в шаблонах документов»).
3. Сохрани в том же формате (.docx или .dotx).
4. Залей обратно через интерфейс справочника — старый файл будет заменён.
5. На пробной заявке нажми «Скачать акт» — проверь подстановку значений.

Часто встречающиеся ошибки

Связано

• См. статью «Метки в шаблонах документов» — полный словарь меток.