Как в 1С Предприятии определить, что документ только что создан

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

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

Анализ свойства «ЭтоНовый» в модуле объекта

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

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

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

⚠️ Внимание: Свойство ЭтоНовый теряет свою актуальность сразу после успешной записи объекта в базу данных (метод Записать()). В коде, выполняющемся после записи, необходимо использовать другие методы проверки, так как объект перестает считаться новым.

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

Процедура ПередЗаписью(Отказ, РежимЗаписи, РежимПроведения)
Если ЭтоНовый Тогда
// Логика инициализации только для нового документа
ЗаполнитьРеквизитыПоУмолчанию();
КонецЕсли;
КонецПроцедуры

Проверка ссылки на объект и пустой идентификатор

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

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

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

• 🔍 Свойство Ссылка.Пустая() возвращает Истина для новых объектов.
• 🔍 После записи документа свойство Ссылка содержит уникальный идентификатор.
• 🔍 Метод работает корректно для всех видов документов и справочников.

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

Функция ЭтоНовыйДокумент(ОбъектДокумента)
Возврат ОбъектДокумента.Ссылка.Пустая();
КонецФункции

Использование режима записи и проведения

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

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

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

Параметр / Свойство	Значение для Нового	Значение для Существующего	Где доступно
ЭтоНовый	Истина	Ложь	Модуль объекта, Модуль формы
Ссылка.Пустая()	Истина	Ложь	В любом месте кода
РежимЗаписи	Запись / Проведение	Запись / Проведение	Обработчик ПередЗаписью

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

Определение новизны в модуле формы

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

В отличие от модуля объекта, в модуле формы мы работаем с объектом формы, который содержит копию данных документа. Однако свойство Объект.ЭтоНовый здесь также доступно и работает аналогичным образом. Разработчик может использовать его для блокировки определенных действий, которые недопустимы для еще не сохраненных документов.

Частая ошибка заключается в попытке определить новизну по заполненности полей. Это ненадежный метод, так как новые документы могут создаваться на основе шаблонов или копированием, где поля уже заполнены. Единственный верный критерий — это внутреннее состояние объекта метаданных, а не визуальное наполнение формы.

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

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

Процедура ПриСозданииНаСервере(Отказ, СтандартнаяОбработка)
Если Объект.ЭтоНовый Тогда
// Скрываем исторические данные для нового документа
Элементы.ИсторияИзменений.Видимость = Ложь;
КонецЕсли;
КонецПроцедуры

Почему не стоит проверять номер документа?

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

Работа с временными хранилищами и копированием

Сценарии копирования документов или создания их на основе временных данных требуют особого подхода. Когда пользователь выбирает функцию «Скопировать», система создает новый объект, но наполняет его данными старого. В этот момент с точки зрения платформы документ является новым, несмотря на наличие данных.

Это поведение корректно и ожидаемо. Свойство ЭтоНовый вернет Истина, так как у копии еще нет своего идентификатора в базе. Разработчику важно учитывать этот момент, чтобы не сбросить важные реквизиты, которые были скопированы, но должны остаться неизменными.

Иногда возникает задача отличить документ, созданный «с нуля», от документа, созданного копированием. Для этого свойство новизны не подходит, так как в обоих случаях оно истинно. В таких случаях используют дополнительные флаги или анализируют источник данных, если такая информация передается в параметрах формы.

• 📋 Копирование создает новый объект с новым UUID.
• 📋 Загрузка из файла также создает новый объект в памяти.
• 📋 Проверка новизны одинакова для всех способов создания.

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

Частые ошибки и рекомендации по оптимизации

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

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

Помните, что понятие «новый» существует только до момента первой записи. После выполнения метода Записать() документ становится существующим. Если логика программы требует знать, была ли это первая запись в текущей сессии, необходимо использовать дополнительные переменные или флаги в модуле формы, так как свойство ЭтоНовый обновится автоматически.

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

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

Вопросы и ответы (FAQ)

Может ли свойство «ЭтоНовый» быть ложным для документа без номера?

Да, может. Если документ был записан в базу (получил UUID), но нумерация для него не предусмотрена или номер еще не присвоен, свойство ЭтоНовый все равно будет равно Ложь. Статус новизны зависит от факта записи, а не от заполнения реквизитов.

Как определить новизну документа во внешнем отчете или обработке?

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

Влияет ли проведение документа на его статус «Новый»?

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

Что происходит со свойством «ЭтоНовый» при отмене записи?

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