Данные формы в 1С 8.3: что это и как с ними работать

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

Поисковый запрос «данныеформыструктура 1с 8.3» обычно означает одно из двух: либо вопрос о типе ДанныеФормыСтруктура из встроенного языка, либо общий вопрос о том, как устроены данные управляемой формы. Ниже рассмотрены оба аспекта: архитектура данных формы и практическая работа с типом ДанныеФормыСтруктура в коде.

Материал ориентирован на начинающих разработчиков 1С, которые уже умеют создавать формы в конфигураторе, но путаются в типах ДанныеФормыСтруктура, ДанныеФормыКоллекция и методах преобразования.

Что такое данные формы и зачем они отделены от объектов базы

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

Каждый реквизит формы хранится как элемент данных формы определённого типа. Основной реквизит формы объекта (например, реквизит «Объект» типа «ДокументОбъект.РеализацияТоваровУслуг») на форме представлен типом ДанныеФормыСтруктура — структурой, поля которой соответствуют реквизитам объекта метаданных.

Табличные части и реквизиты типа «ТаблицаЗначений» превращаются в ДанныеФормыКоллекция, деревья значений — в ДанныеФормыДерево, а вложенные объекты (например, характеристики) — в ДанныеФормыСтруктура внутри основной структуры. Таким образом, вся форма становится деревом типизированных данных, которые можно передавать между клиентом и сервером.

Структура данных формы: какие типы где используются

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

Важная особенность: строки табличных частей и коллекций имеют тип ДанныеФормыЭлементКоллекции — по сути, это тоже структура с именованными полями. Вложенные объекты внутри основного (например, «УдалитьКонтрагент» или дополнительные реквизиты сложного состава) представляются вложенными структурами.

Проверить фактический тип данных в конкретной точке кода можно через отладчик: добавьте переменную в табло и посмотрите колонку «Тип». Это надёжнее, чем полагаться на предположения, особенно в формах с динамически создаваемыми реквизитами.

Как обратиться к данным формы в коде

В модуле формы доступ к данным идёт через реквизиты формы по имени. Если основной реквизит называется «Объект», то поля документа читаются и изменяются напрямую: Объект.Комментарий = "Проверено";. При этом вы работаете не с объектом базы данных, а с данными формы — изменения попадут в базу только после записи.

Для табличных частей используется индексация и обход коллекции. Типичный пример — пересчёт сумм по строкам:

&НаСервере
Процедура ПересчитатьСуммы()
	Для Каждого СтрокаТовары Из Объект.Товары Цикл
		СтрокаТовары.Сумма = СтрокаТовары.Количество * СтрокаТовары.Цена;
	КонецЦикла;
КонецПроцедуры

На клиенте доступны те же данные формы, но с ограничениями: недоступны серверные методы объектов, запросы и прямое обращение к базе. Поэтому тяжёлую логику принято выносить в серверные процедуры с директивой &НаСервере или &НаСервереБезКонтекста.

Преобразование данных формы в объект и обратно

Главная операция при работе с ДанныеФормыСтруктура — преобразование в прикладной объект и обратно. Для этого существуют два метода формы:

• РеквизитФормыВЗначение("Объект") — возвращает объект базы данных (например, ДокументОбъект), построенный из данных формы;
• ЗначениеВРеквизитФормы(ОбъектБазы, "Объект") — помещает объект обратно в данные формы.

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

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

У преобразования есть стоимость: платформа копирует все данные, включая табличные части. На больших документах частые вызовы РеквизитФормыВЗначение заметно замедляют форму. Если нужно только прочитать пару полей, дешевле обратиться к ним напрямую через данные формы без преобразования.

Программное создание и изменение реквизитов формы

Структура данных формы не фиксирована: реквизиты можно добавлять и удалять программно через метод ИзменитьРеквизиты(). Это используется в динамических формах, где набор полей зависит от настроек пользователя или вида объекта.

Порядок действий: сформировать массив добавляемых реквизитов (объекты типа РеквизитФормы с именем, типом и путём), массив удаляемых (строки путей), вызвать ИзменитьРеквизиты(Добавляемые, Удаляемые), затем создать элементы формы для новых реквизитов через Элементы.Добавить().

1. 1
   Создайте объект РеквизитФормы: Новый РеквизитФормы("Имя", ОписаниеТипов, "", "Заголовок")
2. 2
   Соберите добавляемые реквизиты в массив, при необходимости подготовьте массив удаляемых путей
3. 3
   Вызовите ИзменитьРеквизиты(МассивДобавляемых, МассивУдаляемых) на сервере
4. 4
   Добавьте элемент формы и свяжите его с реквизитом через ПутьКДанным
5. 5
   Проверьте результат: реквизит виден в отладчике, элемент отображается на форме

Ограничение: метод ИзменитьРеквизиты доступен только на сервере, и после его вызова форма полностью пересоздаётся на клиенте. Частые изменения состава реквизитов при интерактивной работе пользователя — признак неудачной архитектуры; лучше заранее создать реквизиты в конфигураторе и управлять только видимостью элементов.

Типичные ошибки при работе с данными формы

Ещё одна частая проблема — путаница между Элементы.ИмяПоля.Значение и реквизитом формы. У большинства элементов управляемой формы нет свойства «Значение»: данные хранятся в реквизите, а элемент лишь отображает его через ПутьКДанным. Менять нужно реквизит, а не элемент.

Как проверить, что всё работает правильно

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

FAQ: частые вопросы о данных формы в 1С 8.3