Шаблоны договоров
Шаблон — это ваш обычный документ Word, в котором переменные части заменены плейсхолдерами. Система подставляет данные и отдаёт готовый файл.
Загрузка
| Тип шаблона | Форматы |
|---|---|
| Договор | .docx, .xlsx, .xlsm |
| Отчёт | .docx |
Максимальный размер — 20 МБ. Формат .dotx не поддерживается: сохраните шаблон Word как
обычный .docx.
Переменная
Договор № {{contract_no}} от {{contract_date}}
Территория: {{territory}}
Вознаграждение: {{licensor_share}}%
Если переменной нет в данных, плейсхолдер заменяется пустой строкой — документ не ломается, просто в этом месте ничего не будет. Список значений (например, несколько авторов) печатается через запятую.
Поддерживается обращение к полю: {{w.muz_name}}, {{works.0.artist}}.
Цикл
Повторяет фрагмент по каждому элементу списка:
{{FOR:w IN works}}
{{w.index}}. {{w.muz_name}} — {{w.artist}}, {{w.year_relize}}
{{ENDFOR:works}}
Внутри цикла доступны счётчики {{w.index}}, {{w.loop_index}} и
{{w.no}} — все начинаются с единицы. Открывающий и закрывающий маркеры должны занимать
абзац целиком. Если список пуст, весь блок удаляется.
Циклы в таблицах. Если строка таблицы начинается с {{FOR:…}} и
заканчивается {{ENDFOR:…}}, размножается сама строка — так делается таблица произведений.
Условие
{{IF:has_M}}
Лицензиар передаёт права на музыкальное произведение…
{{ENDIF:has_M}}
Если условие ложно, удаляются и маркеры, и весь текст между ними. Условия можно вкладывать друг в друга. Маркер должен занимать абзац целиком.
Арифметика
Для сквозной нумерации, когда на каждый объект приходится несколько пунктов договора:
{{w.index*3-2}} → 1, 4, 7
{{w.index*3-1}} → 2, 5, 8
{{w.index*3}} → 3, 6, 9
Доступны +, -, * и их комбинации. Работает только с числовыми
переменными.
Изображения
{{cover_image}} обложка, размер по умолчанию 53 × 53 мм
{{cover_image_30x30}} обложка 30 × 30 мм
{{cover_image_2_60x40}} обложка второго объекта, 60 × 40 мм
Размер задаётся в миллиметрах. Внутри цикла достаточно написать {{cover_image_30x30}} —
номер объекта подставится автоматически по номеру итерации. Так же ведут себя
{{file_hash}}, {{format}}, {{duration}} и {{size}}.
Какие переменные доступны
Договор
contract_no · contract_date · territory ·
license_term · license_start · license_end ·
licensor_share · exclusive_methods · nonexclusive_methods ·
objekt
Флаги вида объекта — для условий
has_M · has_I · has_F · has_O ·
has_Foto · has_Art, а также block_MIFO, block_MIO,
block_MFO, block_MO и остальные комбинации.
Список произведений — works
Поля элемента: no, index, muz_name, name_albom,
year_relize, artist, author_text, author_muz,
phonogram, picture_own, license_term, territory,
exclusive_methods, nonexclusive_methods, licensor_share,
object_type, object_name, rights_scope, description,
right_holder.
Правообладатели — licensors_all
Поля: name, short (краткая форма для подписной строки),
share_percent, email.
Подписанты
Коллекции signers_fiz, signers_org, signers и готовые текстовые
блоки — подробно в разделе Подписанты.
Файлы
file_hash (SHA-256), duration (в формате 3:45),
format, size, storage_link, cover_image.
Расходы
expenses (список для цикла), expenses_total, recoupment_carry,
licensor_due_after_expenses, готовый блок expenses_block и флаг
has_expenses для условия. См. Расходы и возмещение.
Ваши реквизиты
org_full_name · org_short_name · org_inn ·
org_ogrn · org_address · org_bank_details ·
org_email · org_phone · org_signer_name ·
org_signer_position · org_signer_doc. Заполняются в «Настройки» → «Организация».
Проверка шаблона при загрузке
Каждый загруженный DOCX-шаблон автоматически проверяется, и вы сразу видите список замечаний:
| Замечание | Что означает |
|---|---|
| Цикл без закрытия | {{FOR:…}} есть, парного {{ENDFOR:…}} нет |
| Закрытие без цикла | Обратная ситуация |
| Переменная файла вне цикла | file_hash, duration, format или size стоят вне {{FOR:…}} и всегда покажут значение первого файла |
| Неизвестная переменная | Имя не совпало ни с одной известной — обычно опечатка |
| Арифметика на нечисловой переменной | Выражение может не сработать |
Замечания не блокируют загрузку. Шаблон сохранится даже с незакрытым циклом — список замечаний носит рекомендательный характер. Прочитайте его перед первой генерацией, иначе ошибку вы увидите уже в готовом документе. Исключение — Excel-шаблоны: у них проверка строгая, файл с ошибкой не примут.
Совместимость со старым синтаксисом
Шаблоны, написанные в синтаксисе {% for %} и {% if %}, продолжают работать —
они преобразуются автоматически. Новые шаблоны пишите в форме {{FOR:…}} и
{{IF:…}}.