При разработке внешних обработок для заполнения табличных частей или при интеграции новых функций в типовые конфигурации программисты 1С часто сталкиваются с диагностическим сообщением (поможет инструментарий для разработки и отладки 1С): «Ошибка отображения типов: Отсутствует отображение для типа 'ФормаКлиентскогоПриложения'». Эта проблема может возникать спорадически и сопровождаться ошибками преобразования данных XDTO. Давайте подробно разберем, почему это происходит и как правильно организовать передачу данных между клиентом и сервером.
Для начала проанализируем архитектуру управляемого приложения — для этого подойдёт инструмент для анализа архитектуры управляемого приложения. В 1С:Предприятии 8.3 объекты разделены по типам контекста. Объект типа УправляемаяФорма (или ФормаКлиентскогоПриложения в терминологии XDTO) существует исключительно на клиенте. Его невозможно «сериализовать» (превратить в поток данных) и передать на сервер в «чистом» виде. Сервер просто не знает, что делать с клиентским окном, кнопками и элементами управления.
Рассмотрим по шагам основные сценарии, в которых возникает данная ошибка, и способы их решения.
В коде автора темы присутствует процедура ОбновитьИтоги(Форма), помеченная директивой &НаКлиентеНаСервереБезКонтекста. Это «универсальная» процедура, которая, по задумке, должна работать везде. Однако в нее передается параметр Форма.
Выясним причину ошибки: когда платформа встречает процедуру с такой директивой, она выполняет проверку типов для всех возможных контекстов выполнения. Даже если вы вызываете эту процедуру только с клиента, система готовится к тому, что она может быть выполнена на сервере. Поскольку тип Форма не имеет серверного отображения, возникает конфликт при попытке подготовить данные для вызова.
Как исправить: Никогда не передавайте форму целиком в процедуры, которые могут выполняться на сервере. Вместо формы передавайте только те данные, которые необходимы для расчетов. Обычно это основной реквизит формы — Объект.
Посмотрим на правильный пример кода:
// Неправильно:
&НаКлиентеНаСервереБезКонтекста
Процедура ОбновитьИтоги(Форма)
Объект = Форма.Объект;
// ... расчеты ...
КонецПроцедуры
// Правильно:
&НаКлиентеНаСервереБезКонтекста
Процедура ОбновитьИтоги(ДанныеОбъекта)
Итог = ДанныеОбъекта.Товары.Итог("Сумма");
// Передаем только ДанныеФормыСтруктура
КонецПроцедуры
Разберем ситуацию в процедуре ВыполнитьКоманду. В ней происходит поиск открытого окна документа и попытка программно вызвать заполнение. Автор использует следующий подход:
Форма = ОткрытьФорму("Документ.АвансовыйОтчет.Форма.ФормаДокумента", КлючПоиска,,, Окно1);
НовыйОбъект = Форма.Объект;
ЗаполнитьНаСервере(НовыйОбъект);
Здесь важно понимать, что Форма.Объект имеет тип ДанныеФормыСтруктура. Этот тип специально предназначен для передачи между клиентом и сервером. Однако, если процедура ЗаполнитьНаСервере объявлена в модуле, который требует передачи контекста, или если внутри этой процедуры (или при вызове) случайно «затесалась» ссылка на саму форму, произойдет ошибка.
Проанализируем механизм работы КопироватьДанныеФормы. Часто программисты используют эту функцию для обновления интерфейса, но при работе с основным реквизитом Объект она может быть избыточной. Поскольку ДанныеФормыСтруктура — это ссылочный тип, изменения, внесенные в НовыйОбъект внутри серверной процедуры, автоматически отобразятся на клиенте при возврате управления.
Если ваша конфигурация построена на базе БСП (Библиотеки стандартных подсистем), обратите внимание на вызовы в модуле формы. В сообщении №10 автор указывает, что ошибка пропала после комментирования вызова ПодключаемыеКомандыКлиент.ПослеЗаписи в процедуре ПередЗаписью.
Разберем ситуацию подробнее: процедура ПередЗаписью в модуле формы является клиентской, но за ней следует ПередЗаписьюНаСервере. Если в цепочке вызовов подключаемых команд система пытается передать структуру параметров, содержащую ссылку на текущую форму (ЭтотОбъект), в серверный контекст, вы получите обсуждаемую ошибку.
Важное правило: При работе с БСП всегда проверяйте соответствие контекста. Клиентские методы (с постфиксом Клиент) не должны вызываться из серверных процедур напрямую, и в них не должны передаваться объекты, которые не подлежат сериализации (формы, элементы форм, обработчики оповещений).
Если вы столкнулись с ошибкой «Отсутствует отображение для типа 'ФормаКлиентскогоПриложения'», выполните следующие действия:
&НаКлиентеНаСервереБезКонтекста. Если в параметрах передается Форма или ЭтотОбъект, замените их на передачу конкретных данных (Объект, ТаблицаЗначений).ПодключаемыеКомандыКлиент. Это сигнал того, что в структуру ПараметрыВыполненияКоманды попал «мусор» в виде клиентского объекта формы, который платформа пытается передать на сервер при записи документа — для этого есть инструмент отладки кода и анализа стека.ДанныеФормыСтруктура, ДанныеФормыКоллекция или простые типы (Строка, Число, Массив, Структура).Объект.Рассмотрим исправленный вариант серверного заполнения:
&НаСервере
Процедура ЗаполнитьНаСервере(ДанныеФормыОбъект)
// Преобразуем данные формы в реальный объект документа для работы с ним
ДокОбъект = ДанныеФормыВЗначение(ДанныеФормыОбъект, Тип("ДокументОбъект.АвансовыйОтчет"));
// Выполняем заполнение ТЧ
// ... логика запроса ...
ДокОбъект.ВыданныеАвансы.Загрузить(Запрос.Выполнить().Выгрузить());
// Возвращаем изменения обратно в данные формы
ЗначениеВДанныеФормы(ДокОбъект, ДанныеФормыОбъект);
КонецПроцедуры
Такой подход с использованием ДанныеФормыВЗначение и ЗначениеВДанныеФормы является наиболее безопасным и «чистым» с точки зрения платформы 1С, так как он гарантирует правильную трансформацию типов между клиентским представлением данных и серверными объектами метаданных.
Подведем итог: Ошибка отображения типов — это всегда сигнал о том, что клиентский объект пытается «пролезть» на сервер. Внимательно следите за тем, что вы передаете в параметрах процедур, и избегайте использования типа Форма вне клиентского кода. Для оперативного обнаружения подобных ошибок есть мониторинг журнала регистрации с уведомлениями в Telegram.