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