uip Maestro 初始化

uip maestro init使用有效的 BPMN 2.0 入门版以及 Orchestrator 需要用于流程编排包的元数据文件，构建一个新的 Maestro 项目目录。

大纲

uip maestro init <name> [--force]

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

参数

• <name> （必填） — 项目文件夹名称。已验证VALID_PROJECT_NAME_REGEX ：仅限字母、数字、下划线 ( _ ) 和连字符 ( - )。

选项

• --force — 即使目标目录存在且不为空，也会进行初始化。现有文件不会被清除 — 文件会同时写入；这适用于在预先创建的文件夹中重新初始化。

行为

在当前工作目录中创建<name>/并写入六个文件：

文件	用途
project.uiproj	{ "Name": "<name>", "ProjectType": "ProcessOrchestration" }
operate.json	runtime 元数据 — targetFramework: "Portable" 、 contentType: "processOrchestration" 、 runtimeOptions.isAttended: false 。
entry-points.json	一个入口点指向入门版 BPMN 内的Event_start ，输入/输出架构为空。
bindings_v2.json	{ "version": "2.0", "resources": [] }。
package-descriptor.json	打包程序使用的文件清单。
<name>.bpmn	包含Event_start → _Implicit_EndEvent入门版 BPMN，已与uipath:entryPointId扩展程序连接。

在写入之前，通过bpmn-moddle解析入门BPMN；如果出现结构（非 UiPath 扩展程序）警告，则该命令将失败，并显示BPMN validation failed: … 。

如果<name>已存在且非空，而且未设置--force ，则命令将失败并显示错误。

示例

# Create a new project in ./invoice-orchestration
uip maestro init invoice-orchestration

# Reinitialize into an existing non-empty folder
uip maestro init invoice-orchestration --force

数据形状（--输出 json）

{
  "Code": "MaestroInit",
  "Data": {
    "Status": "Created successfully",
    "Path": "/workspace/invoice-orchestration"
  }
}

失败时，响应会包含Result: "Failure" 、 Message和Instructions 。

另请参阅

• uip maestro pack — 打包框架内的项目
• uip maestro debug — 通过 Studio Web 运行
• Maestro 概述