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

Другое · 6 мин

Получение значения дополнительного реквизита в 1С 8.3 программно

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

Дополнительные реквизиты в 1С 8.3 относятся к данным, которые не являются частью основной структуры объекта, но могут быть привязаны к справочникам, документам, контрагентам или другим сущностям. Их значение существует только для конкретного экземпляра объекта, поэтому попытка прочитать реквизит «в общем» без указания документа или элемента справочника обычно не имеет смысла.

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

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

Откуда берутся значения дополнительных реквизитов

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

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

Объект загружен в памятьМожно обращаться к реквизитам и свойствам

Проверьте, что документ или элемент справочника получен через запрос или выборку

Реквизит зарегистрирован для вида объектаЧтение возможно без дополнительных настроек

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

Значение пустоеРеквизит существует, но не заполнен

Проверьте заполнение в карточке объекта перед программным чтением

Как выбрать объект и контекст для чтения

Нужно явно указать, у какого экземпляра читается значение: документ по номеру и дате, элемент справочника по коду или контрагент по ИНН. Без этого контекста программа не будет знать, чье значение требуется вернуть.

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

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

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

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

Порядок действий
  1. 1
    Загрузить объект документа, справочника или другой сущности
  2. 2
    Убедиться, что объект поддерживает дополнительные реквизиты
  3. 3
    Обратиться к реквизиту по имени и получить значение
  4. 4
    Проверить, что значение не пустое и соответствует ожидаемому типу

Чтение через свойства и общие механизмы

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

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

Типичные ошибки
01
Чтение реквизита без загрузки объекта: программа не знает, у какого экземпляра брать значение
02
Обращение по несуществующему имени реквизита: возникает ошибка или возвращается пустота
03
Принятие пустого значения за неисправность: реквизит может быть просто не заполнен

Проверка результата и границы безопасной работы

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

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

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

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

Значение в программе совпадает с карточкой объекта
Норма

Чтение работает корректно

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

Значение пустое или отличается от интерфейса

Объект поддерживает дополнительные реквизиты
Норма

Доступ к реквизиту возможен

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

Альтернативы и когда обращаться к разработчику

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

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

Итог

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

Читайте значение только у загруженного объекта, проверяйте поддержку реквизита и не путайте пустое значение с ошибкой.

Нужно ли загружать объект перед чтением дополнительного реквизита?

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

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

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

Можно ли читать дополнительные реквизиты у любого справочника?

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

Безопасно ли изменять значения дополнительных реквизитов программно?

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