1C Skills: как собрать печатную форму MXL и проверить макет

Работа с табличным документом в 1C Skills: JSON-описание, mxl-compile, анализ областей, параметры и валидация печатной формы.

Article

Макет MXL неудобно редактировать как непрозрачный файл, особенно когда изменение делает ИИ-агент. В 1C Skills табличный документ можно представить компактным JSON, собрать в MXL и проверить до подключения к объекту 1С.

Разобрать существующий макет

mxl-info показывает области, параметры и колонки. mxl-decompile преобразует MXL в JSON-описание. Первый коммит после декомпиляции лучше оставить без функциональных правок — он станет точкой отсчёта.

Разбери макет счёта, найди область Итоги, добавь параметры СуммаБезНДС и СуммаНДС, не меняя ширину остальных колонок. Собери MXL и покажи структурный diff.

Создать макет из описания

mxl-compile строит табличный документ из JSON. В нём явно задаются строки, колонки, области, текст и параметры. Такой формат легче проверить агенту и человеку.

После сборки mxl-validate проверяет структуру. Затем template-add добавляет макет к отчёту, обработке, документу или другому объекту.

Что проверять кроме файла

Параметры макета должны совпадать с кодом заполнения. Если BSL обращается к Область.Параметры.Итого, а параметр называется СуммаИтого, файл может быть корректным, но печать упадёт.

Зафиксируйте контракт: обязательные области, параметры, число колонок, правила переноса и пример данных для рендера.

Визуальная проверка

Валидатор не оценит, помещается ли длинное наименование и не уехала ли подпись на вторую страницу. Сформируйте печатную форму в тестовой базе на коротком и длинном документе и сравните визуально.

JSON и валидация делают изменение обозримым, а реальный рендер подтверждает, что пользователь получит ожидаемый документ.

Статьи по теме