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

Другое · 5 мин

Запись объекта из управляемой формы в 1С

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

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

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

Когда запись объекта требуется явно

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

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

Форма открыта на редактированиеОбъект доступен для изменения и записи

Проверьте права доступа и режим формы

Объект новыйСсылка ещё не заполнена

Запись создаёт запись в базе и заполняет ссылку

Изменения не появляются в базеВызов записи пропущен или отменён ошибкой

Посмотрите сообщение об ошибке и состояние транзакции

Способы вызова метода записи

Наиболее распространённый способ — вызов метода Запись() у объекта формы, например Объект.Запись(). Это фиксирует текущие значения реквизитов в информационной базе, если объект прошёл проверку на заполнение.

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

Запись нового объекта

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

Запись существующего объекта

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

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

Проверка результата и обработка ошибок

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

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

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

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

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

Типичные ошибки
01
Закрытие формы без вызова записи — изменения теряются
02
Вызов записи у формы вместо объекта — данные не сохраняются
03
Игнорирование ошибки записи — пользователь считает, что данные сохранены

Альтернативы и выбор способа сохранения

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

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

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

Стандартная команда сохранения формы

Подходит для обычного ввода данных, использует встроенную проверку и проведение

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

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

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

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

Итог

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

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

Часто задаваемые вопросы

Нужно ли закрывать форму после записи объекта?

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

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

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

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

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

Нужно ли использовать транзакцию при записи из формы?

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