Приглашаем к тестированию LadVen OSЗапросить демо
Перейти к основному содержимому

Экземпляры процессов

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

Запущенные процессы доступны в разделе /automation/workflows.

Если карточка ручного задания, экземпляра или правила показывает технический ID вместо названия, статуса или связанного объекта, это дефект отображения. Проверьте понятные название, статус, исполнителя и источник; не принимайте raw ID за рабочее имя и не включайте такую карточку в общие документы или скриншоты — передайте экран администратору.

Что такое экземпляр

Жизненный цикл экземпляра Жизненный цикл экземпляра — концептуальная схема, не UI-скриншот и не evidence.

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

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

Где смотреть

Жизненный цикл экземпляра Жизненный цикл экземпляра — концептуальная схема, не UI-скриншот и не evidence.

В разделе /automation/workflows экземпляры собраны на вкладке запущенных процессов. Оттуда можно открыть карточку конкретного экземпляра по адресу /automation/workflows/instances/:id. В списке видно состояние, связанный объект и время запуска; карточка раскрывает подробную историю.

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

Статусы экземпляра

Жизненный цикл экземпляра Жизненный цикл экземпляра — концептуальная схема, не UI-скриншот и не evidence.

Экземпляр проходит через состояния:

  • идёт — процесс выполняется;
  • ожидает — стоит на ручном задании или узле-ожидании (это нормальная пауза, а не ошибка);
  • завершён — дошёл до конца;
  • ошибка — шаг не выполнился и процесс не может продолжиться;
  • прерван — остановлен вручную с причиной.

Статус — первое, на что смотрят при контроле: он отделяет нормальную паузу от застрявшего или сломанного процесса.

СтатусНормально или требует вниманияЧто делать
ИдётНормальноНичего, если укладывается в ожидаемое время
ОжидаетНормальноПроверить, кто исполнитель ручного задания, если пауза долгая
ЗавершёнНормальноИспользовать как запись для отчётности
ОшибкаТребует вниманияОткрыть карточку, разобрать шаг, исправить причину
ПрерванТребует вниманияПроверить причину в истории, при необходимости запустить новый экземпляр

Карточка экземпляра: история шагов

Жизненный цикл экземпляра Жизненный цикл экземпляра — концептуальная схема, не UI-скриншот и не evidence.

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

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

Дела к запуску

Жизненный цикл экземпляра Жизненный цикл экземпляра — концептуальная схема, не UI-скриншот и не evidence.

Часть шагов процессов выполняется по расписанию или по наступлению срока. Запуск таких отложенных шагов («дела к запуску») собирает их и обрабатывает за один проход, а затем показывает сводку: сколько шагов обработано, сколько успешно и сколько с ошибкой.

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

Прерывание экземпляра с причиной

Жизненный цикл экземпляра Жизненный цикл экземпляра — концептуальная схема, не UI-скриншот и не evidence.

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

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

Состояния и ограничения

Жизненный цикл экземпляра Жизненный цикл экземпляра — концептуальная схема, не UI-скриншот и не evidence.

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

Хорошие практики

Жизненный цикл экземпляра Жизненный цикл экземпляра — концептуальная схема, не UI-скриншот и не evidence.

  • Регулярно просматривайте запущенные экземпляры и их статусы.
  • Различайте «ожидает» (норма) и «ошибка»/зависание (требует разбора).
  • Указывайте понятную причину при прерывании.
  • Разбирайте ошибки из сводки «дел к запуску» по конкретным экземплярам.
  • Повторяющиеся ошибки на одном шаге чините в шаблоне, а не ручными обходами.

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

Жизненный цикл экземпляра Жизненный цикл экземпляра — концептуальная схема, не UI-скриншот и не evidence.

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

Прерывать без причины. Потом невозможно понять, это было решение или ошибка.

Игнорировать ошибки в сводке прогона. Отложенные шаги молча не выполняются, и регламент рвётся.

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

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

Жизненный цикл экземпляра Жизненный цикл экземпляра — концептуальная схема, не UI-скриншот и не evidence.

  • статус экземпляра соответствует ожиданию (идёт, ожидает, завершён);
  • история шагов показывает пройденный путь без неожиданных остановок;
  • сводка «дел к запуску» завершилась без ошибок или ошибки разобраны;
  • прерванные экземпляры имеют понятную причину;
  • повторяющиеся сбои устранены в шаблоне.

Связанные сценарии

Жизненный цикл экземпляра Жизненный цикл экземпляра — концептуальная схема, не UI-скриншот и не evidence.