--- name: onec-print-forms-and-mxl description: "Проектирует и дорабатывает печатные формы 1С, макеты табличного документа (SpreadsheetDocument / .mxl) и подключение к подсистеме УправлениеПечатью БСП. Используй для создания внутренних и внешних печатных форм, настройки областей, параметров, расшифровки и пакетной печати комплекта без запросов в цикле." --- # Печатные формы, макеты MXL и подсистема печати БСП Используй навык, когда требуется создать или изменить печатную форму документа/справочника, настроить макет табличного документа (`.mxl`), подключить команду печати к БСП (`УправлениеПечатью`) или устранить дефект вывода/форматирования печатного бланка. Чтение и изменение метаданных объекта, макетов и модулей выполняй через `edt-mcp`, а проверку сформированного печатного бланка по эталону — через навык `onec-vanessa-scenario`. ## Устройство макета табличного документа (`MXL`) До написания кода модуля менеджера изучи структуру макета: - **Горизонтальные и вертикальные области**: обычные полосы бланка (`Шапка`, `ШапкаТаблицы`, `Строка`, `Подвал`) задаются именованными областями строк. Если количество колонок динамическое, используются пересечения областей строк и колонок: `Макет.ПолучитьОбласть("Строка|КолонкаДанных")` и вывод по горизонтали через `ТабДок.Присоединить(ОбластьЯчейки)`. - **Режим свойства `Заполнение` ячейки** — частая причина пустых значений или литералов вместо данных: - `Текст` — выводит строку ячейки как есть, игнорируя `Область.Параметры`; - `Параметр` — выводит значение одноимённого свойства из `Область.Параметры.<Имя>` с сохранением типа (число, дата, формат ячейки); - `Шаблон` — подставляет параметры в квадратных скобках внутри текста, например `Договор № [НомерДоговора] от [ДатаДоговора]`. - **Расшифровка (`ПараметрРасшифровки`)**: если ячейка содержит ссылку на документ, контрагента или номенклатуру, заполняй параметр расшифровки, чтобы двойной щелчок в печатной форме открывал карточку объекта. - **Параметры страницы и разрывы**: проверяй `АвтоМасштаб` (`ПоШиринеСтраницы` = `Истина` для широких накладных/актов), ориентацию листа (`Портрет`/`Ландшафт`), `ПовторятьПриПечатиСтроки` для шапки многостраничной таблицы и `ПроверитьВывод(МассивОбластей)` перед выводом подвала с подписями, чтобы блок подписей не отрывался на пустой последний лист без единой строки таблицы. ## Контракт подсистемы `УправлениеПечатью` БСП В конфигурациях на БСП печать размещается в **модуле менеджера** объекта (или в модуле объекта внешней печатной формы), а не в модуле управляемой формы документа! 1. **Регистрация команды в `ДобавитьКомандыПечати(КомандыПечати)`**: - Укажи уникальный `Идентификатор` (совпадающий с именем макета или списком макетов через запятую), локализованное `Представление` (`НСтр`), `Обработчик` (если отличается от стандартного `Печать`), `СписокФорм` (при ограничении показа), `ПроверкаПроведенияПередПечатью` и параметры комплекта. 2. **Формирование в процедуре `Печать(МассивОбъектов, ПараметрыПечати, КоллекцияПечатныхФорм, ОбъектыПечати, ПараметрыВывода)`**: - Всегда проверяй `УправлениеПечатью.НужноПечататьМакет(КоллекцияПечатныхФорм, "<ИмяМакета>")` в начале ветки каждого макета; - Передавай сформированный табличный документ через `УправлениеПечатью.ВывестиТабличныйДокументВКоллекцию(КоллекцияПечатныхФорм, "<ИмяМакета>", "<Синоним>", ТабДок, , "<ПолноеИмяМакета>")`; - Заполняй соответствие области каждого документа через `УправлениеПечатью.ЗадатьОбластьПечатиДокумента(ТабДок, НомерНачальнойСтроки, ОбъектыПечати, СсылкаНаДокумент)` — без этого сломаются постраничная разбивка пакета, сохранение присоединённых PDF и отправка по ЭДО/почте! ## Пакетная выборка данных: ни одного запроса в цикле по `МассивОбъектов` Процедура `Печать` обязана одинаково быстро печатать и **один документ** из карточки, и **пачку из 200 документов** из формы списка: - Выполни **один пакетный запрос** с условием `ГДЕ Док.Ссылка В (&МассивОбъектов)` (поместив шапки во временную таблицу и отдельным пакетом выбрав строки табличной части, упорядоченные по `Ссылка, НомерСтроки`); - При выводе пачки вставляй горизонтальный разделитель страниц `ТабДок.ВывестиГоризонтальныйРазделительСтраниц()` между документами; - Сумму прописью, склонения, представление валюты, ФИО подписантов и телефон/адрес организации получай пакетно или из подготовленного кэша по организациям пачки, не вызывая БСП-функции чтения базы на каждой строке товара. ## Внешние печатные формы и проверка результата - При поставке печатной формы как внешней обработки (`.epf`) добавь в модуль объекта `СведенияОВнешнейОбработке()` с `Вид = УправлениеПечатью.ТипКомандыПечати()` / `"ПечатнаяФорма"`, перечисли целевые метаданные в `Назначение` и соблюдай контракт `Печать(...)` с тем же набором параметров (см. навык `onec-external-processors-and-delivery`). - Для приёмки сформируй печатную форму на контрольном документе в клиенте тестирования (тонком или веб-клиенте) и сверь видимые строки или `.mxl`-эталон через `onec-vanessa-scenario`: простого отсутствия синтаксических ошибок в модуле менеджера недостаточно.