Другое · 6 мин
Как проверить есть ли реквизит в документе 1С
Практическая инструкция: как узнать, есть ли реквизит в документе 1С, где искать в конфигураторе и как проверить через модуль или форму.
Реквизит документа в 1С — это свойство объекта документа, которое хранит значение: контрагент, договор, сумма, дата и т. п. Перед тем как использовать реквизит в модуле, отчете или обработке, нужно убедиться, что он действительно существует в конфигурации этого документа.
Важно разделять три уровня: реквизит самого объекта документа, реквизит формы документа и реквизит строки табличной части. Наличие поля в конфигураторе не всегда означает, что оно доступно в текущей форме или в выбранном контексте выполнения.
Проверка может потребоваться при доработке типовой конфигурации, написании внешней обработки, переносе данных или отладке модуля документа. Ниже описаны способы проверки без риска для рабочей базы.
Что считать реквизитом документа
Реквизит объекта документа хранится в самой структуре документа и доступен в модуле объекта через контекст Объект. Такие реквизиты видны в конфигураторе в редакторе документа на вкладке «Реквизиты».
Реквизит формы документа
Реквизит формы существует только в интерфейсе и может не совпадать с реквизитом объекта. Он добавляется в редакторе формы и используется для отображения, ввода или временных вычислений. Если реквизит есть в объекте, но нет на форме, пользователь его не увидит.
Реквизит табличной части
Реквизиты строк табличной части проверяются отдельно от реквизитов заголовка документа. Поле может быть в строке табличной части, но отсутствовать в шапке документа, и наоборот.
Где искать реквизит в конфигураторе
Откройте конфигуратор, найдите нужный документ в дереве метаданных и откройте его редактор. На вкладке «Реквизиты» отображается список реквизитов объекта документа. Для табличных частей откройте соответствующую табличную часть и проверьте её вкладку «Реквизиты». Для формы перейдите к редактору формы и посмотрите элементы и реквизиты формы.
- 1Найдите документ в дереве конфигурации и откройте его редактор.
- 2Перейдите на вкладку «Реквизиты» и найдите нужное имя в списке.
- 3Для табличной части откройте её редактор и проверьте вкладку «Реквизиты».
- 4Для формы откройте редактор формы и проверьте реквизиты и элементы формы.
Если имя не найдено ни на одной из этих вкладок, реквизита с таким именем в данном документе нет. Может существовать реквизит с похожим названием, но другой орфографией или регистром.
В конфигураторе также можно использовать поиск по метаданным, чтобы найти все документы, содержащие реквизит с заданным именем. Это полезно при анализе типовых решений и при поиске дублей.
Как проверить реквизит программно
В модуле объекта документа безопаснее не обращаться к реквизиту напрямую, а сначала убедиться в его наличии через метаданные. Например, можно проверить коллекцию реквизитов объекта на наличие элемента с нужным именем перед обращением к значению.
Если проверка не выполнена, а в коде написано обращение к отсутствующему реквизиту, платформа может выдать ошибку на этапе выполнения. Это особенно критично для универсальных обработок, которые работают с разными документами.
Также учитывайте, что реквизит может быть заполнен только при определенных условиях: после проведения документа, при выборе вида операции или в определенном периоде. Отсутствие значения не всегда означает отсутствие реквизита.
Проверка в форме документа
В форме документа реквизит может быть представлен как элемент управления, поле ввода или скрытый атрибут. Чтобы проверить его наличие, используйте поиск по элементам формы или реквизитам формы в зависимости от того, где он объявлен.
Если реквизит есть в объекте, но не отображается на форме, его можно добавить через редактор формы, при условии что у вас есть права на изменение конфигурации и это не нарушает правила обновления типовых решений.
Еще одна частая ошибка — считать, что отсутствие значения в документе означает отсутствие реквизита. Поле может быть пустым, но существовать в конфигурации. Проверка значения и проверка наличия реквизита — разные задачи.
Не пытайтесь проверить наличие реквизита через открытие документа в пользовательском режиме, если интерфейс не показывает все поля. Некоторые реквизиты могут быть скрыты настройками формы или правами.
Как проверить результат
Реквизит существует в метаданных документа
Имя отсутствует в списке реквизитов объекта, формы или табличной части
Код выполняется без ошибки и возвращает значение
Платформа выдает ошибку «Поле не найдено» или аналогичное
Ограничения и безопасная работа
Не все реквизиты можно свободно использовать в вычислениях. Некоторые являются системными, служебными или заполняются только в определенных режимах. Перед изменением логики документа изучите назначение реквизита и возможные зависимости.
Если документ входит в типовую конфигурацию, добавление собственных реквизитов может усложнить обновление. Предпочитайте регистры сведений, дополнительные реквизиты или внешние обработки, если это допускается логикой учета.
Что важно запомнить
Проверяйте реквизит в конфигураторе, различайте объект, форму и табличную часть, избегайте прямого обращения к несуществующему полю и тестируйте изменения отдельно от рабочей базы.
Нужно ли проверять реквизит перед каждым обращением в коде?
Если код написан для конкретного документа, в котором реквизит точно есть, можно обращаться напрямую. Для универсальных модулей и внешних обработок лучше предварительно проверить наличие реквизита через метаданные.
Что делать, если реквизит есть в объекте, но отсутствует на форме?
Добавьте его на форму через редактор формы или настройте отображение существующего элемента. Если прав на изменение конфигурации нет, обратитесь к администратору или используйте отчеты и обработки для работы с данными.
Может ли реквизит быть в метаданных, но недоступен пользователю?
Да. Доступ может ограничиваться правами, ролями, настройками интерфейса или состоянием документа. Наличие в метаданных означает только то, что реквизит определен в конфигурации.
В чем разница между отсутствием реквизита и пустым значением?
Отсутствие реквизита означает, что такого поля нет в конфигурации документа. Пустое значение означает, что реквизит существует, но в конкретном документе не заполнен. Эти ситуации требуют разных способов проверки.