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

Другое · 5 мин

Ссылка (Ref) в 1С: что это и как с ней работать

Ссылка в 1С — это указатель на объект конфигурации, например элемент справочника. Разберём разницу со ссылкой и объектом, как получать и использовать Ref.

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

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

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

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

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

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

Порядок работы со ссылкой
  1. 1
    Получить ссылку на нужный объект
  2. 2
    При необходимости вызвать ПолучитьОбъект() для редактирования
  3. 3
    Изменить реквизиты объекта и вызвать Запись()
  4. 4
    Проверить, что запись прошла без ошибок

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

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

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

Ссылки в запросах и отчётах

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

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

Типичные ошибки
01
Хранить наименование элемента вместо ссылки и потом искать объект по имени
02
Получать объект по ссылке и забывать вызвать Запись после изменений
03
Сравнивать ссылку со строкой вместо другого значения ссылки

Ограничения и риски при работе со ссылками

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

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

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

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

Ссылка не равна пустой
Норма

Объект выбран и может быть использован

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

Пустая ссылка — объект не найден или удалён

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

Доступны реквизиты и методы записи

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

Ошибка получения объекта или отсутствие прав

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

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

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

Итог

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

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

Можно ли хранить ссылку в файле или передать её пользователю вне системы?

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

Чем отличается отбор по ссылке от отбора по наименованию?

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

Нужно ли всегда вызывать ПолучитьОбъект() после получения ссылки?

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

Что делать, если ссылка ведёт на удалённый объект?

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