BPMN uip Maestro

Commandes pour la création, la compression, le débogage et l'exploitation de projets UiPath Maestro BPMN à l'aide de l'outil `uip maestro bpmn`.

uip maestro bpmn é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 l'une des trois surface d'orchestration frères: BPMN (cette page), Flux (uip maestro flow) et Gestion des cas (uip maestro case). Choisissez BPMN pour la sémantique BPMN standard (tâches utilisateur, événements de limite, minuteries, sous-processus), Flow pour un graphique à nœuds et bords d'étapes agentiques ou de connecteurs, et Gestion des cas pour une unité longue durée pilotée par un humain du travail modélisé sous forme d'étapes/tâches/SLA plutôt que d'un processus linéaire.

L'outil est livré sous la forme du plug-in @uipath/maestro-tool. Chaque commande de cette page est enregistrée sous la branche bpmn - l'invocation réelle est toujours uip maestro bpmn <verb>, jamais une barre uip maestro <verb>. 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 bpmn 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 bpmn debug ./invoice-orchestration

# 4. Validate the .bpmn file before packing
uip maestro bpmn validate ./invoice-orchestration/invoice-orchestration.bpmn

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

# ...or pack + publish straight to Orchestrator in one step
uip maestro bpmn process publish ./invoice-orchestration --folder-key <key>

Création de commandes

Commande	Objectif
uip maestro bpmn init	Élaborer un nouveau projet Maestro (démarrage BPMN)
uip maestro bpmn debug	Charger vers Studio Web et exécuter une session de Debug
uip maestro bpmn validate	Valider le BPMN et les métadonnées d’un projet sans le compresser
uip maestro bpmn format	Formater automatiquement et optimiser un fichier .bpmn
uip maestro bpmn refresh	Régénérer les fichiers de projet générés à partir du fichier .bpmn
uip maestro bpmn update-metadata	(Obsolète — utilisez refresh) Mettre à jour les fichiers de métadonnées générés
uip maestro bpmn pack	Créer un déployable .nupkg
uip maestro bpmn process publish	Créer un package et publier sur Orchestrator en une seule étape

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 bpmn process	Lister et exécuter les Processes Maestro déployéslistgetrunpublish
uip maestro bpmn processes	Résumés des processus dans les dossiers, les incidents par processus et les diagnosticslistincidentsdiagnoseerror-codes
uip maestro bpmn instance	Inspecter et piloter les instances en cours d'exécution,list getpauseresumecancelretrymigrategotovariablesmessage sendelement cancelretry…)
uip maestro bpmn debug-instance	Déboguer une instance spécifique en cours d'exécution de manière interactive
uip maestro bpmn incident	Lire les résumés et les détails des incidents
uip maestro bpmn 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>] [--operation <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 bpmn 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 maestro flow — Lorsqu'un workflow est en forme de graphique
• uip maestro case — Simultanéité
• Outils (extensions)
• Authentification
• Options globales, codes de sortie