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