Как получить макет на сервере в 1С

В клиент-серверном режиме работы 1С код разделяется на клиентскую и серверную части, и макеты чаще всего нужны именно на сервере: для формирования печатных форм, отчётов, файлов обмена и служебных табличных документов. Получить макет на сервере можно штатными методами платформы, но важно понимать, в каком контексте выполняется код — от этого зависит, какой метод доступен и как правильно передать результат на клиент.

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

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

Где выполняется код и почему это важно

В управляемом приложении процедуры и функции помечаются директивами компиляции: &НаКлиенте, &НаСервере, &НаСервереБезКонтекста, &НаКлиентеНаСервереБезКонтекста. Директива определяет, какие объекты и методы доступны внутри кода. Методы получения макетов работают на сервере, поэтому вызов из клиентской процедуры напрямую невозможен — платформа выдаст ошибку компиляции или выполнения.

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

Получение макета объекта метаданных через ПолучитьМакет

Если макет создан внутри конкретного объекта конфигурации (документа, справочника, обработки, отчёта), его получают через менеджер объекта. Синтаксис одинаков для всех типов метаданных:

Макет = Документы.РеализацияТоваровУслуг.ПолучитьМакет("Печать");
МакетОбработки = Обработки.ЗагрузкаДанных.ПолучитьМакет("Шаблон");
МакетСправочника = Справочники.Номенклатура.ПолучитьМакет("Этикетка");

Метод доступен на сервере и в толстом клиенте. Возвращаемый тип зависит от вида макета: для табличного документа это объект ТабличныйДокумент, для схемы компоновки — СхемаКомпоновкиДанных, для текстового макета — ТекстовыйДокумент, для двоичных данных — ДвоичныеДанные.

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

&НаСервере
Процедура ПечатьНаСервере()
	Макет = Документы.РеализацияТоваровУслуг.ПолучитьМакет("Печать");
	ОбластьШапка = Макет.ПолучитьОбласть("Шапка");
	ТабДок = Новый ТабличныйДокумент;
	ТабДок.Вывести(ОбластьШапка);
КонецПроцедуры

Получение общего макета через ПолучитьОбщийМакет

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

Макет = ПолучитьОбщийМакет("ТиповаяПечатнаяФорма");

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

Если макет с указанным именем не существует, платформа выбросит исключение. Перед вызовом полезно убедиться, что имя в коде совпадает с именем в конфигураторе с точностью до регистра и без лишних пробелов — это одна из самых частых причин ошибок при переносе кода между конфигурациями.

Получение макета в форме и в общем модуле

В модуле формы

В форме объекта макет можно получить в процедуре &НаСервере через менеджер объекта, как показано выше. Если форма принадлежит обработке или отчёту, есть более короткий путь — метод ЭтотОбъект.ПолучитьМакет("ИмяМакета"), доступный в серверном контексте формы. Он обращается к макету той обработки или отчёта, которой принадлежит форма.

В процедуре &НаСервереБезКонтекста метод ЭтотОбъект недоступен, поэтому там работает только обращение через менеджер: Обработки.МояОбработка.ПолучитьМакет("Шаблон"). Это ограничение часто становится причиной ошибки «Метод объекта не обнаружен» при рефакторинге серверных процедур.

В общем серверном модуле

Общий модуль с флагами «Сервер» и «Вызов сервера» — стандартное место для процедур печати. Внутри него доступны оба метода получения макетов. Пример типовой процедуры:

Функция СформироватьПечатнуюФорму(СсылкаНаДокумент) Экспорт
Макет = Документы.РеализацияТоваровУслуг.ПолучитьМакет("Печать");
ТабДок = Новый ТабличныйДокумент;
Область = Макет.ПолучитьОбласть("Шапка");
Область.Параметры.НомерДокумента = СсылкаНаДокумент.Номер;
ТабДок.Вывести(Область);
Возврат ТабДок;
КонецФункции

Функция возвращает табличный документ, который клиентская процедура дальше показывает через ТабДок.Показать() или отправляет на печать. Такой подход отделяет логику формирования от отображения и упрощает тестирование.

1. 1
   Создайте клиентскую команду и её обработчик &НаКлиенте
2. 2
   В обработчике вызовите серверную функцию общего модуля или процедуру &НаСервере
3. 3
   На сервере получите макет через ПолучитьМакет или ПолучитьОбщийМакет
4. 4
   Заполните области табличного документа параметрами
5. 5
   Верните табличный документ на клиент и выведите его методом Показать

Передача результата на клиент

Табличный документ передаётся между сервером и клиентом без дополнительной сериализации — его можно просто вернуть из серверной функции. То же относится к текстовым документам и двоичным данным. Ограничение касается объёмных макетов: большие табличные документы увеличивают трафик между клиентом и сервером, поэтому для тяжёлых отчётов лучше формировать результат по частям или использовать фоновые задания.

Если макет нужен как файл (например, шаблон Excel для заполнения пользователем), на сервере получают двоичные данные макета, помещают их во временное хранилище, а на клиент передают адрес хранилища. Клиент забирает файл методом ПолучитьФайл() или сохраняет через диалог.

&НаСервере
Функция ПолучитьАдресШаблона()
ДвоичныеДанные = ПолучитьОбщийМакет("ШаблонЗагрузки");
Возврат ПоместитьВоВременноеХранилище(ДвоичныеДанные, УникальныйИдентификаторФормы);
КонецФункции

Типичные ошибки и их причины

Самая распространённая ошибка — «Метод объекта не обнаружен (ПолучитьМакет)». Она возникает, когда метод вызывают у объекта, который его не поддерживает: например, у ссылки документа (Ссылка.ПолучитьМакет() — неверно, нужно Документы.ИмяДокумента.ПолучитьМакет()) или в контексте БезКонтекста через ЭтотОбъект.

Вторая группа ошибок связана с контекстом компиляции: попытка вызвать получение макета в клиентской процедуре тонкого клиента приводит к ошибке «Процедура или функция с указанным именем не определена» ещё на этапе проверки модуля. Лечится переносом вызова в серверную процедуру.

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

Проверка результата и отладка

После получения макета полезно убедиться, что объект имеет ожидаемый тип. Для табличного макета проверка выглядит так: Если ТипЗнч(Макет) = Тип("ТабличныйДокумент") Тогда .... Это защищает от ситуации, когда макет с нужным именем существует, но имеет другой вид — например, разработчик создал текстовый макет вместо табличного.

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

Если печатная форма формируется, но выглядит пустой, проверьте, что области выводятся из правильного макета и что параметры областей реально заполняются — пустая область без параметров выводится без ошибок, просто с пустыми ячейками.

FAQ