Другое · 7 мин
Как получить пустую ссылку на клиенте в 1С:Предприятие
Практическая инструкция: как получить пустую ссылку на клиенте в 1С:Предприятие, чем она отличается от Неопределено, как проверить результат и избежать ошибок при записи.
В управляемом приложении 1С:Предприятие ссылка — это значение с типом, которое указывает на элемент справочника, документ или другой объект конфигурации. Иногда в коде формы или модуля объекта на клиенте нужно задать «ничего», то есть ссылку, которая не указывает ни на какой конкретный элемент. Такое значение называется пустой ссылкой.
Пустая ссылка полезна, когда нужно сбросить реквизит, сравнить значение с отсутствием выбранного элемента или передать в процедуру признак того, что объект не выбран. На клиенте порядок получения пустой ссылки отличается от серверного, и неправильный способ может привести к ошибке компиляции или выполнения.
Ниже разобрано, как именно получить пустую ссылку на клиенте, как проверить результат и в каких случаях лучше не использовать этот приём без осторожности.
##
Способы получить пустую ссылку на клиенте
На клиенте наиболее надёжный способ — использовать встроенную функцию ПустаяСсылка(). Вызванная без параметров, она возвращает пустую ссылку без привязки к конкретному типу. Такое значение можно присвоить переменной или реквизиту, если тип позволяет принять пустую ссылку.
Если нужно получить пустую ссылку определённого справочника, документа или перечисления, укажите тип в параметре: ПустаяСсылка(Тип(Справочник.Контрагенты)). Результат будет пустой ссылкой с типом этого справочника, что важно при передаче в реквизиты и процедуры, ожидающие конкретный тип.
Когда подходит вызов без типа
Без параметра функция подходит, когда тип ещё не известен или значение временно не определено. Однако такая ссылка может не пройти проверку совместимости в строго типизированных реквизитах, поэтому перед записью в форму или базу уточните, какой тип ожидает поле.
Когда нужен тип справочника
Указание типа предпочтительнее для реквизитов форм и табличных частей, где тип задан явно. Пустая ссылка с правильным типом сохраняет структуру данных и не вызывает ошибок несовместимости при присваивании.
- 1Определите тип справочника или объекта
- 2Вызовите ПустаяСсылка(Тип) на клиенте
- 3Присвойте результат реквизиту или переменной
- 4Проверьте через ЗначениеЗаполнено
В некоторых старых или тонких клиентах глобальная коллекция Справочники может быть недоступна, поэтому конструкция Справочники.Имя.ПустаяСсылка() не всегда работает на клиенте. Безопаснее использовать именно функцию ПустаяСсылка(Тип), которая доступна в клиентском контексте.
##
Как проверить, что ссылка пустая
Самый простой способ — функция ЗначениеЗаполнено(). Для пустой ссылки она возвращает Ложь, а для заполненной ссылки на существующий объект — Истину. Это подходит для проверки перед использованием значения в расчётах или записи.
Также можно сравнивать значение с результатом ПустаяСсылка() того же типа. Если ссылка пустая, сравнение даст Истину. Этот способ надёжнее, чем проверка на пустую строку или ноль, потому что учитывает тип ссылки.
Проверка через ТипЗначения() помогает убедиться, что перед вами именно ссылка, а не число, строка или дата. Пустая ссылка имеет тип, но не указывает на элемент, поэтому тип определяется, а значение считается незаполненным.
##
Пустая ссылка и Неопределено: в чём разница
Пустая ссылка — это значение с типом, которое просто не указывает на конкретный объект. Неопределено — это отсутствие значения вообще, без типа. Эти понятия не эквивалентны, и их нельзя заменять друг другом без проверки.
Сравнение вариантов
Имеет тип, но не указывает на объект; подходит для сброса реквизита
Не имеет типа; используется, когда значение вообще не определено
Сравнение пустой ссылки с Неопределено через оператор равно вернёт Ложь, даже если оба значения выглядят как «пустота». Поэтому для проверки отсутствия выбранного элемента используйте ЗначениеЗаполнено или сравнение с ПустаяСсылка(), а не с Неопределено.
##
Ограничения и риски при работе на клиенте
На тонком и веб-клиенте часть серверных объектов и коллекций недоступна напрямую. Перед использованием пустой ссылки в форме убедитесь, что код выполняется в клиентском контексте и не вызывает серверные методы без необходимости.
Запись пустой ссылки в базу очищает соответствующий реквизит. Если в этом реквизите хранилась важная связь с документом или контрагентом, связь пропадёт. Перед массовой записью проверьте логику на копии информационной базы.
Не пытайтесь «удалить» объект через присвоение пустой ссылки в реквизит другого объекта. Пустая ссылка не удаляет сам элемент справочника или документа, она только разрывает ссылку в текущем поле. Удаление объектов требует отдельных процедур и прав доступа.
##
Типичные ошибки
Частая ошибка — проверка пустой ссылки через сравнение с Неопределено. Как уже сказано, результат будет Ложь, и код может не сработать там, где ожидалась обработка пустоты. Используйте ЗначениеЗаполнено или ПустаяСсылка().
Другая ошибка — попытка вызвать методы у пустой ссылки, как у реального объекта. Пустая ссылка не имеет данных элемента, поэтому обращение к его реквизитам приведёт к ошибке. Всегда проверяйте заполненность перед доступом к свойствам.
Не путайте пустую ссылку с пустым значением строки или числом ноль. Для ссылочных типов применимы только способы проверки ссылок, а для простых типов — свои. Смешивание типов приводит к трудноотлаживаемым ошибкам в формах.
##
Безопасная работа с пустыми ссылками
Перед записью пустой ссылки в реквизит документа или справочника убедитесь, что бизнес-логика допускает отсутствие значения. Некоторые реквизиты помечены как обязательные, и запись пустой ссылки в них будет заблокирована платформой.
При передаче пустой ссылки в серверную процедуру уточните, как сервер обрабатывает незаполненные ссылки. Сервер может ожидать реальный объект и вернуть ошибку, если получит пустую ссылку без дополнительной проверки.
Что важно запомнить
На клиенте используйте ПустаяСсылка(Тип), проверяйте через ЗначениеЗаполнено и не путать пустую ссылку с Неопределено.
Можно ли получить пустую ссылку через Справочники.Имя.ПустаяСсылка() на клиенте?
На тонком и веб-клиенте глобальная коллекция Справочники может быть недоступна, поэтому этот способ не всегда работает. Надёжнее использовать функцию ПустаяСсылка(Тип) с типом нужного справочника.
Чем пустая ссылка отличается от Неопределено?
Пустая ссылка имеет тип справочника или другого объекта, но не указывает на конкретный элемент. Неопределено не имеет типа и означает полное отсутствие значения. Сравнение их через равно даёт Ложь.
Как проверить, что ссылка пустая?
Используйте функцию ЗначениеЗаполнено(): для пустой ссылки она вернёт Ложь. Также можно сравнить значение с ПустаяСсылка() того же типа.
Безопасно ли записывать пустую ссылку в базу?
Запись очищает реквизит и может разорвать связи с другими объектами. Перед массовыми изменениями проверьте логику на копии информационной базы и убедитесь, что реквизит не обязательный.
Можно ли вызывать методы у пустой ссылки?
Нет. Пустая ссылка не содержит данных элемента, поэтому обращение к его реквизитам или методам вызовет ошибку. Сначала проверьте заполненность через ЗначениеЗаполнено.