sla de caso do uip Maestro

Sintaxe e opções para ler o contrato de nível de serviço (SLA) e configurações de escalonamento em uma definição de Maestro Case Management com "uip Maestro case sla".

uip maestro case sla lê a duração do acordo de nível de serviço (SLA), regras condicionais de SLA e notificações de escalonamento definidas em um arquivo caseplan.json de gerenciamento de caso — na raiz do caso ou em um estágio específico. Consulte uip maestro case para o subsistema de Gerenciamento de casos geral ao qual ele pertence.

Resumo

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>

Conceitos

• Destino do SLA — cada verbo de leitura opera na raiz do caso (padrão) ou em um estágio nomeado, selecionado com --stage-id <stageId>. Omita-o para o SLA de nível raiz.
• Regra padrão vs. regras condicionais — internamente, um SLA raiz/stage simples (definido por meio de edição direta de arquivo) é armazenado como uma entrada slaRules com uma expressão fixa (=js:true) que sempre corresponde; uma regra de SLA condicional é uma entrada adicional com uma expressão booleana JavaScript real (por exemplo =js:amount>1000) avaliado em relação aos dados do caso, permitindo que casos diferentes atinjam durações de SLA diferentes. As regras condicionais são ordenadas antes da regra padrão na matriz — a primeira expressão correspondente prevalece.
• Unidade de duração — cada duração de SLA é um par {count, unit} ; unit é um dos min, h, d, w, m (minutos/horas/dias/semanas/meses).
• Regra de escalonamento — uma notificação opcional anexada à regra de SLA padrão (raiz ou estágio), disparando at-risk (com um limite de --at-risk-percentage , por exemplo 80% da duração do SLA decorrido) ou sla-breached. Cada regra de escalonamento tem um destinatário — um User ou UserGroup, identificado por um ID/email de destino e um valor de exibição.
• Fallback de forma legada — sla get também reconhece uma forma pré-slaRules mais antiga ({sla: {count, unit, escalationRule}} escrita diretamente sob os dados do caso/estage) se nenhuma matriz slaRules estiver presente ainda e a normaliza no mesmo formato de saída.

sla de caso do uip Maestro obter

Leia as configurações efetivas de SLA — duração e quaisquer regras condicionais — para o caso raiz ou um estágio.

Argumentos

Name	Required	Finalidade
<file>	sim	Caminho para o arquivo JSON de gerenciamento de caso (caseplan.json).

Opções

Long	Valor	Description
--stage-id <stageId>	String	ID do estágio do qual o SLA será lido. Omita para o SLA de nível raiz.

Exemplo

uip maestro case sla get case.json

Formato dos dados (--output json)

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

Target é "root" ou o ID do estágio passado. SlaRules está vazio ([]) quando nenhum SLA tiver sido definido (por meio da edição direta de arquivo) nesse destino.

lista de escalonamento de sla de casos do uip Maestro

Liste as regras de escalonamento anexadas à regra de SLA padrão na raiz do caso ou em um estágio.

Argumentos

Name	Required	Finalidade
<file>	sim	Caminho para o arquivo JSON de gerenciamento de caso.

Opções

Long	Valor	Description
--stage-id <stageId>	String	ID do estágio do qual listar os escalonamentos. Omita para o SLA de nível raiz.

Exemplo

uip maestro case sla escalation list case.json

Formato dos dados (--output json)

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

EscalationRules é [] quando o destino não tem nenhuma regra de SLA definida ou a regra de SLA não tem escalonamentos.

lista de regras de sla de casos do uip Maestro

Liste cada regra de SLA condicional definida na raiz do caso (as regras condicionais são apenas de raiz; o SLA de um estágio não tem uma lista de regras condicionais separada).

Argumentos

Name	Required	Finalidade
<file>	sim	Caminho para o arquivo JSON de gerenciamento de caso.

Exemplo

uip maestro case sla rules list case.json

Formato dos dados (--output json)

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

Isso retorna a mesma matriz subjacente que sla get no destino raiz — regras condicionais primeiro, a regra padrão (=js:true) por último.

Criação de um SLA diretamente

Configure SLAs e escalonamentos editando você mesmo a matriz slaRules de caseplan.json, correspondendo as formas acima, e depois valide:

uip maestro case validate case.json

• Defina um SLA simples: adicione ou edite a entrada com expression: "=js:true" na matriz slaRules do destino, definindo count/unit.
• Adicionar uma regra condicional: adicione uma entrada com um expression real (por exemplo "=js:amount>1000") e seu próprio count/unit antes da entrada padrão.
• Adicionar um escalonamento: envie um objeto para a matriz escalationRule da regra padrão — { id, displayName?, action: { type: "notification", recipients: [{ scope: "User" | "UserGroup", target, value }] }, triggerInfo: { type: "at-risk" | "sla-breached", atRiskPercentage? } }.
• Remover qualquer coisa: exclua a entrada do array correspondente e valide novamente.

Relacionado

• caso uip Maestro — Visão geral do gerenciamento de casos, init/pack/debug/validate/spec.
• casos e estágios de caso do uip Maestro — as definições de caso/etapa às quais um destino de SLA anexa.
• tarefas de caso do uip Maestro — definições de tarefas (SLAs em tarefas, se compatíveis, são documentados lá).

Veja também

• Visão geral da ferramenta Maestro
• Opções globais
• Códigos de saída