Что такое ссылка на объект в 1С и как с ней работать

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

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

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

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

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

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

Важно понимать: изменение реквизитов объекта в памяти не меняет данные в базе, пока не вызван метод Записать(). И наоборот — если два пользователя одновременно получили объект одной записи и записали его, изменения первого могут быть потеряны или вызовут конфликт блокировок.

Как устроена ссылка внутри платформы

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

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

Как получить ссылку в коде и в запросе

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

• Справочники.Номенклатура.НайтиПоКоду("000001") — поиск по коду;
• Справочники.Номенклатура.НайтиПоНаименованию("Стол") — поиск по наименованию;
• Документы.РеализацияТоваровУслуг.НайтиПоНомеру(Номер, Дата) — поиск документа;
• Справочники.Контрагенты.ПолучитьСсылку(Новый УникальныйИдентификатор(СтрокаGUID)) — ссылка по известному GUID;
• Элемент.Ссылка — когда уже есть объект, полученный из выборки или формы.

В запросах ссылки используются напрямую: поле Ссылка есть у любой ссылочной таблицы, и именно его возвращает выборка по умолчанию. Сравнение в условии ГДЕ Номенклатура = &Ссылка работает по ссылке и выполняется быстро, поскольку сравниваются только идентификаторы.

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

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

Проверка ссылки: пустая, битая, предопределённая

Работа со ссылками требует трёх стандартных проверок. Первая — на пустоту: метод Пустая() или сравнение с Справочники.Номенклатура.ПустаяСсылка(). Пустая ссылка означает, что реквизит не заполнен, и обращение к её реквизитам вернёт неопределённые значения.

Вторая проверка — на «битость». Битая ссылка возникает, когда запись удалена из базы, а ссылки на неё остались в других объектах. При обращении к реквизитам такой ссылки платформа выдаёт строку вида <Объект не найден> (123:abc...). Программно это определяется запросом: если выборка по ссылке вернула пустой результат, запись не существует.

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

Ссылки в реквизитах, на форме и в движениях документа

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

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

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

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

Самая распространённая ошибка — обращение к реквизитам ссылки внутри цикла обхода табличной части или результата запроса. Каждое обращение через точку порождает отдельный запрос к базе. Правильный приём — выбрать нужные поля сразу в запросе через точку (Товары.Номенклатура.СтавкаНДС) или собрать ссылки и получить данные одним пакетным запросом.

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

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

Как выбрать способ работы в конкретной задаче

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

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

Частые вопросы о ссылках в 1С