Как узнать, есть ли реквизит у документа 1С

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

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

Проверка реквизита в конфигураторе

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

Табличные части проверяются отдельно: реквизиты табличной части находятся внутри узла «Табличные части» в соответствующей ветке. Частая ошибка — искать реквизит табличной части в общем списке реквизитов документа и делать вывод, что его нет.

Удобный приём — открыть палитру свойств документа и воспользоваться поиском по дереву конфигурации (Ctrl+F в окне конфигурации). Если реквизит добавлен расширением, он отображается в дереве расширения, а не основной конфигурации, и это тоже нужно учитывать при поиске.

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

Основной программный способ — обращение к объекту метаданных документа. Коллекция Реквизиты имеет метод Найти(), который возвращает описание реквизита или Неопределено, если реквизита нет.

Функция ЕстьРеквизитДокумента(ДокументОбъект, ИмяРеквизита)

МетаданныеДокумента = ДокументОбъект.Метаданные();
Возврат МетаданныеДокумента.Реквизиты.Найти(ИмяРеквизита) <> Неопределено;

КонецФункции

Функция универсальна: её можно вызывать для любого документа, передавая объект или получая метаданные по ссылке — ДокументСсылка.Метаданные() работает так же. Это позволяет проверять реквизиты без открытия объекта, что быстрее и безопаснее по блокировкам.

Если Документ.Метаданные().Реквизиты.Найти("Комментарий") <> Неопределено Тогда
    Документ.Комментарий = "Заполнено программно";
КонецЕсли;

Если нужно проверить реквизит по имени вида документа без ссылки, используйте менеджер: Метаданные.Документы.Найти(\"РеализацияТоваровУслуг\").Реквизиты.Найти(\"ИмяРеквизита\"). Этот вариант подходит, когда проверка выполняется до создания или получения самого документа.

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

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

МетаданныеДокумента = Документ.Метаданные();
ТабличнаяЧасть = МетаданныеДокумента.ТабличныеЧасти.Найти("Товары");

Если ТабличнаяЧасть <> Неопределено Тогда
ЕстьРеквизит = ТабличнаяЧасть.Реквизиты.Найти("Скидка") <> Неопределено;
КонецЕсли;

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

Стандартные реквизиты и невидимые поля

Коллекция Реквизиты не содержит стандартные реквизиты документа: «Номер», «Дата», «Проведен», «Ссылка» и другие. Они перечислены в коллекции СтандартныеРеквизиты. Если нужно проверить наличие любого поля, включая стандартные, проверяйте обе коллекции.

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

Альтернатива: обращение через попытку

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

Использовать «Попытку» оправдано лишь в редких случаях — например, когда проверяется доступность свойства у произвольного объекта неизвестного типа. Для документов проверка через метаданные предпочтительнее всегда.

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

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

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

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