Как получить пустую ссылку на клиенте 1С

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

Задача решается двумя рабочими способами: через функцию ПредопределенноеЗначение(), которая работает прямо в клиентском коде, и через вызов серверной функции, возвращающей ссылку. Выбор зависит от типа объекта, режима работы (тонкий клиент, веб-клиент, толстый клиент) и требований к производительности.

Ниже разобраны оба подхода с примерами кода, ограничениями по типам данных, способами проверки результата и типичными ошибками, из-за которых сравнение с пустой ссылкой даёт неожиданный результат.

Способ 1: ПредопределенноеЗначение на клиенте

Самый простой и рекомендуемый способ — функция ПредопределенноеЗначение() глобального контекста. Она доступна и на клиенте, и на сервере, и не требует обращения к серверу, что важно для производительности форм.

Синтаксис:

ПустаяНоменклатура = ПредопределенноеЗначение("Справочник.Номенклатура.ПустаяСсылка");
ПустойКонтрагент = ПредопределенноеЗначение("Справочник.Контрагенты.ПустаяСсылка");
ПустойДокумент = ПредопределенноеЗначение("Документ.РеализацияТоваровУслуг.ПустаяСсылка");

Строка параметра строится по шаблону: вид объекта.имя объекта.ПустаяСсылка. Обратите внимание: вид указывается в единственном числе — «Справочник», «Документ», «Перечисление», а не «Справочники».

Для перечислений та же функция возвращает и конкретные значения, и пустую ссылку:

СтавкаНДС = ПредопределенноеЗначение("Перечисление.СтавкиНДС.НДС20");
ПустаяСтавка = ПредопределенноеЗначение("Перечисление.СтавкиНДС.ПустаяСсылка");

&НаКлиенте
Процедура ОчиститьКонтрагента(Команда)
	Объект.Контрагент = ПредопределенноеЗначение("Справочник.Контрагенты.ПустаяСсылка");
КонецПроцедуры

Ограничения способа

Функция ПредопределенноеЗначение() работает только с именами, известными на этапе компиляции конфигурации — строка должна соответствовать реально существующему объекту метаданных. Если имя справочника указано с ошибкой, будет выдано исключение времени выполнения.

Для типов, не являющихся ссылочными (строка, число, дата), функция не применяется — там используются литералы: пустая строка "", ноль, '00010101' для даты.

Способ 2: вызов сервера через общий модуль

Если по какой-то причине ПредопределенноеЗначение() не подходит (например, имя объекта формируется динамически), пустую ссылку получают через серверную функцию в общем модуле с признаками «Сервер» и «Вызов сервера».

Пример такого модуля:

// Общий модуль РаботаСоСсылками, Сервер = Истина, ВызовСервера = Истина
Функция ПустаяСсылкаСправочника(ИмяСправочника) Экспорт
Возврат Справочники[ИмяСправочника].ПустаяСсылка();
КонецФункции

На клиенте вызов выглядит так:

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

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

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

Проверка значения на пустоту

Получив пустую ссылку, её используют для сравнения. Прямое сравнение работает корректно:

Если Объект.Контрагент = ПредопределенноеЗначение("Справочник.Контрагенты.ПустаяСсылка") Тогда
Сообщить("Контрагент не заполнен");
КонецЕсли;

Однако чаще вместо сравнения с пустой ссылкой применяют функцию ЗначениеЗаполнено(). Она универсальна: возвращает Ложь для пустых ссылок любого типа, пустых строк, нулевых дат и значения Неопределено. Это избавляет от необходимости знать тип проверяемого реквизита.

Если НЕ ЗначениеЗаполнено(Объект.Контрагент) Тогда
Сообщить("Контрагент не заполнен");
КонецЕсли;

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

Если реквизит имеет составной тип (например, «СправочникСсылка.Контрагенты, СправочникСсылка.Организации»), пустая ссылка одного конкретного вида может не совпасть с текущим пустым значением реквизита. Незаполненный составной реквизит часто содержит Неопределено, а не пустую ссылку какого-либо вида.

Поэтому для составных типов сравнение с конкретной пустой ссылкой ненадёжно. Используйте ЗначениеЗаполнено() или проверку на Неопределено:

Если Объект.Плательщик = Неопределено Тогда
// реквизит не заполнен
КонецЕсли;

Также помните, что Неопределено и пустая ссылка — разные значения. Сравнение Неопределено = ПустаяСсылка возвращает Ложь, что является частым источником ошибок в условиях.

Пошаговый порядок действий

1. 1
   Определите вид и имя объекта метаданных, для которого нужна пустая ссылка (например, справочник «Номенклатура»)
2. 2
   В клиентском коде вызовите ПредопределенноеЗначение("Справочник.Номенклатура.ПустаяСсылка")
3. 3
   Если имя объекта формируется динамически — создайте серверную функцию в общем модуле с признаком «Вызов сервера» и вызовите её из клиента
4. 4
   Для проверки заполненности реквизита используйте ЗначениеЗаполнено() вместо явного сравнения, если тип может меняться
5. 5
   Проверьте результат в отладчике: тип значения должен соответствовать ожидаемой ссылке

После выполнения шагов откройте отладку и убедитесь, что полученное значение имеет ожидаемый тип: ТипЗнч(Значение) должен вернуть тип вида «СправочникСсылка.Номенклатура». Если возвращается Неопределено — ищите ошибку в строке имени объекта.

Частые вопросы