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