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

Другое · 10 мин

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

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

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

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

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

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

Пустая ссылка — это специальное значение типа СправочникСсылка.Имя, ДокументСсылка.Имя или другого ссылочного типа, которое не указывает на конкретный объект базы. У него нет заполненного идентификатора, и обращение к его свойствам вызывает ошибку. В конфигураторе такое значение получается вызовом ПустаяСсылка() у соответствующего метаобъекта.

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

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

Когда проверка нужна на клиенте

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

На клиенте проверка выполняется без обращения к серверу, что важно для производительности в тонком и веб-клиенте. Однако не все операции со ссылками доступны клиентскому контексту, поэтому сложную логику лучше выносить на сервер, а на клиенте оставить только признак заполненности.

Если форма работает в управляемом приложении, проверку удобно разместить в обработчиках ПриИзменении реквизита, ПередЗаписью или при открытии формы. В обычном приложении подходят аналогичные события формы модуля объекта или модуля формы.

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

Сравнение с ПустаяСсылка() нужного типа

Надёжный способ — сравнить значение реквизита с результатом вызова ПустаяСсылка() у того же справочника или документа. Пример условия на клиенте: Если СсылкаНаКонтрагента = Справочники.Контрагенты.ПустаяСсылка() Тогда. Условие истинно только тогда, когда ссылка действительно пуста и относится к указанному типу.

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

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

Функция ЗначениеЗаполнено работает на клиенте и возвращает ложь для пустых ссылок большинства ссылочных типов. Условие Если Не ЗначениеЗаполнено(Ссылка) Тогда позволяет отловить незаполненный реквизит без указания типа справочника. Это удобно, когда тип реквизита может меняться или заранее неизвестен.

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

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

Иногда полезно убедиться не только в заполненности, но и в том, что значение относится к ожидаемому ссылочному типу. Для этого используется ТипЗначения. Это помогает избежать ситуации, когда в реквизит попадает значение другого справочника или документа, и прямая проверка на пустоту не срабатывает по смыслу задачи.

Особенности работы на клиенте

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

ПризнакРеквизит не выбран в форме

Проверьте значение через ПустаяСсылка() или ЗначениеЗаполнено

ПризнакОшибка при открытии объекта

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

ПризнакЗапись проходит без обязательного реквизита

Добавьте проверку в ПередЗаписью на клиенте или сервере

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

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

Порядок действий
  1. 1
    Определите тип справочника или документа для проверяемой ссылки
  2. 2
    Напишите условие сравнения с ПустаяСсылка() или вызов ЗначениеЗаполнено
  3. 3
    Добавьте обработку результата: сообщение, блокировка записи или отбор
  4. 4
    Проверьте поведение на пустой, заполненной и неверной ссылке
  5. 5
    Запустите проверку на копии информационной базы

Пошаговая проверка в форме

Откройте модуль формы, в которой нужно контролировать заполнение ссылки. Найдите событие, в котором проверка логична: ПриИзменении реквизита, ПередЗаписью или ПриОткрытии. Напишите условие, которое определяет, заполнена ли ссылка.

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

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

Частые ошибки и ограничения

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

Типичные ошибки
01
Сравнение пустых ссылок разных справочников — условие всегда ложно
02
Проверка через Неопределено вместо ПустаяСсылка() — пустая ссылка пропускается
03
Оценка заполненности по строковому представлению — ложный результат

Некоторые разработчики проверяют только длину строкового представления ссылки. Это ненадёжно: строковое представление пустой ссылки может быть непустым, а проверка через него даёт ложный результат. Используйте специальные средства языка 1С, а не текстовые приёмы.

Ограничение клиентской проверки в том, что она не защищает от прямой записи через программный интерфейс или внешние обработки. Если данные критичны, дублируйте проверку на сервере в модуле объекта или менеджере.

Сравнение вариантов

Сравнение с ПустаяСсылка()

Точно для известного типа, требует указания справочника или документа

ЗначениеЗаполнено

Универсально и просто, но менее точно для сложных типов

ТипЗначения

Позволяет исключить чужой тип, но не заменяет проверку на пустоту

Сравнение способов проверки

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

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

Риски и безопасная самостоятельная работа

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

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

Итог

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

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

Часто задаваемые вопросы

Можно ли сравнивать ссылку с пустой ссылкой любого справочника?

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

Работает ли ЗначениеЗаполнено для пустой ссылки на клиенте?

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

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

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

Нужна ли серверная проверка, если уже есть клиентская?

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

Можно ли проверять пустую ссылку в веб-клиенте?

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