Как получить значение объекта в 1С

Получение значения объекта — базовая операция во встроенном языке 1С:Предприятие. Под «объектом» здесь понимается либо объект конфигурации (справочник, документ, план счетов), либо переменная сложного типа — структура, таблица значений, результат запроса. В зависимости от того, что именно нужно прочитать, применяются разные подходы: обращение через точку, метод ПолучитьОбъект(), запрос или функции работы с коллекциями.

Главное, что нужно понимать перед написанием кода: в 1С существует принципиальная разница между ссылкой на объект базы данных и объектом как редактируемой сущностью. Через ссылку можно только читать данные, а для изменения требуется получить объект методом ПолучитьОбъект(). Путаница между этими понятиями — источник большинства ошибок начинающих разработчиков.

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

Чтение значения реквизита через ссылку

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

Контрагент = Справочники.Контрагенты.НайтиПоКоду("000000123");
Наименование = Контрагент.Наименование;
ИНН = Контрагент.ИНН;

Такое обращение работает для ссылок на справочники, документы, планы видов характеристик, планы счетов и другие ссылочные типы. Стандартные реквизиты (Код, Наименование, Дата, Номер) доступны всегда, прикладные реквизиты — если они добавлены в конфигурацию.

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

Получение объекта методом ПолучитьОбъект()

Когда требуется не только прочитать, но и изменить данные, используется метод ПолучитьОбъект(). Он загружает объект целиком — со всеми реквизитами и табличными частями — в оперативную память:

ДокументСсылка = Документы.РеализацияТоваровУслуг.НайтиПоНомеру("0001", ТекущаяДатаСеанса());
ДокументОбъект = ДокументСсылка.ПолучитьОбъект();
ДокументОбъект.Комментарий = "Проверен";
ДокументОбъект.Записать();

После изменения реквизитов объект обязательно записывается методом Записать(). Без вызова записи все изменения останутся только в памяти и будут потеряны при завершении процедуры.

Метод ПолучитьОбъект() — ресурсоёмкая операция. Не используйте его в циклах для простого чтения данных: если нужно только посмотреть значения, применяйте запрос. Неоправданное получение объектов в цикле — одна из главных причин медленной работы обработок.

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

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

Запрос = Новый Запрос;
Запрос.Текст =
"ВЫБРАТЬ
|	Контрагенты.Наименование,
|	Контрагенты.ИНН
|ИЗ
|	Справочник.Контрагенты КАК Контрагенты
|ГДЕ
|	Контрагенты.Ссылка = &Ссылка";
Запрос.УстановитьПараметр("Ссылка", КонтрагентСсылка);
Выборка = Запрос.Выполнить().Выбрать();
Если Выборка.Следующий() Тогда
ИНН = Выборка.ИНН;
КонецЕсли;

Результат запроса можно обработать тремя способами: методом Выбрать() — построчный обход выборки, методом Выгрузить() — получение таблицы значений, методом Выгрузить(ОбходРезультатаЗапроса.ПоГруппировкам) — иерархическая выборка. Для чтения значений одного объекта достаточно выборки с проверкой Следующий().

Обязательно передавайте изменяемые значения через параметры (УстановитьПараметр), а не конкатенацией строки запроса. Это защищает от ошибок синтаксиса и делает код безопаснее.

Работа со структурами, соответствиями и табличными частями

Структура и соответствие

Структура — не объект базы данных, а коллекция пар «ключ-значение» в памяти. Значение из структуры получают либо через точку (если ключ — допустимый идентификатор), либо через квадратные скобки:

Данные = Новый Структура("Контрагент, Сумма");
Данные.Контрагент = КонтрагентСсылка;
Данные.Сумма = 15000;

Сумма = Данные.Сумма;              // через точку
Сумма = Данные["Сумма"];           // через скобки

Обращение через точку к несуществующему ключу структуры вызывает ошибку «Поле объекта не обнаружено». Чтобы безопасно проверить наличие ключа, используйте метод Свойство():

Значение = Неопределено;
Если Данные.Свойство("Сумма", Значение) Тогда
// ключ существует, значение в переменной Значение
КонецЕсли;

Для соответствия обращение возможно только через скобки: Значение = Соответствие[Ключ]. Метод Свойство() у соответствия отсутствует.

Табличная часть объекта

Табличные части доступны только через объект, а не через ссылку. Строки перебираются в цикле, значения колонок читаются через точку:

ДокументОбъект = ДокументСсылка.ПолучитьОбъект();
ИтогоСумма = 0;
Для Каждого СтрокаТовары Из ДокументОбъект.Товары Цикл
ИтогоСумма = ИтогоСумма + СтрокаТовары.Сумма;
КонецЦикла;

Если данные табличной части нужны только для чтения, выгоднее обратиться к ней запросом через виртуальную таблицу вида Документ.РеализацияТоваровУслуг.Товары — без получения всего объекта.

Значение = Неопределено;
Если Структура.Свойство("ИмяКлюча", Значение) Тогда
	// ключ найден
Иначе
	// ключа нет, используем значение по умолчанию
КонецЕсли;

Проверка результата: пустая ссылка и отсутствие данных

Прежде чем читать значения, убедитесь, что объект вообще найден. Методы поиска (НайтиПоКоду, НайтиПоНомеру, НайтиПоНаименованию) при отсутствии результата возвращают пустую ссылку, а не Неопределено. Проверка выполняется так:

Если Контрагент.Пустая() Тогда
ВызватьИсключение "Контрагент не найден";
КонецЕсли;

Отдельная ситуация — «битая ссылка»: объект был удалён, а ссылка на него осталась в других записях. Признак — значение вида «Объект не найден». Проверить можно функцией ОбщегоНазначения.СсылкаСуществует() в типовых конфигурациях или запросом к таблице по ссылке.

Для реквизитов примитивных типов после чтения полезно проверять заполненность функцией ЗначениеЗаполнено() — она корректно обрабатывает пустые строки, нулевые даты, пустые ссылки и Неопределено.

Типичные ошибки при получении значений

Первая распространённая ошибка — попытка записать значение через ссылку: Ссылка.Наименование = "Новое". Платформа выдаст ошибку, потому что ссылка доступна только для чтения. Решение — получить объект и записать его.

Вторая ошибка — обращение к реквизиту, которого нет в конфигурации. Сообщение «Поле объекта не обнаружено» означает опечатку в имени реквизита или его отсутствие у данного типа объекта. Проверьте состав реквизитов в конфигураторе.

Третья ошибка — чтение данных в цикле через точку от ссылки внутри запроса-обхода. Если уже есть выборка запроса, добавьте нужное поле прямо в текст запроса вместо обращения Выборка.Ссылка.Реквизит — это сокращает число обращений к базе в разы.

FAQ