Как проверить, существует ли реквизит в 1С: все способы от кода до интерфейса

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

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

1. Проверка через конфигуратор (без программирования)

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

Как это сделать:

• 🔹 Откройте конфигуратор в режиме 1С:Предприятие (с правами администратора).
• 🔹 Перейдите в дерево метаданных: Объекты → [Тип объекта] → [Конкретный объект] (например, Справочники → Номенклатура).
• 🔹 Разверните ветку Реквизиты — здесь отображаются все стандартные и пользовательские поля.
• 🔹 Для детальной информации дважды кликните на реквизит — откроется окно свойств.

Этот метод не требует знаний кода, но имеет ограничения:

• 🚫 Не подходит для динамической проверки в runtime (например, при выполнении обработки).
• 🚫 Не показывает реквизиты, добавленные через расширения или внешние обработки.
• 🚫 Не отображает виртуальные реквизиты (например, созданные через ДополнительныеОтборыИПоля).

2. Метод Метаданные().Реквизиты (универсальный программный способ)

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

Пример кода для проверки реквизита "Артикул" в справочнике "Номенклатура":

Метаданные = Метаданные().Справочники.Номенклатура.Реквизиты;
Если Метаданные.Найти("Артикул") <> Неопределено Тогда
Сообщить("Реквизит 'Артикул' существует!");
Иначе
Сообщить("Реквизит не найден!");
КонецЕсли;

Разберем ключевые моменты:

• 🔹 Метаданные() — глобальный объект, дающий доступ ко всей структуре конфигурации.
• 🔹 .Найти("ИмяРеквизита") — ищет реквизит по имени. Если не найден, возвращает Неопределено.
• 🔹 Работает и для табличных частей (например, Метаданные().Документы.ЗаказПокупателя.ТабличныеЧасти.Товары.Реквизиты).

3. Функция ЭтоРеквизитОбъекта() (для динамического контроля)

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

Синтаксис:

Если ЭтоРеквизитОбъекта(Объект, "ИмяРеквизита") Тогда
// Действия, если реквизит есть
КонецЕсли;

Пример для документа "РеализацияТоваровУслуг":

Док = Документы.РеализацияТоваровУслуг.СоздатьДокумент();
Если ЭтоРеквизитОбъекта(Док, "Комментарий") Тогда
Док.Комментарий = "Тестовая поставка";
КонецЕсли;

Особенности метода:

4. Проверка через ОписаниеТипов (для сложных структур)

Когда работаете с динамическими структурами (например, данные из JSON, XML или внешних систем), полезно использовать объект ОписаниеТипов. Он позволяет не только проверить наличие реквизита, но и уточнить его тип.

Пример для справочника "Контрагенты":

ТипОбъекта = Тип("СправочникОбъект.Контрагенты");
Описание = Новый ОписаниеТипов(ТипОбъекта);

Если Описание.Свойства.Найти("ИНН") <> Неопределено Тогда
Сообщить("Реквизит 'ИНН' существует. Тип: " + Описание.Свойства.ИНН.Тип.ИмяТипа);
КонецЕсли;

Когда это актуально:

• 🔹 При интеграции с REST API или веб-сервисами, когда структура данных заранее неизвестна.
• 🔹 При работе с расширяемыми объектами (например, когда реквизиты добавляются динамически через код).
• 🔹 Для отладки обменов данными между базами 1С.

5. Проверка реквизитов табличных частей

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

Пример для табличной части "Товары" в документе "ЗаказПокупателя":

Док = Документы.ЗаказПокупателя.СоздатьДокумент();
ТабличнаяЧасть = Док.Товары;

Если ТабличнаяЧасть.Колонки.Найти("ЦенаЗаЕдиницу") <> Неопределено Тогда
Сообщить("Колонка 'ЦенаЗаЕдиницу' существует!");
Иначе
Сообщить("Колонка отсутствует!");
КонецЕсли;

Важные нюансы:

• 🔹 Для табличных частей не работает метод Метаданные().Реквизиты — нужно использовать ТабличнаяЧасть.Колонки.
• 🔹 Колонки могут быть динамическими (добавлены через ДобавитьКолонку() в коде). Такие колонки не видны в метаданных, но доступны через Колонки.
• 🔹 Для проверки реквизитов строк табличной части используйте ТабличнаяЧасть.Колонки.Найти("Имя").

Убедиться, что табличная часть существует|Использовать коллекцию .Колонки|Проверить наличие через .Найти("Имя")|Учесть динамически добавленные колонки-->

6. Ошибки и ловушки при проверке реквизитов

Даже опытные разработчики сталкиваются с неочевидными проблемами при работе с реквизитами. Вот типичные подводные камни:

⚠️ Ловушка 1: Регистрозависимость имен

В 1С имена реквизитов чувствительны к регистру. Например, Метаданные().Найти("артикул") не найдет реквизит "Артикул". Всегда используйте точный регистр, как в конфигураторе.

⚠️ Ловушка 2: Реквизиты с одинаковыми именами в разных объектах

Если реквизит "Комментарий" есть и в справочнике "Контрагенты", и в документе "Заказ", проверяйте его существование в контексте конкретного объекта. Иначе можно получить ложноположительный результат.

⚠️ Ловушка 3: Виртуальные реквизиты

Реквизиты, созданные через ДополнительныеОтборыИПоля или ВычисляемыеПоля, не отображаются в стандартных методах проверки. Для них нужно использовать специализированные функции, например:

Если Док.ДополнительныеПоля.Найти("Скидка") <> Неопределено Тогда
// Работа с виртуальным полем
КонецЕсли;

Тогда при изменении имени достаточно поправить его в одном месте.-->

FAQ: Частые вопросы о проверке реквизитов в 1С

Если Форма.ЭлементыФормы.Найти("ПолеАртикул") <> Неопределено Тогда
Сообщить("Поле найдено на форме!");
КонецЕсли;

Метаданные = Метаданные().РегистрыСведений.ЦеныНоменклатуры.Реквизиты;
Если Метаданные.Найти("Валюта") <> Неопределено Тогда
Сообщить("Реквизит существует!");
КонецЕсли;

Элемент = Форма.Элементы.Найти("ПолеЦены");
Если Элемент <> Неопределено Тогда
Путь = Элемент.ПутьКДанным; // Например, "Объект.Товары.Цена"
КонецЕсли;