Instance de débogage BPMN uip maestro

Syntaxe et options pour `uip maestro bpmn debug-instance`, qui génère une session de débogage interactive compatible avec les points d'arrêt par rapport à une solution Studio Web déjà téléchargée.

uip maestro bpmn debug-instance entraîne une session de débogage interactive de bas niveau - créez l'instance, inspectez son statut/variables/incidents, définissez des points d'arrêt et faites un pas en avant. Elle est enregistrée sous la branche bpmn.

Il s'agit d'une surface de niveau inférieur différent de uip maestro bpmn debug: debug est une commande unique « télécharger et exécuter jusqu'à l'achèvement». debug-instance suppose que la solution est déjà téléchargée sur Studio Web et vous donne le contrôle manuel sur une exécution de débogage — pause aux points d'arrêt, inspection des variables à mi-parcours et pas à pas ultérieur — l'équivalent interactif, référencé par les propres instructions d'erreur de debug lorsqu'une session de débogage nécessite un contrôle au niveau étape.

Synthèse

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>

Toutes les sous-commandes nécessitent uip login, respectent les options globales et suivent le contrat de code de sortie standard.

création d’instance de débogage bpmn uip maestro

Créez une instance de débogage à partir d'une solution déjà téléchargée sur Studio Web et commencez une session de débogage dans le dossier de l'espace de travail personnel d'Orchestrator.

Options

Option	Requis	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	Type de processus. Par défaut processOrchestration.
--debug-mode <mode>	non	Un de None, Default (pause au point d'arrêt), StepByStep (pause à chaque étape), SingleStep (une seule étape). Par défaut Default. Une valeur non valide échoue rapidement dans la liste de l’ensemble accepté.
--simulation-mode <mode>	non	L’un des éléments None, All (simuler tous les éléments), Selective (simuler, sauf pour les refus). None par défaut. Une valeur non valide échoue rapidement dans la liste de l’ensemble accepté.
-i, --inputs <json>	non	Les arguments d'entrée sous la forme d'une chaîne JSON. Par défaut {}.

Format des données

{
  "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."
}

Statut de l'instance de débogage BPMN uip Maestro

Obtenez le statut d’exécution actuel par élément d’une instance de débogage.

Arguments: <instance-id> (requis). Format des données: Code: "DebugInstanceStatus".

Points d’arrêt des instances de débogage BPMN uip Maestro

Remplacez le point d'arrêt défini sur une instance de débogage.

Arguments: <instance-id> (requis).

Options: --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. Si ce champ est omis, une liste de points d'arrêt vide ({"breakpoints": []}) est envoyée, effaçant tous les points d'arrêt.

Format des données: Code: "DebugInstanceBreakpointsUpdated".

uip maestro bpmn - instance de débogage

Annulez une instance de Debug.

Arguments: <instance-id> (requis). Format des données: Code: "DebugInstanceCanceled".

uip maestro bpmn debug-instance

Reprenez l'exécution sur une instance de débogage suspendue.

Arguments: <instance-id> (requis).

Options: --inputs <value> — continue la charge utile sous forme de chaîne JSON, @file chemin ou un pipeline via st din. Si omis, {"nextStep": false} est envoyé (exécuter au point d'arrêt suivant plutôt qu'à une seule étape).

Format des données: Code: "DebugInstanceContinued".

incidents de débogage bpmn uip maestro

Récupérez les incidents déclenchés lors de l'exécution d'une instance de débogage.

Arguments: <instance-id> (requis). Format des données: Code: "DebugInstanceIncidents", Data est un tableau (vide lorsqu'il n'y en a pas).

Variables bpmn uip maestro d'instance de débogage

Obtenez les valeurs actuelles des variables d'une instance de débogage.

Arguments: <instance-id> (requis).

Options: --parent-element-id <id> — filtrer les variables par ID d'élément parent.

Format des données: Code: "DebugInstanceVariables".

uip maestro bpmn debug-instance variables-set

Corrigez (mettez à jour) les variables d'une instance de débogage à mi-parcours.

Arguments: <instance-id> (requis).

Options:

Option	Requis	Description
--inputs <value>	oui	Charge utile des variables de correctif sous forme de chaîne JSON, de chemin @file ou de pipeline via st din. Échoue si aucune charge utile ne se résout.
--parent-element-id <id>	non	Étendue du correctif à un ID d'élément parent.

Format des données: Code: "DebugInstanceVariablesSet".

uip maestro bpmn debug-instance variables-all

Obtenez chaque variable d'une instance de débogage, y compris les variables de sous-processus.

Arguments: <instance-id> (requis). Format des données: Code: "DebugInstanceVariablesAll".

Exemples

# 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>

Voir également

• uip maestro bpmn debug — session de débogage unique de téléchargement et d'exécution
• uip maestro bpmn instance — les opérations équivalentes sur une instance de processus publiée , plutôt que sur une session de débogage
• Vue d’ensemble de Maestro