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

Проверка наличия реквизита формы — типовая задача при доработке конфигураций 1С:Предприятие. Она встречается, когда код должен работать с разными формами, когда реквизит добавляется программно и нужно избежать дублирования, либо когда модуль пишется универсально и не может опираться на жёстко заданную структуру формы. Попытка обратиться к несуществующему реквизиту вызывает ошибку «Поле объекта не обнаружено», поэтому проверка перед обращением — обязательный элемент надёжного кода.

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

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

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

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

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

Проверка в управляемой форме через ПолучитьРеквизиты()

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

Типовой фрагмент кода в модуле формы:

Функция ЕстьРеквизитФормы(Форма, ИмяРеквизита)
    РеквизитыФормы = Форма.ПолучитьРеквизиты();
    Для Каждого Реквизит Из РеквизитыФормы Цикл
        Если Реквизит.Имя = ИмяРеквизита Тогда
            Возврат Истина;
        КонецЕсли;
    КонецЦикла;
    Возврат Ложь;
КонецФункции

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

Обратите внимание: метод доступен только в контексте формы. Вызвать его из общего модуля можно, передав форму как параметр, но только если общий модуль выполняется на сервере с возможностью вызова сервера, а форма сериализуема в данные формы — на практике это работает в серверных процедурах формы и в модулях с установленными флагами «Сервер» и «Вызов сервера».

Проверка через обращение к свойству и обработку исключения

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

Пример:

Функция ЕстьРеквизитПоИмени(Форма, ИмяРеквизита)
    Попытка
        ЗначениеПроверки = Форма[ИмяРеквизита];
        Возврат Истина;
    Исключение
        Возврат Ложь;
    КонецПопытки;
КонецФункции

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

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

Если задача — узнать, есть ли реквизит у документа или справочника, данные которого редактирует форма, правильный инструмент — метаданные. Проверка выполняется на сервере и не зависит от того, открыта форма или нет.

Типовой код в общем серверном модуле:

Функция ЕстьРеквизитОбъекта(ИмяРеквизита, ОбъектМетаданных)
    Возврат ОбъектМетаданных.Реквизиты.Найти(ИмяРеквизита) <> Неопределено;
КонецФункции

// Вызов из формы:
// ЕстьРеквизит = ЕстьРеквизитОбъекта("Комментарий", Объект.Ссылка.Метаданные());

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

Для табличных частей проверка строится аналогично, но коллекция берётся на уровень глубже: ОбъектМетаданных.ТабличныеЧасти.Найти("Товары").Реквизиты.Найти("Цена"). Перед обращением к табличной части тоже стоит проверить её существование, иначе получите ошибку обращения к свойству Неопределено.

Проверка перед программным добавлением реквизита

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

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

1. 1
   Вызвать ПолучитьРеквизиты() и проверить, что имени нет в коллекции
2. 2
   Создать объект РеквизитФормы с именем, типом и путём
3. 3
   Передать массив добавляемых реквизитов в ИзменитьРеквизиты()
4. 4
   Повторно получить список реквизитов и убедиться, что новый реквизит присутствует
5. 5
   При необходимости добавить связанный элемент формы и привязать его к реквизиту

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

Обычные формы: как проверить реквизит там

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

Практические варианты: проверка через метаданные объекта (если речь о реквизитах документа или справочника), обращение через Вычислить() или Попытка/Исключение, либо опора на соглашения об именовании, когда состав реквизитов известен заранее. В большинстве случаев для обычных форм достаточно проверки через метаданные, поскольку динамическое добавление реквизитов там практически не используется.

Типичные ошибки и как их избежать

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

Вторая ошибка — проверка реквизита верхнего уровня, когда нужна колонка таблицы. Реквизит «Товары» существует, а обращение к колонке «Склад» падает с ошибкой, потому что колонку никто не проверял. Для таблиц значений и динамических списков проверяйте состав колонок отдельно: у таблицы значений — через Колонки.Найти(), у реквизита формы табличного типа — через ПолучитьРеквизиты("ИмяТаблицы").

Третья ошибка — вызов проверки в неподходящем контексте. Клиентская процедура пытается вызвать серверный метод, серверная процедура без контекста обращается к форме напрямую — всё это даёт ошибки компиляции или выполнения, которые маскируются под «реквизит не найден». Следите за директивами компиляции и передавайте форму параметром туда, где это допустимо.

Как проверить результат и организовать отладку

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

Для реквизитов объекта аналогичный приём — вывод коллекции Метаданные().Реквизиты. Это помогает, когда проверка «не находит» реквизит, который в конфигураторе виден: частая причина в том, что реквизит относится к табличной части или является стандартным реквизитом, который лежит в другой коллекции (СтандартныеРеквизиты).

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

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