DEV Community

Глеб Лужбин S-WEBS
Глеб Лужбин S-WEBS

Posted on Originally published at s-webs24.ru

Свой Word-файл как шаблон «Фабрики документов» Битрикс24

У многих компаний коммерческое предложение, договор или счёт — это годами вылизанный Word-файл. Менеджер открывает его, вручную заменяет название клиента, предмет, дату и сумму, и надеется, что ничего не пропустит. Спойлер: пропускает.

Приложение «Фабрика документов» для Битрикс24 решает эту задачу иначе: один раз готовится шаблон, а дальше документ собирается из данных CRM автоматически. Хорошая новость — существующий бланк переделывать не придётся. Вот как его превратить в рабочий шаблон.

Разделите текст и данные до того, как откроете приложение

Откройте свой бланк и честно ответьте на вопрос: что здесь менеджер правит вручную каждый раз? Обычно это название клиента, предмет предложения, контакт, дата и сумма. Постоянные формулировки — условия оплаты, реквизиты, логотип — остаются обычным текстом.

Для каждой переменной части определите источник в CRM. Название сделки возьмётся из поля сделки, данные клиента — из связанной компании или контакта, список товаров — из товаров сделки.

Важный момент, который часто игнорируют: если данные сейчас хранятся только в переписке с клиентом, никакая переменная их не достанет. Сначала настройте процесс, чтобы сотрудник записывал их в карточку, — иначе шаблон будет заполняться пустотой.

Вставьте поля из каталога

В приложении при подготовке шаблона открывается каталог полей. Находите нужное поле по названию или коду и копируете выражение. Название сделки, например, выглядит так:

{{ deal.title }}
Enter fullscreen mode Exit fullscreen mode

Есть подводный камень: путь deal.title не становится универсальным, если файл привязать к нескольким типам карточек. Для компании или смарт-процесса источник будет другим — выражение надо брать заново из каталога для нужной сущности.

Также не меняйте регистр кода и используйте прямые кавычки в параметрах выражений. Вводите переменные в обычный текст документа или ячейки таблицы.

Таблицы — отдельная история

Самая частая ошибка — ожидание, что одна строка таблицы с первым товаром как-то сама превратится в список. Не превратится. Для нескольких позиций нужна настоящая Word-таблица с повторением строк: начало и конец цикла оформляются отдельными служебными строками, между ними лежит строка данных.

До загрузки проверьте ширину колонок и высоту строк. Короткое тестовое значение часто маскирует проблему: в реальном документе полное наименование компании займёт три строки и сдвинет подписи на следующую страницу.

Не усложняйте первый вариант изображениями по ссылкам, QR-кодами и вложенными условиями. Сначала добейтесь корректного вывода обычных полей и одной таблицы — остальное добавите позже.

Загрузка и проверка

В разделе «Шаблоны» задаёте название, уникальный код, формат DOCX, файл и подходящие сущности. После загрузки приложение показывает анализ переменных. Если какое-то выражение не поддерживается — исправляйте исходный файл в Word, а не пытайтесь чинить его в каталоге: макет редактируется в редакторе, каталог лишь помогает выбрать данные.

И финальная привычка, которая экономит часы: проверяйте два разных результата. Сначала тестовая генерация на понятных учебных данных — она ловит ошибки макета. Затем документ из реальной контрольной карточки CRM — она ловит ошибки связи с данными. Для приёмки используйте короткое и длинное название, заполненный и пустой контакт, один и несколько товаров. Откройте файл в режиме печати и убедитесь, что поля не слились с соседним текстом, а фигурных скобок с кодами в документе не осталось.

Частые вопросы

Изменится ли уже созданный документ после правки бланка?
Нет. Обновление шаблона влияет только на новые генерации. Прежний файл остаётся прежним — для нового результата нужен новый запуск.

Можно ли загрузить шаблон встроенного генератора без подготовки?
Проверить как исходный файл можно, но полная совместимость не гарантируется. Сверьте поля и конструкции с каталогом приложения и сравните контрольные результаты.

Работать с документами из CRM приятнее, когда бланк выглядит привычно для компании, а заполняется без ручного копирования. Начать можно со страницы приложения и подробной инструкции с примерами.

Читать полностью на S-WEBS24

Top comments (0)