Тип данных СправочникСсылка — один из ключевых элементов платформы 1С:Предприятие 8.3, который позволяет работать с объектами справочников без загрузки их полных данных в память. Это не просто "указатель" на элемент справочника, а полноценный инструмент для манипуляции данными, фильтрации и связывания объектов. Однако многие разработчики сталкиваются с трудностями при попытке получить СправочникСсылка программно — особенно когда речь идет о динамических запросах, работе с формами или интеграции с внешними системами.

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

1. Базовые методы получения СправочникСсылка

Начнем с простейших способов, которые покрывают 80% повседневных задач. Эти методы работают во всех конфигурациях на базе 1С:Предприятие 8.3 и не требуют глубоких знаний платформы.

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

СсылкаНаНоменклатуру = Справочники.Номенклатура.НайтиПоНаименованию("Ноутбук Dell XPS 15");

Если элемент не найден, метод вернет Неопределено. Чтобы избежать ошибок, всегда проверяйте результат:

Если СсылкаНаНоменклатуру = Неопределено Тогда

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


Иначе


// Работаем со ссылкой


КонецЕсли;

  • 🔹 НайтиПоНаименованию() — ищет первый элемент с точным совпадением имени (регистрозависимый!).
  • 🔹 НайтиПоРеквизиту() — позволяет искать по любому реквизиту, например, по артикулу или коду.
  • 🔹 ПолучитьСсылку() — возвращает ссылку на элемент по его уникальному идентификатору (если он известен).
  • 🔹 СоздатьСсылку() — создает новую ссылку на несуществующий элемент (полезно для подготовки данных перед записью).
⚠️ Внимание: Метод НайтиПоНаименованию() работает медленно на больших справочниках (10 000+ элементов). Для производительных решений используйте Запрос или ИндексированныеКоллекции.
📊 Какой метод получения ссылок вы используете чаще?
Менеджер справочника (НайтиПоНаименованию)
Запросы
Прямое обращение по УИД
Другое

2. Получение ссылок через запрос

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

Пример запроса, который возвращает ссылки на номенклатуру с ценой выше 50 000 рублей:

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

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


"ВЫБРАТЬ


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


|ИЗ


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


|ГДЕ


|   Номенклатура.Цена > 50000";



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


Выборка = Результат.Выбрать();



Пока Выборка.Следующий() Цикл


Ссылка = Выборка.Ссылка; // Это и есть СправочникСсылка


Сообщить(Ссылка.Наименование);


КонецЦикла;

Ключевые преимущества этого подхода:

  • 🚀 Производительность — запрос оптимизирован на уровне СУБД.
  • 🔍 Гибкость — можно фильтровать по любым полям, включая виртуальные таблицы.
  • 🔗 Связи — легко получить ссылки из связанных справочников (например, Контрагенты → Договоры).
⚠️ Внимание: Если в запросе используете псевдонимы (например, КАК Ссылка), убедитесь, что они не совпадают с именами реквизитов справочника. Это может привести к конфликтам при выборке.
💡

Для ускорения повторяющихся запросов используйте Запрос.УстановитьПараметр() вместо конкатенации строк. Это защищает от SQL-инъекций и улучшает читаемость кода.

3. Работа с УИД (уникальным идентификатором)

Каждый элемент справочника в 1С имеет уникальный идентификатор (УИД) — неизменяемый признак, который сохраняется даже при переносе данных между базами. Это надежный способ получить СправочникСсылка, если вы знаете УИД заранее (например, при интеграции с внешними системами).

Пример получения ссылки по УИД:

УИД = "a1b2c3d4-5678-90ef-1234-567890abcdef"; // Пример УИД

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



Если Ссылка.Пустая() Тогда


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


Иначе


Сообщить("Найден элемент: " + Ссылка.Наименование);


КонецЕсли;

Где взять УИД?

  • 📋 Из 1С:EDT или конфигуратора (в свойствах элемента справочника).
  • 🔄 При обмене данными (например, через EnterpriseData или УниверсальныйФорматОбмена).
  • 📊 Из отчетов или логов, если УИД хранится в базе как реквизит.
Метод Преимущества Недостатки
ПолучитьСсылку(УИД) Надежность (УИД не меняется), быстрота Требуется знать УИД заранее
НайтиПоНаименованию() Простота использования Медленно на больших справочниках, чувствителен к регистру
Запрос Гибкость, производительность Сложнее в написании, требует знания языка запросов

4. Динамическое создание ссылок (без привязки к базе)

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

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

Ссылка.Наименование = "Новый товар";


Ссылка.Артикул = "ART-001";



// Теперь можно записать в базу


Ссылка.Записать();

Особенности этого подхода:

  • ⚡ Нет привязки к базе — ссылка существует только в памяти до записи.
  • 🔄 Полезно для пакетной обработки (например, при импорте данных из Excel).
  • ⚠️ Опасно! Если не записать ссылку, она исчезнет после завершения сеанса.
Что будет, если не записать созданную ссылку?

Ссылка, созданная через СоздатьСсылку(), существует только в оперативной памяти. После завершения сеанса работы 1С (или перезапуска клиента) она будет утеряна, даже если вы присвоили ей реквизиты. Чтобы сохранить элемент, обязательно вызовите метод Записать().

Для массового создания ссылок удобно использовать объектный способ:

НоваяНоменклатура = Справочники.Номенклатура.СоздатьЭлемент();

НоваяНоменклатура.Наименование = "Товар из Excel";


НоваяНоменклатура.Артикул = "EXCEL-001";


НоваяНоменклатура.Записать();



// Получаем ссылку на только что созданный элемент


Ссылка = НоваяНоменклатура.Ссылка;

5. Работа с ссылками в формах и на клиенте

При разработке управляемых форм часто требуется передавать СправочникСсылка между клиентом и сервером. Здесь важно помнить о контексте выполнения: некоторые методы доступны только на сервере.

Пример: получение ссылки на контрагента из поля ввода формы:

&НаКлиенте

Процедура КонтрагентПриИзменении(Элемент)


Если Элементы.Контрагент.Значение <> Неопределено Тогда


Сообщить("Выбран: " + Элементы.Контрагент.Значение.Наименование);



// Передаем ссылку на сервер для дальнейшей обработки


ОбработатьКонтрагентаНаСервере(Элементы.Контрагент.Значение);


КонецЕсли;


КонецПроцедуры



&НаСервере


Процедура ОбработатьКонтрагентаНаСервере(СсылкаНаКонтрагента)


// Здесь можно работать с ссылкой на сервере


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


Запрос.Текст = "ВЫБРАТЬ Договоры.Ссылка ИЗ Справочник.ДоговорыКонтрагентов КАК Договоры ГДЕ Договоры.Контрагент = &Контрагент";


Запрос.УстановитьПараметр("Контрагент", СсылкаНаКонтрагента);


// ...


КонецПроцедуры

Типичные ошибки при работе с формами:

  • 🚫 П попытка вызвать серверные методы (например, Записать()) напрямую из клиентского кода.
  • 🚫 Передача неполных ссылок (например, только наименования без самой ссылки).
  • 🚫 Игнорирование события ПриИзменении для полей с выбором справочников.

Поле формы имеет тип "СправочникСсылка.ИмяСправочника"|

Событие "ПриИзменении" обрабатывает выбор пользователя|

Серверные процедуры помечены директивой &НаСервере|

Проверена работа в тонком и толстом клиенте|-->

6. Оптимизация и типичные ошибки

Неправильная работа с СправочникСсылка может приводить к замедлению производительности, утечкам памяти или логическим ошибкам. Разберем ключевые моменты оптимизации.

Ошибка 1: Частые обращения к базе через НайтиПоНаименованию() в циклах.

Плохо:

Для Каждого Строка Из ТаблицаТоваров Цикл

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


// ...


КонецЦикла;

Хорошо (с использованием кеша):

КешСсылок = Новый Соответствие;

Для Каждого Строка Из ТаблицаТоваров Цикл


Если НЕ КешСсылок.СодержитКлюч(Строка.Наименование) Тогда


КешСсылок.Вставить(Строка.Наименование, Справочники.Номенклатура.НайтиПоНаименованию(Строка.Наименование));


КонецЕсли;


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


КонецЦикла;

Ошибка 2: Сравнение ссылок через = вместо .Сравнить().

Плохо:

Если Ссылка1 = Ссылка2 Тогда // Может работать некорректно, если ссылки из разных сеансов

// ...


КонецЕсли;

Хорошо:

Если Ссылка1.Сравнить(Ссылка2) = 0 Тогда // 0 означает "равны"

// ...


КонецЕсли;

Ошибка 3: Хранение ссылок в реквизитах без проверки на пустоту.

Всегда проверяйте ссылки на пустоту перед использованием:

Если НЕ СсылкаНаДокумент.Пустая() Тогда

// Работаем со ссылкой


КонецЕсли;

💡

Используйте метод .Сравнить() для надежного сравнения ссылок, особенно если они получены из разных источников (например, из запроса и из формы).

7. Расширенные сценарии: рефлексия и метаданные

Для опытных разработчиков: иногда требуется получить СправочникСсылка динамически, когда имя справочника заранее неизвестно. В этом помогает рефлексия и работа с метаданными.

Пример: получение ссылки на элемент справочника, имя которого хранится в переменной:

ИмяСправочника = "Контрагенты"; // Может быть получено динамически

СправочникОбъект = Метаданные.Справочники.Найти(ИмяСправочника);


Если СправочникОбъект = Неопределено Тогда


ВызватьИсключение "Справочник не найден: " + ИмяСправочника;


КонецЕсли;



МенеджерСправочника = СправочникОбъект.ПолучитьМенеджерВыбора();


Ссылка = МенеджерСправочника.НайтиПоНаименованию("ООО Рога и Копыта");

Это полезно для:

  • 🤖 Универсальных обработок, работающих с любыми справочниками.
  • 🔧 Инструментов администрирования (например, массовое изменение реквизитов).
  • 🔄 Интеграций, где имена справочников приходят извне (например, из JSON).

Для работы с динамическими списками (например, в отчетах) можно использовать ПланОбмена или РегистрСведений, но это тема для отдельной статьи.

⚠️ Внимание: Рефлексия и динамическая работа с метаданными могут нарушать типизацию кода и усложнять поддержку. Используйте эти приемы только когда это действительно необходимо.

FAQ: Ответы на частые вопросы

Как получить ссылку на элемент справочника по коду (не по УИД)?

Используйте метод НайтиПоКоду():

Ссылка = Справочники.Номенклатура.НайтиПоКоду("00-000001");

Если код хранится в строковом формате, убедитесь, что он соответствует формату кода в справочнике (например, с ведущими нулями).

Почему НайтиПоНаименованию() возвращает Неопределено, хотя элемент существует?

Возможные причины:

  • 🔠 Несовпадение регистра (метод чувствителен к регистру!).
  • 📛 Наименование содержит невидимые символы (пробелы, табуляции).
  • 🔒 Элемент помечен на удаление или недоступен текущему пользователю.

Решение: используйте СокрЛП() для удаления пробелов или запрос с ПОДОБНО для неточного поиска.

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

Да, но только если базы связаны через:

  • 🔗 План обмена (например, УниверсальныйФорматОбмена).
  • 🌐 Web-сервисы или HTTP-запросы (если API другой базы это позволяет).
  • 📤 Файловый обмен (например, через XML или JSON с УИД).

Пример для плана обмена:

Ссылка = ПланыОбмена.ОсновнойПланОбмена.ПолучитьСсылкуНаОбъект(

Новый УникальныйИдентификатор("a1b2c3d4-5678-90ef-1234-567890abcdef"),


"Справочник.Контрагенты"


);

Как проверить, что переменная содержит именно СправочникСсылка?

Используйте функцию ТипЗнч():

Если ТипЗнч(Переменная) = Тип("СправочникСсылка.Номенклатура") Тогда

Сообщить("Это ссылка на номенклатуру!");


КонецЕсли;

Для универсальной проверки (любой справочник):

Если ТипЗнч(Переменная) = Тип("СправочникСсылка") Тогда

Сообщить("Это ссылка на справочник: " + Переменная.Метаданные().Имя);


КонецЕсли;

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

Для небольших справочников (до 1000 элементов) можно использовать Выбрать():

Выборка = Справочники.Номенклатура.Выбрать();

Пока Выборка.Следующий() Цикл


Сообщить(Выборка.Ссылка.Наименование);


КонецЦикла;

Для больших справочников обязательно используйте запрос с пагинацией:

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

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


"ВЫБРАТЬ ПЕРВЫЕ 100


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


|ИЗ


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


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