Шаблонизатор

Обновлено: 19.05.2026

Шаблонизатор — это механизм формирования текста по заранее заданному шаблону, в котором специальные метки и команды заменяются данными из системы.

В Timetta шаблонизатор на базе Scriban используется для подстановки данных в текст с помощью конструкций {{ ... }} и {% ... %}: например, {{ Name }} заменяется на название проекта, а {% for ... %} позволяет вывести список связанных записей. Он применяется в моделях контекста ИИ, шаблонах электронной почты и документах проекта.

Где используется шаблонизаторГде используется шаблонизатор

В системе шаблонизатор подключен в трех компонентах:

• моделях контекста ИИ;
• шаблонах электронной почты / сценариях взаимодействия;
• типах документов проекта.

Во всех случаях это подстановка данных в текст по шаблону с {{ ... }} и {% ... %}, но контекст и загрузка данных разные.

Структура шаблона и синтаксисСтруктура шаблона и синтаксис

Пример:

Проект: {{ Name }}
Код: {{ Code }}

В результате {{ Name }} заменится на название проекта, {{ Code }} — на код. Строка Проект: останется без изменений.

Подстановка одного значения — Подстановка одного значения — {{ ... }}

Внутри {{ }} указывается поле записи или цепочка через точку для связанной записи:

{{ Name }}
{{ Code }}
{{ Description }}
{{ Manager.Name }}
{{ StartDate }}
{{ EndDate }}

Правила:

• имена полей указываются как в системе, обычно с большой буквы: Name, не name;
• точка означает «взять поле у связанной записи»: Manager.Name = имя менеджера;
• даты, числа и флаги подставляются как текст, в том виде, в котором система их хранит или форматирует при выводе.

Если поля нет или оно пустое, на этом месте часто будет пусто.

Убрать лишние пробелы и переносы — и Убрать лишние пробелы и переносы — {{- и -}}

Иногда после метки или цикла остаются лишние пустые строки, особенно в таблицах Markdown. Символ - у скобок подрезает пробелы и переносы с этой стороны:

| Ресурс | Роль |
| :----- | :--- |
{{- for Member in ProjectTeamMembers }}
| {{ Member.Resource.Name }} | {{ Member.Role.Name }} |
{{- end }}

Без - между строками таблицы могут появиться лишние пустые ряды.

Повтор для списка — Повтор для списка — {% for ... %}

Если у записи есть несколько связанных строк, один блок шаблона повторяется для каждого элемента:

{% for Member in ProjectTeamMembers %}
- {{ Member.Resource.Name }} - {{ Member.Role.Name }}
{% end %}

Смысл конструкции:

• ProjectTeamMembers — имя списка у текущей записи, как в модели;
• Member — временное имя одного элемента внутри цикла, его можно назвать иначе, например Row;
• внутри цикла обращайтесь к полям через это имя: Member.Resource.Name.

Тот же список в таблице:

| Сотрудник | Роль |
| :-------- | :--- |
{{- for Member in ProjectTeamMembers }}
| {{ Member.Resource.Name }} | {{ Member.Role.Name }} |
{{- end }}

Важно для Timetta: система по шаблону сама подгружает связанные данные, которые явно указаны в путях: Manager.Name, ProjectTeamMembers.Resource.Name и т. п. Поэтому в шаблоне лучше писать прямые обращения к полям, а не выдумывать обходные пути.

Условие — показать только если есть — Условие — показать только если есть — {% if %}

{% if Description %}
## Описание
{{ Description }}
{% end %}

Блок между {% if %} и {% end %} попадет в текст только если Description заполнено.

Можно комбинировать условия с циклами и Markdown.

Markdown в шаблонеMarkdown в шаблоне

Шаблонизатор не мешает разметке Markdown. Можно использовать:

• заголовки #, ##;
• списки - или 1.;
• таблицы | ... |;
• жирный текст **...**, если он нужен в контексте.

Итог — готовый текст для чата, удобный и человеку, и ИИ.

Полный пример шаблонаПолный пример шаблона

# Паспорт проекта

- Наименование: {{ Name }}
- Код: {{ Code }}
- Менеджер: {{ Manager.Name }}
- Сроки: {{ StartDate }} - {{ EndDate }}

## Описание
{{ Description }}

## Команда

| Ресурс | Роль |
| :----- | :--- |
{{- for Member in ProjectTeamMembers }}
| {{ Member.Resource.Name }} | {{ Member.Role.Name }} |
{{- end }}

Для нескольких выделенных записей в списке этот шаблон выполняется отдельно для каждой записи. Полученные блоки склеиваются с пустой строкой между ними.

Откуда брать имена для метокОткуда брать имена для меток

Корень шаблона — одна выбранная сущность того типа, для которого настроена схема: проект, сделка, документ и т. д.

Полное описание сущностей и их свойств доступно в менеджере сущностей.

Доступно для применения:

• Свойства примитивы: Name, Code, StartDate и т. п.;
• Навигационные свойства: Manager.Name, (в том числе по «цепочке») — Organization.Code);
• Свойства коллекции: ProjectTeamMembers (их надо итерировать в цикле) и т. п.

Имена должны совпадать со свойства в метамодели / карточке, как в API и настройках сущности. Если метка не совпадает, в результате будет пустое место или ошибка при генерации.

Что шаблонизатор в Timetta не делаетЧто шаблонизатор в Timetta не делает

Расширенные возможности Scriban, например сложные функции и специальное форматирование дат, в справочнике Timetta почти не используются. Шаблон в Timetta ориентирован прежде всего на поля сущности и простые конструкции, как в примерах выше.

Если шаблон пустой или с ошибкойЕсли шаблон пустой или с ошибкой

При создании схемы для типа с полем имени система может подставить минимальный шаблон: {{ Name }}.

Дополнительные материалыДополнительные материалы

• Описание Scriban: https://scriban.github.io/docs/.