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

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

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

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

Механизм проверки ссылки и пустого значения

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

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

В модуле формы или общем модуле проверка может выглядеть следующим образом:

Если Объект.Ссылка = ПустаяСсылка Тогда // Логика для нового документа

КонецЕсли;

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

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

Использование режима формы и флага Нового

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

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

🔍 РежимФормы — показываетный режим открытия окна (Создание, Редактирование, Просмотр).
🆕 Объект.Новый — указывает, есть ли несохраненные изменения или создан ли объект с нуля.
💾 Объект.Модифицированность — сигнализирует о любых правках, даже в уже записанном документе.

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

Обработчики событий ПередЗаписью и ПриЗаписи

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

В этом обработчике вы можете манипулировать данными, заполнять реквизиты по умолчанию или проводить сложные расчеты, которые должны выполниться только один раз при рождении документа. Использование параметра Отказ позволяет прервать запись, если условия для нового документа не выполнены.

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

Пример кода для модуля объекта:

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

КонецПроцедуры

Здесь метод ЭтоНовый является встроенной функцией контекста модуля объекта, которая работает аналогично проверке пустой ссылки, но более читаема.

💡

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

Особенности работы с помеченными на удаление объектами

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

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

Сценарий	Свойство Ссылка	Метод ЭтоНовый	Рекомендация
Создание с нуля	Пустая	Истина	Стандартная логика
Редактирование старого	Заполнена	Ложь	Логика обновления
Копирование документа	Пустая	Истина	Требуется перенос данных
Восстановление из удаления	Заполнена*	Ложь*	Проверка флага удаления

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

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

Синхронизация и обмен данными

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

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

Для корректной обработки в режиме синхронизации рекомендуется:

🔄 Проверять глобальный контекст выполнения на наличие активного сеанса синхронизации.
📝 Использовать специальные флаги в регистрах для пометки «импортных» документов.
🛑 Отключать лишнюю бизнес-логику в обработчиках ПередЗаписью при режиме обмена.

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

Как отключить логику при синхронизации?

Используйте конструкцию: Если Не Синхронизация.ЭтоСеансСинхронизации Тогда.. КонецЕсли; внутри обработчиков записи, чтобы выполнять код только при ручном вводе данных пользователем.

Практические примеры и частые ошибки

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

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

Рассмотрим пример безопасной последовательности действий при создании сложного документа:

Проверка условия новизны через ЭтоНовый.
Заполнение служебных реквизитов.
Вызов метода Записать для фиксации ссылки (если требуется до проведения).
Формирование движений по регистрам.

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

💡

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

В чем разница между ЭтоНовый и Ссылка = ПустаяСсылка?

Функционально они почти идентичны для документов. Однако ЭтоНовый является более читаемым методом контекста объекта, тогда как проверка ссылки — это работа с типами данных. В некоторых редких случаях работы с временными таблицами проверка ссылки может быть предпочтительнее.

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

Прямого свойства «СозданоКопированием» нет. Обычно это определяют по заполненности реквизитов-оснований или анализируют историю изменений. Часто используют флаг, передаваемый через параметры формы при открытии в режиме копирования.

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

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

Зачем проверять новый документ в модуле формы, а не объекта?

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