При разработке внешних обработок заполнения табличных частей часто возникает неприятная особенность платформы 1С:Предприятие 8.3: реквизит ссылочного типа заполнен корректно, однако в пользовательском интерфейсе поле ячейки остается совершенно пустым. Особенно часто эта проблема проявляется, если для целевого ссылочного объекта программно переопределено стандартное представление, а сам документ-владелец еще не записан в базу данных. При этом запись документа в форме мгновенно возвращает правильные строки на экран, а стандартный вызов метода ОповеститьОбИзменении на клиенте не приносит результата.
Проанализируем природу такого поведения платформы и подробно разберем несколько проверенных способов решения задачи.
Рассмотрим механизм формирования и передачи представлений данных на управляемых формах. В платформе 1С:Предприятие 8 строковые представления ссылок вычисляются на стороне сервера и передаются клиенту в оптимизированном виде, сохраняясь в специальном клиентском кэше представлений.
Когда внешняя обработка выполняет прямое заполнение реквизитов чужой формы на клиенте (например, через модификацию коллекции ВладелецФормы.Объект.ТабличнаяЧасть), клиентское приложение фиксирует наличие ссылочного значения, однако не инициирует серверный контекстный вызов для получения его строкового представления. Вызов метода ОповеститьОбИзменении только сбрасывает кэш для указанной ссылки, сообщая платформе о ее неактуальности, но сам по себе не отправляет запрос на сервер для незаписанного объекта формы.
Второй частой причиной является отсутствие или неполная реализация процедуры ОбработкаПолученияПолейПредставления в модуле менеджера связанного объекта. Если в конфигурации переопределена процедура ОбработкаПолученияПредставления, но не отключена стандартная обработка в процедуре получения полей, платформа не может заранее скомпоновать пакетный запрос данных для табличной части.
Если заполнение табличной части выполняется кодом клиентской части внешней обработки, простейшим и наиболее быстрым решением является принудительная перерисовка формы владельца с запросом недостающих представлений.
Посмотрим, как правильно вызвать этот метод после завершения вставки строк:
// Заполняем табличную часть формы-владельца
Для Каждого СтрДанных Из ЗагруженныеДанные Цикл
НоваяСтрока = ВладелецФормы.Объект.Товары.Добавить();
НоваяСтрока.ДокументОснование = СтрДанных.СсылкаНаДокумент;
НоваяСтрока.Количество = СтрДанных.Количество;
КонецЦикла;
// Принудительно заставляем форму перечитать визуальные свойства ячеек
ВладелецФормы.ОбновитьОтображениеДанных();
В отличие от простого сброса кэша, вызов ОбновитьОтображениеДанных() форсирует опрос серверного контекста для видимых строк элементов управления формы, в результате чего платформа запрашивает вычисленные представления для всех новых ссылок.
Разберем архитектурно правильный подход, который исключает рассинхронизацию между серверными данными и клиентским отображением. Вместо прямого редактирования строк объекта через контекст чужой формы, передадим прочитанные данные в серверную процедуру формы-документа.
&НаСервере заполняем табличную часть объекта.Посмотрим на пример реализации передачи через оповещение:
&НаКлиенте
Процедура ЗавершитьЗаполнениеНаКлиенте()
ПараметрыЗаполнения = Новый Структура("ТаблицаДанных", ПодготовленныеДанные);
Оповестить("ЗаполнитьТабличнуюЧастьИзФайла", ПараметрыЗаполнения, ВладелецФормы);
Закрыть();
КонецПроцедуры
В форме документа обрабатываем событие оповещения и уходим на сервер:
&НаКлиенте
Процедура ОбработкаОповещения(ИмяСобытия, Параметр, Источник)
Если ИмяСобытия = "ЗаполнитьТабличнуюЧастьИзФайла" Тогда
ЗаполнитьТаблицуНаСервере(Параметр.ТаблицаДанных);
КонецЕсли;
КонецПроцедуры
&НаСервере
Процедура ЗаполнитьТаблицуНаСервере(ТаблицаДанных)
Для Каждого Стр Из ТаблицаДанных Цикл
НоваяСтрока = Объект.Товары.Добавить();
НоваяСтрока.ДокументОснование = Стр.СсылкаНаДокумент;
НоваяСтрока.Количество = Стр.Количество;
КонецЦикла;
КонецПроцедуры
При завершении серверного вызова и возврате управления клиенту управляемая форма автоматически собирает актуальные строковые представления ссылок и корректно передает их в клиентский кэш.
Если ссылка все равно не отображается даже при серверных вызовах, проанализируем модуль менеджера того объекта, чье представление переопределено. Для корректной оптимизированной сборки строковых представлений платформа требует синхронной работы двух обработчиков событий.
Разберем код в модуле менеджера целевого документа:
Процедура ОбработкаПолученияПолейПредставления(Поля, СтандартнаяОбработка)
СтандартнаяОбработка = Ложь;
Поля.Добавить("Номер");
Поля.Добавить("Дата");
Поля.Добавить("Организация");
КонецПроцедуры
Процедура ОбработкаПолученияПредставления(Данные, Представление, СтандартнаяОбработка)
СтандартнаяОбработка = Ложь;
Представление = СтрШаблон("Документ № %1 от %2 (%3)", Данные.Номер, Формат(Данные.Дата, "ДФ=dd.MM.yyyy"), Данные.Организация);
КонецПроцедуры
Важный нюанс: если в процедуре ОбработкаПолученияПолейПредставления не передать СтандартнаяОбработка = Ложь или забыть объявить реквизиты в коллекции Поля, платформа не сможет определить состав полей для построения оптимизированного запроса на уровне списков и табличных частей, оставив ячейку пустой до момента непосредственного обращения к объекту.
В ситуациях, когда разработчик не имеет возможности вносить правки в модуль менеджера или модуль формы документа (например, при доработке через внешние отчеты и обработки в закрытых конфигурациях), можно применить решения, предложенные участниками форума:
Таким образом, для быстрого решения проблемы на клиенте достаточно применить ВладелецФормы.ОбновитьОтображениеДанных(), а для надежной промышленной разработки рекомендуется передавать массив данных на сервер формы документа и проверять полноту обработчиков представлений в модуле менеджера.