Метод ПолучитьСсылку() в 1С:Предприятие — один из ключевых инструментов для работы с объектами базы данных. Он позволяет получить ссылку на объект (документ, справочник, регистр и т.д.), но его поведение зависит от контекста, типа объекта и даже версии платформы. Новичков часто сбивает с толку, что метод может вернуть не только ожидаемую ссылку, но и Неопределено, коллекцию ссылок или даже вызвать ошибку.

В этой статье мы детально разберём, что именно возвращает ПолучитьСсылку() в разных сценариях: от простых справочников до сложных регистров, а также рассмотрим типовые ошибки и нюансы работы с методом. Вы узнаете, как правильно обрабатывать результаты, избегать падений кода и оптимизировать запросы к базе. Материал будет полезен как начинающим разработчикам 1С, так и опытным программистам, которые хотят систематизировать знания.

1. Основные типы возвращаемых значений

Метод ПолучитьСсылку() не универсален — его результат зависит от того, к какому объекту он применяется. В большинстве случаев вы получите один из четырёх вариантов:

  • 🔗 Ссылка на объект — классический случай для документов, справочников, планов обмена. Например, Справочник.Номенклатура.ПолучитьСсылку(Новый УникальныйИдентификатор("..")) вернёт ссылку на элемент справочника.
  • 🗃️ Коллекция ссылок — если метод вызван для объекта, который может содержать несколько элементов (например, группа справочника или табличная часть документа).
  • ❓ Неопределено — если объект не найден или метод вызван в некорректном контексте (например, для несуществующего идентификатора).
  • ⚠️ Исключение — в редких случаях, когда метод не может быть выполнен (например, при ошибках прав доступа).

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

📊 Как часто вы используете метод ПолучитьСсылку() в коде 1С?
Ежедневно
Несколько раз в неделю
Редко
Никогда не использовал

2. Работа со справочниками: нюансы и примеры

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

  • 📌 Для элемента справочника метод вернёт ссылку на этот элемент. Пример: 
    Ссылка = Справочники.Контрагенты.ПолучитьСсылку(Новый УникальныйИдентификатор("123e4567-e89b-12d3-a456-426614174000"));
  • 📂 Для группы справочника результат зависит от версии платформы:
    • В 1С:Предприятие 8.3.10+
      • метод вернёт ссылку на группу.
    • В старых версиях (до 8.3.10) мог возвращаться массив ссылок на все элементы группы.
  • 🔍 Если элемент не найден, метод вернёт Неопределено, но не вызовет ошибку. Это важно учитывать при проверках: 
    Если Ссылка = Неопределено Тогда

    Сообщить("Элемент не найден!");
    

    КонецЕсли;

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

💡

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

3. Документы: когда метод возвращает неожиданное

С документами метод ПолучитьСсылку() работает иначе, чем со справочниками. Главные особенности:

  • 📄 Для существующего документа метод вернёт ссылку на документ с указанием его типа (например, Документ.ПоступлениеТоваровУслуг).
  • 🔄 Если документ помечен на удаление, ссылка всё равно будет возвращена, но при попытке получить его данные (например, через ПолучитьОбъект()) возникнет ошибка.
  • 📅 Для непроведённого документа метод работает так же, как и для проведённого — разницы в возвращаемом значении нет.

Важный нюанс: если вы передаёте в метод некорректный идентификатор (например, UUID другого типа объекта), 1С не вернёт ошибку, а просто выдаст Неопределено. Это может маскировать логические ошибки в коде.

Сценарий Возвращаемое значение Пример кода
Документ существует Ссылка на документ Док = Документы.РеализацияТоваровУслуг.ПолучитьСсылку(ИдДокумента);
Документ помечен на удаление Ссылка на документ (но объект получить нельзя) Если НЕ Док.ПолучитьОбъект().ПометкаУдаления Тогда..
Некорректный UUID Неопределено Ссылка = Документы.ЗаказПокупателя.ПолучитьСсылку(НеСуществующийИд);
Документ в другой базе (распределённая ИБ) Ссылка с признаком внешней базы Если Ссылка.Внешний Тогда..
💡

Для документов всегда проверяйте не только существование ссылки, но и её "жизнеспособность" (пометку удаления, доступность объекта).

4. Регистры и другие объекты: неочевидные случаи

С регистрами (накопления, сведений, бухгалтерии) и планами обмена метод ПолучитьСсылку() ведёт себя менее предсказуемо. Вот ключевые сценарии:

  • 📊 Для регистров накопления/сведений метод вернёт ссылку на запись регистра, но только если она существует. В отличие от документов, здесь нет "объекта" в привычном смысле — только записи.
  • 🔄 Для планов обмена метод может возвращать ссылки на узлы обмена или сами сообщения (в зависимости от контекста).
  • 🚫 Для виртуальных таблиц (например, регистров бухгалтерии) метод ПолучитьСсылку() неприменим — попытка его использования вызовет ошибку.

Пример работы с регистром сведений: 

Запись = РегистрыСведений.ЦеныНоменклатуры.ПолучитьСсылку(

Новый Структура("Номенклатура, Период", Элемент, ТекущаяДата())


);


Если Запись <> Неопределено Тогда


ЗначениеЦены = Запись.Получить();


КонецЕсли;

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

Что будет, если передать неполный набор ключей для регистра?

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

5. Типовые ошибки и как их избежать

Даже опытные разработчики иногда сталкиваются с проблемами при использовании ПолучитьСсылку(). Вот самые распространённые ошибки и способы их предотвращения:

  • 🔍 Игнорирование проверки на Неопределено:
    ⚠️ Внимание: Если не проверить результат метода на Неопределено, код может упасть при попытке обратиться к свойствам несуществующего объекта. Всегда используйте конструкцию Если Ссылка <> Неопределено Тогда...
  • 🔄 Путаница между ПолучитьСсылку() и ПолучитьОбъект():

    Первый возвращает ссылку (легковесный объект), второй — сам объект (с данными). Запрос объекта по несуществующей ссылке вызовет ошибку.

  • 📝 Неучёт прав доступа:

    Если у пользователя нет прав на чтение объекта, метод может вернуть Неопределено или вызвать исключение (зависит от настроек РЛС).

  • 🔗 Работа с внешними ссылками:

    Ссылки на объекты из других баз (в распределённой ИБ) требуют специальной обработки. Прямой вызов ПолучитьОбъект() для них не сработает.

Пример опасной конструкции: 

// ❌ Неправильно: нет проверки на Неопределено

ДокОбъект = Документы.ЗаказПокупателя.ПолучитьСсылку(Ид).ПолучитьОбъект();



// ✅ Правильно: с проверкой


Ссылка = Документы.ЗаказПокупателя.ПолучитьСсылку(Ид);


Если Ссылка <> Неопределено Тогда


ДокОбъект = Ссылка.ПолучитьОбъект();


КонецЕсли;

Убедиться, что UUID корректен|Проверить результат на Неопределено|Учесть права доступа пользователя|Обработать случай внешних ссылок (для распределённых ИБ)|-->

6. Оптимизация запросов: когда ПолучитьСсылку() тормозит

Метод ПолучитьСсылку() кажется простым, но при массовом использовании может замедлять работу системы. Вот как оптимизировать код:

  • 🚀 Кэширование ссылок:

    Если вам нужно многократно обращаться к одним и тем же объектам, сохраняйте ссылки в Соответствие или Массив.

  • 🔍 Пакетные запросы:

    Вместо цикла с ПолучитьСсылку() для каждого элемента используйте Выбрать() с фильтром по UUID.

  • 📊 Использование временных таблиц:

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

Пример оптимизированного кода: 

// ❌ Медленно: 1000 вызовов ПолучитьСсылку() в цикле

Для Каждого Ид Из СписокИд Цикл


Ссылка = Справочники.Номенклатура.ПолучитьСсылку(Ид);


КонецЦикла;



// ✅ Быстро: один запрос


Запрос = Новый Запрос;


Запрос.Текст =


"ВЫБРАТЬ


|  Номенклатура.Ссылка КАК Ссылка


|ИЗ


|  Справочник.Номенклатура КАК Номенклатура


|ГДЕ


|  Номенклатура.Ссылка В(&СписокИд)";


Запрос.УстановитьПараметр("СписокИд", СписокИд);


Результат = Запрос.Выполнить().Выгрузить();

Критическая ошибка многих разработчиков: использование ПолучитьСсылку() внутри циклов по большим массивам данных (например, при обработке тысяч документов). Это приводит к тысячам отдельных обращений к базе, тогда как один запрос с JOIN решит задачу в разы эффективнее.

7. Альтернативные методы: когда ПолучитьСсылку() не подходит

Иногда ПолучитьСсылку() — не лучший выбор. Рассмотрим альтернативы:

  • 🔍 НайтиПоНаименованию() / НайтиПоКоду():

    Если вам известны не UUID, а код или наименование объекта, эти методы могут быть удобнее.

  • 📌 ПолучитьОбъект() по ссылке:

    Если вам нужен не только адрес объекта, но и его данные, сразу берите объект.

  • 🔄 Запросы с JOIN:

    Для сложных выборок лучше использовать язык запросов 1С — он оптимизирован для работы с большими объёмами данных.

Пример с НайтиПоКоду(): 

Элемент = Справочники.Контрагенты.НайтиПоКоду("0001");

Если Элемент.Пустая() Тогда


Сообщить("Контрагент не найден!");


Иначе


Ссылка = Элемент.Ссылка;


КонецЕсли;

Например, НайтиПоНаименованию() чувствителен к регистру и пробелам, а ПолучитьОбъект() требует, чтобы объект существовал и был доступен.

FAQ: Частые вопросы о методе ПолучитьСсылку()

Можно ли получить ссылку на объект по его номеру (без UUID)?

Нет, метод ПолучитьСсылку() работает только с УникальнымИдентификатором (UUID). Для поиска по номеру используйте НайтиПоНомеру() (для документов) или НайтиПоКоду() (для справочников).

Почему метод возвращает Неопределено, если объект точно существует?

Вероятные причины:

  • У пользователя нет прав на чтение объекта.
  • Объект помечен на удаление (для документов).
  • UUID передан некорректно (например, с лишними символами).
  • Объект существует в другой базе данных (в распределённой ИБ).

Как получить ссылку на текущий документ в форме?

Внутри формы документа используйте ЭтотОбъект.Ссылка. Например: 

ТекущаяСсылка = ЭтотОбъект.Ссылка;

Метод ПолучитьСсылку() здесь не нужен.

Можно ли сравнивать ссылки напрямую (оператором =)?

Да, ссылки в 1С можно сравнивать оператором =. Сравнение происходит по внутреннему идентификатору, а не по "внешнему виду" ссылки. Например: 

Если Ссылка1 = Ссылка2 Тогда

// Ссылки указывают на один и тот же объект


КонецЕсли;

Что делать, если ПолучитьСсылку() возвращает коллекцию, а не одну ссылку?

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

// Для группы справочника в 1С 8.2

Ссылки = Справочники.Номенклатура.ПолучитьСсылку(ИдГруппы);


ПерваяСсылка = Ссылки[0]; // Берём первый элемент

В современных версиях (8.3.10+) группа возвращает одну ссылку на саму группу.