Конструктор печатных форм

Подключение обработки

Стандартный способ — автоматически через расширение

Конструктор печатных форм поставляется в составе расширения WA: ЛК Сотрудника и добавляется в раздел Дополнительные отчёты и обработки автоматически при установке расширения.

Чтобы убедиться, что обработка установлена:

1. Перейдите в Администрирование → Печатные формы, отчёты и обработки → Дополнительные отчёты и обработки.
2. В списке должна присутствовать запись «Конструктор печатных форм».

Если запись есть — обработка готова к работе, переходите к разделу 2.

1. Перейдите в Администрирование → Печатные формы, отчёты и обработки → Дополнительные отчёты и обработки.

2. Если обработка отсутствует — нажмите Добавить из файла и выберите файл КонструкторПечатныхФормWA.epf.

3. Если обработка есть, но устарела — откройте её строку, нажмите Обновить из файла и выберите актуальный файл.

4. После загрузки проверьте, что в списке назначений присутствуют нужные объекты (например, Приём на работу, Кадровый перевод, Сотрудники).

   Ваши настройки (команды печати, шаблоны, представления) хранятся отдельно от файла обработки и не сбрасываются при обновлении.

Настройка видимости команд печати

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

Если обработка не появилась или требует обновления

1. Перейдите в раздел Администрирование → Печатные формы, отчёты и обработки.
2. Откройте ссылку Дополнительные отчёты и обработки.
3. Нажмите кнопку Добавить из файла и выберите файл обработки КонструкторПечатныхФормWA.epf.
4. После загрузки система автоматически определит размещение в объектах:
   • Документ Приём на работу
   • Документ Кадровый перевод
   • Справочник Сотрудники
5. Будут созданы предопределённые идентификаторы команд.

Настройка видимости команд печати

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

---

Открытие конструктора

Конструктор открывается как внешняя обработка.

Порядок открытия

1. Перейдите в Администрирование → Печатные формы, отчёты и обработки → Дополнительные отчёты и обработки.

2. Найдите строку «Конструктор печатных форм».

3. Нажмите правой кнопкой мыши → Сохранить как — сохраните файл .epf на компьютер.

4. В главном меню 1С выберите Файл → Открыть и откройте только что сохранённый файл.

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

Вкладки конструктора

Конструктор открывается как самостоятельная форма с тремя вкладками:

Вкладка	Назначение
Настройки макетов	Связь идентификаторов команд с файлами-шаблонами, настройка представлений и ТЧ
Параметры печатной формы	Просмотр всех доступных параметров для вставки в шаблон
Параметры регистрации	Объекты назначения, состав команд в меню «Печать»

Вкладка «Настройки макетов»

Основная вкладка для настройки шаблонов печатных форм.

Основные поля верхней таблицы

Поле	Описание
Тип объекта	Справочник или документ (выбирается для тестирования)
Объект настройки и проверки макета	Конкретный экземпляр документа/справочника для тестирования

Поля таблицы «Настройки макетов печати»

Колонка	Описание
Идентификатор команды печати	Уникальный ключ. Должен точно совпадать с идентификатором в таблице «Команды» во вкладке «Параметры регистрации».
Макет печати	Файл-шаблон (.mxl или .docx), хранящийся в справочнике «Файлы».
Формат вывода	MXL или DOC. Рекомендуется MXL.
Ориентация страницы	Портрет (по умолчанию) или Ландшафт.
Произвольный запрос основной таблицы	Флажок. При включении отображается поле для ввода текста запроса.

Группа «Отборы» (три последних колонки):

Колонка	Описание
Организация	Если заполнена — шаблон применяется только для этой организации. Пусто = для всех.
Подразделение	Шаблон для конкретного подразделения. Учитывается иерархия.
Должность	Шаблон для конкретной должности.

Приоритет выбора шаблона: если есть несколько строк для одного идентификатора, система выберет наиболее специфичную — приоритет: Должность (100) > Подразделение (10) > Общая (0). При этом учитывается иерархия подразделений.

После добавления строки нажмите Записать настройку.

---

Представления

Нижняя часть вкладки. Представления — это наборы данных из разных таблиц ЗУП, которые «присоединяются» к основному объекту.

Предустановленные представления:

Имя представления	Префикс	Описание
КадровыеДанныеСотрудников	сотр	ФИО, должность, подразделение, оклад и т.д.
КадровыеДанныеФизическихЛиц	фл	Паспортные данные, ИНН, СНИЛС и т.д.
СведенияОбОрганизации	орг	Реквизиты организации, КПП, ОГРН, ОКВЭД и т.д.
ДополнительныеРеквизиты	др	Дополнительные реквизиты объекта

Как добавить представление:

1. Нажмите Добавить в таблице представлений.
2. Выберите имя представления.
3. Отметьте флажками нужные поля.
4. На вкладке Условия соединения укажите, по каким полям соединять таблицу представления с основным объектом.

Типичные условия соединения:

Для документа «Приём на работу» с представлением КадровыеДанныеСотрудников:

Поле объекта	Поле таблицы
Сотрудник	Сотрудник
ДатаПриема	Период

Для справочника «Сотрудники» с представлением КадровыеДанныеСотрудников:

Поле объекта	Поле таблицы
Ссылка	Сотрудник
ТекущаяДата	Период

Произвольный запрос в представлении: отметьте флажок Произвольный запрос и введите текст запроса. В запросе обязательно должны быть поля Ссылка и те поля, что нужны в ПФ. В блоке ИЗ используйте временную таблицу втЗапросПоРеквизитамОбъекта.

Табличные части

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

Порядок настройки:

1. Перейдите на вкладку Табличные части.
2. Нажмите Заполнить табличные части из метаданных объекта — список ТЧ заполнится автоматически.
3. Отметьте флажком нужную ТЧ.
4. В поле Псевдоним (имя ТЧ на ПФ) укажите имя — оно используется при именовании областей макета (см. раздел 6.1).
5. Отметьте флажками нужные поля ТЧ.
6. При необходимости поставьте флажок Добавить параметры шапки — тогда в каждую строку ТЧ будут также включены поля шапки документа.
7. На вкладке Условия соединений ТЧ при необходимости добавьте дополнительные условия (по умолчанию соединение по ссылке добавляется автоматически).
8. На вкладке Отбор строк настройте фильтр, если нужно выводить не все строки ТЧ.

Произвольный запрос основной таблицы

Доступен только для формата MXL. Позволяет полностью переопределить основной запрос, например, для вывода отдельной ПФ на каждого сотрудника из ТЧ.

Обязательные поля запроса:

Поле	Назначение
КлючПечатнойФормы	Уникальный ключ экземпляра ПФ (по умолчанию = Ссылка)
Ссылка	Ссылка на объект
Фильтр ОбъектыНазначения	Обязателен в блоке ГДЕ

Пример (отдельная ПФ на каждого сотрудника из ТЧ графика отпусков):

ВЫБРАТЬ РАЗЛИЧНЫЕ
    ДанныеОбъекта.Ссылка.Организация КАК Организация,
    ДанныеОбъекта.Ссылка.Дата КАК Дата,
    ДанныеОбъекта.Ссылка КАК Ссылка,
    ДанныеОбъекта.Сотрудник КАК КлючПечатнойФормы,
    ДанныеОбъекта.Сотрудник КАК Сотрудник,
    &ТекущаяДата КАК ТекущаяДата
ИЗ
    Документ.ГрафикОтпусков.Сотрудники КАК ДанныеОбъекта
ГДЕ
    ДанныеОбъекта.Ссылка В (&ОбъектыНазначения)

---

Постобработка параметров

На вкладке Постобработка параметров можно написать произвольный код на встроенном языке 1С, который будет выполнен после сбора всех параметров. Это позволяет дополнительно преобразовать значения параметров перед вставкой в шаблон.

---

Вкладка «Параметры печатной формы»

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

Порядок работы:

1. Настройте представления и ТЧ на вкладке «Настройки макетов».
2. Перейдите на вкладку Параметры печатной формы.
3. Нажмите кнопку Заполнить параметры — система автоматически сформирует список всех параметров.
4. В колонке Параметр для макета Word — имя для вставки в Word-шаблон.
5. В колонке Параметр для шаблона ТД (mxl) — имя для MXL-шаблона.

Этот список используется при подготовке шаблона: именно отсюда берутся имена параметров для вставки в ячейки макета.

---

Вкладка «Переопределение параметров регистрации»

Здесь настраивается, в каких объектах ЗУП будет доступна ваша печатная форма.

Назначения (типы объектов)

• Кнопка Добавить → введите строку вида ТипОбъекта.ВидДокумента.
  Примеры:

  Документ.ПриемНаРаботу
  Документ.КадровыйПеревод
  Документ.Премия
  Справочник.Сотрудники

• После изменений нажмите Записать назначение.

Команды печати

В таблице Команды каждая строка соответствует одной команде в меню Печать:

Колонка	Описание
Представление (в меню Печати)	Название, которое увидит пользователь, например: WA: Трудовой договор (офисный)
Идентификатор команды печати	Уникальный ключ — должен совпадать с идентификатором в таблице «Настройки макетов». Например: ТрудовойДоговор_WA
Вариант запуска	Всегда Вызов клиентского метода
Модификатор	ПечатьMXL (для MXL-шаблонов) или ПечатьОфисныйДокумент (для Word-шаблонов)
Тип объекта печати	Заполняется при необходимости отображения в объектах ЛКС (КЭДО)

После изменений нажмите Записать команды.

Как работает код: при запуске печати система (ПолучитьДокументПоИдентификаторуКомандыПечати) ищет в таблице команд строку, идентификатор которой совпадает с ИмяМакета. Именно поэтому идентификатор команды и идентификатор макета должны быть строго одинаковыми.

Подготовка макета ПФ

Макет — это файл-шаблон (.mxl или .docx), хранящийся в справочнике Файлы системы 1С.

Рекомендация: используйте формат MXL — он обеспечивает более стабильную работу.

Именование областей

Это самый критичный раздел. Если имена областей не совпадут с ожидаемыми конструктором — параметры не заполнятся, табличные части не выведутся.

Как работает механизм областей

Функция ПолучитьОписаниеОбластейМакетаОфисногоДокумента в коде обработки строит жёстко заданный порядок областей:

1. Заголовок        (тип: Общая)
2. <ИмяТЧ>Шапка     (тип: СтрокаТаблицы) — для каждой ТЧ
3. <ИмяТЧ>Строка    (тип: СтрокаТаблицы) — для каждой ТЧ
4. НижняяЧасть      (тип: Общая)
5. ВерхнийКолонтитул
6. НижнийКолонтитул

Логика заполнения при формировании (СформироватьТабличныйДокумент):

• Область типа "Общая" → вставляется с заполнением параметров шапки.
• Область с именем, оканчивающимся на "Шапка" → вставляется с параметрами шапки.
• Область с именем, оканчивающимся на "Строка" → код берёт имя ТЧ как Лев(ИмяОбласти, Длина - 6) и итерирует по массиву строк ТЧ.

Таблица стандартных имён областей

Имя области	Тип	Когда использовать
Заголовок	Общая	Обязательна. Начальная часть документа — шапка, реквизиты, текст до таблиц.
<ИмяТЧ>Шапка	СтрокаТаблицы	Заголовок таблицы (шапка столбцов). Например: тчНачисленияШапка
<ИмяТЧ>Строка	СтрокаТаблицы	Строка данных таблицы. Например: тчНачисленияСтрока
НижняяЧасть	Общая	Нижняя часть документа после всех таблиц (подписи, печати и т.д.)
ВерхнийКолонтитул	ВерхнийКолонтитул	Колонтитул верхний
НижнийКолонтитул	НижнийКолонтитул	Колонтитул нижний

Правила именования — сводка

✅ Область.Заголовок          → основной текст документа
✅ Область.тчНачисленияШапка  → шапка таблицы начислений
✅ Область.тчНачисленияСтрока → строка таблицы начислений
✅ Область.НижняяЧасть        → подписи и т.д.
✅ Область.ВерхнийКолонтитул  → верхний колонтитул
✅ Область.НижнийКолонтитул   → нижний колонтитул

Ключевое правило: имя области для строк ТЧ должно быть строго <ПсевдонимТЧ>Строка, где <ПсевдонимТЧ> — это именно то значение, которое вы указали в колонке «Псевдоним (имя ТЧ на ПФ)» в настройках.

---

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

После настройки макета рекомендуется проверить результат непосредственно в конструкторе:

1. На вкладке Настройки макетов выберите объект в поле «Объект настройки и проверки макета».
2. Нажмите кнопку Проверить команду печати рядом с нужной строкой.
3. Система сформирует ПФ и откроет её для просмотра.

Это позволяет проверить ПФ без необходимости открывать исходный документ.

---

Быстрый чеклист при создании новой ПФ

• Добавлен тип объекта в «Назначения» → нажата «Записать назначение»
• Создана команда в «Команды» с уникальным идентификатором → нажата «Записать команды»
• В «Настройках макетов» добавлена строка с тем же идентификатором команды
• Выбран или загружен файл макета (MXL или DOCX)
• Указан формат вывода (MXL или DOC)
• Нажата кнопка «Записать настройку»
• В макете область Заголовок обязательно присутствует и правильно именована
• Имена областей ТЧ: <ПсевдонимТЧ>Шапка и <ПсевдонимТЧ>Строка — строго совпадают с псевдонимом в настройках
• Параметры в ячейках взяты из вкладки «Параметры печатной формы»
• Выполнена проверка команды печати на тестовом объекте