Экземпляры процессов
Экземпляр процесса — это конкретный запуск шаблона для одной сделки, задачи или другого объекта. Если бизнес-процесс описывает регламент, то экземпляр — это его прохождение здесь и сейчас: где процесс сейчас находится, какие шаги уже выполнены, чего он ждёт и чем завершился. Экземпляры — это рабочее место контроля: по ним руководитель видит, что автоматизация действительно работает, а не висит на середине.
Запущенные процессы доступны в разделе /automation/workflows.
Что такое экземпляр
Когда опубликованный процесс запускается — вручную или из автоматизации, — создаётся экземпляр, привязанный к конкретному объекту. Он идёт по графу шаблона: автоматические шаги выполняются сами, ручные задания уходят людям, узлы-ожидания держат паузу до времени или события. У каждого экземпляра своя история и свой текущий шаг.
Один шаблон может иметь много экземпляров одновременно — по одному на каждый объект, для которого процесс запустился.
Где смотреть
В разделе /automation/workflows экземпляры собраны на вкладке запущенных процессов. Оттуда можно открыть карточку конкретного экземпляра по адресу /automation/workflows/instances/:id. В списке видно состояние, связанный объект и время запуска; карточка раскрывает подробную историю.
Статусы экземпляра
Экземпляр проходит через состояния:
- идёт — процесс выполняется;
- ожидает — стоит на ручном задании или узле-ожидании (это нормальная пауза, а не ошибка);
- завершён — дошёл до конца;
- ошибка — шаг не выполнился и процесс не может продолжиться;
- прерван — остановлен вручную с причиной.
Статус — первое, на что смотрят при контроле: он отделяет нормальную паузу от застрявшего или сломанного процесса.
Карточка экземпляра: история шагов
В карточке экземпляра видны связанный объект, время начала и завершения, текущий шаг и история шагов на временной линии. По истории читается весь путь: какие узлы пройдены, что выполнено автоматически, где процесс ждал человека и сколько это заняло.
Используйте историю, чтобы ответить на вопросы: процесс действительно запустился, на каком шаге он сейчас, кто должен выполнить ручное действие и почему он завершился или остановился.
Дела к запуску
Часть шагов процессов выполняется по расписанию или по наступлению срока. Запуск таких отложенных шагов («дела к запуску») собирает их и обрабатывает за один проход, а затем показывает сводку: сколько шагов обработано, сколько успешно и сколько с ошибкой.
Читайте сводку как итог прогона: ненулевое число ошибок означает, что часть отложенных шагов не выполнилась — их нужно разобрать по соответствующим экземплярам.
Прерывание экземпляра с причиной
Зависший или ошибочно запущенный экземпляр можно прервать. При остановке указывайте понятную причину: позже она помогает отличить корректное управленческое решение от ошибки настройки. Не используйте прерывание, чтобы спрятать неправильный шаблон, — лучше исправить шаблон и оставить след в истории.
Прерывание касается конкретного экземпляра и не меняет шаблон: новые запуски пойдут по прежнему графу, пока вы не отредактируете и не опубликуете процесс заново.
Состояния и ограничения
- экземпляр в статусе «ожидает» — это пауза на задании или событии, а не сбой;
- экземпляр в статусе «ошибка» — шаг не выполнился, процесс остановился;
- прерванный экземпляр не возобновляется — при необходимости запускают новый;
- в сводке «дел к запуску» есть ошибки — часть отложенных шагов не прошла;
- нет прав на запуск или прерывание — соответствующие действия недоступны.
Хорошие практики
- Регулярно просматривайте запущенные экземпляры и их статусы.
- Различайте «ожидает» (норма) и «ошибка»/зависание (требует разбора).
- Указывайте понятную причину при прерывании.
- Разбирайте ошибки из сводки «дел к запуску» по конкретным экземплярам.
- Повторяющиеся ошибки на одном шаге чините в шаблоне, а не ручными обходами.
Частые ошибки
Путать «ожидает» с поломкой. Процесс на ручном задании выглядит «застрявшим», хотя просто ждёт человека.
Прерывать без причины. Потом невозможно понять, это было решение или ошибка.
Игнорировать ошибки в сводке прогона. Отложенные шаги молча не выполняются, и регламент рвётся.
Чинить симптом ручными действиями. Если экземпляры падают на одном шаге, проблема в шаблоне.
Как проверить результат
- статус экземпляра соответствует ожиданию (идёт, ожидает, завершён);
- история шагов показывает пройденный путь без неожиданных остановок;
- сводка «дел к запуску» завершилась без ошибок или ошибки разобраны;
- прерванные экземпляры имеют понятную причину;
- повторяющиеся сбои устранены в шаблоне.