![Данные company и contact содержат пустые строки. Блок организации между [[?company]] и [[/company]] пропускается, а contact вне условного блока получает заметную метку пустого значения.](/static/articles-media/dokumenty-avtosalona-proverka-podstanovok.svg)
Документ выглядит аккуратно: фирменная шапка, таблица автомобиля, место для подписей. Но контакт покупателя остался пустым, а строка организации появилась у частного клиента. Просмотр одного удачного примера не обнаружит все такие ошибки. При настройке документов в CRM полезно отдельно проверять связи между полями и поведение разных вариантов данных.
Начните с перечня источников, а не с готового PDF
Для каждой подстановки запишите, откуда берётся значение: автомобиль, покупатель, компания продавца или сама сделка. Одинаковые по виду поля не обязательно взаимозаменяемы. Например, внутренний комментарий менеджера не должен становиться текстом для покупателя только потому, что рядом не оказалось другого описания.
| Ситуация | Пример учебной переменной | Что проверить |
|---|---|---|
| Поле существует, но не заполнено | contact есть со значением «» | Кто должен внести контакт и допустимо ли формировать результат без него |
| Название поля не найдено | Шаблон просит buyer_name, а данные содержат buyer | Карту подстановок и точное имя переменной |
| Необязательная часть не относится к случаю | company пусто у частного покупателя | Включается ли целая строка только при наличии нужных данных |
| В данных есть лишний ключ | operator_comment не читается шаблоном | Действительно ли он не нужен здесь, либо забыта предусмотренная подстановка |
В A777AA документы создаются из данных сделки; действующая страница возможностей также описывает сохранение снимка данных. Это помогает отличать уже созданный результат от текущей карточки. Но перед началом работы всё равно стоит проверить, что именно попало в документ и какой набор данных использован в тесте.
Проверьте минимум два разных случая
Возьмите обезличенные примеры с заполненной организацией и без неё. Добавьте случай с отсутствующим ключом и случай с пустой строкой. Это разные состояния: отсутствующий ключ может указывать на неправильную связь полей, а пустой — на незавершённую карточку. Не следует автоматически закрывать обе проблемы одним прочерком.
Практика просмотра результатов подстановки по отдельным записям знакома и по слиянию документов Word: Microsoft рекомендует предварительный просмотр и переход между записями источника. Здесь важен сам принцип проверки нескольких вариантов данных. Он не означает, что формат шаблонов Word совпадает с форматом вашей CRM.
Как устроен учебный предпросмотр
Обычная подстановка записывается как [[buyer]]. Она берёт строку по точному ключу buyer из JSON-словаря. Если ключ отсутствует, результат содержит заметную метку «нет поля». Если значение пустое или состоит из пробелов, показывается отдельная метка «пусто». Поэтому недостающие данные не исчезают в незаметный пробел.
Необязательный фрагмент помещается между [[?company]] и [[/company]]. Если company существует и содержит непустую строку, фрагмент включается. Если строка пустая, фрагмент пропускается без замечания об обязательном заполнении. Отсутствующий ключ условия отмечается как нехватка данных: инструмент не угадывает, было ли скрытие намеренным.
Покупатель: [[buyer]]
[[?company]]Организация: [[company]]
[[/company]]Контакт: [[contact]]Сначала разбирается структура всего шаблона. Незакрытый блок или несовпадающее закрытие останавливает расчёт даже внутри скрываемого фрагмента. Затем вычисляется активная часть. Поля, находящиеся внутри пропущенной части, не требуют заполнения для данного предпросмотра.
Значение поля не становится новым шаблоном
Подставленный текст не разбирается повторно. Если тестовое значение содержит [[other]], оно так и останется текстом, а не прочитает ещё одно поле. Разметка HTML также показывается как обычная строка. Здесь нет выполнения формул, скриптов и перехода по именам свойств через точку. Все значения задаются строками, в том числе уже подготовленные суммы и даты.
Как читать список неиспользованных ключей
Он показывает данные, которые не были прочитаны в активном сценарии. Это повод проверить карту полей, но не команда удалить их из CRM. Один ключ может понадобиться другому документу или варианту покупателя. Если условный блок выключен, его внутренние поля тоже могут остаться непрочитанными.
Что произойдёт в начальном примере
Автомобиль и покупатель подставятся. company существует, но пусто, поэтому строка организации исчезнет целиком. contact существует и пуст, поэтому в активной строке появится заметная метка. operator_comment не используется и будет перечислен отдельно. Устранение пустого contact уберёт именно это замечание, но не подтвердит правильность содержания остальных значений.
Что принять после настройки настоящего документа
- Сверьте карту подстановок с фактическими полями карточек.
- Проверьте разные варианты покупателя, отсутствующие значения и необязательные разделы.
- Просмотрите полученный файл целиком: переносы, таблицы, даты, номера и формат сумм не проверяются этим текстовым инструментом.
- Убедитесь, что сотрудник понимает разницу между актуальной карточкой и ранее сохранённым документом.
- Отдельно согласуйте содержание и порядок использования документа с ответственным за него специалистом.
Для начала работы с документами A777AA подготовьте обезличенную сделку и перечень ожидаемых подстановок. Такой набор удобнее проверять вместе с командой, чем один визуально красивый файл. Текстовый предпросмотр помогает сформулировать тесты, а окончательная приёмка относится к реальному документу и рабочему сценарию CRM.
Проверить поля и необязательные части учебного шаблона
Свой учебный синтаксис, не формат A777AA/Word. Ключи из латинских букв, цифр и _, начиная с буквы; все значения строки. До 100 ключей, 20 уровней условий и 100000 знаков результата. Нет чтения документов, проверки реквизитов, юридического содержания или печати. Расчёт выполняется на вашем устройстве, введённые данные никуда не отправляются.