Как получить все реквизиты формы в 1С

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

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

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

Как работает метод ПолучитьРеквизиты()

Метод ПолучитьРеквизиты() вызывается у объекта управляемой формы и возвращает массив, каждый элемент которого — объект типа «РеквизитФормы». У элемента массива доступны свойства: Имя (строка с именем реквизита), Путь (путь к данным для реквизитов, связанных с объектом), Заголовок и ТипЗначения (объект «ОписаниеТипов»).

Метод принимает необязательный параметр «Путь» — строку, указывающую, относительно какого реквизита получать подчинённые. Например, ПолучитьРеквизиты("Объект") вернёт только реквизиты формы, подчинённые реквизиту «Объект» (то есть реквизиты редактируемого документа или справочника). Вызов без параметра вернёт реквизиты верхнего уровня.

Типовой пример обхода всех реквизитов формы:

МассивРеквизитов = ЭтотОбъект.ПолучитьРеквизиты();
Для Каждого Реквизит Из МассивРеквизитов Цикл
Сообщить(Реквизит.Имя + " | " + Строка(Реквизит.ТипЗначения));
КонецЦикла;

Обратите внимание: метод возвращает только описания (метаданные уровня формы), а не сами значения. Чтобы получить значение, нужно обратиться к реквизиту по имени через квадратные скобки: ЭтотОбъект[Реквизит.Имя] в серверном контексте модуля формы.

МассивРеквизитов = ЭтотОбъект.ПолучитьРеквизиты();
Для Каждого Реквизит Из МассивРеквизитов Цикл
    Значение = ЭтотОбъект[Реквизит.Имя];
    Сообщить(Реквизит.Имя + " = " + Строка(Значение));
КонецЦикла;

Получение реквизитов на клиенте и на сервере

Метод ПолучитьРеквизиты() доступен как в клиентском, так и в серверном контексте модуля формы. На клиенте обращение идёт через ЭтаФорма.ПолучитьРеквизиты(), на сервере внутри модуля формы — через ЭтотОбъект.ПолучитьРеквизиты(). Состав возвращаемых данных одинаков, но работа со значениями отличается.

На клиенте доступны не все типы значений. Например, значения ссылочных типов и таблиц значений могут быть представлены иначе, а часть реквизитов может быть недоступна для прямой модификации. Если задача — универсально обойти и обработать значения (например, выгрузить их в структуру), надёжнее выполнять это в серверной процедуре с директивой &НаСервере.

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

Отличие реквизитов формы от реквизитов объекта и элементов управления

Частая путаница у начинающих разработчиков — смешение трёх разных сущностей: реквизитов формы, реквизитов объекта метаданных и элементов управления (полей ввода, таблиц) на форме. Это не одно и то же, и методы их получения различаются.

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

Если задача — получить именно то, что видит пользователь на экране, обходить нужно коллекцию Элементы и по свойству ПутьКДанным находить связанные реквизиты. Если задача — получить все данные формы, достаточно ПолучитьРеквизиты().

Обход реквизитов с получением значений: практический пример

Рассмотрим прикладную задачу: собрать все реквизиты формы верхнего уровня вместе со значениями в структуру для последующей обработки. Код выполняется на сервере в модуле формы:

&НаСервере
Функция СобратьДанныеФормы()
Результат = Новый Структура;
Для Каждого Реквизит Из ЭтотОбъект.ПолучитьРеквизиты() Цикл
Попытка
Результат.Вставить(Реквизит.Имя, ЭтотОбъект[Реквизит.Имя]);
Исключение
// Реквизит содержит несериализуемый тип — пропускаем
КонецПопытки;
КонецЦикла;
Возврат Результат;
КонецФункции

Обратите внимание на конструкцию «Попытка/Исключение»: некоторые реквизиты содержат типы, которые нельзя поместить в структуру для передачи на клиент (например, «ДанныеФормыДерево» в определённых контекстах или хранилища значений со сложным содержимым). Без обработки исключения универсальный обход упадёт на первом же таком реквизите.

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

Как получить колонки таблиц и динамические реквизиты

Если форма содержит реквизит типа «ТаблицаЗначений» или «ДинамическийСписок», метод ПолучитьРеквизиты() вернёт только сам реквизит-коллекцию, но не её колонки. Для получения колонок таблицы значений на сервере используйте метод ПолучитьРеквизиты("ИмяТаблицы") — он вернёт массив подчинённых реквизитов, то есть колонок.

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

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

Проверка результата и отладка

Самый быстрый способ убедиться, что обход работает корректно, — вывести имена и типы реквизитов в окно сообщений или в файл. Сравните полученный список с деревом реквизитов в редакторе формы конфигуратора: панель «Реквизиты» в правой части редактора формы показывает именно то, что вернёт метод.

Для отладки удобно использовать «Табло» (окно вычисления выражений) в режиме предприятия при остановке в точке останова: выражение ЭтотОбъект.ПолучитьРеквизиты().Количество() покажет число реквизитов, а обращение к элементу массива по индексу — свойства конкретного реквизита.

Если ожидаемый реквизит отсутствует в результате, проверьте три вещи: не ищете ли вы его на другом уровне иерархии (нужен параметр «Путь»), не является ли искомое поле элементом управления без связи с данными, и не добавлен ли реквизит программно после момента вызова вашего кода.

Ограничения и безопасные границы самостоятельной работы

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

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

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

Частые вопросы