Что такое переменные
Переменные — это «заполнители» в тексте шаблона, которые при генерации заменяются на реальные данные. Вы пишете в Google Doc {field.client_name} — а в готовом документе на этом месте появляется «Иван Петрович». Простая идея, которая экономит часы ручной работы.
Синтаксис переменных
В ШАБЛОНЕ
Договор № {field.contract_number}
г. {field.city}
{company.name}, в лице {company.directorName | fsd}
В ДОКУМЕНТЕ
Договор № 125
г. Москва
ООО «Ромашка», в лице Иванова И.И.
Как добавлять переменные
Порядок работы такой: сначала вы добавляете поле в интерфейсе сервиса (задаёте имя, тип, модификаторы), затем сервис показывает готовую переменную — и вы вручную копируете её и вставляете в нужное место текста в Google Doc. Сервис не ищет переменные в тексте автоматически, вы полностью управляете их расположением. Одну и ту же переменную можно вставить в нескольких местах документа.
Типы переменных
| Тип | Пример | Где взять значение | Когда применять |
|---|---|---|---|
| Обычное поле | {field.city} | Вводится вручную при генерации | Любые данные: город, сумма, описание |
| Контрагент | {company.name} | Из справочника контрагентов | Реквизиты клиентов и партнёров |
| Таблица | {table.items} | Построчный ввод при генерации | Спецификации, перечни, сметы |
| Счётчик | {counter.invoice} | Автоматически из счётчика | Нумерация документов |
| Системная | {system.date} | Подставляется автоматически | Текущая дата, время, имя пользователя |
| Calc | {total} | Вычисляется по формуле | Итоговые суммы, расчёты |
Модификаторы — главная сила переменных
Каждую переменную можно пропустить через модификатор — специальную обработку, которая меняет отображение значения. Синтаксис: {переменная | модификатор}. Модификаторы можно комбинировать: {переменная | модификатор1 | модификатор2}. Например, можно взять число, перевести его в сумму прописью и просклонять: {sum | amount-words | case:genitive}.
Подробно каждый модификатор разобран в следующих статьях этого раздела.