Вернуться к статьям Два уровня совместимости
Первый уровень — где пользователь видит шаблон. При создании или загрузке файла указываются подходящие сущности: например, сделка и лид. Если нужный тип не выбран, шаблон может не предлагаться при запуске из этой карточки.
Второй уровень — какие данные шаблон ожидает получить. Файл может быть доступен, но обращаться к полям, которых нет в контексте выбранной сущности. Именно поэтому проверка списка флажков не заменяет контрольную генерацию.
Прямой путь и алиас текущей сущности
В инструкции приложения приведены два варианта:
{{ deal.title }}
{Title}
Первый явно обращается к названию сделки. Второй — поддерживаемый алиас поля текущей сущности. Подходящий алиас нужно выбирать в каталоге и проверять на каждом источнике: нельзя считать любое знакомое имя универсальным.
То же правило относится к реквизитам и связанным данным. В сделке клиент может быть связан через компанию, а в другом сценарии структура данных будет отличаться. Пользовательские поля также принадлежат определённому типу карточек.
Когда полезен общий бланк
Общий шаблон удобен, если документ имеет одинаковое назначение, структуру и набор действительно общих данных. Например, короткое информационное письмо с названием текущей записи и проверенным блоком клиента.
Не стоит объединять документы только ради уменьшения количества файлов. Если у сделки и лида разные обязательные поля, общий бланк быстро обрастает условиями, которые сложно проверять и объяснять сотрудникам.
Когда лучше сделать отдельные варианты
Разделите шаблоны, если отличаются стороны, таблицы, источник суммы, обязательные условия или смысл документа. Два понятных файла «КП по сделке» и «Письмо по лиду» могут быть надёжнее одного «Универсального документа».
| Ситуация | Подход |
|---|---|
| Одинаковый текст и общие поля | Проверить общий шаблон |
| Разный смысл суммы или реквизитов | Отдельные варианты либо явное сопоставление |
| Уникальные пользовательские поля | Проверить каждый тип отдельно |
| Разные таблицы и условия | Обычно проще разделить бланки |
Матрица проверки
Для каждого выбранного типа подготовьте контрольную карточку. Сформируйте файл и запишите результат по ключевым полям: название, клиент, сумма, товары и дополнительные сведения. Добавьте пример с пустым необязательным значением.
Проверяйте фактические данные, а не только отсутствие ошибки. Шаблон может успешно сформироваться с пустым блоком или с формально подходящим, но неверным по смыслу полем.
Отдельно проверяйте связанные задачи. Наличие списка в одном сценарии не означает его наличие во всех: для предложений CRM в описанной реализации он не загружается.
Что делать после изменения общего шаблона
Повторите проверку на всех назначенных сущностях. Правка, полезная для сделки, может нарушить вариант для лида. Храните небольшой набор контрольных карточек и образцы ожидаемого результата.
Изменения применяются к новым генерациям. Уже созданные документы не переписываются, поэтому проверять обновление нужно новым запуском.
Частые вопросы
Достаточно заменить слово deal на lead?
Нет. Нужно проверить существование каждого поля и структуру связанных данных. Автоматическая замена части пути не доказывает совместимость.
Можно ли добавить смарт-процесс к тому же файлу?
Только после проверки его точного типа, доступных полей и результата. Смарт-процесс имеет собственный набор данных, который зависит от настройки портала.
Каталог и примеры алиасов описаны в инструкции приложения. Общие возможности — на странице «Фабрики документов».