Чтение запуска
Открытие выполнения в веб-интерфейсе (/executions/<id>, для администратора с доступом к управлению
чужими запусками —
/admin/executions/<id>) показывает страницу запуска: один запуск воркфлоу как процесс,
который воркфлоу объявляет. Всё на странице берётся из записанного маршрута запуска; ничего не
выводится из порядка блоков. Воркфлоу без представления процесса (progress) показывает вместо
этого технический граф нод и панель переменных.
Заголовок показывает каноническое название задачи, имя собственного флоу и произвольную заметку отдельно. Переименование текущего запуска обновляет название без повторной загрузки определения и сброса положения чтения. Ответы от запуска, который вы уже покинули, не подменяют текущий запуск и цель его кнопок ответа и правки переменных. Без авторского прогресса остаются технический граф и переменные, с названием из метаданных и без выдуманных этапов процесса.
Открытие запуска из списка
Откройте Запуски и выберите карточку. Она отдельно показывает известное время начала и последний записанный принятый шаг. Правка заметки или других данных записи не меняет время шага. Время последнего шага неизвестно означает, что сохранённого наблюдения принятого шага нет; отсутствующее время начала не подменяется другой датой. Заметка, состояние, блокировки и число отказов помогают понять контекст до открытия запуска. Администратор с доступом к управлению чужими запусками может использовать администраторский список: он также показывает владельца и не фильтруется исключениями аналитики. Выбор Заблокирован применяется до пагинации, поэтому счётчик описывает заблокированные запуски, а не только совпадения на видимой странице.
Виды
Две вкладки над картинкой показывают один и тот же запуск двумя способами; выбор хранится в URL
как view.
- Карта (по умолчанию) — процесс как схема с оглавлением. Заголовок над ней называет
запуск: его задачу, цель и факты проекции чипами. Схема рисует блоки слева направо в порядке
процесса: основная последовательность в одном ряду, каждая боковая ветка в своём ряду выше или
ниже её, а блок, в который ведут многие другие или в который попадают только циклы, — под ними.
Каждый блок — одна карточка: полоса заголовка с бейджем номера блока, его именем и статусом,
затем описание и чипы фактов (шаги, потраченное время, число проходов,
сделано/всегодля блока, привязанного к списку), слева колонка входных портов, справа — выходных. Порт называет переход и блок на другом его конце. Переход, возвращающий работу назад, — пунктирный порт возврата со значком ↻, все переходы блока на себя делят двойной порт под карточкой, а длинная связь идёт ближайшим свободным зазором между рядами, а не поверх схемы. Наведите на порт или линию, чтобы подсветить этот один переход и прочитать его условие или, для возврата, причину и выход цикла; наведите на карточку, чтобы подсветить все её связи; нажмите на порт или линию, чтобы перенестись к другому концу; выберите блок, чтобы его линии остались подсвеченными. Чип шагов открывает подсказку со списком шагов блока маленькими карточками — нажмите шаг, чтобы открыть его на графе. Блок, в котором находится запуск, отмечен выполняется, агент на шаге или ждёт вас и «дышит»; завершённый блок показывает галочку, блок, выполнявшийся несколько раз, — число проходов (×2, ×3), блок, который запуск обошёл, зачёркнут как пропущен, а недостигнутые блоки приглушены. Карта открывается на текущем блоке; прокручивайте или тяните для перемещения, масштаб — щипком (или колесом с зажатым Ctrl); кнопка подгонки показывает весь процесс. «Содержание» слева перечисляет все блоки с их статусом, числом проходов,сделано/всегои, если другие завершённые запуски владельца на этой версии дают её, обычной длительностью блока; нажмите блок, чтобы выбрать его и перенести к нему камеру. - Граф — технический граф нод: каждая нода воркфлоу как карточка шага, сгруппированная по
блокам в порядке процесса; статусы блоков запуска — заливка групп, шаг, на котором находится
запуск, «дышит», пройденные шаги окрашены как завершённые. У карточки шага та же полоса
заголовка, боковые порты и чипы фактов, что и у карточки блока на карте; её чипы несут
директиву, поля, которые шаг обязан вернуть, и его выражения — наведите, чтобы прочитать полный
текст. Каждая связь нарисована линией между боковыми портами, включая циклы и связи в другие
блоки; выходной порт назван case, который его выбирает,
successиdefault— выходы, которые берутся, когда ни один case не выполнен, аerrorиtimeout— управляющие выходы. Наведение, нажатие и выбор работают ровно так же, как на карте. Блок, выбранный на карте, держит здесь рамку своей группы, а «Содержание» рядом с графом переносит камеру к группе блока. Нажатие на карточку открывает уровень ноды в панели: директиву, условие завершения, возвращаемые поля, выражения, case-ы, связи в видевыход → цельс case, который выбирает каждый выход, валидацию, playbooks и конфигурацию ноды из каталога, с хлебной крошкой назад к блоку и действием «Показать на графе», которое подводит камеру к шагу. Когда граф открывается на текущем шаге или переносит камеру к выбранному шагу, его карточка целиком помещается в области схемы; если на узкой панели она кажется мелкой, увеличьте масштаб. Граф следует за текущим шагом запуска. Если вы перешли внутри графа (поиском, по порту, по чипу прибытия), он держит в виде ваш шаг, пока запуск не перейдёт к другому шагу.
У обоих видов один тулбар над схемой: переключатель Карта / Граф, кнопка сворачивания оглавления, курсор маршрута, поиск шага (он отвечает на вопрос «в каком блоке этот шаг», а на графе открывает этот шаг), пресеты раскладки, масштаб и подгонка, переключатель навигатора, компас, легенда статусов и Что это?. Пресеты перекладывают открытую схему и возвращают камеру к блоку, который вы читали; каждый вид называет их по тому, что они двигают: на карте Рядами, Компактная, По потоку (ветки по обе стороны главной линии) и Сверху вниз, на графе Группы стопкой, Компактная, Группы в ряд и Шаги сверху вниз, — и оба вида следуют выбранному. Компас открывает заметку о том, как читать открытый вид, и запоминает, оставили ли вы её открытой.
Переключение вкладок оставляет страницу как есть: карта сохраняет выбранный блок, граф — позицию, на которой вы его оставили. При первой загрузке представления область схемы может показывать локальный плейсхолдер; страница не перезагружается, заголовок, панель и выбранный блок сохраняются.
Курсор
Ползунок над картинкой — курсор маршрута (at в URL). Перетаскивание, как и щелчок по шагу в
маршруте, показывает запуск на момент этого шага: карта и панель показывают статусы блоков на
тот момент, а вкладка переменных — значения, записанные до него. «Показать весь запуск»
возвращает к настоящему.
Панель
Вкладки панели образуют одну полосу, которая на узкой панели переносится на вторую строку, а не
прокручивается; наведение на вкладку говорит, что в ней, счётчик на Ошибках — число
записанных ошибок (второй, янтарный счётчик — сколько шагов прошли без названного
ими playbook), а значок ! на Переменных или Блокировках — приостановленному шагу можно
ответить со страницы или активна блокировка.
- Блок — выбранный блок (по умолчанию текущий): статус, описание, текст результата, строка
фактов приглушённым текстом (шаги, сколько раз выполнен, визиты), затем Время — каждый
проход через блок с тем, когда он начался, когда закончился и сколько занял, идущий проход с
бегущим счётчиком, сумма и рядом — сколько обычно занимают проход и всё время запуска в этом
блоке по завершённым запускам владельца запуска на этой версии воркфлоу; проход, записанный до появления
отметок времени, показывает «—», а не «0 с». Блок, привязанный к списку, показывает его как
Список —
сделано из всего, каждый пункт с состоянием и временем, текущий отмечен (привязка, которая только считает, показывает счётчики). Куда ведёт выписывает переходы словами, включая, почему случается цикл и когда он заканчивается; Что здесь происходило — факты маршрута блока: каждый визит со связью, через которую он вышел, что изменил и кто это задал; затем его шаги в виде карточек одной формы — бейдж типа на одном месте в каждой карточке, затем имя шага, первое предложение инструкции и поля, которые он обязан вернуть, — свидетельство, которое Мойра проверяет, прежде чем запуск продолжится. Щелчок по шагу открывает его на виде «Граф» и на уровне ноды в панели. - Переменные — значения запуска в двух сворачиваемых группах выровненных строк: каждая
объявленная переменная (имя, текущее значение, небольшой счётчик, открывающий историю шагов,
которые её меняли) и результаты каждого шага под этим шагом. Объекты раскрываются деревом
внутри строки. Объявленная переменная, которую
runtimePolicyворкфлоу разрешает править на текущем шаге, — поле ввода в своей строке: измените и сохраните. Значение, заданное извне флоу, помечено как изменено. Фильтр сужает обе группы; кнопка разворота открывает ту же панель в большом окне. - Ошибки, Шаги, Блокировки — история ошибок выполнения (а над ней — шаги, прошедшие без названного ими playbook: процесс продолжился с плейсхолдером вместо этого текста, так что это не ошибка, но она названа вместе с шагом), все шаги определения на тех же карточках, что и во вкладке блока (блок за блоком; шаги, которые запуск прошёл, отмечены как завершённые, текущий — отмечен) и история блокировок.
Кого ждёт запуск
Приостановленный запуск говорит, кого он ждёт. Ждёт вас появляется только тогда, когда
действовать должен человек — на PIN-гейте (шаг lock), на шаге, который флоу пометил как
ожидающий решения человека (humanGate), или когда агент задал вопрос, без ответа на который не
может продолжить. Для помеченного шага плашка под шапкой говорит, что вас просят сделать, а для
вопроса агента — сам вопрос и предложенные варианты. В обоих случаях отвечать нужно агенту в чате.
Вопрос агента снимается, когда агент снова действует или запуск уходит с шага, а не когда вы меняете
здесь переменную. Строка под плашкой говорит, получили ли вы уведомление об ожидании: в какие каналы
и сколько времени назад оно ушло, отправлено ли напоминание, отправляется ли ещё, что каналы
уведомлений не настроены, что его не удалось доставить или что оно не ушло, потому что ожидание сменилось раньше.
Для шага, о котором workflow шлёт своё сообщение сам, строка появляется, только когда уйдёт
напоминание Moira. Пока агент находится на шаге, карточка, легенда и
панель говорят агент на шаге; запуск не ждёт вас, хотя вы можете ответить на шаг из вкладки
переменных вместо агента.
Ответ ожидающему шагу
Когда запуск ждёт ввода шага, а вы владеете выполнением (или являетесь администратором), вкладка переменных показывает Ответить ожидающему шагу с полями, которые требует шаг, включая объявленные глобальные переменные, которые он записывает. Отправка выполняет ответ как обычный шаг движка: ввод проверяется по схеме шага точно так же, как ответ агента, а отклонённый ответ показывается с сообщением шага. Шаг остаётся ожидающим, но диагностика отказа и revision могут измениться; перед новым ответом перечитайте состояние. Принятый ответ продолжает маршрут и записывается в нём как правка во время запуска с вашим именем — как и переменная, изменённая в своей строке панели переменных.
Агент, державший шаг, на который вы ответили, получает ATTEMPT_STALE на следующем step и
читает execution (current_step), чтобы получить шаг, на котором запуск находится теперь. Ответ
отклоняется, пока агент выполняет текущий шаг, на заблокированном или завершённом выполнении и
когда копия запуска на странице отстала от сервера (перезагрузите страницу, проверьте текущий шаг и решите, применим ли прежний ответ).
Остановка своего запуска
Когда свой запуск можно остановить, Остановить задачу открывает подтверждение с обязательной причиной. Выполняющаяся операция временно отключает действие; администратор, читающий чужой запуск, не получает его. Проверьте задачу перед подтверждением. Ошибка сохраняет причину, а конфликт требует Принять новое решение по текущему состоянию перед повторной отправкой.
Остановлен и записанная причина означают намеренное прекращение, а не успешное выполнение задачи. Маршрут, выполненные этапы и частичный список остаются доступны. Незаконченные этапы не считаются выполненными; остановленная граница работы не пульсирует, не показывает ожидание и не продолжает отсчёт длительности. Дочерние запуски продолжаются независимо. Свой запуск обновляется вживую; у администратора при чтении чужого запуска остаётся ручное обновление.
Объяснение страницы
Что это? открывает тур по странице. Карточка каждого шага встаёт рядом с элементом, который она
объясняет на живом запуске, в том виде, который открыт, а остальная страница затемняется. Тур
рассказывает о блоке и видах «Карта» и «Граф»; о текущем шаге, свидетельстве, которое он обязан
вернуть, и цикле; о курсоре маршрута; о вкладках панели; о том, как ответить ожидающему шагу самому:
форма ответа во вкладке переменных даёт ответ шага вместо агента, Мойра проверяет его как ответ
агента и записывает в маршрут как вашу правку; о том, куда ведут уведомления Мойры о запуске (план
готов к одобрению, результат готов к проверке, работа закончена — каждое начинается с флоу и задачи
и ведёт на эту страницу); и о тулбаре. Подсвеченная карточка внутри схемы подводится в камеру. Шаг,
элемента которого у этого запуска нет (нет цикла, нет ожидающего шага), пропускается с пометкой на
следующей карточке. Стрелка вправо или Enter ведут дальше, стрелка влево — назад, Escape закрывает.
На телефоне карточка — полоса у верхнего или нижнего края экрана, у того, где она не закрывает
элемент. Тур и его шаг хранятся в URL (guide=run&step=…), так что на позицию можно дать ссылку.