UIP Maestro 流 UITL 和 UIP Maestro 流迁移

“uip Maestro Flow 点击”（添加人机回圈节点）和“uip Maestro Flow Migrate”（将“.flow”文件升级到当前架构）的语法和选项。

本页介绍两个不相关的小型命令组，这两个命令组都直接编辑 .flow 文件：

• uip maestro flow hitl — 添加一个人机回圈 (HITL) 节点，该节点会暂停执行并等待人员在 Action Center 中完成任务。
• uip maestro flow migrate — 升级.flow文件的工作流和节点架构版本。

大纲

uip maestro flow hitl add <file> [--schema <json>] [--priority <Low|Medium|High>] [--position <x,y>] [--label <label>] [--assignee <email-or-group>]

uip maestro flow migrate <file> [--dry-run] [--no-include-optional]

使用全局选项。退出代码遵循标准合同。没有一个命令需要 uip login。

uip Maestro 流点击量添加

将 HITL 节点添加到 .flow 文件。

参数

• <file> （必填） — .flow文件的路径。

选项

选项	描述
--schema <json>	任务架构 JSON 对象。从流变量中预填充 inputs[] 个条目（添加 "binding":"varName"）； outputs[] 条目写回流变量（添加 "variable":"varName"）； outcomes[] 列出了可能的决策（例如批准/拒绝）。
--priority <level>	Low、Medium 或 High。默认 Low。
--position <x,y>	画布位置，例如250,300。
--label <label>	显示节点的标签。
--assignee <email-or-group>	分配目标：用户电子邮件或组名称。

示例

# Bare HITL node, no schema
uip maestro flow hitl add workflow.flow

# With label, priority, and a group assignee
uip maestro flow hitl add workflow.flow --label "Invoice Review" --priority High --assignee finance-approvers

# Full schema: pre-filled input, a required output written back to a variable, two outcomes
uip maestro flow hitl add workflow.flow --label "Approval" \
  --schema '{"inputs":[{"name":"invoiceId","binding":"fetchInvoice1.result.invoiceId"}],"outputs":[{"name":"decision","variable":"approvalDecision","required":true}],"outcomes":[{"name":"Approve"},{"name":"Reject"}]}'

数据形状 ( --output json )

{
  "Code": "HitlNodeAdded",
  "Data": {
    "NodeId": "approval1",
    "NodeType": "uipath.human-in-the-loop",
    "Label": "Approval",
    "DefinitionAdded": true
  }
}

uip Maestro 流迁移

将 .flow 文件的工作流架构版本及其节点 typeVersion 升级到当前版本。幂等 — 对已为当前版本的文件运行此文件，不会报告任何更改。

参数

• <file> （必填） — .flow文件的路径。

选项

选项	描述
--dry-run	显示在不写入文件的情况下会更改的内容。
--no-include-optional	跳过可选的节点迁移（例如 typeVersion 规范化）。默认：应用可选迁移。

示例

# Migrate to the current schema version
uip maestro flow migrate ./my-flow/my-flow.flow

# Preview only
uip maestro flow migrate ./my-flow/my-flow.flow --dry-run

# Skip optional node migrations
uip maestro flow migrate ./my-flow/my-flow.flow --no-include-optional

数据形状 ( --output json )

{
  "Code": "FlowMigrate",
  "Data": {
    "File": "./my-flow/my-flow.flow",
    "Migrated": true,
    "DryRun": false,
    "FromVersion": "1.0.0",
    "ToVersion": "1.0",
    "WorkflowSteps": ["1.0.0 -> 1.0"],
    "NodeMigrations": {
      "ForcedAvailable": 0,
      "OptionalAvailable": 2,
      "OptionalApplied": 2,
      "Failed": 0
    }
  }
}

当文件已处于当前版本时，Migrated 为 false 且 WorkflowSteps 为空。如果使用 --dry-run，Data.DryRun 就是 true，并且文件会保持不变。

另请参阅

• uip maestro flow validate — 迁移后验证
• uip maestro flow node 、 uip maestro flow variable
• 流概述
• 全局选项、退出代码