Другое · 7 мин
Как программно запустить бизнес-процесс в 1С
Программный запуск бизнес-процесса в 1С: способы инициации, проверка прав и контекста выполнения, признаки успешного старта и ошибки без риска для данных.
Бизнес-процессы в 1С часто стартуют по стандартным событиям: созданию документа, изменению реквизита или истечению срока. Когда стандартных условий недостаточно, например при интеграции с внешней системой или сложной логике инициации, приходится запускать процесс программно.
Программный запуск означает, что код инициирует экземпляр бизнес-процесса с заданными параметрами, ответственными и данными для обработки. Важно понимать, что механизм зависит от используемой конфигурации, версии платформы и того, где выполняется код: в клиентском приложении, на сервере или в фоновом задании.
Перед запуском нужно уточнить вариант процесса, состав входных параметров, права текущего пользователя и порядок проверки результата. Рекомендуется отрабатывать сценарий на копии базы, чтобы случайно не запустить массовую обработку документов или не создать дублирующие экземпляры процессов.
Когда программный запуск оправдан
Программный запуск уместен, если стандартные условия старта не покрывают ситуацию. Например, процесс должен начаться после завершения внешней выгрузки, по результату вычисления в отчете или при действии пользователя в форме, для которого нет предусмотренного события.
Такой подход оправдан, когда нужно передать в процесс конкретный объект, контрагента, договор или набор строк табличной части. Если же процесс должен стартовать при любом создании документа, проще настроить стандартное условие запуска, чем поддерживать дополнительный код.
Основные способы запуска из конфигурации
Запуск по изменению данных
Код может размещаться в модуле объекта, модуле формы или обработчике события, связанном с записью документа или справочника. При сохранении объекта проверяется условие, и если оно выполняется, вызывается механизм старта бизнес-процесса с передачей ссылки на объект.
Такой способ подходит для процессов согласования, проверки заполнения реквизитов или запуска этапа после утверждения документа. Риск в том, что обработчик сработает при каждом сохранении, включая исправление опечатки, поэтому условие должно быть точным.
Запуск по расписанию или из фонового задания
Если процесс должен стартовать раз в день, неделю или после закрытия периода, используется расписание или фоновое задание. Код собирает список объектов, подлежащих обработке, и для каждого инициирует отдельный экземпляр процесса.
Фоновый запуск выполняется на сервере, поэтому важно учитывать права пользователя, от имени которого работает задание, и ограничения на длительность сессии. Долгий процесс может заблокировать ресурсы или прерваться при истечении тайм-аута.
Запуск из внешней интеграции
Внешняя система может инициировать процесс через веб-сервис, COM-соединение или другой поддерживаемый интерфейс 1С. В этом случае точка входа должна принимать параметры, проверять подлинность и создавать экземпляр процесса в безопасном контексте.
При внешнем запуске особенно важно валидировать incoming-данные: некорректная ссылка на документ или отсутствующий реквизит может привести к ошибке выполнения процесса или созданию «висящего» экземпляра без исполнителя.
- 1Определите вариант бизнес-процесса и необходимые входные параметры
- 2Проверьте права текущего пользователя и контекст выполнения: клиент, сервер или фоновое задание
- 3Напишите или настройте код запуска с точным условием срабатывания
- 4Проведите тест на копии базы с минимальным набором документов
- 5Запустите в рабочей базе и проверьте создание экземпляра процесса
Подготовка, права и контекст выполнения
Перед программным стартом уточните, какой пользователь инициирует процесс. Если код выполняется от имени текущего пользователя, у него должны быть права на чтение исходных данных и запись результатов процесса. При серверном запуске права зависят от учетной записи фонового задания.
Отдельно проверьте контекст: клиентский код не всегда имеет доступ к серверным объектам, а серверный код может не видеть временные сессии пользователя. Неправильный контекст чаще всего становится причиной ошибки «не хватает прав» или пустого результата запуска.
Также определите, должен ли процесс быть синхронным или асинхронным. Синхронный запуск заставляет пользователя ждать завершения, а асинхронный позволяет продолжить работу, но требует отдельной проверки статуса экземпляра.
Проверка результата и признаки успешного запуска
Успешный запуск подтверждается созданием экземпляра бизнес-процесса со статусом «Выполняется» или «Назначен», появлением задачи у исполнителя и изменением реквизита документа, если такое изменение предусмотрено процессом.
Если экземпляр не создан, проверьте журнал регистрации, сообщения об ошибках и условия старта. Часто причина кроется в отсутствии права на запуск процесса, неверной ссылке на объект или блокировке документа другим пользователем.
Для массового запуска ведите учет созданных экземпляров по времени и инициатору. Это упростит поиск дублей и поможет понять, завершились ли процессы или остались на этапе ожидания.
Как проверить результат
Есть запись со статусом выполнения и назначенным исполнителем
Экземпляр отсутствует или висит в статусе ошибки
Реквизиты и статусы обновлены согласно логике процесса
Документ не изменился, хотя процесс должен был его обработать
Задача видна в списке задач пользователя
Исполнитель не получил уведомления и задачи нет
Ограничения и типичные ошибки
Не все конфигурации одинаково открывают программный интерфейс для управления бизнес-процессами. В некоторых решениях старт доступен только через встроенные инструменты администрирования, в других — через объектную модель конфигурации. Перед написанием кода изучите возможности вашей конфигурации.
Ограничение по количеству одновременных процессов, длительности выполнения и блокировкам объектов может привести к отказу в запуске. Не запускайте большое число тяжелых процессов одновременно в рабочее время без оценки нагрузки на сервер.
Работать самостоятельно безопасно при разовом запуске на копии базы, с проверкой прав и минимальным объемом данных. Обращайтесь к администратору системы или разработчику конфигурации при настройке фоновых заданий, интеграции и доступа к серверным ресурсам.
Итоговый выбор способа зависит от того, кто инициирует запуск, где выполняется код и какие данные нужно передать в процесс. Основное правило: проверяйте условие старта, права и результат на копии базы перед работой с реальными данными.
Что важно запомнить
Программный запуск возможен, но способ зависит от конфигурации и контекста; проверяйте права, условия и результат, тестируйте на копии базы.
Нужен ли программный запуск, если есть стандартное условие старта?
Если процесс должен начинаться при создании или изменении документа по простому правилу, стандартного условия достаточно. Программный запуск оправдан при сложной логике, внешней инициации или необходимости передать специфические параметры.
Можно ли запускать процесс от любого пользователя?
Нет, пользователь или учетная запись фонового задания должны иметь права на запуск бизнес-процесса и доступ к связанным объектам. Иначе процесс не создастся или завершится с ошибкой прав доступа.
Как отличить успешный запуск от просто создания задачи?
Успешный запуск фиксируется созданием экземпляра процесса с идентифицируемым статусом, а не только появлением задачи. Если задача есть, но экземпляра процесса нет, возможно, сработал только уведомляющий механизм без реального старта процесса.
Что делать, если процесс «зависает» после запуска?
Проверьте статус экземпляра, журнал регистрации и заполненность обязательных реквизитов. Частая причина — ожидание действия исполнителя, блокировка документа или невыполнение условия перехода на следующий этап.
Безопасно ли тестировать программный запуск в рабочей базе?
Для первичной отладки рабочую базу использовать небезопасно: возможны дубли процессов, блокировки документов и изменения реквизитов. Сначала отработайте сценарий на копии с ограниченным набором данных.