Редактор макетов

Главная форма редактирования записи справочника pw_Макеты — конструктор печатных форм PrintWizard. Здесь пользователь создаёт и настраивает всё, что нужно для формирования печатной формы: визуальный макет, источники данных, правила заполнения параметров, обработчики событий и пользовательские функции. Поддерживаются два формата: табличный документ (.mxl) и офисный документ (.docx).

Форма

Имя формы в метаданных конфигурации: Справочник.pw_Макеты.Форма.ФормаЭлемента

Назначение

Форма решает полный цикл разработки печатной формы: от создания визуального макета до блокировки, после которой кнопка «Печать» целевого объекта метаданных становится доступна пользователям.

Исполнитель — внутренняя обработка PrintWizard, отвечающая за фактическое формирование печатной формы по подготовленному в редакторе макету (внутреннее имя — pw_Исполнитель). Далее в документе используется короткое имя «Исполнитель».

На форме физически семь страниц первого уровня:

Описание — шапка макета, настройки формата, объекты метаданных.
Макет — визуальный редактор шаблона и таблица областей.
Запросы — запросы к данным информационной базы.
Наборы — наборы данных, формируемые на основе запросов или алгоритмов.
Соединения — связи между наборами для построения «доступных полей».
События — обработчики жизненного цикла формирования.
Функции — пользовательские функции многократного использования.

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

Несколько ключевых сущностей в этом документе вынесены отдельными разделами для удобства поиска, хотя физически они находятся внутри других страниц: «Объекты метаданных» (на странице «Описание»), «Области макета» (на странице «Макет»). Также отдельным разделом описаны «Доступные поля» — концепция, общая для нескольких вкладок.

Точки входа

Форма открывается из формы списка справочника pw_Макеты:

кнопка «Создать» — новый элемент;
двойной клик по строке или кнопка «Изменить» — открыть существующий макет.

На форме списка и форме элемента доступны дополнительные команды:

Экспорт в файл — сохранить макет в формате .pdwx (собственный формат PrintWizard) или .xml;
Загрузить из файла (форма списка) — создать новый макет из файла .pdwx или .xml;
Выгрузить как внешнюю обработку — сформировать автономный файл .epf;
Выгрузить как расширение — сформировать файл расширения конфигурации .cfe.

Состояния и жизненный цикл

Состояния макета

Состояние	Признак	Что значит
Редактируемый	`Заблокирована = false`	Разработка; кнопка печати в интерфейсе объекта недоступна
Заблокированный (production)	`Заблокирована = true`	Кнопка «Печать» добавлена в интерфейс целевых объектов метаданных; редактирование формы заблокировано
Образ для разработки	`ЭтоОбразДляРазработки = true`	Копия заблокированного макета; имеет подменю «Разработка» для передачи изменений в основной макет; показывает предупреждающий баннер

Жизненный цикл (основной сценарий)

Разработка в разблокированном макете.
Тестирование и отладка.
Заблокировать → комплексная проверка → кнопка печати активируется (при условии включённого признака «Команда печати» хотя бы для одного объекта метаданных, см. ниже).
При необходимости доработок: создать образ для разработки → внести изменения → передать в основной макет.

Условия появления кнопки печати у объекта

Чтобы кнопка «Печать» появилась в интерфейсе целевого объекта метаданных, должны выполниться оба условия:

Макет заблокирован (Заблокирована = Истина).
На странице «Описание» в таблице «Объекты метаданных» у нужного объекта включён признак «Команда печати» (пиктограмма принтера в шапке колонки).

Если макет заблокирован, но признак «Команда печати» снят — кнопка не появится. Если признак включён, но макет не заблокирован — кнопка тоже не появится.

Формат макета

Формат (табличный или офисный) задаётся пользователем на странице «Описание» в любой момент. При переключении области и параметры обновляются из нового шаблона; если имена совпадают с предыдущими — настройки заполнения параметров сохраняются.

Лучше определять формат сразу в начале работы. У офисного формата есть ограничения по сравнению с табличным:

доступны не все настройки областей;
доступны не все типы доступных полей.

Поэтому если изначально создавать макет под .docx, можно избежать переделки настроек, которые позже окажутся неподдерживаемыми.

Режим отладки

Независимый от состояния макета переключатель. При включённом режиме Исполнитель собирает подробный журнал каждого этапа формирования; после запуска «Тестирования» журнал отображается на вкладке «Журнал событий». Режим может замедлять печать.

Описание

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

Шапка

Поле	Назначение
Наименование	Заголовок, который видит пользователь и который попадает в имя кнопки печати, если для объекта метаданных не задано имя команды
Полное наименование	Используется в форме списка справочника `pw_Макеты` для классификации
ОКУД	Код общероссийского классификатора управленческой документации; справочное поле
Номер унифицированной формы	Справочное поле для классификации в компаниях с большим парком печатных форм
Утверждена документом / Утверждена дата	Реквизиты приказа, утвердившего форму; справочные поля

Поля «ОКУД», «Номер унифицированной формы», «Утверждена…» в формирование печатной формы не вмешиваются — это метаданные для классификации.

Настройки макета

Настройка (синоним)	Внутреннее имя	Назначение
Макет в формате Open Office Documents (*.docx)	`ЭтоOfficeOpenXML`	Переключатель табличный документ ↔ офисный документ. Меняет вид страницы «Макет»: вместо встроенного редактора таблицы — просмотр загруженного `.docx`
Это реестр	`ЭтоРеестр`	Управляет режимом печати при множественном выделении ссылок

Семантика признака «Это реестр»:

Это реестр = Ложь — для каждой выделенной ссылки формируется отдельная печатная форма (например, приходная накладная: 5 выделенных документов → 5 печатных форм);
Это реестр = Истина — для всех выделенных ссылок формируется одна печатная форма со списком (например, журнал накладных: 5 выделенных → 1 печатная форма со всеми внутри).

Объекты метаданных

Таблица на странице «Описание». Целевые объекты, для которых предназначен макет (Справочники, Документы и т.п.). Для каждого объекта указывается имя команды печати, которая появится в его меню после блокировки макета.

Колонки

Колонка (синоним)	Внутреннее имя	Назначение
Объект метаданных	`ОбъектыМетаданных.ПолноеИмяОбъекта`	Например, `Документ.РеализацияТоваровУслуг`
Заголовок	`ОбъектыМетаданных.КомандаПредставление`	Имя кнопки в меню «Печать». Если оставить пустым — сформируется автоматически из «Наименование» макета. Можно переопределить вручную
Печать (пиктограмма принтера в шапке колонки)	`ОбъектыМетаданных.КомандаПечати`	Включает фактическое создание команды печати для этого объекта. Без включённого признака кнопка «Печать» в интерфейсе объекта не появится, даже если макет заблокирован

Команды таблицы объектов

Команда	Действие
Заполнить запросы по метаданным	Перезаполняет запросы на основе указанных объектов метаданных
Обновить наличие полей БСП	Проверяет наличие подсистем БСП «Доп. реквизиты и сведения» и «Контактная информация» в конфигурации; включает/выключает соответствующие колонки в форме списка полей наборов
Навигатор по объекту	Открывает просмотр метаданных через расширение Infostart Toolkit (если оно подключено в конфигурации)
Открыть представления ЗУП	Специальный конструктор запросов «Представлений» из конфигурации 1С:ЗУП

Несколько объектов в одном макете

Поддерживается, но не рекомендуется в текущей версии: команда печати добавляется к каждому объекту, запросы строятся через ОБЪЕДИНИТЬ (отдельно для шапки и для каждой табличной части). Механизм будет переработан — останется один основной объект, остальные через другой механизм.

Макет

Вторая страница формы. Содержит визуальный редактор шаблона и таблицу областей.

Внешний вид страницы зависит от настройки формата на странице «Описание»:

Табличный документ (.mxl) — встроенный редактор табличного документа.
Офисный документ (.docx) — просмотр загруженного файла Word.

Переключение между двумя видами происходит автоматически при изменении настройки формата.

Редактор табличного документа (.mxl)

Встроенный редактор с поддержкой форматирования (шрифт, выравнивание, границы, цвет, объединение ячеек). Области задаются стандартными средствами 1С (именованные области в табличном документе).

Перенос из Excel. Отдельной кнопки загрузки из Excel нет. Перенос делается через буфер обмена: выделить область в Excel → копировать → вставить в табличный документ редактора. Форматирование при этом сохраняется. Области и параметры размечаются вручную.

Команды загрузки макета

Команда	Что загружает
Загрузить из файла	Из файла .mxl на диске
Загрузить из метаданных	Из любого макета любого объекта метаданных конфигурации
Загрузить из общего макета	Из состава общих макетов конфигурации
Загрузить из макета объекта	Из макетов объекта метаданных, указанного на странице «Описание»

Заполнение ячейки

Стандартные три варианта типа ячейки табличного документа:

Текст — статичный, не меняется при печати.
Параметр — параметр макета; при печати заменяется на данные.
Шаблон — комбинация: "Текст [ИмяПараметра] ещё текст".

Команды панели заполнения: Заполнение → Текст / Параметр / Шаблон.

Вставка картинок

Команда	Назначение
Вставить картинку из файла	Статичная картинка из файла
Вставить картинку пустую	Пустая картинка с именем параметра; данные задаются через параметры области
Вставить картинку QR-кода	Картинка под QR-код; содержимое настраивается в параметрах области
Вставить картинку с печатью	Картинка для печати организации; заполняется из реальных данных через параметры области
Вставить картинку с подписью	Картинка для подписи (руководителя, бухгалтера); аналогично «Печати»

Редактор офисного документа (.docx)

Загрузка из файла, подготовленного в Word или совместимом редакторе по правилам разметки PrintWizard. Области и параметры определяются автоматически при загрузке.

Правила разметки .docx

Специальные теги в тексте документа:

Тег	Назначение
`{v8 Область.ИмяОбласти}`	Начало области
`{/v8 Область.ИмяОбласти}`	Конец области
`{v8 ИмяПараметра}`	Параметр внутри области

Согласие на передачу данных документа

При просмотре макета .docx данные макета передаются в S3-хранилище для серверной обработки. Перед первой передачей запрашивается согласие пользователя. Подробнее — общая форма pw_СогласиеНаОбработкуДанных.

Области макета

Таблица на странице «Макет» (под редактором шаблона). Перечень областей шаблона с правилами заполнения параметров для каждой области.

Колонки строки области

Колонка (синоним)	Внутреннее имя	Назначение
Имя области	`ОбластиМакета.ИмяОбласти`	Имя именованной области в шаблоне (.mxl/.docx)
Способ вывода	`ОбластиМакета.СпособВывода`	Как выводится область при формировании; см. ниже
Набор	`ОбластиМакета.КлючСтрокиНабора`	Имя набора, по строкам которого повторяется область (для способа вывода «По строкам коллекции»)
Есть правила вывода (значок-фильтр в шапке колонки)	`ОбластиМакета.ЕстьПравилаВывода`	Пиктограмма видна, когда у области заданы правила условного вывода. По клику открывается редактор правил вывода области (форма `pw_Редакторы.Форма.ПравилаВыводаОбласти`); см. «Правила вывода области»

Способ вывода

Все значения — в общем модуле pw_Перечисления.СпособВыводаОбласти(). Колонка «Внутреннее имя» — то, что хранится в данных и используется в коде; колонка «Синоним» — то, что видит пользователь в выпадающем списке.

Синоним (что видит пользователь)	Внутреннее имя	Семантика
Без повторений	`БезПовторений`	Область выводится один раз
По строкам коллекции	`ПоСтрокамКоллекции`	Область повторяется для каждой строки набора, указанного в колонке «Набор». Набор должен иметь вид «Многострочная коллекция»
Перенос строки	`ПереносСтроки`	Область служебная для механизма переноса (см. «Настройки переноса»)
Верхний колонтитул	`ВерхнийКолонтитул`	Выводится в верхнем колонтитуле каждой страницы
Нижний колонтитул	`НижнийКолонтитул`	Выводится в нижнем колонтитуле каждой страницы
Не выводить на печать [без вывода]	`НеВыводитьНаПечать`	Область отключена; используется для черновиков и временно выключенных блоков
Область колонки [без вывода]	`ОбластьКолонки`	Используется для многоколоночного вывода
Контрольная строка [служ: перенос строки]	`КонтрольнаяСтрока`	Служебная область для контроля переноса (см. «Настройки переноса»)
Строка переноса [служ: перенос строки]	`СтрокаПереноса`	Аналогично — для механизма переноса
Пустая область [служ: перенос строки]	`ПустаяОбласть`	Заглушка для выравнивания вывода

Пометки [без вывода] и [служ: перенос строки] отображаются в самом названии значения списка — так задано в pw_Перечисления для подсказки пользователю.

Параметры области

Правая таблица для каждой строки области — список параметров и правила их заполнения. Колонки:

Колонка (синоним)	Внутреннее имя	Назначение
Имя	`ОбластиМакетаПараметры.ИмяПараметра`	Имя параметра шаблона (для .mxl — имя параметра ячейки; для .docx — имя из тега `{v8 ИмяПараметра}`)
Тип	`ОбластиМакетаПараметры.ТипПараметра`	Источник данных; см. «Доступные поля» и таблицу ниже
Значение	`ОбластиМакетаПараметры.ЗначениеТекст`	Значение в формате, зависящем от типа параметра

Типы параметра — из pw_Перечисления.ТипПараметраМакета():

Тип (синоним)	Внутреннее имя	Значение/настройка
Значение набора	`ЗначениеНабора`	Указание на поле набора через путь (см. «Доступные поля»)
Конструктор строки	`КонструкторСтроки`	Шаблон вида `[Префикс][ПолеНабора][Окончание]`. Несколько фрагментов; настройка — в форме редактора из обработки `pw_Редакторы`
Алгоритм	`ПроизвольныйАлгоритм`	BSL-алгоритм, возвращающий значение параметра
Данные QR-кода	`ДанныеQRКода`	Для параметров под QR-картинку. Тип кода (УФЭБС / XML / JSON / Алгоритм) задаётся в форме настройки QR из обработки `pw_Редакторы`
Сумма прописью	`СуммаПрописью`	Преобразование числа в строку. Настройки (валюта, язык, дробная часть) — в форме редактора из обработки `pw_Редакторы`

Правила вывода области

Декларативная альтернатива событию «ПередВыводомОбласти» для условного вывода. Позволяют задать условия пропуска области без программирования на BSL.

Логика: область выводится, если все заданные правила истинны (логическое И). Если хотя бы одно правило ложно — область пропускается. Если правил нет — область выводится всегда (поведение по умолчанию).

Структура правила:

Колонка (синоним)	Внутреннее имя	Назначение
Использование	`ОбластиПравилаВывода.Использование`	Флаг — учитывать правило или нет (отключённое правило игнорируется при проверке)
Левое значение	`ОбластиПравилаВывода.ЛевоеЗначение`	Поле из «Доступных полей» (выбирается через дерево). См. «Доступные поля»
Вид сравнения	`ОбластиПравилаВывода.ВидСравнения`	Оператор сравнения; список доступных операторов фильтруется по типу данных левого значения
Правое значение	`ОбластиПравилаВывода.ПравоеЗначение`	Сравниваемое значение или другое поле из «Доступных полей»

Хранение: табличная часть ОбластиПравилаВывода справочника pw_Макеты; флаг наличия правил в колонке ОбластиМакета.ЕстьПравилаВывода обновляется автоматически.

Открытие редактора: в таблице «Области макета» клик по колонке «Есть правила вывода» (значок-фильтр) у нужной области. Открывается форма редактора правил pw_Редакторы.Форма.ПравилаВыводаОбласти — там доступно дерево «Доступных полей» для левого/правого значения, список «Видов сравнения» по типу данных, добавление/удаление строк правил.

Когда использовать правила, а когда событие. Правила удобнее для типовых условий: сравнение поля набора с константой, проверка непустоты, диапазоны значений, наличие признака. Событие — для сложной логики (несколько условий с разной комбинацией ИЛИ/И, вычисления, обращения к внешним источникам). Правила и событие «ПередВыводомОбласти» совместимы: если правила пропустили область, событие для неё не вызывается; если правила пропустили проверку — событие может всё равно пропустить область через Отказ = Истина.

Настройки переноса

Группа полей в строке области, отвечающих за поведение при разрыве страницы. Колонки видны на форме под основными полями строки:

Колонка (синоним)	Внутреннее имя	Назначение
Параметр	`ОбластиМакета.ИмяПараметраПереноса`	Имя параметра, через который пробрасывается значение при переносе
Контроль 1	`ОбластиМакета.ИмяКонтрольнойОбласти1`	Имя контрольной области для механизма переноса
Контроль 2	`ОбластиМакета.ИмяКонтрольнойОбласти2`	Вторая контрольная область
Область печати	`ОбластиМакета.ИмяДополнительнойОбласти`	Имя дополнительной области

Тема сложная и в этом документе подробно не раскрывается — используйте по согласованию с разработчиком PrintWizard.

Команды таблицы областей

Команда	Действие
Заполнить области макета	Перечитывает шаблон и обновляет состав областей (если автоматический разбор отработал некорректно)
Обновить параметры области макета	Обновляет состав параметров в текущей области
Заполнить параметры области макета по набору	Сопоставляет параметры области и поля выбранного набора по совпадающим именам, при совпадении проставляет соответствие

Запросы

Третья страница формы. Запросы к данным информационной базы, на основе которых строятся наборы. Запросы автоматически генерируются при добавлении объекта метаданных на странице «Описание»; могут быть отредактированы вручную.

Колонки строки запроса

Колонка (синоним)	Внутреннее имя	Назначение
Запрос	`ЗапросыДанных.ИмяЗапроса`	Имя запроса. Уникальное в пределах макета
Врем. таблица	`ЗапросыДанных.ИмяВременнойТаблицы`	Имя временной таблицы для типа результата «Временная таблица»
Это общий запрос	`ЗапросыДанных.ЭтоОбщийЗапрос`	См. ниже
Текст запроса	`ЗапросыДанных.ТекстЗапроса`	Текст BSL-запроса

Это общий запрос

При множественном выделении ссылок в форме списка обычные запросы получают параметр &МассивОбъектов и должны иметь:

отбор ГДЕ Ссылка В (&МассивОбъектов);
поле Ссылка в выборке.

В случаях, когда отбор по ссылкам нецелесообразен (например, остатки по всей номенклатуре независимо от выделенных документов), запрос помечается как «Общий» (ЭтоОбщийЗапрос = Истина). Тогда отбор по МассивОбъектов не применяется и проверка наличия поля Ссылка не выполняется.

Параметры запроса

Таблица параметров под текстом запроса. Тип параметра — из pw_Перечисления.ТипПараметра():

Тип (синоним)	Внутреннее имя	Когда использовать
Значение	`Значение`	По умолчанию — обычное значение указанного типа
Список	`Список`	Включается флагом «Это список» в строке параметра. Передаётся как `Массив` / `СписокЗначений` в запрос
Алгоритм	`Алгоритм`	Включается флагом «Это алгоритм». Значение параметра вычисляется BSL-алгоритмом перед выполнением запроса
Таблица	`Таблица`	Зарезервирован, в текущей версии не используется

Алгоритм-параметр выполняется на сервере перед запросом. Контракт переменных описывается в отдельной задаче по подсказкам в полях алгоритмов.

Команды панели запросов

Команда	Действие
Открыть конструктор запроса	Стандартный конструктор платформы 1С или конструктор из расширения Infostart Toolkit (если подключено)
Открыть консоль запросов	Встроенная в PrintWizard консоль запросов (для тестового исполнения)
Проверить запрос	Отправляет текст запроса на проверку встроенному в PrintWizard ассистенту. Ассистент анализирует запрос и возвращает свои замечания
Заполнить запросы по метаданным	Перегенерирует запросы по объектам метаданных, заданным на странице «Описание»
Обновить поля запросов данных	Извлекает список колонок из результата запроса для дальнейшего сопоставления с полями наборов
Обновить параметры запроса	Перечитывает текст запроса и обновляет таблицу параметров

Ошибки и рекомендации запроса

Под текстом запроса — две области с результатами автоматического анализа запроса:

Ошибки запроса — некорректные конструкции, не позволяющие исполнить запрос.
Рекомендации запроса — замечания об оптимизации и стиле, не блокирующие исполнение.

Анализ выполняется автоматически при редактировании текста запроса.

Наборы

Четвёртая страница формы. Наборы данных — таблицы значений для вывода областей. Один набор соответствует одному источнику. Один источник (запрос) может питать несколько наборов.

Колонки строки набора

Колонка (синоним)	Внутреннее имя	Назначение
Источник данных	`НаборыДанных.ИмяЗапроса`	Имя набора — уникальное в пределах макета. Колонка названа «Источник данных», поскольку часто совпадает с именем запроса-источника
Источник	`НаборыДанных.КлючСтрокиЗапроса`	Ссылка на запрос (для типа источника «Запрос»). Один набор = одна строка результата запроса
Алгоритм	`НаборыДанных.АлгоритмОбработкиВТ`	BSL-код, формирующий или дообрабатывающий данные набора
Вид набора	`НаборыДанных.ВидНабора`	Как Исполнитель интерпретирует данные набора (см. ниже)

Тип источника набора

Из pw_Перечисления.ТипИсточникаНабора():

Тип (синоним)	Внутреннее имя	Семантика
Запрос	`Запрос`	Данные берутся из именованного запроса через колонку «Источник»
Алгоритм	`Алгоритм`	Данные формирует BSL-алгоритм (колонка «Алгоритм»); результат — таблица значений
Объект	`Объект`	Зарезервирован: указание объекта метаданных напрямую (`Справочник.Имя`, `Документ.Имя.ИмяТабличнойЧасти`, регистры). В текущей версии не используется

Вид набора

Из pw_Перечисления.ВидНабора():

Вид (синоним)	Внутреннее имя	Семантика
Первая строка	`ПерваяСтрока`	Берётся одна (первая) строка результата — типично для шапки
Последняя строка	`ПоследняяСтрока`	Аналогично — последняя строка
Соединение строк	`СоединениеСтрок`	Все строки склеиваются в одно значение через разделитель
Многострочная коллекция	`МногострочнаяКоллекция`	Все строки набора доступны построчно — для способа вывода области «По строкам коллекции»

Вид набора влияет на видимость полей в других областях — см. «Доступные поля».

Поля набора

Таблица в правой части страницы. Колонка «Тип данных» (НаборыДанныхПоля.ТипДанных) показывает тип поля. Поля либо берутся из запроса/алгоритма автоматически, либо добавляются пользователем как «дополнительные». Все типы — из pw_Перечисления.ТипПоля():

Тип (синоним в выпадающем списке)	Внутреннее имя	Содержимое
Поле источника	`ПолеИсточника`	Поле из результата запроса или из таблицы значений алгоритма источника
Поле алгоритма	`ПолеАлгоритма`	Значение вычисляется BSL-алгоритмом обработки набора
Поле свойства	`ПолеСвойства`	Дополнительный реквизит / свойство из подсистемы БСП «Доп. реквизиты и сведения» — произвольные реквизиты, задаваемые в режиме «Предприятие» без вмешательства в конфигурацию
Поле конт. инф.	`ПолеКонтИнф`	Адрес / телефон / e-mail и т.п. из подсистемы БСП «Контактная информация»
Поле представления	`ПолеПредставления`	Конструктор строки по шаблону `[Префикс][ПолеНабора][Окончание]` — несколько фрагментов; форма редактирования — в обработке `pw_Редакторы`
Поле нумератора	`ПолеНумератора`	Автоматическая нумерация по правилам. Пример: 10 строк, 5 уникальных номенклатур → нумератор по полю `Номенклатура` даст номера 1..5 (вместо обычных 1..10)
Вычисляемое поле	`ВычисляемоеПоле`	Результат вычисления BSL-выражения от других полей того же набора
Поле QR-кода	`ПолеQRКода`	В полях набора создать нельзя. «Обёртка» для типа параметра области «Данные QR-кода»

Команды добавления полей

Команда	Тип поля
Добавить поле набора данных нумератор	Нумератор
Добавить поле набора данных вычисляемое	Вычисляемое
Добавить поле набора данных алгоритм	Алгоритм
Добавить поле набора данных конструктор	Представление
Добавить поле набора данных контактная информация	Контактная информация
Добавить поля набора данных доп. сведения	Свойство

Прочие команды панели

Команда	Действие
Обновить наборы данных по запросам	Пересоздаёт наборы из текущего списка запросов
Обновить поля набора данных из запроса	Перечитывает поля выбранного набора из результата привязанного запроса
Обновить поля набора данных из набора	Перечитывает поля из соединённого набора
Обновить поля набора из алгоритма	Извлекает поля из таблицы значений, формируемой алгоритмом источника
Обновить использование полей набора	Контроль сквозной связи: поле запроса → параметр области (через алгоритмы и соединения)
Вывести связи поля набора данных	Сообщение пользователю «Поле X используется в: …» с перечислением мест использования. Реализация — `pw_СхемаСвязьДанных`
Синтаксический контроль набора	Проверяет алгоритм набора (см. ниже)

Синтаксический контроль (общее правило)

Применяется ко всем полям с алгоритмами на языке 1С: разбор алгоритма в синтаксическое дерево, поиск ошибок (неинициализированные переменные, недопустимые конструкции). Аналогичные команды есть для событий («Синтаксический контроль события») и функций («Синтаксический контроль функции»).

Соединения

Пятая страница формы. Дерево связей между наборами. Цель — расширить «Доступные поля» наборов: добавить в левый набор поля правого набора через имя соединения.

Важно: соединения не добавляют колонки в сам набор (внутри pw_Исполнителя каждый набор — таблица значений). Соединения добавляются в дерево «Доступных полей» левого набора в виде вложенного «соединённого» набора с именем ИмяСоединения. См. «Доступные поля».

Структура строки дерева

Колонка (синоним)	Внутреннее имя	Назначение
Левая сторона (набор / поле)	`ДеревоСоединений.ИмяЛево`	Набор (или поле — в зависимости от уровня дерева) слева
Правая сторона (набор / поле)	`ДеревоСоединений.ИмяПраво`	Набор (или поле) справа
Соединение	`ДеревоСоединений.ИмяСоединения`	Имя вложенного «доступного» набора. Используется в пути доступа: `НаборыДанных.ИмяЛевогоНабора.ИмяСоединения.ИмяПоляПравогоНабора`
№ *	`ДеревоСоединений.НомерСтроки`	Номер строки в дереве (служебный)

Команды добавления

Команда	Что добавляет
Добавить соединение → Связь наборов	Соединение целиком — аналог соединения таблиц в SQL-запросе
Добавить соединение → Связь полей	Условие соединения — пара полей внутри уже существующей связи наборов

Порядок строк в дереве

Можно менять стандартными командами MoveUp / MoveDown. На исполнение не влияет.

Типы наборов в соединении

Тип источника наборов (запрос / алгоритм) и вид набора (первая строка / многострочная коллекция / …) — не ограничивают возможность соединения. Внутри pw_Исполнителя любой набор — таблица значений.

Свободно стоящие наборы

Набор не обязан быть упомянут в дереве соединений. По умолчанию все наборы — свободные.

Доступные поля

Концепция, общая для нескольких вкладок: какие поля видны в дереве выбора при настройке параметров области, ключей нумератора, выражений вычисляемых полей и т.п.

Полный путь поля

Возможные формы пути:

Путь	Семантика
`НаборыДанных.ИмяНабора.ИмяПоля`	Обычное поле набора
`НаборыДанных.ИмяНабора.Итог.ИмяПоля.АгрегатнаяФункция`	Итог по полю набора. См. таблицу агрегатных функций ниже
`НаборыДанных.ИмяНабора.Строка.ИмяПоля`	Данные конкретной строки при выводе области, связанной с многострочной коллекцией
`НаборыДанных.ИмяНабораЛево.ИмяСоединения.ИмяПоляПраво`	Поле через соединение
`НаборыДанных.СистемныеПоля.ИмяПоля`	Предопределённые системные данные

Дополнительно для каждого поля хранится JSON-расшифровка с информацией о поле (тип, представление и т.п.).

Агрегатные функции

Для итогов по полям наборов. Имена и синонимы — из pw_Перечисления.АгрегатнаяФункция():

Синоним (что видит пользователь)	Внутреннее имя
Сумма	`Сумма`
Количество	`Количество`
Количество различных	`КоличествоРазличных`
Максимум	`Максимум`
Минимум	`Минимум`
Среднее	`Среднее`
Итог накопительный	`ИтогНакопительный`
Итог по странице	`ИтогПоСтранице`
Процент к итогу	`ПроцентКИтогу`

Правила видимости полей по виду набора

Свободно стоящие наборы (не упомянутые в соединениях):

Вид набора	Что видно из других областей
Первая строка / Последняя строка / Соединение строк	Поля видны для всех областей
Многострочная коллекция — поля итогов (агрегатов)	Видны для всех областей
Многострочная коллекция — поля построчного вывода	Видны только в области, связанной с этим набором через колонку «Набор» (`КлючСтрокиНабора`)

Правила видимости полей через соединения

В соединениях построчный вывод не предусмотрен. Поэтому:

Вид правого набора	Что доступно через соединение
Первая строка / Последняя строка / Соединение строк	Все поля правого набора
Многострочная коллекция	Только поля итогов (агрегатов)

Связь колонки «Набор» области и дерева соединений

Никак не связаны. Видимость полей определяется правилами выше, а не наличием/отсутствием набора в дереве соединений.

События

Шестая страница формы. Обработчики жизненного цикла формирования печатной формы. Список событий — фиксированный, определяется в pw_КонструкторКлиентСервер.СобытияКонструктора(). Полный перечень с параметрами и типичным использованием — в разделе «События жизненного цикла».

Состав страницы событий

Слева — список событий.
Справа — текст алгоритма выбранного события.
Под алгоритмом — подсказка (доступные переменные).

Команды панели событий

Команда	Действие
Заполнить события	Проверяет наличие всех 8 событий; если каких-то нет — создаёт пустые «болванки»
Синтаксический контроль события	Разбирает алгоритм события в синтаксическое дерево, ищет ошибки (см. «Синтаксический контроль» на вкладке «Наборы»)

Подсказки

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

Где писать код

Пользователь пишет код события самостоятельно. Готовых шаблонов нет.

Функции

Седьмая страница формы. Пользовательские функции многократного использования.

Состав страницы функций

Слева — список функций.
Справа — текст алгоритма функции.
Под текстом функции — таблица параметров.

Свойства функции

Свойство (синоним)	Внутреннее имя	Назначение
Имя	`Функции.ИмяФункции`	Имя функции — уникальное в пределах макета
Параметры	`ФункцииПараметры`	Таблица параметров функции (см. ниже)
Алгоритм	`Функции.Алгоритм`	Текст функции на языке 1С

Контекст исполнения — только серверный (текущая версия). Возврат необязателен — функция может ничего не возвращать (роль процедуры).

Параметры функции

Таблица параметров. Колонки:

Колонка (синоним)	Внутреннее имя	Обязательность
Имя	`ФункцииПараметры.ИмяПараметра`	Обязательно
Тип	`ФункцииПараметры.ОписаниеТипов`	Желательно — если указан, консоль кода даёт подсказки
Описание	`ФункцииПараметры.Описание`	Желательно

Где можно вызывать функции

Функция видна из любого алгоритма в макете:

из событий;
из параметров областей (тип параметра «Алгоритм», внутреннее имя ПроизвольныйАлгоритм);
из текстов запросов;
из алгоритмов полей наборов;
из алгоритмов параметров запроса.

Функции могут вызывать сами себя (рекурсия).

Как вызвать функцию из алгоритма

В алгоритмах макета доступен контекст ЭтотМакет. Функции вызываются через ЭтотМакет.ВыполнитьФункцию(...). Имя функции передаётся как ЭтотМакет.Функции.ИмяФункции.

Поддерживаются два способа передачи параметров.

Вариант 1. Позиционные параметры (по порядку, как в таблице параметров функции):

ВалютаРегУчета = ОбщегоНазначенияБПВызовСервераПовтИсп.ПолучитьВалютуРегламентированногоУчета();

Для Каждого СтрокаШапки Из ДанныеЗапроса Цикл
    ПараметрыДокумента = ЭтотМакет.ВыполнитьФункцию(ЭтотМакет.Функции.ПараметрыДокумента,
        СтрокаШапки,
        ВалютаРегУчета);

    // далее мы уже можем использовать ПараметрыДокумента по необходимости
КонецЦикла;

Вариант 2. Через структуру параметров (когда параметров много или порядок неудобен):

ПараметрыМетода = ЭтотМакет.ПараметрыФункции(ЭтотМакет.Функции.ПараметрыДокумента);
ПараметрыМетода.СтрокаШапки = СтрокаШапки;
ПараметрыМетода.ВалютаРегУчета = ВалютаРегУчета;

ЭтотМакет.ВыполнитьФункцию(ЭтотМакет.Функции.ПараметрыДокумента, ПараметрыМетода);

ЭтотМакет.ПараметрыФункции(...) возвращает структуру с полями по именам параметров функции. Поля заполняются и структура передаётся вторым аргументом в ВыполнитьФункцию — Исполнитель сам сопоставляет значения по именам.

Команды панели

Команда	Действие
Синтаксический контроль функции	Разбирает алгоритм функции в синтаксическое дерево, ищет ошибки

Журнал событий

Дополнительная страница, видна только при включённом режиме отладки. Содержит подробный трейс этапов формирования печатной формы, собранный pw_Исполнителем при последнем «Тестировании».

Содержимое и формат журнала меняются — детали в этом документе не описаны. Используйте журнал для диагностики после включения «Отладки» и запуска «Тестирования».

Командная панель формы

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

Команда	Действие
Заблокировать / Разблокировать	Блокирует или снимает блокировку макета. Перед блокировкой выполняется комплексная проверка
Тестирование	Запускает формирование печатной формы через Исполнитель; результат открывается в виде табличного документа
Тестирование → Повторить	Повторяет последний запуск тестирования с теми же параметрами
Режим отладки	Переключатель: при включении Исполнитель собирает подробный трейс; после «Тестирования» трейс виден на вкладке «Журнал событий». Может замедлять печать
Управление параметрами печати (иконка ключа)	Открывает форму редактирования параметров печати макета (`pw_НастройкиПечати`): ориентация, размер страницы, поля, поля колонтитула, двусторонняя печать, чередование, точность. Привязка через `КлючПараметровПечати`. Если ключ ещё формируется автоматически и настроек нет — диалог предлагает задать собственное значение ключа. Изменения отложенные — копятся в реквизите формы и применяются при записи макета; пока есть несохранённые правки, в заголовке кнопки виден маркер «*»
Обработка / Экспорт	Подменю экспорта: в `.pdwx`, `.xml`, выгрузка как внешняя обработка `.epf`, выгрузка как расширение `.cfe`
Разработка → Записать изменения макета разработки	Только в образе для разработки. Передаёт текущие изменения в основной (заблокированный) макет
Разработка → Закрыть образ для разработки	Только в образе для разработки. Передаёт финальные изменения в основной макет и удаляет образ

Сценарии

Создание нового макета (рекомендуемый порядок)

В форме списка нажать «Создать».
На странице «Описание» ввести наименование.
Выбрать формат макета: табличный документ или офисный документ.
На странице «Описание» в таблице «Объекты метаданных» добавить целевой объект (Справочник или Документ). Запросы и наборы по реквизитам объекта и его табличным частям сформируются автоматически.
Перейти на страницу «Макет» и создать шаблон:
- для .mxl: нарисовать вручную, вставить из Excel или загрузить из вариантов конфигурации;
- для .docx: подготовить файл в Word по правилам PrintWizard, загрузить кнопкой «Обновить из файла».
После сохранения/загрузки шаблона области и параметры определятся автоматически. В таблице «Области макета» последовательно настроить правила заполнения параметров каждой области.
Если нужны данные, которых нет в автосгенерированных запросах: отредактировать запросы на странице «Запросы», добавить дополнительные поля в наборы на странице «Наборы».
Задать порядок вывода областей: какие повторяются в шапке/подвале при переносе страницы.
При необходимости добавить обработчики событий на странице «События».
Нажать «Тестирование» и проверить результат. При обнаружении проблем включить «Режим отладки» и изучить журнал событий.
Нажать «Заблокировать» → пройти проверку → кнопка печати появится в интерфейсе целевого объекта.

Доработка заблокированного макета через образ для разработки

В форме элемента заблокированного макета создать образ для разработки.
Открывается копия макета с признаком ЭтоОбразДляРазработки = true; отображается предупреждающий баннер.
Внести изменения (форма ведёт себя как обычный разблокированный макет).
Для поэтапной передачи: «Разработка → Записать изменения макета разработки» — изменения скопируются в основной макет.
По завершении: «Разработка → Закрыть образ для разработки» — передаёт финальные изменения и удаляет образ.

Переключение формата макета

На странице «Описание» изменить настройку формата.
На странице «Макет» загрузить или создать шаблон в новом формате.
Области и параметры перезаполнятся из нового шаблона. Если имена параметров и областей совпадают — настройки заполнения сохранятся.

Добавление дополнительного поля в набор

Перейти на страницу «Наборы», выбрать нужный набор.
В правой таблице полей вызвать команду добавления нужного типа: «Нумератор», «Вычисляемое», «Алгоритм», «Конструктор», «Контактная информация», «Доп. сведения».
Заполнить настройки поля: имя, источник, алгоритм или шаблон.
Перейти на страницу «Макет» → таблица «Области макета» → выбрать область → в строке параметра указать «Тип параметра» = «Значение набора» → выбрать новое поле из дерева доступных полей.

Привязка области к строкам коллекции

На странице «Наборы» убедиться, что нужный набор имеет «Вид набора» = «Многострочная коллекция».
Перейти на страницу «Макет» → таблица «Области макета» → выбрать строку нужной области.
Установить «Способ вывода» = «По строкам коллекции».
В колонке «Набор» выбрать имя набора.
В параметрах области указать поля набора через путь НаборыДанных.ИмяНабора.Строка.ИмяПоля.

Связь с объектной моделью

Форма читает и записывает следующие табличные части справочника pw_Макеты:

Табличная часть	Данные
ОбъектыМетаданных	Целевые объекты и команды печати
ЗапросыДанных	Тексты запросов и их параметры
НаборыДанных, НаборыДанныхПоля	Наборы и их поля (включая дополнительные типы)
НаборыДанныхСоединения	Дерево связей между наборами
ОбластиМакета, ОбластиМакетаПараметры	Области шаблона и правила заполнения параметров
ОбластиПравилаВывода	Декларативные условия вывода областей (см. «Правила вывода области»)
События	Алгоритмы обработчиков событий
Функции, ФункцииПараметры	Пользовательские функции

Внешние зависимости:

pw_ФормаКонструктора — общий модуль (40+ методов): синхронизация данных формы, валидация, автогенерация запросов и наборов по объекту метаданных, обновление доступных полей.
pw_Исполнитель — вызывается при «Тестировании» и «Отладке» для фактического формирования печатной формы.
pw_СхемаДоступныеПоля — предоставляет дерево доступных полей при выборе источника параметра.
pw_СхемаСвязьДанных — обеспечивает «Вывести связи поля набора данных».
pw_КонструкторКлиентСервер — хранит фиксированный список 8 событий жизненного цикла формирования.
pw_Перечисления — единый источник истины для всех типов и видов (СпособВыводаОбласти, ТипПоля, ТипПараметра, ВидНабора, ТипИсточникаНабора, ТипПараметраМакета, АгрегатнаяФункция, ТипАлгоритма и др.).
pw_Редакторы — обработка с формами редактирования: конструктор строки, настройка QR-кода, настройка «Сумма прописью», редактор правил вывода области (ПравилаВыводаОбласти).
pw_НастройкиПечати — обработка, открывается командой «Управление параметрами печати»; редактирует параметры печати макета (ориентация, размер страницы, поля, поля колонтитула, двусторонняя печать, чередование, точность). Хранение настроек — по КлючПараметровПечати макета.

События жизненного цикла

Список событий фиксированный, определяется в pw_КонструкторКлиентСервер.СобытияКонструктора().

Событие	Когда вызывается	Основные параметры	Типичное использование
ПередИнициализацией	До любой обработки, в самом начале	МассивОбъектов, ВнешниеПараметры, Отказ	Предварительная подготовка данных; отказ от печати
ПриПолученииДанных	После выполнения всех запросов, до «нарезки» сводных таблиц на наборы для каждого объекта (ссылки)	ДанныеМакета	Изменение или дополнение сводных таблиц данных перед тем, как они будут разделены на наборы по объектам
ПередФормированием	Перед началом вывода в документ	ТабличныйДокумент, НаборыДанных, Отказ	Настройки документа; отказ от дальнейшей обработки
ПередВыводомСтраницы	Перед выводом каждой страницы	ТабличныйДокумент, НаборыДанных	Вставка заголовка страницы
ПередВыводомОбласти	Перед выводом каждой области	ИмяОбласти, ОбластьМакета, Отказ	Пропуск области или изменение её данных. Декларативная альтернатива для простых условий пропуска — см. «Области макета» → «Правила вывода области»
ПослеВыводаОбласти	После вывода области	ИмяОбласти, НачалоОбласти, Отказ	Постобработка выведенной области
ПослеВыводаСтраницы	После вывода страницы	НачалоСтраницы	Вставка итогов страницы
ПослеФормирования	После завершения всего формирования	ТабличныйДокумент, НаборыДанных	Финальная обработка результирующего документа

Ошибки и ограничения

Блокировка не пройдена: при нажатии «Заблокировать» выполняется комплексная проверка; ошибки выводятся списком и должны быть устранены перед повторной попыткой.
Редактирование заблокированного макета: все поля формы неактивны. Для изменений необходимо создать образ для разработки.
Дублирование имён: области, наборы, запросы, функции должны иметь уникальные имена; ошибка выводится при сохранении.
Запрос без отбора по Ссылка: для не-общих запросов «Проверить запрос» сообщит об отсутствии ГДЕ Ссылка В (&МассивОбъектов) или поля Ссылка в выборке.
Ошибки в тексте запроса: диагностируются автоматически при редактировании текста (см. область «Ошибки запроса»); для глубокого разбора — команда «Проверить запрос» (отправка ассистенту PrintWizard) или «Открыть консоль запросов».
Образ для разработки: при открытии образа отображается предупреждающий баннер; непередача изменений в основной макет перед удалением образа приведёт к их потере (кнопка «Закрыть образ» передаёт автоматически).
Переключение формата: при смене .mxl ↔ .docx настройки параметров, имена которых не совпадают с новым шаблоном, будут сброшены.
Многообъектность макета: текущий механизм объединения запросов через ОБЪЕДИНИТЬ будет переработан. Старайтесь использовать один основной объект на макет.
Тип источника «Объект» у набора: зарезервирован, не используется в текущей версии.
Тип параметра запроса «Таблица»: зарезервирован, не используется в текущей версии.
QR-код в полях набора: создать нельзя; QR-код реализуется через тип параметра области «Данные QR-кода».

FAQ

Q: Как кнопка печати появляется в меню «Печать» объекта? A: Нужно заблокировать макет (кнопка «Заблокировать»). Для этого должен быть указан хотя бы один объект метаданных. До блокировки макет недоступен для конечных пользователей.

Q: Как редактировать уже заблокированный макет? A: Создать образ для разработки. Изменения вносятся в образ; после завершения передаются в основной макет через «Разработка → Записать изменения макета разработки» или «Разработка → Закрыть образ для разработки».

Q: Откуда берётся список параметров в таблице областей? A: Автоматически из табличного документа (.mxl) при его редактировании, или из офисного документа (.docx) при загрузке. Первичен шаблон: области и параметры синхронизируются с его содержимым. Если автоматический разбор отработал некорректно — есть команды «Заполнить области макета» и «Обновить параметры области макета».

Q: Как указать, что параметр заполняется из поля запроса? A: На странице «Макет» → таблица «Области макета» → выбрать нужную область → в строке параметра задать «Тип параметра» = «Значение набора» → выбрать поле из дерева доступных полей. Дерево формируется по правилам, описанным в разделе «Доступные поля».

Q: Чем «Тестирование» отличается от «Режима отладки»? A: «Тестирование» — запуск формирования через Исполнитель. «Режим отладки» — переключатель: при включении Исполнитель собирает подробный трейс; после запуска тестирования трейс виден на вкладке «Журнал событий».

Q: Нужно ли указывать объект метаданных? A: Рекомендуется. При добавлении объекта запросы и наборы создаются автоматически. Без объекта метаданных блокировка невозможна, а значит — кнопка печати в интерфейсе не появится.

Q: Можно ли переключить макет с .mxl на .docx? A: Да, в любой момент. Области и параметры будут обновлены из нового шаблона. Если имена совпадают — настройки заполнения сохранятся, иначе — сбросятся.

Q: В чём разница между «Это реестр = Истина» и «Это реестр = Ложь»? A: При выделении нескольких ссылок в форме списка: Ложь — для каждой ссылки своя печатная форма; Истина — одна печатная форма со списком всех выделенных внутри (например, журнал накладных).

Q: Зачем нужен «Ключ макета»? A: Это внутренний идентификатор. Используется как КлючПараметровПечати табличного документа — пользовательские настройки печати (масштаб, поля, ориентация) и параметры печати макета из формы «Управление параметрами печати» сохраняются в привязке к этому ключу. Кнопок просмотра/обновления ключа в форме нет: значение видно и может быть переопределено через диалог при первом открытии «Управление параметрами печати», если ключ всё ещё формируется автоматически.

Q: Как настроить параметры печати макета (ориентация, поля, двусторонняя)? A: На главной командной панели формы — кнопка «Управление параметрами печати» (иконка ключа). Открывается форма pw_НастройкиПечати, в которой задаются ориентация, размер страницы, поля, поля колонтитула, двусторонняя печать, чередование, точность. Изменения копятся как отложенные и применяются при записи макета — пока есть несохранённые правки, в заголовке кнопки виден маркер «*».

Q: Чем правила вывода области отличаются от события «ПередВыводомОбласти»? A: Правила — декларативные условия (Левое значение / Вид сравнения / Правое значение), задаются в редакторе без написания кода. Событие — программный обработчик на BSL с произвольной логикой. Правила хороши для типовых сравнений (поле = значение, поле заполнено, поле в диапазоне), событие — для сложной логики с несколькими ветвями, вычислениями, обращениями к внешним источникам. Если правила пропустили область — событие для неё не вызывается.

Q: Какой запрос сделать «общим»? A: Тот, что не должен фильтроваться по Ссылка В (&МассивОбъектов) — например, остатки по всей номенклатуре, справочные данные. Для таких запросов установите флаг «Это общий запрос», и проверка наличия отбора по ссылкам не будет применяться.

Q: Как поле одного набора попадает в параметр области, использующей другой набор? A: Через дерево соединений. Соединение добавляет в «Доступные поля» левого набора вложенный «соединённый» набор с именем ИмяСоединения. В параметре области поле задаётся через путь НаборыДанных.ИмяЛевогоНабора.ИмяСоединения.ИмяПоляПравогоНабора. См. «Доступные поля».

Q: Может ли пользовательская функция вызывать саму себя? A: Да, рекурсия поддерживается. Также функции видны из любого алгоритма в макете — события, поля наборов, параметры областей, тексты запросов, параметры запросов.