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

Другое · 8 мин

1С: как проверить значение на пустоту

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

Пустое значение в 1С может означать разные состояния в зависимости от типа данных: неопределённое значение, пустая ссылка на объект справочника или документа, пустая строка, пустая дата или NULL в данных. Перед записью, расчётом или обменом важно отличать «не заполнено» от «значение равно нулю или пустой строке», иначе условие может сработать неверно.

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

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

Как 1С определяет пустое значение

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

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

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

ПризнакЧто означает

Пустая ссылка — объект не выбран

ПризнакЧто означает

Неопределённое значение — реквизит не инициализирован

ПризнакЧто означает

Пустая строка — длина ноль, но значение существует

ПризнакЧто означает

NULL в запросе — отсутствие значения в источнике данных

Проверка ссылок, справочников и документов

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

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

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

Проверка строк, чисел, дат и неопределённого значения

Пустую строку проверяют прямым сравнением с пустой строкой или через длину строки, если такая функция доступна в вашем релизе. Неопределённое значение проверяют сравнением с Неопределено. Не смешивайте эти проверки: пустая строка не равна неопределённому значению.

Для чисел пустотой обычно считается отсутствие значения, а не ноль. Если реквизит «Сумма» равен нулю, это заполненное значение; если он неопределён, сумма не введена. Перед расчётом убедитесь, что числовые реквизиты существуют, иначе результат может быть некорректным.

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

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

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

Порядок действий
  1. 1
    Определите обязательные реквизиты и их типы
  2. 2
    Выберите способ проверки для каждого типа
  3. 3
    Добавьте условие перед записью или расчётом
  4. 4
    Проверьте результат на тестовой копии базы
  5. 5
    Оформите протоколирование ошибок при массовой обработке

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

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

Типичные ошибки
01
Проверка пустой строки только универсальной функцией без сравнения с пустой строкой
02
Принятие нулевой суммы за пустое значение
03
Изменение типовой конфигурации без тестирования на копии базы

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

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

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

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

Универсальная проверка заполненности

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

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

Подходит для справочников и документов, ограничена ссылочными типами

Сравнение с Неопределено

Подходит для неинициализированных реквизитов, не проверяет пустые строки

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

Как проверить результат

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

Контрольные точки

Как проверить результат

Пустой обязательный реквизит
Норма

Запись блокируется, пользователю показано поле для заполнения

Тревожный признак

Запись проходит с пустым реквизитом или с неизвестной ошибкой

Заполненный реквизит
Норма

Документ или справочник сохраняется без сообщения

Тревожный признак

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

Массовая обработка
Норма

Протокол содержит объекты с пустыми обязательными полями

Тревожный признак

Пустые поля не обнаружены, но данные перенесены с пропусками

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

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

Итог

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

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

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

Что считается пустым значением в 1С?

Это зависит от типа данных: для ссылок — отсутствие выбранного объекта, для строк — пустая строка или неопределённое значение, для дат — пустая дата, в запросах — NULL. Каждый случай проверяется своим способом.

Можно ли использовать одну функцию для всех типов?

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

Нулевая сумма — это пустое значение?

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

Где размещать проверку перед записью документа?

В начале обработки события записи или проведения, чтобы не выполнять лишние действия с неполным объектом. Если проверка не пройдена, отменяйте запись и указывайте пользователю не заполненное поле.

Безопасно ли добавлять проверки в типовую конфигурацию?

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