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

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

Главная сложность в том, что способов проверки несколько, и они не всегда взаимозаменяемы: сравнение через «=» работает не для всех типов, функция ЗначениеЗаполнено() имеет свои нюансы, а в запросах логика отличается от кода модуля. Ниже разобраны все рабочие варианты с примерами и границами применения.

Что такое пустая ссылка и чем она отличается от NULL

Пустая ссылка — это значение ссылочного типа, которое указывает на несуществующий объект. У каждого ссылочного типа своя пустая ссылка: пустая ссылка справочника «Номенклатура» не равна пустой ссылке документа «РеализацияТоваровУслуг». При сравнении разных типов результат будет «Ложь», а в ряде случаев — ошибка несовместимости типов.

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

Сравнение с ПустаяСсылка() — основной способ

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

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

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

Универсальная функция ЗначениеЗаполнено()

Функция ЗначениеЗаполнено(Значение) возвращает Истина, если значение заполнено, и Ложь — если оно пустое. Для ссылок пустым считается значение, равное пустой ссылке своего типа. Главное достоинство — функция работает с любым типом: ссылками, строками, числами, датами, булево.

Если НЕ ЗначениеЗаполнено(ДокументОснование) Тогда
Возврат;
КонецЕсли;

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

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

Метод Пустая() и проверка составных реквизитов

У самого значения ссылочного типа есть метод Пустая(), который возвращает Истина для пустой ссылки. Это удобно, когда тип неизвестен и нет желания вызывать менеджер:

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

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

Проверка пустой ссылки в запросе

В языке запросов своя логика. Пустая ссылка конкретного типа задаётся литералом ЗНАЧЕНИЕ(Справочник.Номенклатура.ПустаяСсылка):

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

Альтернатива — передать пустую ссылку параметром: Запрос.УстановитьПараметр("ПустаяНоменклатура", Справочники.Номенклатура.ПустаяСсылка()) и в тексте писать ГДЕ Номенклатура = &ПустаяНоменклатура. Это гибче, когда тип определяется в коде динамически.

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

Если НЕ ЗначениеЗаполнено(Ссылка) Тогда
    ВызватьИсключение "Не заполнен обязательный реквизит";
КонецЕсли;

// В запросе:
// ГДЕ Таб.Контрагент <> ЗНАЧЕНИЕ(Справочник.Контрагенты.ПустаяСсылка)
// ГДЕ НЕ Таб.Контрагент ЕСТЬ NULL

Проверка в СКД, на форме и в типовых механизмах

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

На управляемой форме проверку заполнения реквизита лучше не писать вручную, а использовать стандартный механизм: установить у реквизита свойство «Проверка заполнения» = «Выдавать ошибку». Тогда платформа сама подсветит незаполненное поле и не даст провести документ. Ручная проверка через ЗначениеЗаполнено() нужна только для нестандартной логики — например, когда обязательность зависит от других полей.

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

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

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