Что такое ссылка в 1С
В платформе 1С «Cсылка» — это специальное значение, которое однозначно идентифицирует конкретный объект в информационной базе, но не содержит его данных.
Проще говоря, ссылка — это «адрес» объекта (элемента справочника, документа, записи регистра и т.д.), по которому платформа может быстро найти и загрузить нужный экземпляр.
Важно отличать два понятия:
💡 Рекомендуем по теме: Типовые услуги 1С с фиксированной ценой
Обновления,настройки кадров, склада, УПД, чеков и печатных форм. Результат и стоимость известны заранее.
Подробнее →- Объект (например, элемент справочника «Контрагенты») — это набор данных и методов, с которыми мы можем работать и которые можно изменять и записывать.
- Ссылка на объект — это лёгкое, компактное значение, позволяющее обратиться к этому объекту, получить его данные, но саму ссылку изменить нельзя.
Ссылка в 1С является типом данных, доступным только для прикладных объектов метаданных (справочники, документы, планы счетов и т.п.). Все ссылочные типы в языке имеют специальные имена вида:
- СправочникСсылка.<ИмяСправочника>
- ДокументСсылка.<ИмяДокумента>
- Аналогичные для других объектов (планы видов характеристик, планы счетов и др.).
Таким образом, в переменной ссылочного типа хранится не сам документ или элемент справочника, а только указатель на него.
Особенности ссылок в 1С
У ссылок в 1С есть несколько ключевых свойств, которые важно понимать при разработке:
- Ссылка всегда указывает на конкретный экземпляр объекта. Например, не просто на справочник «Контрагенты», а на конкретного контрагента с определённым внутренним идентификатором.
- Ссылка доступна только для чтения. Само значение ссылки изменить нельзя — оно либо указывает на существующий объект, либо является пустым значением (Не определено или пустая ссылка, в зависимости от контекста).
- Ссылка не содержит данных объекта. При обращении к данным по ссылке платформа загружает объект из базы данных, что более ресурсозатратно, чем работа с самой ссылкой.
- Работа со ссылками быстрее, чем с объектами. Это особенно заметно при передаче параметров в процедуры и функции, при хранении больших объёмов связей и при интеграциях с другими системами.
Благодаря этим свойствам ссылки широко используются для связи объектов между собой: реквизиты документов и справочников часто имеют ссылочные типы данных.
Где используются ссылочные типы
Ссылки в 1С используются практически во всех прикладных конфигурациях для построения связей между объектами.
Наиболее типичные варианты:
- Реквизиты документов. Например, в документе «Реализация товаров и услуг» реквизит «Контрагент» имеет тип СправочникСсылка.Контрагенты.
- Реквизиты справочников. В справочнике «Договоры контрагентов» может быть реквизит «Контрагент» со ссылкой на элемент справочника «Контрагенты», что формирует иерархию отношений.
- Табличные части. В табличной части документа «Поступление товаров» колонки «Номенклатура», «Склад» и т.п. обычно ссылочные (справочник «Номенклатура», «Склады»).
- Регистры (накопления, бухгалтерии, сведений). В измерениях и ресурсах регистров часто хранятся ссылки на документы, справочники и другие объекты, что позволяет легко строить отчёты и выборки по связям.
Использование ссылок вместо дублирования данных повышает целостность базы и упрощает сопровождение: если вы изменили, например, наименование контрагента, во всех документах, где он подставлен ссылкой, автоматически будет отображаться актуальное представление.
Как получить ссылку и объект
В процессе разработки нам часто нужно:
- Получить ссылку на объект;
- По имеющейся ссылке получить сам объект для чтения/изменения.
Получение ссылки
Ссылку на объект можно получить разными способами.
Основные варианты:
- Из результата запроса. В выборке запросов по таблицам документов и справочников поля «Ссылка» обычно содержат ссылку на соответствующий объект.
- При выборе пользователя в форме. Когда пользователь выбирает контрагента, номенклатуру или документ из списка, в реквизит формы попадает именно ссылка, а не объект.
- Через навигационные/текстовые ссылки. Платформа позволяет получить текстовую ссылку вида e1cib://… и затем преобразовывать её в ссылку на объект и обратно.
Внутри конфигурации существуют специализированные типы данных для хранения ссылок (ДокументСсылка.<Имя>, СправочникСсылка.<Имя>), позволяющие явным образом указывать, с каким объектом вы работаете.
Получение объекта по ссылке
Имея ссылку, разработчик может получить сам объект и работать с его реквизитами.
Для этого используется специальный механизм: ссылка содержит метод или функцию доступа к объекту (в документации это, как правило, описывается как получение объекта по ссылке, например, через метод ПолучитьОбъект()).
Общий принцип:
- Ссылка хранится в переменной ссылочного типа;
- По этой ссылке вызывается метод получения объекта;
- Возвращается объект с которым можно работать (читать и изменять данные, выполнять запись).
Такой подход позволяет на пользовательском уровне передавать и сохранять только лёгкие ссылочные значения, загружая «тяжёлые» объекты из базы только там, где действительно нужно.
Почему ссылки важны для производительности
Ссылочная архитектура — одна из причин, почему 1С эффективно работает с большими объёмами данных.
Основные преимущества:
- Минимум трафика при интеграциях. При обмене с другими системами можно передавать только ссылки или идентификаторы вместо полного набора реквизитов, а детали поднимать уже в 1С.
- Меньший объём памяти. Хранить в реквизитах и табличных частях компактные ссылки выгоднее, чем дублировать одни и те же строки и наборы реквизитов.
- Гибкость изменения данных. Если атрибуты объекта изменились, достаточно обновить сам объект; все «привязанные» к нему документы по ссылке увидят новые значения в представлении.
Поэтому правильное использование ссылок — ключевой навык для 1С‑разработчика и архитектора конфигураций.
Пример использования ссылки в 1С
Ниже приведён упрощённый пример сценария, который часто встречается в прикладных решениях: у нас есть документ «Реализация товаров и услуг» и справочник «Контрагенты».
Реквизит документа «Контрагент» имеет тип СправочникСсылка.Контрагенты, то есть в нём хранится ссылка на выбранного контрагента.
Постановка задачи
Пусть нужно:
- При проведении документа «Реализация товаров и услуг» получить полный объект контрагента по ссылке, хранящейся в реквизите «Контрагент»;
- Проверить некоторые его реквизиты (например, флаг «ЯвляетсяПокупателем» или группу);
- При необходимости вывести пользователю сообщение.
Логика на уровне конфигурации
- В конфигураторе в структуре документа «Реализация товаров и услуг» создаётся реквизит «Контрагент» с типом СправочникСсылка.Контрагенты.
- На форме документа пользователь выбирает контрагента из списка — фактически в реквизит попадает ссылка на элемент справочника.
- В модуле объекта документа в обработчике проведения по ссылке получаем объект контрагента и работаем с его данными (читаем нужные реквизиты, при необходимости выполняем проверки).
Иллюстрация действий
- Пользователь открывает документ «Реализация товаров и услуг» и выбирает контрагента из справочника.
- В реквизите «Контрагент» документа остаётся только ссылочное значение типа СправочникСсылка.Контрагенты.
- При проведении документа по этой ссылке поднимается объект контрагента, из которого считываются необходимые реквизиты (например, наименование, ИНН, группа, статусы).
Такая схема демонстрирует типичный паттерн работы: формы и документы хранят и передают между собой ссылки, а полноценные объекты считываются из базы данных только тогда, когда нужно изменить или подробно проанализировать информацию.
Использование в пользовательском интерфейсе
Помимо программного кода, ссылки широко применяются в пользовательском интерфейсе 1С как навигационные и текстовые.
Возможности:
- Получить текстовую ссылку на любой объект (справочник, документ, отчёт).
- Отправить эту ссылку по электронной почте или в мессенджере.
- Перейти по полученной ссылке и открыть нужный объект напрямую.
Текстовые ссылки имеют специальный формат с префиксом e1cib, что позволяет системе отличать их от обычных веб‑адресов.
Это удобно для удалённого взаимодействия между пользователями: бухгалтер может отправить ссылку на конкретный проблемный документ коллеге, и тот откроет его одним кликом, не тратя время на поиск.
Заключение
