Instance de débogage du flux uip Maestro

Syntaxe et options de `uip Maestro flow debug-instance`, une interface de contrôle de débogage de bas niveau permettant d'inspecter et de gérer une session de débogage de Studio Web.

uip maestro flow debug-instance est une interface de contrôle de débogage de bas niveau: créez une instance de débogage, puis parcourez-la, inspectez ses variables et ses incidents, puis annulez-la ou poursuivez-la. Il s'agit d'une couche différente et plus précise que uip maestro flow debug, qui permet de télécharger un projet et d'effectuer des interrogations jusqu'à la fin en un seul appel. debug-instance est ce que vous atteindrez pour créer un outil de débogage personnalisé (par exemple, une intégration d'éditeur) autour du protocole de débogage de Studio Web, en pilotant une étape à la fois.

Synthèse

uip maestro flow 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 flow debug-instance status         <instance-id>
uip maestro flow debug-instance breakpoints    <instance-id> [--inputs <json|@file>]
uip maestro flow debug-instance cancel         <instance-id>
uip maestro flow debug-instance continue       <instance-id> [--inputs <json|@file>]
uip maestro flow debug-instance incidents      <instance-id>
uip maestro flow debug-instance variables      <instance-id> [--parent-element-id <id>]
uip maestro flow debug-instance variables-set  <instance-id> [--inputs <json|@file>]
uip maestro flow debug-instance variables-all  <instance-id>

Les options globales sont respectées. Les codes de sortie suivent le contrat standard. Nécessite uip login.

Création d’instances de débogage de flux uip Maestro

Commencez une session de débogage dans Orchestrator et créez l'instance de débogage correspondante pour une solution déjà téléchargée.

Options

Option	Requis	Default	Description
--solution-id <id>	oui	—	ID de solution d'un téléchargement précédent ou de Studio Web.
--project-id <id>	oui	—	ID de projet Studio Web dans la solution.
--entry-point <path>	oui	—	Chemin du point d'entrée, par exemple /Main.bpmn#start.
--process-type <type>	non	processOrchestration	Type de processus.
--debug-mode <mode>	non	Default	Default (pause au point d'arrêt), StepByStep (pause à chaque étape) ou SingleStep (exécutez exactement une étape).
--simulation-mode <mode>	non	None	None, All (simuler chaque élément) ou Selective (simuler, sauf les refus).
-i, --inputs <json>	non	{}	Les arguments d'entrée sous la forme d'une chaîne JSON.

Les valeurs --debug-mode/--simulation-mode non valides échouent rapidement, affichant l’ensemble valide.

Format des données

{
  "Code": "DebugInstanceCreated",
  "Data": {
    "instanceId": "…",
    "runId": "…",
    "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."
}

Statut de débogage du flux UIP Maestro

Obtenez le statut d’exécution par élément. Argument: <instance-id>. Format des données: Code: "DebugInstanceStatus".

Points d’arrêt des instances de débogage du flux UIP Maestro

Mettez à jour le point d'arrêt défini pour une instance suspendue. Argument: <instance-id>. Option: --inputs <value> — la charge utile des points d'arrêt sous la forme d'une chaîne JSON, d'un chemin @file ou d'un pipeline via st din. Format des données: Code: "DebugInstanceBreakpointsUpdated".

Annuler l'instance de débogage du flux uip Maestro

Annulez une instance de Debug. Argument: <instance-id>. Format des données: Code: "DebugInstanceCanceled".

instance de débogage du flux uip maestro

Reprenez l'exécution sur une instance suspendue. Argument: <instance-id>. Option: --inputs <value> — une chaîne JSON, un chemin d'accès @file ou un stbin; la valeur par défaut est {"nextStep": false} lorsqu'elle est omise (exécution au point d'arrêt suivant plutôt qu'à une seule étape). Format des données: Code: "DebugInstanceContinued".

incidents de débogage du flux uip maestro

Récupérez les incidents déclenchés pendant la session de Debug. Argument: <instance-id>. Format des données: Code: "DebugInstanceIncidents", Data est un tableau (vide si aucun).

Variables d’instance de débogage du flux UiP Maestro

Récupérez les variables de l'instance. Argument: <instance-id>. Option: --parent-element-id <id> — filtrer sur les variables étendues sous un élément. Format des données: Code: "DebugInstanceVariables".

Flux uip Maestro - Variables d’instance - Définir

Variables de correctif (mise à jour partielle). Argument: <instance-id>. Option: --inputs <value> — corriger la charge utile au format chaîne JSON, @file chemin ou stbin. Format des données: Code: "DebugInstanceVariablesSet".

Flux uip Maestro déboguer-instances-all

Obtenez toutes les variables, y compris les étendues de sous-processus. Argument: <instance-id>. Format des données: Code: "DebugInstanceVariablesAll".

Voir également

• uip maestro flow debug — la commande de débogage de niveau supérieur et d'interrogation que la plupart des workflows doivent utiliser à la place
• uip maestro flow instance — la surface de contrôle équivalente pour une instance publiée en cours d'exécution plutôt qu'une session de débogage
• Vue d’ensemble du flux
• Options globales, codes de sortie