Sla du cas UIP Maestro

Syntaxe et options de lecture de l'accord de niveau de service (SLA) et des paramètres d'escalade sur une définition de Maestro Case Management avec « uip maestro case sla».

uip maestro case sla lit la durée de l'accord de niveau de service, les règles de SLA conditionnelles et les notifications d'escalade définies sur un fichier de gestion des cas caseplan.json — à la racine du cas ou à une étape spécifique. Voir uip maestro case pour le sous-système global de gestion des cas auquel il appartient.

Synthèse

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>

Concepts

• Cible du SLA — chaque verbe de lecture fonctionne sur la racine du cas (par défaut) ou sur une étape nommée, sélectionnée avec --stage-id <stageId>. Omettez-le pour le SLA de niveau racine.
• Règle par défaut vs. règles conditionnelles - en interne, un SLA racine/étape simple (défini via la modification directe du fichier) est stocké sous la forme d’une entrée slaRules avec une expression fixe (=js:true) qui correspond toujours; une règle SLA conditionnelle est une entrée supplémentaire avec une expression booléenne JavaScript réelle (par ex. =js:amount>1000) évalués par rapport aux données du cas, permettant à différents cas de atteindre des durées de SLA différentes. Les règles conditionnelles sont triées avant la règle par défaut dans le tableau — la première expression correspondante l'emporte.
• Unité de durée : chaque durée de SLA correspond à une paire de {count, unit} ; unit est l’un de min, h, d, w, m .
• Règle d’escalade — une notification facultative jointe à la règle SLA par défaut (racine ou étape), déclenchant soit at-risk (avec un seuil de --at-risk-percentage , par ex. 80 % de la durée du SLA écoulée) ou sla-breached. Chaque règle d’escalade a un destinataire — un User ou UserGroup, identifié par un ID/une adresse e-mail cible et une valeur d’affichage.
• Format de secours hérité - sla get reconnaît également une ancienne forme pré-slaRules ({sla: {count, unit, escalationRule}} écrite directement sous les données de l’incident/de l’étape) si aucun tableau slaRules n’est encore présent, et le normalise dans la même forme de sortie.

Obtenir le cas UIP Maestro

Lisez les paramètres SLA efficaces - durée et toutes les règles conditionnelles - pour la racine du cas ou une étape.

Arguments

Nom	Requis	Objectif
<file>	oui	Chemin d’accès au fichier JSON de gestion des cas (caseplan.json).

Options

Long	Valeur (Value)	Description
--stage-id <stageId>	string	ID d’étape à partir duquel lire le SLA. Omettez pour le SLA au niveau racine.

Exemple

uip maestro case sla get case.json

Format des données (--sortie json)

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

Target est "root" ou l’ID d’étape que vous avez réussi. SlaRules est vide ([]) lorsqu’aucun SLA n’a été défini (via la modification directe du fichier) sur cette cible.

Liste d’escalade Sla du cas UIP Maestro

Répertoriez les règles d’escalade associées à la règle du SLA par défaut à la racine du cas ou à une étape.

Arguments

Nom	Requis	Objectif
<file>	oui	Chemin d’accès au fichier JSON de gestion des cas.

Options

Long	Valeur (Value)	Description
--stage-id <stageId>	string	ID de l’étape à partir de laquelle répertorier les escalades. Omettez pour le SLA au niveau racine.

Exemple

uip maestro case sla escalation list case.json

Format des données (--sortie json)

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

EscalationRules est [] lorsque la cible n'a aucune règle SLA définie ou que la règle SLA n'a pas d'escalades.

Liste des règles sla du cas UIP Maestro

Répertoriez chaque règle de SLA conditionnelle définie à la racine du cas (les règles conditionnelles sont uniquement appliquées à la racine; le SLA d’une étape n’a pas de liste de règles conditionnelles distincte).

Arguments

Nom	Requis	Objectif
<file>	oui	Chemin d’accès au fichier JSON de gestion des cas.

Exemple

uip maestro case sla rules list case.json

Format des données (--sortie json)

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

Cela renvoie le même tableau sous-jacent que sla get sur la cible racine - les règles conditionnelles en premier, la règle par défaut (=js:true) en dernier.

Créer un SLA directement

Configurez les SLA et les escalades en modifiant vous-même le tableau slaRules de caseplan.json, en faisant correspondre les formes ci-dessus, puis en validant:

uip maestro case validate case.json

• Définir un SLA simple: ajoutez ou modifiez l'entrée avec expression: "=js:true" dans le tableau slaRules de la cible, en définissant count/unit.
• Ajouter une règle conditionnelle: ajoutez un expression réel (par exemple, "=js:amount>1000") et son propre count/unit avant l'entrée par défaut.
• Ajouter une escalade: placez un objet dans le tableau escalationRule de la règle par défaut — { id, displayName?, action: { type: "notification", recipients: [{ scope: "User" | "UserGroup", target, value }] }, triggerInfo: { type: "at-risk" | "sla-breached", atRiskPercentage? } }
• Supprimer quoi que ce soit: supprimez l’entrée de tableau correspondante et validez à nouveau.

Associé

• Incident uip maestro — Vue d'ensemble de la gestion des cas, init/pack/debug/validate/spec.
• uip maestro case cases & étapes — les définitions d'incident/étape à laquelle une cible SLA s'attache.
• tâches de cas uip maestro — définitions de tâches (les SLA sur les tâches, si pris en charge, sont documentés ici).

Voir également

• Présentation de l’outil Maestro
• Options globales
• Codes de sortie