uip Maestro 案例案例退出条件、阶段进入条件、阶段退出条件

本地案例管理 JSON 文件中案例级别和阶段级别条件组的 "get" 动词（案例退出条件、阶段进入条件和阶段退出条件）的语法和选项，以及 JSON字段参考以方便手动编辑每个字段参考。

三个命令组在本地案例管理定义文件中管理基于规则的条件，这些条件对转换进行门控：case-exit-conditions（整个案例何时完成或关闭）、stage-entry-conditions（阶段可以何时开始）和 stage-exit-conditions（整个案例何时可以完成或关闭）。阶段可以在何时完成或进行切换）。这三者共享相同的get形状，并读取相同的案例管理 JSON 文档；有关文件格式和子系统的其余部分，请参阅uip maestro case 。有关任务级别的等效项，请参阅task-entry-conditions 。

条件在 caseplan.json 中手动编辑 - 每个组的 JSON 字段引用位于其 get 动词下方。

概念

• 条件是一个或多个规则组的命名容器。rules 是数组的数组 — 每个内部数组是一个“或”分支，内部数组中的每个规则都进行“与”运算。实际上，源中的每个工作示例的每个条件只有一个规则，但形状支持多个规则。
• 完成/退出规则类型拆分。对case-exit-conditions和stage-exit-conditions ，哪个rule-type值有效取决于条件是否将其父级标记为完成： marksCaseComplete / marksStageComplete: true使用完成规则类型集； false （或缺失）使用退出集。
• stage-entry-conditions只有一个规则类型 枚举，没有完成/退出拆分。

uip Maestro 案例案例退出条件

读取整个案例的退出/完成条件 (文件范围，无阶段参数)。

大纲

uip maestro case case-exit-conditions get <file> <condition-id>

uip Maestro 案例案例退出条件获取

参数

名称	必填	用途
<file>	是	案例管理 JSON 文件的路径。
<condition-id>	是	要检索的案例退出条件的 ID。

示例

uip maestro case case-exit-conditions get case.json Condition_a1b2c3d4

数据形状（--输出 json）

{
  "Code": "CaseExitConditionFound",
  "Data": {
    "Condition": {
      "id": "Condition_a1b2c3d4",
      "displayName": "Completed",
      "marksCaseComplete": true,
      "rules": [[{ "id": "Rule_e5f6a7b8", "type": "required-stages-completed" }]]
    }
  }
}

Condition 是存储在磁盘上的原始节点对象 — 手动编辑 caseplan.json 时请使用此形状作为参考。

案例退出条件 JSON 字段

用于手动将条件编辑为 caseplan.json 的字段参考：

字段	值	注意
displayName	字符串	条件的显示名称。
marksCaseComplete	true | false	切换哪个 rule-type 集合有效（请参阅概念）。
规则 type	补全集( marksCaseComplete: true )： required-stages-completed ， wait-for-connector 。退出设置（ false /缺失）： selected-stage-completed 、 selected-stage-exited 、 wait-for-connector 。	进入 rules[][] 条目。
条件表达式	字符串	规则的自由格式表达式（当规则类型支持时）。
selectedStageId	字符串	selected-stage-* 规则的阶段 ID。

编辑后，运行uip maestro case validate 。

uip Maestro 案例阶段进入条件

读取一个阶段的进入条件（文件 + 阶段范围）。

大纲

uip maestro case stage-entry-conditions get <file> <stage-id> <condition-id>

uip Maestro 案例阶段进入条件获取

参数

名称	必填	用途
<file>	是	案例管理 JSON 文件的路径。
<stage-id>	是	阶段节点 ID。
<condition-id>	是	要检索的进入条件的 ID。

示例

uip maestro case stage-entry-conditions get case.json Stage_1 Condition_a1b2c3d4

数据形状（--输出 json）

{
  "Code": "StageEntryConditionFound",
  "Data": {
    "Condition": {
      "id": "Condition_a1b2c3d4",
      "displayName": "Start",
      "rules": [[{ "id": "Rule_e5f6a7b8", "type": "current-stage-entered" }]]
    }
  }
}

阶段进入条件 JSON 字段

用于手动编辑的字段引用：

字段	值	注意
displayName	字符串	条件的显示名称。
isInterrupting	true | false	条件是否为中断条件。
规则 type	case-entered、selected-stage-exited、selected-stage-completed、wait-for-connector 和 user-selected-stage 之一	单个枚举，无补全/退出拆分。
条件表达式	字符串	规则中的自由格式表达式（如果支持）。
selectedStageId	字符串	selected-stage-* 规则的阶段 ID。

编辑后，运行uip maestro case validate 。

uip Maestro 案例阶段退出条件

读取一个阶段的退出/完成条件（文件 + 阶段范围）。三组中内容最丰富的 — 它还控制退出时执行的位置。

大纲

uip maestro case stage-exit-conditions get <file> <stage-id> <condition-id>

uip Maestro 案例阶段退出条件获取

参数

名称	必填	用途
<file>	是	案例管理 JSON 文件的路径。
<stage-id>	是	阶段节点 ID。
<condition-id>	是	要检索的退出条件的 ID。

示例

uip maestro case stage-exit-conditions get case.json Stage_1 Condition_a1b2c3d4

数据形状（--输出 json）

{
  "Code": "ExitConditionFound",
  "Data": {
    "Condition": {
      "id": "Condition_a1b2c3d4",
      "displayName": "Done",
      "marksStageComplete": true,
      "rules": [[{ "id": "Rule_e5f6a7b8", "type": "required-tasks-completed" }]]
    }
  }
}

阶段退出条件 JSON 字段

用于手动编辑的字段引用：

字段	值	注意
displayName	字符串	条件的显示名称。
type	exit-only | wait-for-user | return-to-origin	退出时会发生的情况。
exitToStageId	字符串	退出时转移到的阶段（与 return-to-origin 配对）。
marksStageComplete	true | false	切换哪个 rule-type 集合有效（请参阅概念）。
规则 type	补全集( marksStageComplete: true )： required-tasks-completed ， wait-for-connector 。退出设置（ false /缺失）： selected-tasks-completed ， wait-for-connector 。	进入 rules[][] 条目。
条件表达式	字符串	规则中的自由格式表达式（如果支持）。
selectedTasksIds	字符串数组	selected-tasks-completed 规则的任务 ID。

编辑后，运行uip maestro case validate 。

相关内容

• uip Maestro Case — 子系统概述和案例管理 JSON 文件格式。
• uip Maestro 案例案例和阶段— 附加这些条件的阶段节点。
• uip Maestro 案例任务— 这些条件最终触发的任务。
• uip Maestro 案例任务进入条件— 任务级别的等效条件。

另请参阅

• Maestro 工具概述
• 全局选项
• 退出代码