uip Maestro bpmn debug-instance

Sintaxe e opções para o "uip Maestro bpmn debug-instance", que direciona uma sessão de depuração interativa e com ponto de interrupção em uma solução do Studio Web já carregada.

uip maestro bpmn debug-instance direciona uma sessão de depuração interativa de baixo nível — crie a instância, inspecione seu status/variáveis/incidentes, defina pontos de interrupção e avance com ela. Ele está registrado na ramificação bpmn.

Essa é uma superfície diferente e de nível inferior a uip maestro bpmn debug: debug é um comando único "upload e execução até a conclusão". debug-instance assume que a solução já está carregada no Studio Web e dá a você controle manual sobre uma execução de depuração — pausando em pontos de interrupção, inspecionando variáveis no meio da execução e seguindo em frente — a contraparte interativa, referenciada pelas instruções de erro do próprio debug quando uma sessão de depuração precisa de controle no nível da etapa.

Resumo

uip maestro bpmn debug-instance create --solution-id <id> --project-id <id> --entry-point <path>
                                        [--process-type <type>] [--debug-mode <mode>] [--simulation-mode <mode>] [-i, --inputs <json>]
uip maestro bpmn debug-instance status         <instance-id>
uip maestro bpmn debug-instance breakpoints    <instance-id> --inputs <json|@file>
uip maestro bpmn debug-instance cancel         <instance-id>
uip maestro bpmn debug-instance continue       <instance-id> [--inputs <json|@file>]
uip maestro bpmn debug-instance incidents      <instance-id>
uip maestro bpmn debug-instance variables      <instance-id> [--parent-element-id <id>]
uip maestro bpmn debug-instance variables-set  <instance-id> --inputs <json|@file> [--parent-element-id <id>]
uip maestro bpmn debug-instance variables-all  <instance-id>

Todos os subcomandos exigem uip login, honram opções globais e seguem o contrato de código de saída padrão.

criação de depuração da instância do uip Maestro bpmn

Crie uma instância de depuração a partir de uma solução já carregada no Studio Web e inicie uma sessão de depuração na pasta do espaço de trabalho pessoal do Orchestrator.

Opções

Opção	Required	Description
--solution-id <id>	sim	ID da solução de um upload anterior ou Studio Web.
--project-id <id>	sim	ID do projeto do Studio Web dentro da solução.
--entry-point <path>	sim	Caminho do ponto de entrada, por exemplo /Main.bpmn#start).
--process-type <type>	não	Tipo de processo. processOrchestrationPadrão.
--debug-mode <mode>	não	Uma destas opções: None, Default (pausa em pontos de interrupção), StepByStep (pausa em cada etapa), SingleStep (apenas uma etapa). Padrão Default. Um valor inválido falha rapidamente listando o conjunto aceito.
--simulation-mode <mode>	não	Um destes None, All (simular todos os elementos), Selective (simular exceto desativações). Padrão None. Um valor inválido falha rapidamente listando o conjunto aceito.
-i, --inputs <json>	não	Argumentos de entrada como uma string JSON. {}Padrão.

Formato dos dados

{
  "Code": "DebugInstanceCreated",
  "Data": {
    "instanceId": "c3d4e5f6-...",
    "runId": "d4e5f6a7-...",
    "jobKey": "b2c3d4e5-..."
  },
  "Instructions": "Use 'debug-instance status <instance-id>' to check the run. Use 'debug-instance incidents <instance-id>' or 'debug-instance variables <instance-id>' to inspect it."
}

status da instância de depuração do uip Maestro bpmn

Obtenha o status atual de execução por elemento de uma instância de depuração.

Argumentos: <instance-id> (obrigatório). Formato dos dados: Code: "DebugInstanceStatus".

pontos de interrupção da instância debug do uip Maestro bpmn

Substitua o ponto de interrupção definido em uma instância de depuração.

Argumentos: <instance-id> (obrigatório).

Opções: --inputs <value> carga útil dos pontos de interrupção como string JSON, caminho @file ou canalizada via stdin. Se omitido, uma lista de pontos de interrupção vazia ({"breakpoints": []}) será enviada, limpando todos os pontos de interrupção.

Formato dos dados: Code: "DebugInstanceBreakpointsUpdated".

uip Maestro bpmn debug-instância cancelar

Cancele uma instância de depuração.

Argumentos: <instance-id> (obrigatório). Formato dos dados: Code: "DebugInstanceCanceled".

uip Maestro bpmn debug-instância continuar

Retome a execução em uma instância de depuração pausada.

Argumentos: <instance-id> (obrigatório).

Opções: --inputs <value> continue a carga como uma string JSON, caminho @file ou canalizado via stdin. Se omitido, {"nextStep": false} é enviado (executado para o próximo ponto de interrupção em vez de uma única etapa).

Formato dos dados: Code: "DebugInstanceContinued".

incidentes debug-instance do uip Maestro bpmn

Registra os incidentes gerados durante a execução de uma instância de depuração.

Argumentos: <instance-id> (obrigatório). Formato dos dados: Code: "DebugInstanceIncidents", Data é uma matriz (vazia quando não há nenhum).

variáveis de instância debug debug do uip Maestro bpmn

Obtenha os valores da variável atual de uma instância de depuração.

Argumentos: <instance-id> (obrigatório).

Opções: --parent-element-id <id> filtre variáveis por ID de elemento pai.

Formato dos dados: Code: "DebugInstanceVariables".

variáveis-set debug-instance do uip Maestro bpmn

Corrija (atualize) as variáveis de uma instância de depuração no meio da execução.

Argumentos: <instance-id> (obrigatório).

Opções:

Opção	Required	Description
--inputs <value>	sim	Carga de variáveis de patch como uma string JSON, caminho @file ou tabulada via stdin. A falha se nenhuma carga for resolvida.
--parent-element-id <id>	não	Faça o escopo do patch para um ID de elemento pai.

Formato dos dados: Code: "DebugInstanceVariablesSet".

variáveis-all debug-instance do uip Maestro bpmn

Obtenha cada variável para uma instância de depuração, incluindo variáveis de subprocesso.

Argumentos: <instance-id> (obrigatório). Formato dos dados: Code: "DebugInstanceVariablesAll".

Exemplos

# Create a debug session, stepping through one element at a time
uip maestro bpmn debug-instance create \
  --solution-id <solution-id> --project-id <project-id> \
  --entry-point "/Main.bpmn#start" --debug-mode StepByStep

# Check status, then step forward
uip maestro bpmn debug-instance status <instance-id>
uip maestro bpmn debug-instance continue <instance-id>

# Inspect and patch a variable mid-run
uip maestro bpmn debug-instance variables <instance-id>
uip maestro bpmn debug-instance variables-set <instance-id> --inputs '{"amount": 250}'

# Clean up
uip maestro bpmn debug-instance cancel <instance-id>

Veja também

• uip maestro bpmn debug — sessão de depuração única de upload e execução
• uip maestro bpmn instance — as operações equivalentes em uma instância de processo publicada , em vez de uma sessão de depuração
• Visão geral do Maestro