В процессе разработки в системе 1С:Предприятие 8 часто возникает вопрос: есть ли разница в том, нажал ли пользователь кнопку «Провести» в форме документа или программист вызвал метод Записать(РежимЗаписиДокумента.Проведение) в коде? На первый взгляд результат кажется идентичным — документ получает статус «Проведен» и формирует движения. Однако «под капотом» платформы процессы протекают существенно по-разному. Разберем детально эти отличия, чтобы избежать трудноуловимых ошибок при автоматизации бизнес-процессов.
Проанализируем работу стандартного механизма проверки заполнения реквизитов. При интерактивном проведении (через форму) платформа автоматически инициирует событие ОбработкаПроверкиЗаполнения. Это позволяет системе выдать пользователю список незаполненных полей до того, как начнется транзакция записи. Рассмотрим, как это работает программно.
В случае программного вызова метода Записать(), обработчик ОбработкаПроверкиЗаполнения по умолчанию не вызывается. Это сделано для повышения производительности массовых операций. Если ваша логика проведения опирается на то, что данные всегда валидны благодаря этому обработчику, программное проведение может привести к записи некорректных данных. Чтобы выполнить проверку программно, необходимо явно вызвать метод ПроверитьЗаполнение():
// Пример программного проведения с проверкой
Если ДокументОбъект.ПроверитьЗаполнение() Тогда
ДокументОбъект.Записать(РежимЗаписиДокумента.Проведение);
КонецЕсли;
Выясним причину, по которой интерактивное проведение часто сопровождается визуальными эффектами или обновлением связанных данных, а программное — нет. При работе через интерфейс система создает объект формы, и в цепочку выполнения включаются специфические события:
ПередЗаписьюНаСервереПриЗаписиНаСервереПослеЗаписьНаСервереПри программном проведении объект формы отсутствует. Это означает, что любой код, написанный в модуле формы для подготовки данных к проведению, просто не будет выполнен. Рассмотрим ситуацию: разработчик решил обновлять остатки в динамическом списке на форме в процедуре ПослеЗаписиНаСервере. Если этот же документ будет проведен регламентным заданием, никакого обновления (и связанных с ним расчетов) не произойдет. Поэтому критически важную бизнес-логику всегда следует выносить в модуль объекта или модуль менеджера.
Рассмотрим ситуацию, когда в коде проведения прописан вопрос пользователю. При интерактивном действии программист может использовать конструкцию ПоказатьВопрос(). Однако программное проведение может выполняться на сервере в фоновом задании, где никакого пользователя нет.
Если в обработчике ПередЗаписью модуля объекта вызвать метод, требующий взаимодействия с интерфейсом (например, предупреждение), программное проведение завершится критической ошибкой: «Интерактивные операции в данном контексте недопустимы». Чтобы этого избежать, всегда используем проверку:
// Правильный подход к интерактивным действиям
#Если Клиент Тогда
// Здесь можно вызывать вопросы и предупреждения
Предупреждение("Документ будет проведен!");
#КонецЕсли
Проанализируем способ передачи данных между формой и сервером. Часто в форме документа мы заполняем структуру ДополнительныеСвойства, чтобы передать в модуль объекта какой-то флаг (например, "РазрешитьПревышениеЛимита"). При интерактивном нажатии кнопки «Провести» форма передает этот параметр в объект.
При программном создании объекта и вызове Записать(), коллекция ДополнительныеСвойства будет пустой. Если логика проведения в модуле объекта жестко завязана на наличие этих свойств, код может отработать неверно. Посмотрим на пример безопасного извлечения свойств:
// В модуле объекта
Разрешить = Ложь;
ДополнительныеСвойства.Свойство("РазрешитьПревышениеЛимита", Разрешить);
Если Разрешить Тогда
// Особая логика проведения
КонецЕсли;
Посмотрим на специфический режим, который часто путают с обычным программным проведением — ОбменДанными.Загрузка = Истина. Этот флаг обычно устанавливается при синхронизации данных. В этом режиме отключается большинство проверок в ПередЗаписью и ПриЗаписи. Интерактивно (через интерфейс) включить этот режим без доработки конфигурации невозможно. Это ключевое отличие программного проведения при миграции данных от обычного проведения пользователем, так как во втором случае все бизнес-правила конфигурации будут применены в полном объеме.
Разберем, как различается нагрузка на систему. Интерактивное проведение одного документа обычно инициирует транзакцию только для этого объекта. Пользователь визуально ждет окончания процесса. Однако при программном проведении в цикле (например, при групповом перепроведении за месяц) программист может допустить ошибку, объединив проведение сотен документов в одну транзакцию.
Это приводит к длительным блокировкам таблиц базы данных, что парализует работу других пользователей. При интерактивном проведении платформа сама управляет блокировками формы, чтобы два пользователя не редактировали один документ одновременно. В программном коде ответственность за установку управляемых блокировок (БлокировкаДанных) полностью ложится на плечи разработчика.
Последний важный нюанс — контекст безопасности. Интерактивное проведение всегда выполняется под правами текущего пользователя. Если у бухгалтера нет прав на запись в регистр «Бухгалтерские проводки», кнопка «Провести» выдаст ошибку доступа.
Программное проведение может быть инициировано из привилегированного модуля (с установленным флагом «Привилегированный»). В этом случае документ будет проведен игнорируя настройки RLS (ограничение доступа на уровне записей) и проверки прав пользователя. Это мощный инструмент, который, однако, требует осторожности, чтобы не нарушить целостность системы безопасности предприятия.
Главное различие заключается в контексте исполнения. Интерактивное проведение — это цепочка: Интерфейс -> Форма -> Объект -> База данных. Программное проведение — это прямой путь: Объект -> База данных. Для создания надежных систем всегда учитывайте отсутствие контекста формы и необходимость явного вызова проверок при программной работе с документами.