UIP Maestro 案例 SLA

用于使用“uip Maestro case sla”读取 Maestro Case Management 定义中的服务级别协议 (SLA) 和升级设置的语法和选项。

uip maestro case sla 在案例管理 caseplan.json 文件中读取在案例根目录或特定阶段定义的服务级别协议 (SLA) 持续时间、条件 SLA 规则和升级通知。有关此操作所属的整个案例管理子系统的信息，请参阅uip maestro case 。

大纲

uip maestro case sla get <file> [--stage-id <stageId>]
uip maestro case sla escalation list <file> [--stage-id <stageId>]
uip maestro case sla rules list <file>

概念

• SLA 目标— 每个读取动词都在案例根目录（默认）或一个命名阶段上运行，可使用--stage-id <stageId>选择。对于根级别 SLA，可省略它。
• 默认规则与条件规则— 在内部，普通根/阶段 SLA（通过直接文件编辑设置）存储为一个slaRules条目，具有始终匹配的固定表达式 ( =js:true )；条件 SLA 规则是带有真实 JavaScript 布尔表达式的附加条目（例如=js:amount>1000）根据案例的数据进行评估，让不同的案例达到不同的 SLA 持续时间。条件规则在数组中排在默认规则之前，以第一个匹配的表达式为准。
• 持续时间单元— 每个 SLA 持续时间是一个{count, unit}对； unit是min 、 h 、 d 、 w 、 m （分钟/小时/天/周/月）之一。
• 升级规则— 附加到默认SLA 规则（根或阶段）的可选通知，触发at-risk （具有--at-risk-percentage阈值，例如SLA 持续时间已过去 80％）或 sla-breached。每个升级规则都有一个收件人：User 或 UserGroup，由目标 ID/电子邮件和显示值标识。
• 回退旧版— 如果尚不存在slaRules数组， sla get也会识别slaRules之前的较旧的形状（直接写入案例/阶段数据下的{sla: {count, unit, escalationRule}} ），并将其规范化为相同的输出形状。

UIP Maestro 案例 SLA 获取

读取案例根或一个阶段的有效 SLA 设置（持续时间和任何条件规则）。

参数

名称	必填	用途
<file>	是	案例管理 JSON 文件 (caseplan.json) 的路径。

选项

长	值	描述
--stage-id <stageId>	字符串	要从中读取 SLA 的阶段 ID。对于根级别 SLA，请省略。

示例

uip maestro case sla get case.json

数据形状（--输出 json）

{
  "Code": "SlaFound",
  "Data": {
    "Target": "root",
    "SlaRules": [{ "expression": "=js:true", "count": 2, "unit": "d" }]
  }
}

Target 是 "root" 或您传递的阶段 ID。当在该目标上未设置 SLA（通过直接文件编辑）时，SlaRules 为空 ([])。

uip Maestro 案例 SLA 升级列表

列出在案例根目录或阶段附加到默认 SLA 规则的升级规则。

参数

名称	必填	用途
<file>	是	案例管理 JSON 文件的路径。

选项

长	值	描述
--stage-id <stageId>	字符串	列出升级的原始阶段 ID。对于根级别 SLA，请省略。

示例

uip maestro case sla escalation list case.json

数据形状（--输出 json）

{
  "Code": "EscalationRulesList",
  "Data": {
    "Target": "root",
    "EscalationRules": [
      { "id": "esc_a1b2c3d4", "triggerInfo": { "type": "at-risk", "atRiskPercentage": 80 } }
    ]
  }
}

当目标未设置 SLA 规则或 SLA 规则没有升级时，EscalationRules为 []。

uip Maestro 案例 SLA 规则列表

列出在案例根目录中定义的每个条件 SLA 规则（条件规则仅是根规则；阶段的 SLA 没有单独的条件规则列表）。

参数

名称	必填	用途
<file>	是	案例管理 JSON 文件的路径。

示例

uip maestro case sla rules list case.json

数据形状（--输出 json）

{
  "Code": "SlaRulesList",
  "Data": {
    "SlaRules": [
      { "expression": "=js:amount>1000", "count": 4, "unit": "h" },
      { "expression": "=js:true", "count": 2, "unit": "d" }
    ]
  }
}

这将返回与根目标上的 sla get 相同的基础数组 — 首先条件规则，最后返回默认 (=js:true) 规则。

直接创作 SLA

通过自行编辑 caseplan.json 的 slaRules 数组（与上述形状匹配）来配置 SLA 和升级，然后进行验证：

uip maestro case validate case.json

• 设置普通 SLA ：在目标的slaRules数组中添加或编辑带有expression: "=js:true"条目，并设置count / unit 。
• 添加条件规则：在条目前面附加真实的expression （例如"=js:amount>1000"）并在默认条目之前添加自己的 count/unit。
• 添加升级：将对象推送到默认规则的escalationRule数组 — { id, displayName?, action: { type: "notification", recipients: [{ scope: "User" | "UserGroup", target, value }] }, triggerInfo: { type: "at-risk" | "sla-breached", atRiskPercentage? } }中。
• 删除任何内容：删除相应的数组条目并重新验证。

相关内容

• uip Maestro 案例— 案例管理概述， init / pack / debug / validate / spec 。
• uip Maestro 案例案例和阶段— SLA 目标附加到的案例/阶段定义。
• uip Maestro 案例任务— 任务定义（任务的 SLA，如果支持，会记录在其中）。

另请参阅

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