Как исправить ошибки при получении макета и выводе табличного документа в управляемой форме 1С?

← На главную

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

Ошибка «Недопустимое значение параметра (параметр номер '1')» в методе РеквизитФормыВЗначение

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


&НаСервере
Функция ПолучитьМакетНаСервере()
    Объект = РеквизитФормыВЗначение("Обработка");
    Макет  = Объект.ПолучитьМакет("Макет");
    Возврат Макет;
КонецФункции

При выполнении этого кода платформа генерирует исключение: «Недопустимое значение параметра (параметр номер '1')». Выясним причину такого поведения платформы. Метод РеквизитФормыВЗначение принимает имя реквизита формы в виде строки. Ошибка возникает в двух случаях:

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

Ошибка «Нельзя изменять поле, содержащее объект данных формы»

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

Объект = РеквизитФормыВЗначение("Объект");

В результате платформа сообщает: «Ошибка при установке значения атрибута контекста (Объект): Нельзя изменять поле, содержащее объект данных формы».

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

Чтобы исключить конфликт имен, используем отдельную переменную с уникальным именем:


&НаСервере
Функция ПолучитьМакетНаСервере()
    ОбъектОбработки = РеквизитФормыВЗначение("Объект");
    Макет = ОбъектОбработки.ПолучитьМакет("Макет");
    Возврат Макет;
КонецФункции

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

Оптимальное решение: получение макета через менеджер объекта

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

Макеты отчетов и обработок доступны на сервере напрямую через менеджеры соответствующих объектов конфигурации без создания экземпляров и без открытия формы:


// Для обработки конфигурации:
Макет = Обработки.ИмяОбработки.ПолучитьМакет("ИмяМакета");

// Для отчета конфигурации:
Макет = Отчеты.ВидыОплатККМ.ПолучитьМакет("ОсновнойМакет");

// Для общего макета конфигурации:
Макет = ПолучитьОбщийМакет("ИмяОбщегоМакета");

Этот способ работает быстрее, требует меньше строк кода и не зависит от структуры текущей формы.

Ошибка «Метод недоступен на сервере» при вызове Показать()

Следующая проблема возникает на этапе вывода сформированного документа. Код вида ТабДок.Показать();, вызванный внутри серверной процедуры, приводит к падению с ошибкой: «Метод недоступен на сервере».

Метод Показать() отвечает за интерактивное отображение окна пользователю в графическом интерфейсе, поэтому он доступен исключительно на клиенте (директива &НаКлиенте). Серверный контекст не взаимодействует с экраном монитора.

Правильная организация клиент-серверного вывода выглядит следующим образом:

На сервере формируем и заполняем ТабличныйДокумент.
Возвращаем готовый документ на клиент.
На клиенте открываем его пользователю.

Посмотрим на практический пример реализации:


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

&НаКлиенте
Процедура КомандаПечать(Команда)
    ТабДок = СформироватьДокументНаСервере();
    ТабДок.Показать("Печатная форма");
КонецПроцедуры

Альтернатива: отображение табличного документа прямо в форме

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

Добавим в реквизиты формы новый элемент с именем РезультатТабДок и типом ТабличныйДокумент.
Перетащим созданный реквизит в элементы формы — платформа создаст элемент управления Поле табличного документа.
В серверной процедуре обратимся напрямую к реквизиту формы:


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

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