Перейти к содержимому

Чтение запуска

Открытие выполнения в веб-интерфейсе (/executions/<id>, для администратора — /admin/executions/<id>) показывает страницу запуска: один запуск воркфлоу как процесс, который воркфлоу объявляет. Всё на странице берётся из записанного маршрута запуска; ничего не выводится из порядка блоков. Воркфлоу без представления процесса (progress) показывает вместо этого технический граф нод и панель переменных.

Режимы

Вкладки над картинкой переключают, как показан один и тот же запуск; выбор хранится в URL как view.

  • Дорожки (по умолчанию) — по карточке на блок в порядке процесса. Блок, в котором находится запуск, помечен «вы здесь» и отмечен выполняется или ждёт вас; завершённый блок показывает галочку, блок, выполнявшийся несколько раз, — число проходов мелким приглушённым текстом (×2, ×3), блок, который запуск обошёл, зачёркнут как пропущен, а недостигнутые блоки приглушены. Тонкие дуги под рельсой — циклы, тонкие линии над ней — переходы, минующие блок; в покое подписей на них нет. Каждая карточка называет свои циклы и пропуски чипами (↩ 3 План — возврат в блок 3, ↗ 6 Стоп — пропуск к блоку 6, ↩ 3 План ×2 — два цикла в один блок одним чипом); наведите на чип или линию, чтобы подсветить линии и прочитать подпись, а для одиночного цикла — что его вызывает и что заканчивает; у выбранной карточки линии остаются подсвеченными. Под рельсой выписан текст результата выбранного блока.
  • Карта — процесс как схема на всю область: блоки слева направо, соседние переходы как стрелки с подписями, циклы тонким пунктиром снизу, переходы через блоки — сверху; к блоку, в который ведут многие другие (перепланирование или остановка), от каждого из них идёт тонкая линия. Каждый цикл, пропуск и выход в такой блок назван чипом в исходном блоке; так же названы три и более параллельных перехода в следующий блок (один чип с их числом вместо стопки подписей); наведите на чип (или линию), чтобы подсветить её и прочитать подпись, а выбранный блок держит свои линии подсвеченными. Карта открывается на текущем блоке; прокручивайте или тяните для перемещения, масштаб — щипком (или колесом с зажатым Ctrl). Рельса дорожек перемещается и масштабируется так же.
  • Конспект — процесс как документ: каждый блок — нумерованный раздел с описанием, тем, что запуск в нём произвёл, тем, что записали его шаги, переходами словами (включая, почему случается цикл и когда он заканчивается) и шагами со свидетельством, которое каждый требует.
  • Маршрут — запуск как пройденный маршрут: каждая карточка — отрезок подряд идущих шагов внутри одного блока, небольшое число рядом с именем блока говорит, который это визит в блок, линия отмечает возврат к более раннему блоку, а у каждого шага показаны связь, через которую он вышел, ждал ли он ввода и что записал.

Курсор

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

Панель

Вкладки панели образуют одну полосу, которая на узкой панели переносится на вторую строку, а не прокручивается; наведение на вкладку говорит, что в ней, счётчик на Ошибках — число записанных ошибок (второй, янтарный счётчик — сколько шагов прошли без названного ими playbook), а значок ! на Переменных или Блокировках — шаг ждёт вашего ответа или активна блокировка.

  • Блок — выбранный блок (по умолчанию текущий): статус, описание, текст результата, строка фактов приглушённым текстом (шаги, сколько раз выполнен, визиты), куда он ведёт и его шаги в виде карточек одной формы — бейдж типа на одном месте в каждой карточке, затем имя шага, первое предложение инструкции и поля, которые он обязан вернуть, — свидетельство, которое Мойра проверяет, прежде чем запуск продолжится. Щелчок по шагу показывает его на техническом графе нод.
  • Переменные — значения запуска в двух сворачиваемых группах выровненных строк: каждая объявленная переменная (имя, текущее значение, небольшой счётчик, открывающий историю шагов, которые её меняли) и результаты каждого шага под этим шагом. Объекты раскрываются деревом внутри строки. Объявленная переменная, которую runtimePolicy воркфлоу разрешает править на текущем шаге, — поле ввода в своей строке: измените и сохраните. Значение, заданное извне флоу, помечено как изменено. Фильтр сужает обе группы; кнопка разворота открывает ту же панель в большом окне.
  • Ошибки, Шаги, Граф, Блокировки — история ошибок выполнения (а над ней — шаги, прошедшие без названного ими playbook: процесс продолжился с плейсхолдером вместо этого текста, так что это не ошибка, но она названа вместе с шагом), все шаги определения на тех же карточках, что и во вкладке блока (блок за блоком; шаги, которые запуск прошёл, отмечены как завершённые, текущий — отмечен), граф нод (карточки шагов по блокам, статусы блоков запуска как заливка, текущий шаг отмечен и виден при открытии вкладки, кнопки подгонки и направления — в группе масштабирования, а всякая длинная или возвратная связь названа чипами в обеих карточках вместо линии) и история блокировок.

Ответ ожидающему шагу

Когда запуск ждёт ввода шага, а вы владеете выполнением (или являетесь администратором), вкладка переменных показывает Ответить ожидающему шагу с полями, которые требует шаг, включая объявленные глобальные переменные, которые он записывает. Отправка выполняет ответ как обычный шаг движка: ввод проверяется по схеме шага точно так же, как ответ агента, а отклонённый ответ показывается с сообщением шага и ничего не меняет. Принятый ответ продолжает маршрут и записывается в нём как правка во время запуска с вашим именем — как и переменная, изменённая в своей строке панели переменных.

Агент, державший шаг, на который вы ответили, получает ATTEMPT_STALE на следующем step и читает session current_step, чтобы получить шаг, на котором запуск находится теперь. Ответ отклоняется, пока агент выполняет текущий шаг, на заблокированном или завершённом выполнении и когда копия запуска на странице отстала от сервера (перезагрузите страницу и ответьте снова).

Объяснение страницы

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