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

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

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

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

Что такое реквизит формы и чем он отличается от элемента

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

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

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

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

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

Типовой пример перебора выглядит так:

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

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

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

Анализ вложенных данных и табличных частей

Для табличных частей объекта путь строится через основной реквизит: ПолучитьРеквизиты("Объект.Товары") вернёт колонки табличной части «Товары» редактируемого документа. Для динамических списков и деревьев значений подход аналогичный — указывается путь к реквизиту-контейнеру.

Универсальная процедура обхода всех реквизитов с учётом вложенности выглядит так:

&НаСервере
Процедура ОбойтиРеквизиты(Путь = "")
    Для Каждого Реквизит Из ПолучитьРеквизиты(Путь) Цикл
        ПолныйПуть = ?(Путь = "", Реквизит.Имя, Путь + "." + Реквизит.Имя);
        Сообщить(ПолныйПуть + " : " + Строка(Реквизит.ТипЗначения));
        Если Реквизит.ТипЗначения.СодержитТип(Тип("ДанныеФормыКоллекция")) Тогда
            ОбойтиРеквизиты(ПолныйПуть);
        КонецЕсли;
    КонецЦикла;
КонецПроцедуры

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

Получение реквизитов через элементы формы

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

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

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

Какой способ выбрать в разных ситуациях

Выбор метода зависит от цели анализа и места выполнения кода. Для отладки и разовой диагностики удобнее всего конфигуратор: панель «Реквизиты» в редакторе формы показывает полный состав с типами без написания кода. Для программной обработки внутри формы — ПолучитьРеквизиты(). Для анализа интерфейса — перебор элементов.

Если форма создана динамически или изменена кодом через ИзменитьРеквизиты(), актуальный состав известен только в момент выполнения — конфигуратор покажет лишь исходное состояние. Это ещё один аргумент в пользу программного получения списка.

Типичные ошибки и ограничения

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

Отдельное ограничение касается тонкого клиента: реквизиты, у которых в конфигураторе снят флаг использования на клиенте, в клиентском контексте недоступны, хотя в списке реквизитов присутствуют. Обращение к их значениям на клиенте вызовет ошибку, поэтому обработку таких данных выполняют в серверных процедурах.

Проверка результата и практические приёмы

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

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

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