К статье
Практический материал

Другое · 7 мин

Проверка пустой ссылки в 1С 8

Как в 1С 8 определить пустую ссылку справочника или документа: способы проверки, отличие от неопределённого значения и типичные ошибки в конфигурации.

Пустая ссылка в 1С 8 означает, что реквизит или переменная ссылочного типа не указывает ни на один объект базы: ни на элемент справочника, ни на документ, ни на запись регистра. Такое значение возникает, когда пользователь не выбрал значение в форме, когда реквизит не заполнен при записи или когда программа вернула результат поиска без совпадений.

Работа с такой ссылкой без проверки часто приводит к ошибке при обращении к свойствам объекта или к тихому пропуску данных в отчёте. Пустая ссылка не совпадает с пустой строкой и не тождественна неопределённому значению, поэтому проверку нужно строить явно, а не полагаться на внешний вид поля.

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

Что считать пустой ссылкой в 1С 8

Ссылка считается пустой, когда она имеет ссылочный тип, но не указывает на конкретный объект. Это может быть реквизит формы «Контрагент», «Документ», «Номенклатура» или любое другое значение, которое пользователь оставил невыбранным. В конфигурации такая ссылка имеет тип справочника, документа или другого объекта, но её внутренний идентификатор не заполнен.

Пустая ссылка часто встречается после создания нового документа, когда поля «Контрагент», «Договор» или «Склад» ещё не заполнены. Она также появляется в результатах отбора, если условие не нашло подходящих объектов. Внешне поле может выглядеть пустым, но проверка должна выполняться на уровне значения, а не на основе текста в строке ввода.

Где чаще всего возникает пустая ссылка

В справочниках — когда элемент не выбран в поле ввода или не создан программно. В документах — когда реквизит «Контрагент», «Ответственный» или «Склад» не заполнен перед проведением. В регистрах накопления — когда запись не содержит привязки к справочнику. В табличных частях — когда строка добавлена, но ссылка в строке остаётся пустой.

Пустая ссылкаСсылочный тип без объекта

Проверяйте перед записью и чтением свойств

Неопределённое значениеПеременная не имеет типа.

Отличается от пустой ссылки, требует отдельной проверки

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

Не подходит для проверки ссылочных реквизитов

-->

Проверка через ЗначениеЗаполнено

Функция ЗначениеЗаполнено возвращает Истину, если ссылка указывает на существующий объект, и Ложь, если ссылка пустая. Это самый универсальный способ, который не требует знания точного типа метаданных. Используйте его в условиях перед обращением к свойствам объекта, чтобы избежать ошибки выполнения.

Пример условия в модуле формы или общем модуле: если ЗначениеЗаполнено(СсылкаНаКонтрагента) = Ложь, то сообщить «Контрагент не выбран» и прервать обработку. Только после этой проверки безопасно обращаться к свойствам объекта, например к наименованию или ИНН контрагента.

-->

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

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

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

Порядок действий
  1. 1
    Определите тип реквизита, который нужно проверить
  2. 2
    Выберите способ: ЗначениеЗаполнено или сравнение с пустой ссылкой
  3. 3
    Напишите условие перед использованием ссылки
  4. 4
    Проверьте результат на заполненных и пустых данных

-->

Пустая ссылка и неопределённое значение

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

Проверка только через ЗначениеЗаполнено может скрыть различие между неопределённостью и пустой ссылкой. Если важно знать, почему поле пустое, используйте дополнительную проверку типа значения или сравнение с Неопределено, а затем уже проверяйте пустоту ссылки.

Когда используется неопределённое значение

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

Проверка в запросе и табличной части

В запросе пустая ссылка отображается как отсутствие ссылки на объект таблицы. При формировании отбора сравнивайте поле с пустой ссылкой соответствующего объекта или используйте параметр запроса, содержащий пустую ссылку. Не полагайтесь на текстовое представление поля в результате запроса.

В табличной части документа каждая строка может содержать свою ссылку. Перед проведением документа проверяйте все строки табличной части: если хотя бы одна ссылка пустая, а заполнение обязательно, выдайте предупреждение и запретите запись. Это защитит от некорректных проводок и отсутствующих привязок.

Типичные ошибки
01
Проверка пустой ссылки через сравнение с пустой строкой приводит к ложному результату
02
Пропытка чтения свойств пустой ссылки без проверки вызывает ошибку выполнения
03
Запись документа с пустыми обязательными ссылками создаёт некорректные данные в базе

-->

Ограничения, риски и безопасная работа

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

Автоматическая заполняемость пустых ссылок значениями по умолчанию может скрыть ошибку ввода. Лучше явно сообщать о пропуске обязательного реквизита, чем подставлять первое попавшееся значение. Проверяйте результат после записи: ссылка должна указывать на существующий объект, а не оставаться пустой.

Итог

Что важно запомнить

Пустую ссылку в 1С 8 проверяйте явно через ЗначениеЗаполнено или сравнение с пустой ссылкой объекта; не путать с пустой строкой и неопределённым значением.

-->

Чем пустая ссылка отличается от неопределённого значения?

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

Можно ли проверять пустоту через сравнение с пустой строкой?

Нет, для ссылочных реквизитов сравнение с пустой строкой некорректно. Используйте ЗначениеЗаполнено или сравнение с пустой ссылкой соответствующего справочника, документа или регистра.

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

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

Нужно ли проверять каждую ссылку перед использованием?

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