uip Maestro 流验证

“uip Maestro 流验证”的语法和选项，可根据架构和可选监管策略验证“.flow”文件。

uip maestro flow validate通过结构性跨字段检查，根据流程架构验证.flow文件。可选的--governance阶段还会根据组织的监管策略验证代理节点。

大纲

uip maestro flow validate <flowFile> [--governance] [--strict-bindings] [--strict-expressions]

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

参数

• <flowFile> （必填） — .flow文件的路径或包含该文件的项目目录。

选项

• --governance — 还根据组织监管策略验证代理节点。需要uip login ； CLI 会在运行检查之前从平台获取enforcements和允许的modelNames 。如果提取失败，命令将会出错 — 省略--governance以跳过策略检查。
• --strict-bindings — 当托管 HTTP 节点 (core.action.http.v2) 带有连接器形状的标签，但没有 Integration Service 绑定时，验证将失败。默认值：仅警告— 省略此标志仍会运行检查，只是构建不会失败。
• --strict-expressions — 根据画布使用的表达式检查器，当表达式或脚本正文存在类型错误时，验证失败。默认：仅警告。此 CI-gating 检查始终运行；该标志仅控制其结果是否严重。

行为

• 架构验证在本地运行，无需登录。
• 结构检查可确保节点、边缘、绑定、变量和定义之间的引用保持一致。
• 使用--governance ，系统会标记配置（模型、工具、策略）与获取的执行冲突的任何代理节点。

示例

# Structural validation only (no login required)
uip maestro flow validate invoice-flow.flow

# Full validation including governance policy for agent nodes
uip maestro flow validate invoice-flow.flow --governance

数据形状（--输出 json）

成功后：

{
  "Code": "FlowValidate",
  "Data": {
    "File": "invoice-flow.flow",
    "Status": "Valid"
  }
}

验证失败时，该命令非零退出，并在Message / Instructions中返回Failure结果和详细错误信息。

备注：

故障有效负载的确切形式（每个错误的列表、路径、规则 ID）可能会因版本而异。对于以编程方式解析失败详细信息的脚本，使用--output json运行一次已知错误的验证，以捕获当前构型并在 CI 中固定@uipath/cli 。

另请参阅

• uip maestro flow debug — 通过 Studio Web 进行动态验证
• uip maestro flow pack — 打包经过验证的项目
• 流概述