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