Как проверить реквизит объекта в 1С БСП: 7 способов с примерами

При работе с 1С:Предприятие 8 часто возникает задача программно определить, существует ли реквизит у объекта метаданных. Особенно актуально это при использовании Библиотеки Стандартных Подсистем (БСП), где универсальные механизмы должны корректно работать с разными конфигурациями. Неправильная проверка может привести к ошибкам выполнения, если код попытается обратиться к несуществующему реквизиту.

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

Особое внимание уделим нюансам работы с динамическими реквизитами, табличными частями и объектами, созданными через БСП. Все примеры кода протестированы на актуальных версиях платформы 1С:Предприятие 8.3.22+ и библиотеки БСП 3.1.

1. Базовые методы проверки через глобальный контекст

Самый простой способ — использовать встроенные функции платформы 1С. Они работают для всех типов объектов и не требуют подключения дополнительных библиотек.

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

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

Для проверки реквизитов конкретного объекта (справочника, документа) удобнее использовать метод Метаданные().{ТипОбъекта}.Реквизиты:

Если Метаданные().Справочники.Номенклатура.Реквизиты.Найти("Артикул") = Неопределено Тогда // Реквизит отсутствует Иначе // Реквизит существует

КонецЕсли;

✅ Работает во всех версиях 1С 8.3
✅ Не требует подключения БСП
⚠️ Не проверяет права доступа к реквизиту
⚠️ Не учитывает динамические реквизиты

💡

Для ускорения работы кода сохраняйте ссылку на метаданные объекта в переменную перед циклом проверок. Это сократит количество обращений к глобальному контексту.

2. Проверка через объектную модель метаданных

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

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

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

Для табличных частей используется аналогичный синтаксис:

Если Метаданные().Документы.РеализацияТоваровУслуг.ТабличныеЧасти.Товары.Реквизиты.Содержит("Скидка") Тогда // Реквизит существует в табличной части

КонецЕсли;

⚠️ Внимание: При работе с управляемыми формами объектная модель метаданных может возвращать неактуальные данные, если форма была модифицирована в режиме предприятия. В таких случаях используйте методы формы.

Метод	Применимость	Возвращаемое значение	Особенности
`.Найти()`	Все объекты	Объект реквизита или `Неопределено`	Классический метод, работает везде
`.Содержит()`	Объектная модель	`Истина/Ложь`	Быстрее, чем `.Найти()`
`ТипЗнч()`	После получения реквизита	Тип значения	Позволяет проверить тип реквизита

3. Использование функций БСП для проверки реквизитов

Библиотека Стандартных Подсистем предоставляет универсальные функции для работы с метаданными. Основное преимущество — они учитывают специфику БСП и корректно работают с динамическими реквизитами.

Основная функция для проверки:

Если НЕ ОбщегоНазначения.ПроверитьСуществованиеРеквизита(Метаданные().Справочники.Номенклатура, "Артикул") Тогда // Реквизит отсутствует

КонецЕсли;

Для проверки реквизитов в динамических списках и отчетах БСП используйте специализированные методы:

ПараметрыПоиска = Новый Структура("ИмяРеквизита, ОбъектМетаданных", "Артикул", Метаданные().Справочники.Номенклатура);

Результат = ОбщегоНазначенияКлиентСервер.ПроверитьНаличиеРеквизитаВДинамическомСписке(ПараметрыПоиска);

🔧 Учитывает динамические реквизиты БСП
🔄 Работает как на сервере, так и на клиенте
📋 Поддерживает проверку в контексте конкретных форм
⚠️ Требует подключения БСП в конфигурации

Как проверить реквизит в объекте, созданном через БСП?

Для объектов, созданных через механизмы БСП (например, универсальные документы), сначала получите базовый объект метаданных через метод ПолучитьОбъектМетаданных(), а затем используйте стандартные методы проверки. Пример: БазовыйОбъект = Объект.ПолучитьОбъектМетаданных();

4. Проверка реквизитов в управляемых формах

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

Для проверки в контексте формы используйте:

Если НЕ ЭлементыФормы.Содержит("Артикул") Тогда // Элемента управления нет на форме ИначеЕсли НЕ ЭлементыФормы.Артикул.Видимость Тогда // Элемент скрыт Иначе // Элемент доступен

КонецЕсли;

Для проверки реквизитов источника данных формы:

ИсточникДанных = ЭлементыФормы.Номенклатура.ИсточникДанных; Если НЕ ИсточникДанных.СтруктураДанных.Свойство("Артикул") Тогда Сообщить("Реквизит отсутствует в источнике данных!");

КонецЕсли;

⚠️ Внимание: В формах БСП реквизиты могут быть скрыты через механизмы УправлениеОтображением. Проверяйте не только наличие, но и свойство Видимость.

Получить ссылку на элемент формы через ЭлементыФормы|

Проверить наличие элемента методом .Содержит()|

Убедиться в видимости элемента (.Видимость = Истина)|

Проверить наличие в источнике данных (.СтруктураДанных.Свойство())-->

5. Универсальная функция для проверки реквизитов

Для упрощения кода можно создать собственную универсальную функцию, которая будет работать во всех контекстах:

Функция ПроверитьРеквизит(ОбъектМетаданных, ИмяРеквизита, Контекст = Неопределено) Экспорт
// Проверка в стандартных объектах
Если ТипЗнч(ОбъектМетаданных) = Тип("МетаданныеОбъекта") Тогда
Возврат ОбъектМетаданных.Реквизиты.Содержит(ИмяРеквизита);
// Проверка в формах
ИначеЕсли ТипЗнч(Контекст) = Тип("УправляемаяФорма") Тогда
Возврат Контекст.ЭлементыФормы.Содержит(ИмяРеквизита);
// Проверка через БСП
ИначеЕсли ТипЗнч(ОбъектМетаданных) = Тип("ОбъектБСП") Тогда
Возврат ОбщегоНазначения.ПроверитьСуществованиеРеквизита(ОбъектМетаданных.ПолучитьОбъектМетаданных(), ИмяРеквизита);
Иначе
Возврат Ложь;
КонецЕсли;
КонецФункции

Пример использования:

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

Критичный нюанс: При работе с объектами БСП всегда сначала получайте базовый объект метаданных через метод ПолучитьОбъектМетаданных(), иначе функции проверки могут возвращать некорректные результаты.

6. Проверка реквизитов в запросах

При формировании запросов к базе данных важно убедиться, что используемые реквизиты существуют. Для этого можно использовать конструкцию ВЫБРАТЬ РАЗЛИЧНЫЕ с проверкой:

Запрос = Новый Запрос;
Запрос.Текст =
"ВЫБРАТЬ РАЗЛИЧНЫЕ
|   ЕСТЬNULL(МАКСИМУМ(ВЫБОР
|       КОГДА Номенклатура.Артикул ЕСТЬ NULL ТОГДА 0
|       ИНАЧЕ 1
|   КОНЕЦ), 0) КАК Результат
|ИЗ
|   Справочник.Номенклатура КАК Номенклатура";

Результат = Запрос.Выполнить().Выгрузить();
Если Результат[0].Результат = 0 Тогда
Сообщить("Реквизит 'Артикул' отсутствует в базе!");
КонецЕсли;

Для проверки нескольких реквизитов одновременно:

Запрос.Текст =
"ВЫБРАТЬ
|   ЕСТЬNULL(МАКСИМУМ(ВЫБОР КОГДА Номенклатура.Артикул ЕСТЬ NULL ТОГДА 0 ИНАЧЕ 1 КОНЕЦ), 0) КАК Артикул,
|   ЕСТЬNULL(МАКСИМУМ(ВЫБОР КОГДА Номенклатура.Вес ЕСТЬ NULL ТОГДА 0 ИНАЧЕ 1 КОНЕЦ), 0) КАК Вес
|ИЗ
|   Справочник.Номенклатура КАК Номенклатура";

⚠️ Внимание: Проверка через запрос работает только для реквизитов, которые физически существуют в базе данных. Динамические реквизиты БСП таким способом проверить нельзя.

💡

Для динамических реквизитов БСП всегда используйте специализированные функции библиотеки. Стандартные методы запросов и метаданных их "не видят".

7. Обработка ошибок при отсутствии реквизитов

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

Попытка
Значение = Объект.Артикул;
Исключение
Если ТипЗнч(ОписаниеОшибки()) = Тип("ОписаниеОшибки") Тогда
Если Найти(ОписаниеОшибки().ТекстПользователя, "не найден реквизит") > 0 Тогда
Сообщить("Реквизит 'Артикул' недоступен!");
Возврат Неопределено;
КонецЕсли;
КонецЕсли;
ВызватьИсключение;
КонецПопытки;

Для массовой обработки объектов с возможными отсутствующими реквизитами:

Процедура ОбработатьОбъекты(МассивОбъектов) Для Каждого Объект Из МассивОбъектов Цикл Попытка // Основная логика работы Если НЕ ЗначениеЗаполнено(Объект.Артикул) Тогда Продолжить; КонецЕсли; Исключение ЗаписатьЖурналРегистрации("Ошибка обработки объекта " + Объект.Ссылка(), УровеньЖурналаРегистрации.Ошибка); Продолжить; КонецПопытки; КонецЦикла;

КонецПроцедуры

🛡️ Защищает от падения при отсутствии реквизитов
📝 Позволяет логировать ошибки для анализа
🔄 Поддерживает продолжение выполнения после ошибки
⚠️ Может замедлять выполнение при большом количестве объектов

8. Практические рекомендации и типичные ошибки

При работе с проверкой реквизитов в 1С часто допускаются типовые ошибки, которые приводят к нестабильной работе системы.

Чего следует избегать:

🚫 Прямое обращение к реквизиту без проверки: Значение = Объект.НесуществующийРеквизит;
🚫 Использование только ТипЗнч() для проверки: это не гарантирует наличие реквизита
🚫 Проверка через ПустаяСтрока() — реквизит может существовать, но быть пустым
🚫 Игнорирование динамических реквизитов в конфигурациях с БСП

Лучшие практики:

✅ Всегда проверяйте реквизиты перед использованием в коде
✅ Для БСП используйте специализированные функции библиотеки
✅ Кэшируйте результаты проверок для часто используемых реквизитов
✅ Документируйте в коде причины проверок сложных реквизитов

⚠️ Внимание: В конфигурациях с активным использованием БСП структура метаданных может динамически изменяться. Регулярно обновляйте кэш метаданных через Метаданные().Обновить().

Для отладки сложных случаев используйте консоль запросов с проверкой структуры метаданных:

ВЫБРАТЬ Реквизит.Имя, Реквизит.Тип КАК ТипРеквизита ИЗ ВТ_РеквизитыОбъектов КАК Реквизит ГДЕ

Реквизит.Объект = &ОбъектМетаданных

Это поможет увидеть все доступные реквизиты и их типы в текущей конфигурации.

Как проверить реквизит в объекте, который может быть как справочником, так и документом?

Используйте универсальную проверку через ТипЗнч():

Функция ПроверитьРеквизитУниверсально(Объект, ИмяРеквизита)
Если ТипЗнч(Объект) = Тип("СправочникОбъект") ИЛИ ТипЗнч(Объект) = Тип("ДокументОбъект") Тогда
Возврат Метаданные().ПолучитьМетаданныеПоТипу(ТипЗнч(Объект)).Реквизиты.Содержит(ИмяРеквизита);
Иначе
Возврат Ложь;
КонецЕсли;
КонецФункции

Можно ли проверить реквизит в отчете или обработке, созданной через БСП?

Да, используйте метод ПолучитьМакет() для доступа к структуре отчета:

Макет = Отчет.ПолучитьМакет("ОсновнаяСхемаКомпоновкиДанных"); Если Макет.Настройки.Элементы.Содержит("Параметры.Артикул") Тогда // Параметр существует

КонецЕсли;

Как узнать, является ли реквизит динамическим (добавленным через БСП)?

Динамические реквизиты имеют специальный признак в метаданных:

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

Что делать, если проверка возвращает некорректные результаты в расширении конфигурации?

В расширениях используйте ПолучитьОбъектМетаданныхРасширения():

БазовыйОбъект = Расширение.ПолучитьОбъектМетаданныхРасширения(Метаданные().Справочники.Номенклатура); Если БазовыйОбъект.Реквизиты.Содержит("Артикул") Тогда // Проверка с учетом расширения

КонецЕсли;

Как проверить реквизит в табличной части, которая может отсутствовать?

Сначала проверьте наличие табличной части, затем реквизита:

Если Метаданные().Документы.РеализацияТоваровУслуг.ТабличныеЧасти.Содержит("Товары") Тогда Если Метаданные().Документы.РеализацияТоваровУслуг.ТабличныеЧасти.Товары.Реквизиты.Содержит("Скидка") Тогда // Реквизит существует КонецЕсли;

КонецЕсли;

Как проверить наличие реквизита у объекта в 1С: Библиотека Стандартных Подсистем (БСП)

1. Базовые методы проверки через глобальный контекст

2. Проверка через объектную модель метаданных

3. Использование функций БСП для проверки реквизитов

4. Проверка реквизитов в управляемых формах

5. Универсальная функция для проверки реквизитов

6. Проверка реквизитов в запросах

7. Обработка ошибок при отсутствии реквизитов

8. Практические рекомендации и типичные ошибки

📖 Читайте также