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

Другое · 7 мин

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

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

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

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

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

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

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

Обратите внимание, что реквизиты могут быть обычными и табличными. Табличная часть документа имеет свой набор реквизитов строк, и наличие поля «Сумма» в шапке документа не означает наличие одноименного поля в табличной части. Проверяйте именно тот контекст, где планируете использовать значение.

Как проверить наличие реквизита через метаданные

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

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

bsl
Атрибут = Метаданные.Документы.ИмяДокумента.Реквизиты.Найти("ИмяРеквизита");
Если Атрибут = Неопределено Тогда
    // реквизита нет в конфигурации документа
Иначе
    // реквизит описан, можно планировать чтение значения
КонецЕсли;

Как безопасно проверить реквизит у экземпляра документа

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

В управляемом приложении реквизит формы и реквизит документа могут не совпадать. На форме поле может называться по-другому, быть скрытым или находиться в командной панели. Проверка `Элементы.ИмяРеквизита` говорит о наличии элемента управления на форме, а не о наличии атрибута документа в конфигурации.

Реквизит есть в конфигуратореДокумент поддерживает это поле на уровне метаданных

Проверьте вкладку Реквизиты объекта документа

Элемент есть на формеПоле отображается в интерфейсе

Не подтверждает наличие реквизита документа в конфигурации

Значение не заполненоРеквизит может существовать, но быть пустым

Проверяйте заполнение отдельно от наличия

Реквизит, свойство и табличная часть: в чем разница

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

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

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

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

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

Типичные ошибки
01
Проверка элемента формы вместо реквизита документа
02
Обращение к реквизиту табличной части как к реквизиту шапки
03
Пустое значение принимается за отсутствие реквизита

Типичные ошибки при проверке реквизитов

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

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

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

Быстрая проверка без программирования

Если вы не программист, откройте карточку документа в режиме работы и посмотрите, есть ли нужное поле в форме. Затем откройте документ в конфигураторе и проверьте вкладку «Реквизиты». Если поля нет ни там, ни здесь, вероятно, реквизита нет или он вынесен в регистр сведений или другой объект.

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

Итог

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

Наличие реквизита проверяйте через метаданные документа, а чтение значения у экземпляра оборачивайте в обработку ошибок. Реквизиты документа, формы и табличной части — разные сущности.

Нужно ли программирование для проверки реквизита?

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

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

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

Может ли реквизит быть на форме, но отсутствовать у документа?

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

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

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

Зависит ли проверка от прав пользователя?

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