uip maestro bpmn debug

Upload a local Maestro BPMN project (or a single .bpmn file) to Studio Web and run a server-side debug session with streamed status updates using `uip maestro bpmn debug`.

uip maestro bpmn debug uploads a local Maestro project — or a single .bpmn file — to Studio Web and runs a server-side debug session, streaming per-element status updates back to the console and returning a final status. It's registered under the bpmn branch.

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] (optional) — path to the Maestro project directory. Must contain project.uiproj. Omit when using --bpmn-file. One of <project-path> or --bpmn-file is required; passing both is an error ("Provide either a project path or --bpmn-file, not both.").

Options

Option	Default	Description
--bpmn-file <path>	—	Debug a single .bpmn file directly instead of a project directory. Mutually exclusive with <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 links directly to the debug run in 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