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

Другое · 6 мин

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

Как в 1С определить, что документ новый и ещё не записан: признаки, программная проверка, отличие от непроведённого и риски самостоятельной настройки.

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

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

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

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

Что означает «документ новый» в 1С

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

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

Флаг «Новый»Объект создан, но не записан

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

Номер документаОтсутствует или временный

Сравните с номером после сохранения

Режим формыРедактирование без записи

Убедитесь, что форма не закрыта без сохранения

Где проверить признак нового документа

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

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

Программная проверка в модуле объекта или формы

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

Сценарий сохранения нового документа

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

Порядок действий
  1. 1
    Откройте форму или модуль объекта документа
  2. 2
    Найдите свойство, указывающее на новый объект
  3. 3
    Выполните проверку перед записью или проведением
  4. 4
    Зафиксируйте результат и сохраните документ

Отличие нового документа от непроведённого

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

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

Ограничения и риски при самопроверке

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

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

Что делать, если признак не определяется

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

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

Итог

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

Новый документ в 1С — это объект до первой записи; проверяйте признак перед сохранением, не путать с непроведённым и не изменяйте признак в уже записанных документах.

Можно ли считать документ новым, если у него уже есть номер?

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

Отличается ли непроведённый документ от нового?

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

Безопасно ли менять признак нового документа вручную?

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

Что делать, если свойство новизны не работает?

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