Вернуться к статьям Сначала зафиксируйте исходный пример
Запишите для себя, какой шаблон использовался и из какой карточки выполнялся запуск. Сохраните проблемный файл. Проверьте, воспроизводится ли ошибка на том же наборе данных после обновления страницы приложения.
Не меняйте одновременно макет, источник и формат. Один небольшой шаг позволяет понять, что именно исправило результат.
Таблица диагностики
| Симптом | Что проверить первым | Следующее действие |
|---|---|---|
| Поле пустое | Заполненность и точный код | Сверить выражение с каталогом |
| Не подставился клиент | Связь карточки с компанией или контактом | Проверить реквизиты и доступ |
| В файле остались скобки с кодом | Синтаксис, регистр, кавычки | Повторить анализ переменных |
| Товарная строка не размножилась | Список товаров и границы цикла | Проверить отдельные служебные строки |
| Не появились задачи | Связь задач с текущей сущностью | Проверить поддерживаемый источник |
| Неверный вид суммы или даты | Источник и фильтр | Сравнить исходное значение и формат |
| Генерация завершилась ошибкой | Сообщение в «Генерациях» | Исправить указанную причину |
Пустое поле: источник или шаблон
Сначала откройте CRM-карточку и убедитесь, что данные действительно есть. Название компании в комментарии не заменяет связь с компанией. Пользовательское поле другой сущности тоже не становится источником текущего документа.
Затем скопируйте точный код из каталога. Если шаблон был перенесён между порталами, заново проверьте пользовательские поля. Наконец выполните запуск под учётной записью сотрудника: доступ администратора может отличаться.
Остался код вместо значения
Сравните выражение со встроенным примером. Проверьте парные скобки, регистр, прямые кавычки и поддерживаемый фильтр. В Word убедитесь, что выражение введено обычным текстом, а не помещено в неподдерживаемый элемент макета.
Для проверки сделайте копию бланка с одним проблемным полем. Если простой вариант работает, последовательно возвращайте окружающие условия и таблицы.
Таблица не совпадает с данными
У Word и Excel разные конструкции циклов. В DOCX нужны отдельные служебные строки настоящей таблицы, в XLSX — отдельные строки листа. Имя item внутри выражений должно совпадать с именем переменной цикла.
Проверьте ноль, один и несколько элементов. Если товаров нет в CRM, отсутствие строк данных корректно. Если список задач пуст, убедитесь, что они связаны с текущей карточкой; для сущности «Предложение» список задач в описанном сценарии не загружается.
Ошибка времени и отличие пустоты от нуля
duration принимает целые неотрицательные секунды. Текст «2 часа», отрицательное число или неподдерживаемая маска формата вызовут ошибку. Проверьте, что используется зарегистрированное время задачи, а не произвольное текстовое поле.
Запасное значение через default меняет отображение. Оно не подтверждает, что отсутствующие данные в действительности равны нулю.
Файл создан, но выглядит неправильно
Успешная генерация не гарантирует хорошую печатную форму. Откройте файл в Word или Excel: проверьте длинные названия, объединённые ячейки, высоту строк, разрывы страниц и область печати. Для PDF отдельно проверьте готовое преобразование.
После исправления сформируйте новый документ. Изменение шаблона не переписывает ранее созданный файл, поэтому повторное скачивание старой генерации не покажет исправление.
Что передать в поддержку
Подготовьте название операции, текст ошибки, обезличенный пример шаблона и описание ожидаемого результата. Перед передачей удалите из примера реальные контакты, банковские и клиентские сведения, если они не нужны для воспроизведения.
Синтаксис и контрольные примеры собраны в инструкции приложения. На странице «Фабрики документов» доступны учебные файлы для сравнения.