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

Другое · 7 мин

Проверка существования поля (реквизита) в 1C

Как проверить существование поля (реквизита) в 1C: способы через метаданные, запросы и форму отчёта, ограничения и частые ошибки при самостоятельной настройке.

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

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

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

Что понимать под существованием поля в 1C

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

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

Где искать реквизит в конфигураторе

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

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

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

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

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

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

Проверка при выполнении запроса

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

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

Сравнение вариантов

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

Подходит для ручной проверки и обучения, не требует выполнения кода, но не показывает физическую доступность в базе

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

Удобно для обработок и отчётов, требует аккуратности с именами и регистром

Проверка через выполнение запроса

Быстро выявляет отсутствие поля, но может вызвать ошибку и прервать работу

Отличие поля конфигурации и колонки таблицы базы

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

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

Ограничения и риски самостоятельной проверки

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

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

Типичные ошибки
01
Путаница между синонимом и программным именем реквизита, обращение к полю без обновления конфигурации базы, прямое изменение таблиц базы без понимания структуры 1C

Частые ошибки и что делать если поля нет

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

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

Контрольные точки

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

Открытие объекта в конфигураторе
Норма

Реквизит виден в коллекции реквизитов объекта

Тревожный признак

Реквизита нет в списке или имя отличается

Тестовый запрос или форма
Норма

Выполняется без ошибки и возвращает значения

Тревожный признак

Ошибка при компиляции или выполнении запроса

Обновление конфигурации базы
Норма

Новые реквизиты доступны после обновления

Тревожный признак

Поле есть в конфигураторе, но недоступно в базе

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

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

Если запрос выполняется, но возвращает пустые значения, это не означает отсутствие поля: возможны права доступа, отбор, пустой период или отсутствие данных. Разделяйте отсутствие поля и отсутствие данных по полю.

Итог

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

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

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

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

Можно ли проверить поле через пустой результат запроса?

Нет, пустой результат не доказывает отсутствие поля: данные могут быть отсутствовать из-за отбора, прав или пустого периода. Отсутствие поля проявляется ошибкой при обращении к несуществующему имени.

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

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

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

Не рекомендуется: прямое изменение таблиц может нарушить целостность данных, привести к ошибкам в отчётах и затруднить поддержку. Изменения структуры лучше вносить через конфигурацию 1C.