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

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

- Category: gitsell-news
- Published: 2026-10-20T04:04:53.673716
- Canonical: https://gitsell.ru/blog/1c-skills-kak-sobrat-pechatnuyu-formu-mxl-i-proverit-maket

## Article

Макет MXL неудобно редактировать как непрозрачный файл, особенно когда изменение делает ИИ-агент. В [1C Skills](https://gitsell.ru/msrv-tech/skills) табличный документ можно представить компактным JSON, собрать в MXL и проверить до подключения к объекту 1С.

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

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

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

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

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

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

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

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

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

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

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

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


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

- [1C Skills: как создать справочник и форму из задачи](/blog/1c-skills-kak-sozdat-spravochnik-i-formu-iz-zadachi): Практический workflow 1C Skills: новый справочник, реквизиты, подсистема, управляемая форма и валидация XML-исходников.
- [1C Skills и YAxUnit: как встроить тесты в работу ИИ-агента](/blog/1c-skills-i-yaxunit-kak-vstroit-testy-v-rabotu-ii-agenta): Связка 1C Skills и YAxUnit: агент меняет XML, запускает подходящие тесты, читает результат и исправляет код до review.
- [Как подключить 1C Skills к Codex и Claude Code](/blog/kak-podklyuchit-1c-skills-k-codex-i-claude-code): Установка 1C Skills для локального ИИ-агента: клонирование репозитория, зависимости Python, платформа 1С и первая безопасная проверка.