UIP Maestro のケース SLA

「uip Maestro ケース SLA」を使用して、Maestro Case管理の定義のサービス レベル アグリーメント (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 ターゲット — すべての読み取り動詞は、case のルート (既定) または で選択された 1 つの名前付きステージで動作 --stage-id <stageId>。ルートレベルの SLA については省略します。
• 既定のルールと条件付きルール — 内部的には、プレーンなルート/ステージ SLA (ファイルの直接編集で設定) が、常に一致する固定の式 (=js:true) を持つ 1 つのslaRulesエントリとして保存されます。条件付き 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です。各エスカレーション ルールには、1 人の受信者 (ターゲット ID/メール アドレスと表示値で識別される User または UserGroup) が 1 人います。
• レガシー シェイプのフォールバック — sla get、slaRules配列がまだ存在しない場合、古いslaRules前のシェイプ (ケース/ステージのデータに直接書き込まれている{sla: {count, unit, escalationRule}}) も認識し、同じ出力シェイプに正規化します。

UIP Maestro ケース SLA Get

ケースのルートまたは 1 つのステージの有効な SLA 設定 (期間と条件付きルール) を確認します。

引数

名前	Required	目的
<file>	○	ケース管理 JSON ファイルへのパスです (caseplan.json)。

オプション

長押し	値 (Value)	説明
--stage-id <stageId>	string	SLA の読み込み元のステージ ID です。ルートレベルの SLA では を省略します。

例

uip maestro case sla get case.json

データシェイプ(--output json)

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

Target は "root" または合格したステージ ID です。SlaRules は空です ([]ターゲットに (ファイルの直接編集による) SLA が設定されていない場合。

UIP Maestro ケース SLA のエスカレーション リスト

ケースのルートまたはステージで既定の SLA ルールにアタッチされているエスカレーション ルールを一覧表示します。

引数

名前	Required	目的
<file>	○	ケース管理 JSON ファイルへのパスです。

オプション

長押し	値 (Value)	説明
--stage-id <stageId>	string	エスカレーションのリストを取得するステージ ID です。ルートレベルの SLA では を省略します。

例

uip maestro case sla escalation list case.json

データシェイプ(--output json)

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

EscalationRules は、ターゲットに SLA ルールが設定されていない場合、または SLA ルールにエスカレーションがない場合に [] されます。

UIP Maestro ケース SLA ルールのリスト

ケースのルートで定義されているすべての条件付き SLA ルールを一覧表示します (条件付きルールはルート専用です。ステージの SLA には個別の条件付きルール リストはありません)。

引数

名前	Required	目的
<file>	○	ケース管理 JSON ファイルへのパスです。

例

uip maestro case sla rules list case.json

データシェイプ(--output 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 ツールの概要
• グローバル オプション
• 終了コード