uip Maestro 流调试实例

“uip Maestro FlowDebug-instance”的语法和选项，是一个低级别调试器控件界面，用于单步执行、检查和控制 Studio Web 调试会话。

uip maestro flow debug-instance 是一个低级别调试器控件界面 — 创建调试实例，然后单步调试该实例，检查其变量和事件，然后取消或继续实例。这是一个与uip maestro flow debug不同、更细化的层， 在一次调用中即可上传项目并轮询完成。您可以利用 debug-instance 围绕 Studio Web 的调试协议构建自定义调试工具（例如编辑器集成），从而一次驱动一个步骤。

大纲

uip maestro flow debug-instance create        --solution-id <id> --project-id <id> --entry-point <path> [--process-type <type>] [--debug-mode <mode>] [--simulation-mode <mode>] [-i, --inputs <json>]
uip maestro flow debug-instance status         <instance-id>
uip maestro flow debug-instance breakpoints    <instance-id> [--inputs <json|@file>]
uip maestro flow debug-instance cancel         <instance-id>
uip maestro flow debug-instance continue       <instance-id> [--inputs <json|@file>]
uip maestro flow debug-instance incidents      <instance-id>
uip maestro flow debug-instance variables      <instance-id> [--parent-element-id <id>]
uip maestro flow debug-instance variables-set  <instance-id> [--inputs <json|@file>]
uip maestro flow debug-instance variables-all  <instance-id>

使用全局选项。退出代码遵循标准合同。需要 uip login。

uip Maestro 流调试实例创建

在 Orchestrator 中开始调试会话，并为已上传的解决方案创建相应的调试实例。

选项

选项	必填	默认	描述
--solution-id <id>	是	—	上一次上传的解决方案或 Studio Web 中的解决方案 ID。
--project-id <id>	是	—	解决方案中的 Studio Web 项目 ID。
--entry-point <path>	是	—	入口点路径，例如/Main.bpmn#start。
--process-type <type>	否	processOrchestration	流程类型。
--debug-mode <mode>	否	Default	Default （在断点处暂停）、StepByStep（在每一步暂停）或 SingleStep（只执行一个步骤）。
--simulation-mode <mode>	否	None	None、All（模拟每个元素）或 Selective（模拟除选择退出以外的元素）。
-i, --inputs <json>	否	{}	JSON 字符串形式的输入参数。

无效的 --debug-mode/--simulation-mode 值快速失败，列出有效的集合。

数据形状

{
  "Code": "DebugInstanceCreated",
  "Data": {
    "instanceId": "…",
    "runId": "…",
    "jobKey": "b2c3d4e5-…"
  },
  "Instructions": "Use 'debug-instance status <instance-id>' to check the run. Use 'debug-instance incidents <instance-id>' or 'debug-instance variables <instance-id>' to inspect it."
}

uip Maestro 流调试实例状态

获取每个元素的执行状态。参数：<instance-id>。数据形状：Code: "DebugInstanceStatus"。

uip Maestro 流调试实例断点

更新为已暂停实例设置的断点。参数：<instance-id>。选项：--inputs <value> — 将有效负载断点为 JSON 字符串、@file 路径或通过标准输入管道传输。数据形状：Code: "DebugInstanceBreakpointsUpdated"。

uip Maestro 流调试实例取消

取消调试实例。参数：<instance-id>。数据形状：Code: "DebugInstanceCanceled"。

uip Maestro 流调试实例继续

在暂停的实例上继续执行。参数：<instance-id>。选项：--inputs <value> — JSON 字符串、@file 路径或标准输入；省略时默认为 {"nextStep": false}（运行到下一个断点，而不是单个步骤）。数据形状：Code: "DebugInstanceContinued"。

uip Maestro 流调试实例事件

获取调试会话期间引发的事件。参数：<instance-id>。数据形：Code: "DebugInstanceIncidents"，Data 是一个数组（如果没有，则为空）。

uip Maestro 流调试实例变量

获取实例的变量。参数：<instance-id>。选项: --parent-element-id <id> — 筛选到一个元素下的变量。数据形状：Code: "DebugInstanceVariables"。

uip Maestro 流调试实例变量设置

修补（部分更新）变量。参数：<instance-id>。选项：--inputs <value> — 将补丁有效负载作为 JSON 字符串、@file 路径或标准输入。数据形状：Code: "DebugInstanceVariablesSet"。

uip Maestro 流调试实例变量全部

获取所有变量，包括子流程作用域。参数：<instance-id>。数据形状：Code: "DebugInstanceVariablesAll"。

另请参阅

• uip maestro flow debug — 大多数工作流应改用的更高级别的“上传并轮询”调试命令
• uip maestro flow instance — 已发布、正在运行的实例的等效控件界面，而非调试会话
• 流概述
• 全局选项、退出代码