Débogage d’UIP Maestro

uip maestro debug charge un projet Maestro local dans Studio Web et exécute une session de Debug côté serveur, en streaming les mises à jour du statut par élément vers la console et en renvoyant un statut final.

Synthèse

uip maestro debug <project-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> (obligatoire) : chemin d'accès au répertoire du projet Maestro. Doit contenir project.uiproj.

Options

Option	Default	Description
--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 debug ./invoice-orchestration

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

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

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",
    "elementExecutions": [
      { "elementId": "Activity_1", "status": "Completed" }
    ]
  }
}

Voir également

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