Как провести документ из формы в 1С

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

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

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

Интерактивное проведение кнопкой в форме

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

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

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

Программное проведение из кода формы

Когда проведение нужно запустить из собственной команды формы — например, по кнопке «Утвердить» или после заполнения дополнительных реквизитов, — используется метод Записать объекта формы с параметром режима записи. Это стандартный и безопасный способ, потому что он проходит через все обработчики объекта.

&НаКлиенте
Процедура ПровестиДокумент(Команда)

ПараметрыЗаписи = Новый Структура("РежимЗаписи", РежимЗаписиДокумента.Проведение);

Если Записать(ПараметрыЗаписи) Тогда
ОповеститьОбИзменении(Объект.Ссылка);
Иначе
ПоказатьПредупреждение(, "Документ не проведён. См. сообщения об ошибках.");
КонецЕсли;

КонецПроцедуры

Метод Записать формы возвращает Истина, если запись и проведение прошли успешно, и Ложь в противном случае. Возвращаемое значение обязательно стоит проверять: по нему вы решаете, показывать ли пользователю подтверждение или сообщение о неудаче.

ПараметрыЗаписи = Новый Структура("РежимЗаписи", РежимЗаписиДокумента.Проведение);
Записать(ПараметрыЗаписи);

Режимы записи: проведение, отмена и простая запись

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

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

Учтите: если вид документа настроен как «непроводимый» (в метаданных отключено проведение), попытка записи с режимом Проведение вызовет ошибку. Перед разработкой команды проверьте свойство «Проведение» документа в конфигураторе.

Проведение на сервере и вне формы

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

&НаСервере
Процедура ПровестиПоСсылке(ДокументСсылка)

ДокументОбъект = ДокументСсылка.ПолучитьОбъект();
Попытка
ДокументОбъект.Записать(РежимЗаписиДокумента.Проведение);
Исключение
ЗаписьЖурналаРегистрации("Проведение", УровеньЖурналаРегистрации.Ошибка, , ,
ОписаниеОшибки());
КонецПопытки;

КонецПроцедуры

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

Обработка ошибок и контроль результата

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

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

Типичные ошибки при проведении из формы

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

Вторая частая проблема — игнорирование результата записи. Код выполняет Записать(...) и сразу закрывает форму или выводит «Документ проведён», хотя проведение было отклонено. Всегда анализируйте возвращаемое значение или оборачивайте серверный вызов в попытку.

Частые вопросы