Как получить макет на клиенте в 1С: пошаговая инструкция

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

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

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

1. Стандартный способ: метод ПолучитьМакет() и его ограничения

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

🔹 Работает только в контексте сервера (например, в модуле объекта или модуле менеджера). Вызов на клиенте приведёт к ошибке "Метод объекта не обнаружен (ПолучитьМакет)".
🔹 В управляемых формах можно использовать только в серверных процедурах (с директивой &НаСервере).
🔹 Не поддерживает динамическое изменение макетов на клиенте без перезагрузки формы.

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

&НаСервере Процедура ПолучитьМакетДокумента(ИмяМакета) Возврат Документы.ЗаказПокупателя.ПолучитьМакет(ИмяМакета);

КонецПроцедуры

⚠️ Внимание: Если вам нужно получить макет в клиентском коде (например, в обработчике события формы), придётся использовать серверный вызов. Прямой доступ к макетам с клиента невозможен из-за архитектуры платформы.

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

2. Обход ограничений: серверные функции и временные хранилища

Чтобы получить макет на клиенте, можно воспользоваться одним из двух подходов:

Серверная функция с возвратом макета. Создаётся процедура на сервере, которая извлекает макет и передаёт его клиенту через параметры или возвращаемое значение.
Временное хранилище. Макет сохраняется во временное хранилище на сервере, а затем загружается на клиенте.

Рассмотрим оба варианта на примерах.

2.1. Возврат макета через серверную функцию

Допустим, нам нужно получить макет "ПечатнаяФорма" документа РеализацияТоваровУслуг и отобразить его содержимое в клиентском коде:

&НаСервере
Функция ПолучитьМакетНаСервере(ИмяМакета)
Возврат Документы.РеализацияТоваровУслуг.ПолучитьМакет(ИмяМакета);
КонецФункции

&НаКлиенте
Процедура КнопкаПолучитьМакетНажатие(Кнопка)
Макет = ПолучитьМакетНаСервере("ПечатнаяФорма");
Сообщить("Макет получен: " + Макет.Имя);
КонецПроцедуры

2.2. Использование временного хранилища

Если макет нужно передать между разными сеансами или формами, удобнее использовать ВременноеХранилище:

&НаСервере
Процедура СохранитьМакетВоВременноеХранилище(ИмяМакета)
Макет = Документы.ЗаказПокупателя.ПолучитьМакет(ИмяМакета);
Адрес = ПоместитьВоВременноеХранилище(Макет);
Возврат Адрес;
КонецПроцедуры

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

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

3. Работа с макетами в управляемых формах: нюансы и примеры

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

📌 Серверные команды. Вынос логики получения макета в серверные процедуры с вызовом через ВыполнитьНаСервере().
📌 Параметры формы. Передача макета как параметра при открытии формы.
📌 Глобальные переменные. Использование ПараметрыСеанса для хранения макетов между вызовами.

Пример с серверной командой:

&НаКлиенте Процедура ПриСозданииНаСервере(Отказ, СтандартнаяОбработка) Макет = Документы.ЗаказПокупателя.ПолучитьМакет("ПечатнаяФорма"); ПараметрыФормы.Макет = Макет; // Передаём макет в параметры формы КонецПроцедуры &НаКлиенте Процедура КнопкаПоказатьМакетНажатие(Кнопка) Если ЗначениеЗаполнено(ПараметрыФормы.Макет) Тогда ОткрытьЗначение(ПараметрыФормы.Макет); Иначе Сообщить("Макет не загружен!"); КонецЕсли;

КонецПроцедуры

Для динамического изменения макетов (например, модификации табличного документа перед печатью) можно использовать событие ПередЗаписьюМакетов в модуле объекта. Однако это требует прав на изменение конфигурации.

💡

Если макет нужно отредактировать на клиенте (например, изменить текст или добавить строки в таблицу), преобразуйте его в ТабличныйДокумент или ТекстовыйДокумент и работайте с ним как с обычным объектом.

4. Получение макетов из внешних обработок и отчётов

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

Тип объекта	Метод получения макета	Ограничения
Внешняя обработка	`ЭтаОбработка.ПолучитьМакет("ИмяМакета")`	Требует вызова на сервере или в модуле обработки
Отчёт	`Отчеты.ИмяОтчета.ПолучитьМакет("ИмяМакета")`	Доступен только в серверном контексте
Общий макет	`ОбщиеМакеты.ИмяМакета.ПолучитьМакет()`	Может требовать прав на чтение

Пример для внешней обработки:

&НаСервере
Функция ПолучитьМакетОбработки(ИмяМакета)
Возврат ЭтаОбработка.ПолучитьМакет(ИмяМакета);
КонецФункции

&НаКлиенте
Процедура ЗагрузитьМакетИзОбработки()
Макет = ПолучитьМакетОбработки("МойМакет");
Если Макет = Неопределён Тогда
Сообщить("Макет не найден!");
Иначе
// Работаем с макетом
КонецЕсли;
КонецПроцедуры

⚠️ Внимание: При работе с внешними обработками в веб-клиенте убедитесь, что обработка загружена на сервер. В противном случае вызов ЭтаОбработка вернёт ошибку.

5. Альтернативные методы: экспорт макетов в файлы и обмен данными

Если стандартные способы не подходят (например, из-за ограничений прав или архитектуры решения), можно использовать экспорт макетов во внешние файлы или обмен данными через HTTP-сервисы.

5.1. Сохранение макета в файл

Макет можно сохранить в файл (например, .mxl или .txt) и затем загрузить его на клиенте:

&НаСервере Процедура ЭкспортироватьМакетВФайл(ИмяМакета, ПутьКФайлу) Макет = Документы.ЗаказПокупателя.ПолучитьМакет(ИмяМакета); Макет.Записать(ПутьКФайлу); КонецПроцедуры &НаКлиенте Процедура ЗагрузитьМакетИзФайла(ПутьКФайлу) Если НЕ ЗначениеЗаполнено(ПутьКФайлу) Тогда ПутьКФайлу = КаталогВременныхФайлов() + "Макет.mxl"; КонецЕсли; ЭкспортироватьМакетВФайл("ПечатнаяФорма", ПутьКФайлу); // Далее можно открыть файл или загрузить его содержимое

КонецПроцедуры

5.2. Передача макета через HTTP-сервис

Для интеграции с внешними системами удобно использовать HTTP-сервисы. Например, можно создать сервис, который возвращает макет в формате JSON или Base64:

&НаСервере
Функция ПолучитьМакетКакBase64(ИмяМакета)
Макет = Документы.ЗаказПокупателя.ПолучитьМакет(ИмяМакета);
ДвоичныеДанные = Новый ДвоичныеДанные();
Макет.Записать(ДвоичныеДанные);
Возврат Base64Строка(ДвоичныеДанные);
КонецФункции

На клиенте полученную строку Base64 можно декодировать и восстановить макет:

&НаКлиенте
Процедура ЗагрузитьМакетИзBase64(Base64Строка)
ДвоичныеДанные = Base64Значение(Base64Строка);
Макет = Новый Макет();
Макет.Прочитать(ДвоичныеДанные);
Возврат Макет;
КонецПроцедуры

Когда использовать экспорт в файлы?

Этот метод оправдан, если макет нужно передать в другую систему, сохранить для истории или использовать в автономном режиме. Однако он требует дополнительных проверок на права доступа к файловой системе.

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

При работе с макетами на клиенте разработчики часто сталкиваются с следующими проблемами:

🚨 "Метод объекта не обнаружен (ПолучитьМакет)" — попытка вызвать метод на клиенте. Решение: перенесите логику на сервер.
🚨 "Недостаточно прав для чтения макета" — отсутствуют права на объект конфигурации. Решение: проверьте роли пользователя.
🚨 "Макет не найден" — опечатка в имени макета или он удалён. Решение: используйте Макеты.Найти("Имя") для проверки.
🚨 "Невозможно преобразовать тип" — попытка присвоить макет несовместимому типу. Решение: явно укажите тип (Макет = Новый Макет;).

Пример обработки ошибки:

&НаКлиенте
Процедура БезопасноеПолучениеМакета(ИмяМакета)
Попытка
Макет = ПолучитьМакетНаСервере(ИмяМакета);
Возврат Макет;
Исключение
Сообщить("Ошибка получения макета: " + ОписаниеОшибки());
Возврат Неопределён;
КонецПопытки;
КонецПроцедуры

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

☑️ Проверка перед работой с макетами

Убедиться, что макет существуетПроверить права доступаИспользовать серверные процедуры для извлеченияОбработать возможные исключения

Выполнено: 0 / 4

7. Особенности работы в разных клиентах (толстый, тонкий, веб)

Поведение макетов может отличаться в зависимости от типа клиента 1С:Предприятие:

Тип клиента	Поддержка ПолучитьМакет()	Ограничения	Рекомендации
Толстый клиент	Да (с правами)	Можно вызывать на клиенте в неуправляемом режиме	Используйте `ГлобальныйКонтекст.ПолучитьМакет()`
Тонкий клиент	Только на сервере	Прямой вызов на клиенте запрещён	Все операции через `&НаСервере`
Веб-клиент	Только на сервере	Ограничения на размер передаваемых данных	Используйте сжатие или разбивку на части

В веб-клиенте дополнительные сложности создаёт ограничение на объём передаваемых данных между клиентом и сервером. Если макет большой (например, сложный отчёт с графикой), его лучше:

📦 Разбивать на части.
📦 Сжимать перед передачей.
📦 Сохранять во временное хранилище и передавать только ссылку.

Пример сжатия макета перед передачей:

&НаСервере
Функция ПолучитьСжатыйМакет(ИмяМакета)
Макет = Документы.ЗаказПокупателя.ПолучитьМакет(ИмяМакета);
ДвоичныеДанные = Новый ДвоичныеДанные();
Макет.Записать(ДвоичныеДанные);
СжатыеДанные = СжатьДанные(ДвоичныеДанные);
Возврат Base64Строка(СжатыеДанные);
КонецФункции

⚠️ Внимание: В веб-клиенте избегайте передачи макетов размером более 10 МБ — это может привести к обрыву соединения или зависанию браузера.

8. Практический пример: динамическая модификация макета на клиенте

Рассмотрим реальную задачу: нужно получить макет печатной формы документа, изменить в нём заголовок и вывести модифицированный вариант пользователю — всё без перезагрузки формы.

Алгоритм решения:

Получить макет на сервере.
Преобразовать его в ТабличныйДокумент.
Изменить нужные ячейки на клиенте.
Отобразить результат.

Код:

&НаСервере
Функция ПолучитьМакетКакТабличныйДокумент(ИмяМакета)
Макет = Документы.ЗаказПокупателя.ПолучитьМакет(ИмяМакета);
ТабДок = Новый ТабличныйДокумент;
ТабДок.Прочитать(Макет);
Возврат ТабДок;
КонецФункции

&НаКлиенте
Процедура ИзменитьИПоказатьМакет()
ТабДок = ПолучитьМакетКакТабличныйДокумент("ПечатнаяФорма");

// Меняем заголовок в первой ячейке
ТабДок.Область("A1").Текст = "МОДИФИЦИРОВАННАЯ ФОРМА: " + ТабДок.Область("A1").Текст;

// Показываем пользователю
ТабДок.Показать();
КонецПроцедуры

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

💡

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

FAQ: Частые вопросы по работе с макетами на клиенте

Можно ли получить макет на клиенте без вызова сервера?

Нет, в управляемых формах и тонком/веб-клиенте прямой доступ к макетам возможен только через серверные процедуры. Исключение — толстый клиент в неуправляемом режиме, где можно использовать ГлобальныйКонтекст.ПолучитьМакет().

Как передать макет между двумя клиентскими формами?

Используйте ПараметрыСеанса или ВременноеХранилище. Пример:

ПараметрыСеанса.Вставить("ТекущийМакет", Макет);

В другой форме:

Макет = ПараметрыСеанса.Получить("ТекущийМакет");

Почему макет отображается некорректно после модификации?

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

Сохранена ли иерархия объектов в макете.
Не нарушены ли привязки данных (например, поля документа).
Соответствует ли тип макета (ТабличныйДокумент, ТекстовыйДокумент и т.д.) его содержимому.

Как получить список всех макетов объекта?

Используйте метод Макеты с циклом перебора:

Для Каждого Макет Из Документы.ЗаказПокупателя.Макеты Цикл Сообщить(Макет.Имя);

КонецЦикла;

В управляемых формах этот код нужно выполнять на сервере.

Можно ли сохранить изменённый макет обратно в конфигурацию?

Да, но для этого требуются права на изменение конфигурации и использование метода ЗаписатьМакет(). Пример:

&НаСервере Процедура СохранитьМакет(ИмяМакета, НовыйМакет) Документы.ЗаказПокупателя.ЗаписатьМакет(ИмяМакета, НовыйМакет);

КонецПроцедуры

Внимание: это изменяет конфигурацию и может потребовать обновления базы!

Получение макета на клиенте в 1С: все доступные методы и практические примеры

1. Стандартный способ: метод ПолучитьМакет() и его ограничения

2. Обход ограничений: серверные функции и временные хранилища

2.1. Возврат макета через серверную функцию

2.2. Использование временного хранилища

3. Работа с макетами в управляемых формах: нюансы и примеры

4. Получение макетов из внешних обработок и отчётов

5. Альтернативные методы: экспорт макетов в файлы и обмен данными

5.1. Сохранение макета в файл

5.2. Передача макета через HTTP-сервис

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

☑️ Проверка перед работой с макетами

7. Особенности работы в разных клиентах (толстый, тонкий, веб)

8. Практический пример: динамическая модификация макета на клиенте

FAQ: Частые вопросы по работе с макетами на клиенте

📖 Читайте также