débogage bpmn uip maestro

Chargez un projet Maestro BPMN local (ou un fichier.bpmn) vers Studio Web et exécutez une session de débogage côté serveur avec des mises à jour du statut en streaming à l'aide de `uip maestro bpmn debug`.

uip maestro bpmn debug télécharge un projet Maestro local — ou un fichier .bpmn unique — dans Studio Web et exécute une session de débogage côté serveur en affichant les mises à jour de statut par élément dans la console et en renvoyant un statut final. Elle est enregistrée sous la branche bpmn.

Synthèse

uip maestro bpmn debug [project-path]
                  [--bpmn-file <path>]
                  [--folder-id <id>]
                  [--poll-interval <ms>]
                  [-i, --inputs <json>]
                  [--login-validity <minutes>]

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

Arguments

• [project-path] (facultatif) : chemin d'accès au répertoire du projet Maestro. Doit contenir project.uiproj. Omettez lorsque vous utilisez --bpmn-file. L’un des éléments <project-path> ou --bpmn-file est requis; la transmission des deux est une erreur (« Indiquez un chemin d’accès au projet ou --bpmn-file, pas les deux. »).

Options

Option	Default	Description
--bpmn-file <path>	—	Déboguez un seul fichier .bpmn directement au lieu d'un répertoire de projet. Capture mutuellement exclusive avec <project-path>.
--folder-id <id>	Détecté automatiquement	Dossier Orchestrator (OrganizationUnitId). S’il est omis, le dossier de la session de connexion actuelle est utilisé. Analyse et validation via parseFolderId.
--poll-interval <ms>	2000	Intervalle d'interrogation en millisecondes. Doit être un nombre positif.
-i, --inputs <json>	—	Arguments d'entrée sous la forme d'une chaîne JSON ou @path/to/file.json.
--login-validity <minutes>	10	Nombre minimum de minutes avant l’expiration du jeton pour déclencher une actualisation automatique.

Comportement

1. Valide la connexion et extrait l'organisation, le locataire, l'URL de base et le jeton d'authentification de la session.
2. Charge le projet dans Studio Web sous le dossier cible.
3. Interrogation pour un statut final, extrayant des lignes de statut par élément comme:

   Status: InProgress (2/5 elements completed)
     v Activity_1 [Completed]
     > Activity_2 [InProgress]
     - Activity_3 [NotStarted]
   

4. En cas d'incident pendant l'exécution, génère une ligne de journal.
5. Quitte 0 si finalStatus est Completed ou Successful; 1 dans le cas contraire.

Exemples

# Debug with auto-detected folder
uip maestro bpmn debug ./invoice-orchestration

# Specify folder and inline inputs
uip maestro bpmn debug ./invoice-orchestration --folder-id 2553016 \
  --inputs '{"amount":100,"customer":"Acme"}'

# Inputs from a file
uip maestro bpmn debug ./invoice-orchestration --inputs @inputs.json

# Debug a single .bpmn file directly, without a full project directory
uip maestro bpmn debug --bpmn-file ./main.bpmn

Format des données (--sortie json)

{
  "Code": "MaestroDebug",
  "Data": {
    "jobKey":      "b2c3d4e5-0000-0000-0000-000000000001",
    "instanceId":  "c3d4e5f6-0000-0000-0000-000000000001",
    "runId":       "d4e5f6a7-0000-0000-0000-000000000001",
    "finalStatus": "Completed",
    "solutionId":  "e5f6a7b8-0000-0000-0000-000000000001",
    "studioWebUrl": "https://cloud.uipath.com/org/studio_/designer/f6a7b8c9-...?solutionId=e5f6a7b8-...",
    "elementExecutions": [
      { "elementId": "Activity_1", "status": "Completed" }
    ]
  }
}

studioWebUrl renvoie directement à l'exécution du débogage dans Studio Web.

Voir également

• uip maestro bpmn process run — exécute un processus publié
• uip maestro bpmn job traces — traçages de flux pour une tâche déjà démarrée
• Authentification
• Vue d’ensemble de Maestro