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

Другое · 10 мин

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

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

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

Понятие «новый» не совпадает с понятием «непроведённый». Документ может быть записан, но оставаться непроведённым, а может быть записан и проведён. Также записанный документ может быть помечён на удаление. Каждое из этих состояний требует своей проверки и не должно подменять проверку на новизну.

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

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

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

Что понимать под новым документом в 1С

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

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

Проверка в модуле объекта документа

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

Пример логики: если ЭтоНовый, то заполнить автореквизиты, установить дату текущего сеанса или запретить определённые действия. Если это не так, то действовать как с существующим документом: проверять права, проведение, пометку удаления и историю изменений.

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

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

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

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

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

Запрос по ссылке позволяет понять, записан ли документ в базе, но не всегда чётко разделяет «новый не записанный» и «существующий, но удалённый или помечённый». Поэтому для надёжной диагностики комбинируют проверку объекта в памяти и проверку существования записи в базе по ссылке.

Проверка через базу данных и ссылку

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

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

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

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

Отличия новых, проведённых и помечённых документов

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

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

Типичные ошибки
01
Считать пустой номер признаком нового документа, хотя номер может присваиваться при записи
02
Проверять ЭтоНового после записи, когда признак уже сброшен
03
Смешивать новые документы с непроведёнными или помечёнными на удаление
04
Принимать решения о записи только на клиенте без серверной проверки

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

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

Ограничения и риски при самостоятельных изменениях

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

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

Сравнение вариантов

Проверка свойства ЭтоНовый

Подходит для объектов в памяти перед записью, не работает после сохранения и не заменяет проверку по базе.

Получение объекта по ссылке

Позволяет узнать, записан ли документ, но не подходит для ещё не записанных объектов в текущем сеансе.

Запрос по ссылке или реквизитам

Универсален для обмена и импорта, но требует осторожности с неисполненными транзакциями и временными данными.

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

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

Быстрый маршрут выбора способа проверки

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

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

Контрольные точки

Как проверить результат

Объект только что создан и не записан
Норма

Свойство ЭтоНовый возвращает истину перед записью

Тревожный признак

После записи свойство становится ложью

Документ существует по ссылке в базе
Норма

Запрос по ссылке возвращает запись

Тревожный признак

Запрос пуст или ссылка некорректна

Документ записан, но не проведён
Норма

ЭтоНовый ложь, признак проведения не установлен

Тревожный признак

Путаница между непроведённым и новым документом

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

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

Итог

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

Новый документ определяется свойством ЭтоНового до записи; после записи этот признак теряет смысл. Не заменяйте его пустым номером, не проведением или пометкой удаления, и тестируйте изменения на копии базы.

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

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

Работает ли проверка ЭтоНового после записи документа?

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

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

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

Безопасно ли править модуль документа в типовой конфигурации?

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