uip Maestro bpmn 流程和 uip Maestro bpmn 流程

“uip Maestro bpmn 流程”和“uip Maestro bpmn 流程”的语法和选项，涵盖按文件夹和租户范围内的已发布 Maestro BPMN 流程操作。

将 Maestro BPMN 包发布到 Orchestrator 后，它将成为类型为ProcessOrchestration的流程。以下两个命令组都在 bpmn 分支下注册。本页介绍两个相关的命令组：

• uip maestro bpmn process — 对单个流程定义的按文件夹操作（在文件夹中列出、获取其架构、运行、打包+发布）。
• uip maestro bpmn processes （复数） — 整个租户范围的摘要、每个流程的事件查找和诊断。

大纲

# Singular — per-folder, operational
uip maestro bpmn process list    -f <folder-key> [--filter <odata>] [--login-validity <minutes>]
uip maestro bpmn process get     <process-key> <feed-id> -f <folder-key> [--login-validity <minutes>]
uip maestro bpmn process run     <process-key> <folder-key> --release-key <key>
                                  [-i, --inputs <json>] [--feed-id <id>] [--robot-ids <ids>]
                                  [--login-validity <minutes>]
uip maestro bpmn process publish <project-path> [output-path] -f <folder-key>
                                  [-n, --name <name>] [--process-name <name>] [-v, --version <version>]
                                  [-i, --inputs <json>] [--feed-id <id>] [--entry-point <path>]
                                  [--wait [--timeout <seconds>] [--poll-interval <seconds>]] [--login-validity <minutes>]

# Plural — tenant-wide summary, incidents, and diagnostics
uip maestro bpmn processes list       [--folder-key <key>] [-l <limit>] [--offset <n>] [--status <status>]
uip maestro bpmn processes incidents  <process-key> --folder-key <key>
uip maestro bpmn processes diagnose   <process-key> --folder-key <key>
uip maestro bpmn processes error-codes <process-key> --folder-key <key>

所有子命令都需要uip login并遵循全局选项。退出代码遵循标准合同。

---

uip Maestro bpmn 流程列表

列出特定文件夹中可用的 Maestro 流程（版本）。

选项

选项	必填	描述
-f, --folder-key <key>	是	文件夹密钥 (GUID)。
--filter <odata>	否	在服务器端应用的其他 OData 筛选器。
--login-validity <minutes>	否	令牌刷新阈值（默认为10 ）。

数据形状 ( --output json )

{
  "Code": "MaestroProcessList",
  "Data": [
    {
      "name":           "InvoiceOrchestration",
      "processKey":     "a1b2c3d4-0000-0000-0000-000000000001",
      "processVersion": "1.0.0",
      "packageId":      "a1b2c3d4-0000-0000-0000-000000000001",
      "packageVersion": "1.0.0",
      "releaseKey":     "e5f6a7b8-0000-0000-0000-000000000001",
      "folderKey":      "c3d4e5f6-0000-0000-0000-000000000001",
      "feedId":         "default",
      "folderId":       42,
      "active":         "Yes",
      "latest":         "Yes"
    }
  ]
}

---

uip Maestro bpmn 流程获取

获取 Maestro 流程的入口点架构（输入/输出 JSON 架构）。

参数

• <process-key> （必填） — 流程密钥。
• <feed-id> （必填） — 订阅源 ID（来自list ）。

选项

• -f, --folder-key <key> （必填项）
• --login-validity <minutes> （默认为10 ）

数据形状

{
  "Code": "MaestroProcessGet",
  "Data": [
    {
      "Path":         "/content/main.bpmn#Event_start",
      "DisplayName":  "Manual trigger",
      "Type":         "processorchestration",
      "InputSchema":  "{\"type\":\"object\",\"properties\":{}}",
      "OutputSchema": "{\"type\":\"object\",\"properties\":{}}"
    }
  ]
}

InputSchema和OutputSchema是重新字符串化的 JSON 架构字符串。

---

uip Maestro bpmn 流程运行

为已发布的流程启动 Maestro 作业。

参数

• <process-key> （必填） — process list中受版本控制的包流程密钥，例如MyProcess:1.0.0 。
• <folder-key> （必填） — 文件夹密钥 (GUID)。

选项

选项	必填	描述
--release-key <key>	是	发行密钥 (GUID) — 来自process list 。
-i, --inputs <json>	否	以 JSON 字符串或@path/to/file.json表示的输入。如果省略且通过管道传输 标准输入，则解析标准输入。
--feed-id <id>	否	包查找的订阅源 ID（可选）。
--robot-ids <ids>	否	以逗号分隔的机器人 ID（可选）。
--login-validity <minutes>	否	令牌刷新阈值（默认为10 ）。

此命令没有 --validate 选项 — 输入按原样发送；流程本身负责拒绝错误输入。

输入优先级： --inputs <json> / --inputs @file.json > 标准输入 > 空对象{} 。

示例

# Inline JSON
uip maestro bpmn process run "InvoiceOrchestration:1.0.0" "<folder-key>" \
  --release-key <release-key> --inputs '{"amount":100}'

# From a file
uip maestro bpmn process run "InvoiceOrchestration:1.0.0" "<folder-key>" \
  --release-key <release-key> --inputs @inputs.json

# Piped stdin
echo '{"amount":100}' | uip maestro bpmn process run "InvoiceOrchestration:1.0.0" "<folder-key>" --release-key <release-key>

数据形状

{
  "Code": "MaestroJobStarted",
  "Data": {
    "jobKey":  "b2c3d4e5-0000-0000-0000-000000000001",
    "state":   "Pending",
    "traceId": "d4e5f6a7-0000-0000-0000-000000000001"
  }
}

下一步: uip maestro bpmn job traces <jobKey>进行流执行或uip maestro bpmn job status <jobKey>进行轮询。

---

uip Maestro bpmn 流程发布

将 Maestro Maestro BPMN 项目目录一步步打包到 .nupkg 中，并将其作为 Orchestrator 流程版本发布。

参数

• <project-path> （必填） — Maestro BPMN 项目目录的路径。
• [output-path] （可选） — 生成的.nupkg的输出目录。默认为临时目录。

选项

选项	描述
-f, --folder-key <key>	必需。文件夹密钥 (GUID)。
-n, --name <name>	包名称。默认：项目文件夹名称。
--process-name <name>	流程版本名称。默认：包名称。
-v, --version <version>	包版本。默认 1.0.0。
-i, --inputs <json>	默认输入参数为 JSON 字符串、@file.json 或 -（对于标准输入）。
--feed-id <id>	用于包上传的订阅源 ID（可选）。
--entry-point <path>	流程的入口点路径。
--wait	等待已发布包的入口点可用，而不是在上传后立即返回。
--timeout <seconds>	设置 --wait 后发布传播等待的最大秒数。默认 300。
--poll-interval <seconds>	设置了 --wait 时，发布传播检查间隔的秒数。默认 5。
--login-validity <minutes>	令牌刷新阈值。默认 10。

示例

uip maestro bpmn process publish ./invoice-process \
  --folder-key <folder-key> --version 1.2.0 --wait

数据形状

{
  "Code": "MaestroProcessPublished",
  "Data": {
    "Package": "invoice-process@1.2.0",
    "PackagePath": "/tmp/maestro-process-publish-.../invoice-process.processOrchestration.ProcessOrchestration.1.2.0.nupkg",
    "ProcessKey": "invoice-process.processOrchestration.ProcessOrchestration",
    "ProcessVersion": "1.2.0",
    "ReleaseKey": "e5f6a7b8-0000-0000-0000-000000000001",
    "ReleaseName": "invoice-process",
    "Action": "Created",
    "Upload": [
      { "key": "invoice-process.processOrchestration.ProcessOrchestration", "status": "Created" }
    ],
    "EntryPoints": 1
  }
}

Action"Created"在首次发布给定流程密钥时为"Updated" ，在后续发布时为 。

---

uip Maestro bpmn 流程列表

有关租户范围（或文件夹范围）的 Maestro 流程摘要。与单数 process list 不同，这不会在服务器端应用 processType 筛选器 — 复数命令在工具（Maestro、Flow、Case）之间共享，并且本身不会作用域到 ProcessOrchestration。

选项

选项	描述
--folder-key <key>	可选。将摘要的范围限定到一个文件夹。
-l, --limit <number>	要返回的项目数 (1-10000)。
--offset <number>	要跳过的项目数 (0-1000000)。默认 0。
--status <status>	按流程状态筛选。

数据形状

{
  "Code": "ProcessList",
  "Data": [ /* array of Maestro process summaries */ ]
}

备注：

每个流程摘要的确切字段集由 Maestro runtime 指定，并且可能会不断变化；使用--output json对包含数据的租户运行一次命令，以查看您将使用的字段。如果您解析特定字段，请在 CI 中固定@uipath/cli 。

---

uip Maestro bpmn 流程事件

获取特定 Maestro 流程定义的所有事件。

参数

• <process-key> （必填） — 流程定义键。

选项

• --folder-key <key> （必填项）

数据形状

{
  "Code": "ProcessIncidents",
  "Data": [ /* array of process incidents */ ]
}

---

uip Maestro bpmn 流程诊断

在单次调用中关联流程的摘要、故障和错误代码 — processes list、processes incidents 和 processes error-codes 的便捷包装器。

参数

• <process-key> （必填） — 流程定义键。

选项

• --folder-key <key> （必填项）

数据形状

{
  "Code": "ProcessDiagnostics",
  "Data": {
    "ProcessKey": "InvoiceOrchestration",
    "FolderKey": "c3d4e5f6-0000-0000-0000-000000000001",
    "Summary": { /* the matching process summary object, or null if not found */ },
    "FaultedCount": 2,
    "RunningCount": 5,
    "Incidents": [ /* array of incident objects */ ],
    "IncidentCount": 1,
    "ErrorCodes": [ /* array of error code strings */ ],
    "ErrorCodeCount": 1
  }
}

---

uip Maestro bpmn 流程错误代码

获取由特定流程的事件引发的唯一错误代码。

参数

• <process-key> （必填） — 流程定义键。

选项

• --folder-key <key> （必填项）

数据形状

{
  "Code": "ProcessIncidentErrorCodes",
  "Data": [ /* array of error code strings */ ]
}

另请参阅

• uip maestro bpmn instances — 检查和引导正在运行的执行
• uip maestro bpmn job — 单个作业的追踪记录和状态
• uip maestro bpmn incidents — 事件摘要和详细信息
• Orchestrator 作业、 Orchestrator 流程
• Maestro 概述