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