UIP Maestro

uip maestro écrit, compresse, débogue et exploite des projets UiPath Maestro — BPMN 2.0 orchestrations de processus métier avec une sémantique de type Human-in-the-loop. Maestro est le frères de Flow (uip flow) dans l'espace d'orchestration UiPath; choisissez Maestro lorsque vous avez besoin de la sémantique BPMN standard (tâches utilisateur, événements de limite, minuteries, sous-processus), choisissez Flux lorsque vous avez besoin d'un graphique nœud- UiPath d'étapes agentiques ou de connecteurs lourds.

L'outil est livré sous la forme du plug-in @uipath/maestro-tool . Les commandes Maestro sont enregistrées sous uip maestro (ou, pour les sous-surfaces spécifiques à BPMN, uip maestro bpmn). Voir Outils pour le modèle de plug-in.

Création du flux

Un projet Maestro est un répertoire avec un project.uiproj, un fichier .bpmn et des fichiers de métadonnées prenant en charge (operate.json, entry-points.json, bindings_v2.json, package-descriptor.json).

# 1. Scaffold
uip maestro init invoice-orchestration

# 2. Edit the .bpmn in Studio Web or your IDE
#    (BPMN is validated at init time via bpmn-moddle)

# 3. Smoke-test via Studio Web
uip maestro debug ./invoice-orchestration

# 4. Pack for deployment
uip maestro pack ./invoice-orchestration ./dist --version 1.0.0

Création de commandes

Commande	Objectif
uip maestro init	Élaborer un nouveau projet Maestro (démarrage BPMN)
uip maestro debug	Charger vers Studio Web et exécuter une session de Debug
uip maestro pack	Créer un déployable .nupkg

Runtime

Lors du runtime, un package Maestro publié devient un processus de type ProcessOrchestration sur Orchestrator. L'étape de démarrage crée une instance; chaque tentative d'exécution est une tâche; les échecs font l'objet d' un incident.

Commande	Objectif
uip maestro process	Lister et exécuter les Processes Maestro déployés (list, get, run)
uip maestro processes	Résumés des processus dans tous les dossiers et incidents par processus
uip maestro instances	Inspectez et pilotez les instances en cours d'exécution (list, get, pause, resume, cancel, retry, migrate, goto, variables, …)
uip maestro incidents	Lire les résumés et les détails des incidents
uip maestro job	Flux des traçages (traces) et inspecter le statut de la tâche

Les tâches et les processus au niveau d'Orchestrator sont manipulés via l'outil Orchestrator — voir Tâches Orchestrator et Processus Orchestrator.

Registre (BPMN)

Maestro fournit également un registre BPMN — uip maestro bpmn registry — pour parcourir les types d'extension, les connecteurs et les processus utilisables dans un .bpmn. Elle n’est pas encore située dans la barre latérale mais est disponible dès aujourd’hui:

uip maestro bpmn registry pull   [-f, --force]
uip maestro bpmn registry list   [-l, --limit <n>]
uip maestro bpmn registry search <keyword>
uip maestro bpmn registry get    <extensionType> [--connection-id <id>] [--object-name <name>]

Formats de données: RegistryPullSuccess (nombre: ExtensionTypeCount, ConnectorCount, ProcessCount), RegistryListSuccess / RegistrySearchSuccess (Data.ExtensionTypes[], Data.Connectors[], Data.Processes[]), RegistryGetSuccess (Data.ExtensionType, facultatif Data.ISEnrichment lorsque les deux --connection-id et --object-name sont fournis).

Conventions

• Chaque sous-commande uip maestro respecte les options globales (--output, --output-filter, --log-level, --log-file).
• La sortie par défaut est JSON.
• Les codes de sortie suivent le contrat standard.
• La plupart des commandes de runtime nécessitent d'abord uip login - voir Authentification.

Voir également

• uip flow — Lorsqu'un workflow est en forme de graphique
• Outils (extensions)
• Authentification
• Options globales, codes de sortie