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

Другое · 6 мин

Получение значения реквизита объекта в 1С

Как получить значение реквизита объекта в 1С: через свойства объекта, метаданные, запросы и формы, с проверкой типа и контекста выполнения в 1С

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

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

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

Когда достаточно прямого обращения к объекту

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

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

Получение объекта по ссылке

Когда доступна только ссылка, например из табличной части или выбора справочника, применяется метод ПолучитьОбъект(). После этого к возвращённому объекту применяется обычное обращение к реквизиту. Это базовый сценарий для документов, справочников и перечислений.

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

Чтение в управляемой форме

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

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

Получение значения через запрос

Запрос подходит, когда нужно получить значения реквизитов у многих объектов одновременно или отфильтровать их по условиям. Указываются поля объекта в разделе «ВЫБРАТЬ», а источник — соответствующая таблица базы. Это работает быстрее, чем поштучное создание объектов.

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

Проверка типа и пустого значения

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

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

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

Ограничения и риски

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

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

Типичные ошибки
01
Обращение к реквизиту ссылки вместо полученного объекта
02
Чтение базы вместо несохранённых данных формы
03
Забывчивость проверки на пустую ссылку перед использованием

Типичные ошибки

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

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

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

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

Объект получен и не пуст
Норма

Реквизит доступен и имеет ожидаемый тип

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

Ошибка выполнения или неопределённое значение

Данные записаны в базу
Норма

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

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

В запросе старые данные, форма содержит несохранённые изменения

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

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

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

Итог

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

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

Можно ли читать реквизит напрямую из таблицы базы?

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

Почему значение из запроса отличается от значения в форме?

Запрос читает записанные в базе данные, а форма может содержать несохранённые изменения. Сравнивайте только после записи или читайте объект формы.

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

Проверьте, существует ли объект, не пустая ли ссылка, верно ли указано имя реквизита и доступен ли он в текущем контексте клиента или сервера.

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

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