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

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

Главная сложность в том, что «пустая ссылка» и «NULL» — это разные состояния. Пустая ссылка — это значение по умолчанию для ссылочного типа, а NULL возникает при соединениях таблиц и в составных полях. Смешивание этих понятий — источник большинства ошибок в запросах.

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

В языке запросов 1С существует три основных подхода. Первый — сравнение поля с конструкцией ЗНАЧЕНИЕ(Справочник.Номенклатура.ПустаяСсылка). Второй — проверка через оператор ЕСТЬ NULL для полей, которые могут принимать значение NULL. Третий — комбинация через функцию ЕСТЬNULL(), которая заменяет NULL на указанное значение, после чего выполняется обычное сравнение.

Выбор зависит от источника данных. Если поле — обычный реквизит ссылочного типа и соединений в запросе нет, достаточно сравнения с пустой ссылкой. Если в запросе есть левое соединение или поле составного типа, без обработки NULL не обойтись.

Проверка через ЗНАЧЕНИЕ с пустой ссылкой

Самый прямолинейный способ — сравнить поле с пустой ссылкой конкретного типа. Конструкция выглядит так:

ВЫБРАТЬ
Реализация.Контрагент
ИЗ
Документ.РеализацияТоваровУслуг КАК Реализация
ГДЕ
Реализация.Договор = ЗНАЧЕНИЕ(Справочник.ДоговорыКонтрагентов.ПустаяСсылка)

Здесь отбираются документы, в которых реквизит «Договор» не заполнен. Важно указать правильный тип объекта внутри ЗНАЧЕНИЕ() — он должен совпадать с типом проверяемого реквизита. Если реквизит имеет тип «ДокументСсылка.ЗаказКлиента», то и пустую ссылку нужно брать от этого типа.

Обратное условие — отбор только заполненных значений — записывается через неравенство: Реализация.Договор <> ЗНАЧЕНИЕ(Справочник.ДоговорыКонтрагентов.ПустаяСсылка). Это типовой приём для исключения «пустых» строк из отчётов.

ГДЕ Реализация.Договор = ЗНАЧЕНИЕ(Справочник.ДоговорыКонтрагентов.ПустаяСсылка)

Составные типы и проверка каждого варианта

Если реквизит составного типа — например, может хранить ссылку на справочник «Контрагенты» или «ФизическиеЛица» — одной проверки недостаточно. Пустая ссылка справочника «Контрагенты» не равна пустой ссылке справочника «ФизическиеЛица», и сравнение с одной из них не отберёт записи с другой.

В таком случае условия объединяют через ИЛИ:

ГДЕ
Поле = ЗНАЧЕНИЕ(Справочник.Контрагенты.ПустаяСсылка)
ИЛИ Поле = ЗНАЧЕНИЕ(Справочник.ФизическиеЛица.ПустаяСсылка)
ИЛИ Поле ЕСТЬ NULL

Альтернатива — привести поле к конкретному типу через ВЫРАЗИТЬ(... КАК Справочник.Контрагенты) и работать уже с однотипными значениями. Этот приём также полезен, когда нужно обратиться к реквизитам составного поля.

NULL после соединений: почему сравнение не срабатывает

Классическая ошибка — левое соединение и попытка отобрать «пустые» значения сравнением с пустой ссылкой. Когда для строки левой таблицы не нашлось пары в правой, все поля правой таблицы получают значение NULL, а не пустую ссылку. Условие Поле = ЗНАЧЕНИЕ(...ПустаяСсылка) для таких строк вернёт ложь, и записи потеряются.

Для отбора таких строк используют оператор ЕСТЬ NULL:

ВЫБРАТЬ
Товары.Номенклатура
ИЗ
РегистрСведений.Цены.СрезПоследних КАК Товары
ЛЕВОЕ СОЕДИНЕНИЕ Справочник.Номенклатура КАК Спр
ПО Товары.Номенклатура = Спр.Ссылка
ГДЕ
Спр.Ссылка ЕСТЬ NULL

Такой запрос найдёт «битые» ссылки — записи регистра, для которых нет соответствующего элемента справочника. Это рабочий способ поиска нарушений целостности данных.

Универсальная проверка через ЕСТЬNULL

Когда нужно одним условием поймать и NULL, и пустую ссылку, применяют функцию ЕСТЬNULL(). Она принимает два аргумента: проверяемое выражение и значение, которое подставляется вместо NULL.

ГДЕ
ЕСТЬNULL(Спр.Родитель, ЗНАЧЕНИЕ(Справочник.Номенклатура.ПустаяСсылка))
= ЗНАЧЕНИЕ(Справочник.Номенклатура.ПустаяСсылка)

Логика проста: если поле равно NULL, функция подставит пустую ссылку, и сравнение сработает; если поле уже содержит пустую ссылку — сравнение тоже выполнится. В результате одно условие покрывает оба состояния «пустоты».

У этого подхода есть издержки: вызов функции в условии может мешать оптимизатору использовать индексы, и на больших таблицах запрос отработает медленнее. Если NULL заведомо невозможен, лучше ограничиться простым сравнением.

Проверка через параметр запроса

Иногда пустую ссылку передают в запрос параметром из встроенного языка. Это удобно, когда текст запроса универсален, а тип объекта определяется в коде:

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

В тексте запроса условие записывается как ГДЕ Реализация.Договор = &ПустойДоговор. Платформа сама сопоставит типы. Способ удобен в универсальных процедурах, но менее нагляден при чтении текста запроса — тип значения виден только в коде.

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

1. 1
   Определите тип поля: простой ссылочный или составной.
2. 2
   Проверьте, есть ли в запросе соединения, которые могут дать NULL.
3. 3
   Для простого поля без соединений используйте сравнение с ЗНАЧЕНИЕ(...ПустаяСсылка).
4. 4
   При наличии левого соединения добавьте условие ЕСТЬ NULL или оберните поле в ЕСТЬNULL.
5. 5
   Выполните запрос в консоли запросов и убедитесь, что выборка содержит ожидаемые строки.

Проверка результата и типичные признаки ошибок

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

Тревожный признак — количество строк в результате резко отличается от ожидаемого. Если условие «пустая ссылка» не отобрало ни одной записи, хотя незаполненные реквизиты точно есть, почти наверняка в запросе присутствует соединение и значения на самом деле NULL. Если, наоборот, отобралось слишком много — проверьте, не объединены ли условия через ИЛИ без скобок, что меняет логику фильтрации.

FAQ