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

Другое · 7 мин

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

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

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

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

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

Что понимать под новым документом в 1С

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

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

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

Где и как проверить новизну в интерфейсе

В форме документа

Откройте документ в форме редактирования и оцните заполнение реквизитов. Новый документ часто имеет пустой номер, дату равную дате создания или текущей дате сеанса, а также пустые табличные части. Если форма открыта после команды «Создать» и объект ещё не сохранён, изменения существуют только в оперативной памяти.

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

В списке документов

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

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

Проверка в программном коде

Через признак нового объекта

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

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

В модуле объекта документа

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

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

Новый документ и непроведённый документ: разница

Новый документ — это документ, который ещё не записан в базу. Непроведённый документ — это уже записанный объект, который прошёл этап сохранения, но не прошёл процедуру проведения. Эти состояния не совпадают.

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

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

Ограничения и риски при самодельной проверке

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

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

Порядок действий
  1. 1
    Определите, где создаётся документ: в форме, в обработке или в коде.
  2. 2
    Проверьте признак нового объекта в модуле формы или объекта.
  3. 3
    Убедитесь, что документ ещё не записан в базу.
  4. 4
    Отличите новый документ от непроведённого.
  5. 5
    Зафиксируйте результат проверки перед записью или проведением.

Риск неправильной проверки возрастает, если несколько пользователей создают одинаковые документы одновременно. Без блокировок и транзакций возможны дубли и конфликты при записи.

Пошаговый порядок проверки

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

Типичные ошибки
01
Проверять только наличие номера: новый документ может уже иметь временный номер.
02
Смешивать понятия «новый» и «непроведённый»: непроведённый документ может быть старым.
03
Использовать проверку формы в серверном коде, где форма недоступна.

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

Типичные ошибки

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

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

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

Документ только что создан и не сохранён
Норма

Форма открыта после команды Создать, объект в памяти, не в списке

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

Документ уже имеет постоянный номер и отображается в журнале

Проверка выполнена в коде
Норма

Признак новизны возвращает ожидаемое значение на тестовой базе

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

Проверка возвращает одинаковый результат для новых и старых документов

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

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

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

Итог

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

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

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

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

В чем разница между новым и непроведённым документом?

Новый документ ещё не записан в базу и может не отображаться в списке. Непроведённый документ уже записан, имеет номер и отображается, но не прошёл процедуру проведения. Это разные состояния.

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

Самостоятельное изменение модулей допустимо только после создания резервной копии и тестирования на копии рабочей базы. Ошибка в коде может повлиять на запись документов и работу пользователей.

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

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