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