Вернуться к статьям Сохраните рабочий исходник и выполняйте адаптацию в отдельной копии. Не заменяйте используемый отделом шаблон до сравнения результатов.
Составьте карту исходного шаблона
Отметьте все переменные и сгруппируйте их по назначению: поля карточки, реквизиты клиента, своя компания, товары, суммы, даты и специальные элементы. Отдельно выпишите таблицы, условия, изображения и номер документа.
| Элемент | Что проверить при переносе |
|---|---|
| Простое поле | Наличие точного алиаса или пути в каталоге |
| Пользовательское поле | Сущность и код текущего портала |
| Товары | Поддерживаемую структуру повторения |
| Дата и ФИО | Синтаксис модификатора и результат |
| Номер документа | Отдельный источник и правила присвоения |
| Изображение | Подготовленные данные и фактическую вставку |
Такой список позволяет оценить объём адаптации до изменения бланка.
Проверьте поддерживаемые выражения
В приложении есть основной синтаксис с двойными скобками и поддержка ряда выражений в одинарных скобках. Например, для текущего названия используется {Title}. Примеры модификаторов находятся в разделе «Примеры и инструкция».
Не добавляйте похожий модификатор по аналогии, если его нет в поддерживаемом наборе. Для даты через тильду и фильтра date используются разные маски. Даже одинаковое внешнее назначение не делает синтаксис взаимозаменяемым.
Адаптируйте таблицы отдельно
Штатные коды товарного блока и конструкции приложения нужно сверять. Для Word в «Фабрике документов» предусмотрено повторение строк настоящей таблицы через {%tr ... %}. Для Excel используется блок {{#products}} с отдельными строками начала и конца.
Не переносите Word-разметку в XLSX простой заменой расширения файла. У листа Excel другая структура, а формулы, объединённые ячейки и печать требуют собственной проверки.
Не потеряйте нумерацию
У встроенного генератора есть механизм присвоения номера по нумератору. В «Фабрике документов» выбранный нумератор пока сохраняется как справочная привязка: следующий номер DOCX/XLSX не присваивается, счётчик не увеличивается.
Если последовательность номеров обязательна, заранее определите другой проверенный источник номера или оставьте этот тип документа в штатном генераторе. Можно вывести уже записанный номер из поля CRM, но это не равно его автоматической выдаче.
Сравните два результата
Используйте одну контрольную карточку и одинаковые исходные данные. Получите документ старым способом и адаптированным шаблоном. Сверьте смысловые поля, число товарных строк, суммы, номер, даты и печатное оформление.
Затем повторите проверку с длинными названиями, пустыми необязательными полями и несколькими товарами. Совпадение на одной короткой карточке не подтверждает совместимость всего бланка.
Если часть данных отсутствует, исправьте сопоставление или ограничьте назначение нового шаблона. Не убирайте обязательные блоки только ради успешной генерации.
Как вводить новый вариант в работу
Дайте шаблону понятное название, укажите подходящие сущности и сохраните образец результата. Объясните сотрудникам, какой документ теперь создаётся приложением, а какой остаётся во встроенном инструменте.
Первое время удобно проверять новые результаты по короткому чек-листу. После изменения шаблона повторите контрольные сценарии: старые сформированные файлы не показывают поведение новой версии.
Частые вопросы
Возможен перенос без изменений?
Для простого поддерживаемого набора выражений это может оказаться возможным, но устанавливается только контрольной генерацией. Универсальной гарантии для всех штатных шаблонов нет.
Нужно ли обязательно переносить все документы?
Нет. Переносите те типы, для которых приложение решает конкретную задачу. Остальные можно оставить в принятом процессе.
Синтаксис и ограничения приведены в инструкции «Фабрики документов». Описание продукта — на странице приложения.