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

Другое · 6 мин

Как получить ссылку на созданный элемент справочника в 1С

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

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

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

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

Что представляет собой ссылка на элемент справочника

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

В конфигурациях 1С ссылки часто встречаются в реквизитах документов: например, в поле «Контрагент», «Номенклатура» или «Сотрудник». Такое поле хранит не строку, а ссылку на соответствующий элемент справочника, что гарантирует однозначную идентификацию записи.

Как получить ссылку на только что созданный элемент

Если элемент создаётся программно, порядок действий обычно такой: создать объект через метод СоздатьЭлементом, заполнить нужные реквизиты, вызвать метод Записать, а затем взять значение свойства Ссылка у полученного объекта. Только после успешной записи свойство Ссылка становится заполненным и пригодным для использования.

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

Порядок действий
  1. 1
    Создать элемент справочника через СоздатьЭлементом
  2. 2
    Заполнить обязательные реквизиты
  3. 3
    Выполнить запись объекта методом Записать
  4. 4
    Взять значение свойства Ссылка у записанного объекта
  5. 5
    Проверить, что ссылка не пустая

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

Как найти ссылку на существующий элемент

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

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

Где можно использовать полученную ссылку

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

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

Проверка результата и ограничения

После получения ссылки рекомендуется проверить, что она не равна Неопределено и не пустая. Также стоит убедиться, что элемент доступен для текущего пользователя: права доступа могут ограничивать просмотр или использование отдельных справочников и их записей.

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

Типичные ошибки
01
Взять свойство Ссылка до записи элемента — ссылка ещё не существует
02
Использовать наименование вместо ссылки в реквизите типа СправочникСсылка
03
Игнорировать ошибку метода Записать и работать с несуществующей ссылкой

Частые ошибки и способы их исправления

Одна из типичных ошибок — попытка взять свойство Ссылка у объекта до вызова Записать. На этом этапе объект существует только в памяти, и ссылка ещё не сформирована. Исправление: сначала записать элемент, а потом обращаться к ссылке.

Вторая ошибка — использование текстового наименования вместо ссылки в реквизите, который ожидает тип СправочникСсылка. Это приводит к ошибке типа или к записи некорректного значения. Третья — игнорирование ошибок записи: если метод Записать вернул отказ, ссылку нельзя считать полученной.

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

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

Свойство Ссылка после записи
Норма

Ссылка заполнена и соответствует типу справочника

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

Ссылка пустая или равна Неопределено

Элемент найден по наименованию
Норма

Найден одна запись с нужными реквизитами

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

Найдено несколько записей или ни одной

Быстрая проверка перед использованием ссылки

Перед тем как вставлять ссылку в документ или передавать её в обработку, полезно убедиться, что элемент всё ещё существует и не помечен на удаление. В некоторых конфигурациях помеченные на удаление элементы остаются в базе, но их использование ограничено.

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

Итог

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

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

Нужно ли записывать элемент перед получением ссылки?

Да. Объект, созданный в памяти, не имеет ссылки до вызова метода записи. Только после сохранения в базе свойство Ссылка становится доступным.

Можно ли использовать ссылку в другой информационной базе?

Не напрямую. Ссылка привязана к конкретной базе. Для работы в другой базе нужно восстановить элемент по коду, артикулу или уникальному идентификатору.

Что делать, если поиск по наименованию вернул пустую ссылку?

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

Отличается ли ссылка от кода элемента справочника?

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