Чем ссылка отличается от объекта в 1С

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

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

Различие касается всех ссылочных типов данных: справочников, документов, планов счетов, планов видов характеристик и других. Для них существуют пары типов вида «СправочникСсылка.Номенклатура» и «СправочникОбъект.Номенклатура», «ДокументСсылка.РеализацияТоваровУслуг» и «ДокументОбъект.РеализацияТоваровУслуг».

Что такое ссылка и как она устроена

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

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

Важная особенность: получение ссылки не означает чтение всей записи. Когда вы перебираете результат запроса и работаете только со ссылками, платформа не загружает в память полные данные каждого элемента. Это делает операции со ссылками быстрыми и дешёвыми по ресурсам.

Что такое объект и чем он отличается по возможностям

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

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

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

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

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

ОбъектЭлемента = СсылкаНаЭлемент.ПолучитьОбъект();
Если ОбъектЭлемента = Неопределено Тогда
    Возврат; // ссылка битая, записи в базе нет
КонецЕсли;
ОбъектЭлемента.Наименование = "Новое наименование";
ОбъектЭлемента.Записать();

Обратный переход выполняется через свойство Ссылка: у любого объекта оно доступно только для чтения и возвращает ссылку на соответствующую запись. Для нового, ещё не записанного объекта ссылка будет пустой до первой записи, если её не установили принудительно методом УстановитьСсылкуНового().

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

1. 1
   Получите ссылку на элемент — из запроса, реквизита или метода НайтиПоКоду()
2. 2
   Вызовите Ссылка.ПолучитьОбъект() и проверьте результат на Неопределено
3. 3
   Измените нужные реквизиты объекта и при необходимости табличные части
4. 4
   Вызовите метод Записать() и обработайте возможное исключение
5. 5
   Проверьте результат: откройте элемент в режиме Предприятие или перечитайте реквизит запросом

Когда достаточно ссылки, а когда нужен объект

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

Тонкость в чтении реквизитов через ссылку: обращение вида Ссылка.Наименование работает, но каждое такое обращение в цикле — это отдельное неявное обращение к базе. Если нужно прочитать несколько реквизитов у множества элементов, правильнее использовать запрос с выборкой полей — он заберёт все данные одним обращением к СУБД.

Типичные ошибки и ограничения

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

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

Ещё одно ограничение: у ссылки недоступны табличные части. Обращение вида Ссылка.Товары для документа не вернёт строки табличной части — для этого нужен либо объект, либо запрос к табличной части с отбором по ссылке.

Проверка результата и отладка

Определить тип значения в отладчике можно через функцию ТипЗнч() и сравнение с нужным типом, например Тип("СправочникСсылка.Номенклатура"). В конфигураторе тип значения также виден в табло при остановке на точке останова — там явно отображается, ссылка это или объект.

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

Частые вопросы о ссылках и объектах