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

Другое · 7 мин

Как в 1С проверить, что объект записан

Проверка записи объекта в 1С: ссылка, GetModified, запрос к базе, отличия нового и существующего объекта, частые ошибки и способы проверки результата

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

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

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

Как определить, что новый объект записан

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

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

Новый объект перед записьюСсылка обычно не заполнена

Проверьте ЗначениеЗаполнено(Объект.Ссылка) до вызова Запись

Новый объект после записиСсылка обычно заполнена

Убедитесь запросом, что запись существует в базе

Существующий объект после измененияМожет иметь несохранённые изменения

Проверьте метод Изменён и выполните запись повторно при необходимости

Как проверить сохранение изменений существующего объекта

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

Для контроля используйте метод Изменён или соответствующий признак изменения объекта. Если метод возвращает, что объект изменён, выполните запись и проверьте результат. Если запись не требуется, отмените изменения или перечитайте объект из базы, чтобы не работать с несохранённым состоянием.

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

Когда ссылки недостаточно и нужен запрос к базе

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

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

Порядок проверки перед зависимыми действиями

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

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

Ограничения и риски при самостоятельной проверке

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

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

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

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

Ссылка нового объекта после записи
Норма

ЗначениеЗаполнено возвращает истину

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

Ссылка не заполнена или объект не найден запросом

Существующий объект после изменения
Норма

Метод Изменён не указывает на несохранённые изменения

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

Объект остаётся изменённым после вызова Запись

Запрос к базе по ссылке
Норма

Возвращает запись объекта

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

Возвращает пустой результат

Частые ошибки и что делать, если запись не прошла

Самая частая ошибка — считать объект записанным сразу после создания или после вызова метода без проверки результата. Другая ошибка — проверять ссылку внутри той же транзакции до её подтверждения, что может создать ложное представление о сохранении. Также опасно игнорировать исключения метода Запись и продолжать работу с объектом, как будто запись успешна.

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

Итог

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

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

Нужно ли проверять запись каждого объекта?

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

Что делать, если ссылка заполнена, но запрос не находит объект?

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

Можно ли доверять сообщению об успешном сохранении в форме?

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

Какая разница между новым и существующим объектом при проверке?

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