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

Другое · 8 мин

Программный запуск бизнес-процесса в 1С: пошаговое руководство

Как стартовать бизнес-процесс 1C программно: способы запуска, проверка прав, типичные ошибки и контроль результата с рекомендациями по тестированию на копии базы.

Бизнес-процессы в 1С часто описывают маршрут согласования, обработки заявки или движения документа. В стандартном режиме они стартуют вручную пользователем, по событию или по расписанию, но иногда требуется запуск из кода: из внешней обработки, команды интерфейса, встроенного языка или интеграции с другой системой.

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

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

Когда программный запуск уместен

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

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

Способы запуска из конфигурации

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

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

1c
&НаКлиенте
Процедура ЗапуститьПроцессКоманда(Команда)
    Экземпляр = БизнесПроцессы.СоздатьЭкземпляр("ИмяПроцесса");
    Экземпляр.Объект = СсылкаНаОбъект;
    Экземпляр.Начать();
КонецПроцедуры

Запуск по ссылке на документ

Частый сценарий: при проведении документа «Заявка на закупку» запускается процесс согласования. В коде передаётся ссылка на документ в параметр экземпляра процесса, чтобы первый этап сразу знал, по какому объекту работать. Если ссылка не заполнена, процесс может стартовать, но остановиться на этапе из-за отсутствия объекта.

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

Запуск по расписанию или в фоне

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

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

Процесс существует в конфигурацииШаблон виден в конфигураторе и подсистеме бизнес-процессов

Уточните точное имя процесса и доступные параметры

Права пользователяПользователь может запускать процессы и читать объект

Проверьте роли и права на объект и подсистему

Предварительные условияВ шаблоне есть условия старта и обязательные реквизиты

Заполните параметры экземпляра перед вызовом запуска

Проверка результата запуска

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

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

Ограничения и риски

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

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

Частые ошибки

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

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

Типичные ошибки
01
Создали экземпляр, но не вызвали запуск — процесс не начинает движение
02
Передали пустую ссылку на документ — первый этап не находит объект
03
Запуск от пользователя без прав — процесс не стартует или ошибка доступа

Альтернативы программному запуску

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

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

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

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

Статус экземпляра процесса
Норма

Активный или выполнено

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

Черновик, ошибка или отсутствует экземпляр

Исполнитель первого этапа
Норма

Назначен пользователь или роль

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

Исполнитель не определён

Журнал регистрации
Норма

Запись о запуске есть

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

Записей нет или есть исключение

Безопасная самостоятельная работа

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

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

Итог

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

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

Можно ли запустить бизнес-процесс без прав пользователя?

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

Что делать, если процесс не стартует после вызова кода?

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

В чём разница между созданием экземпляра и запуском процесса?

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

Безопасно ли запускать процессы напрямую в рабочей базе?

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

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

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