К статье
Практический материал

Другое · 7 мин

Как проверить наличие поля объекта в 1С

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

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

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

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

Отличие поля конфигурации от свойства объекта

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

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

Когда важно различать эти понятия

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

Проверка через набор полей метаданных

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

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

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

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

Проверка свойства экземпляра через Попытку и Исключение

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

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

Ограничения метода Попытки

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

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

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

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

Особенности сервера, клиента и управляемых форм

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

Типичные ошибки
01
Обращение к свойству объекта без Попытки и Исключения приводит к остановке при отсутствии поля.
02
Проверка метаданных принимается за гарантию доступности свойства у конкретного экземпляра.

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

Частые ошибки и ограничения

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

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

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

Итог

Что важно запомнить

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

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

Можно ли проверить поле без открытия объекта?

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

Что делать, если поле есть в метаданных, но ошибка при записи?

Возможно, доступ запрещён правами, объект открыт только для чтения или поле находится в табличной части, а не в реквизитах объекта. Нужно проверить права и контекст доступа.

Различаются ли проверки для справочника и документа?

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

Безопасно ли добавлять поля в конфигурацию самостоятельно?

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