Как заполнить реквизиты формы данными из документа 1С?

← На главную

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

Использование метода ЗаполнитьЗначенияСвойств

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

Разберем, как применить этот метод на практике:


// В обработчике нажатия кнопки на сервере:
&НаСервере
Процедура ЗаполнитьДанныеНаСервере(СсылкаНаДокумент)
    // Объект документа, из которого берем данные
    ОбъектДокумента = СсылкаНаДокумент.ПолучитьОбъект();
    
    // Заполняем реквизиты формы, совпадающие по именам
    ЗаполнитьЗначенияСвойств(ЭтотОбъект, ОбъектДокумента);
КонецПроцедуры

Важные замечания:

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

Реализация через структуру данных

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

Рассмотрим алгоритм действий:

Получите данные из документа на сервере.
Сформируйте структуру, где ключи соответствуют именам реквизитов вашей формы.
Присвойте значения из структуры непосредственно реквизитам ЭтаФорма.


&НаСервере
Процедура ПолучитьДанныеДляФормы(СсылкаНаДокумент)
    ДанныеДока = СсылкаНаДокумент.ПолучитьОбъект();
    
    // Ручное присвоение для разных имен реквизитов
    ЭтотОбъект.НаименованиеНаФорме = ДанныеДока.Дата;
    ЭтотОбъект.ПартнерНаФорме = ДанныеДока.Партнер;
    ЭтотОбъект.СуммаДокумента = ДанныеДока.СуммаДокумента;
КонецПроцедуры

Работа с табличными частями

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

Проанализируем шаги:

Выгрузите табличную часть документа в таблицу значений: ТабЧасть = ОбъектДокумента.Товары.Выгрузить();
Присвойте эту таблицу реквизиту формы, который связан с элементом управления «Таблица» на форме: Объект.ТоварыНаФорме.Загрузить(ТабЧасть);

Важные правила разработки

При реализации данного функционала всегда учитывайте архитектурные ограничения платформы 1С:

Контекст выполнения: Помните, что обращение к данным базы данных (объектам 1С) должно происходить только в процедурах с директивой &НаСервере. Попытка чтения объекта на клиенте приведет к ошибке.

Типизация: Убедитесь, что реквизит на форме, в который вы передаете ссылку на документ, имеет тип ДокументСсылка.ЗаказКлиента. В противном случае платформа не сможет правильно обработать переданный объект.

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