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