UIP Maestro

uip maestro erstellt, verpackt, debuggt und verwaltet UiPath Maestro- Projekte – BPMN 2.0-Orchestrierungen von Geschäftsprozessen mit langlaufender, menschlicher Eingriffe. Maestro ist das gleichgeordnete Element von Flow (uip flow) in der UiPath-Orchestrierungsoberfläche; Wählen Sie Maestro, wenn Sie eine Standard-BPMN-Semantik benötigen (Benutzeraufgaben, Grenzereignisse, Timer, Teilprozesse), und wählen Sie Flow, wenn Sie ein Knoten-und-Edge-Diagramm von agentischen oder steckverbinder-Schritten benötigen.

Das Tool wird als @uipath/maestro-tool -Plugin ausgeliefert. Maestro-Befehle werden unter uip maestro (oder für BPMN-spezifische Teiloberflächen uip maestro bpmn) registriert. Das Plugin-Modell finden Sie unter Tools (Plugins) .

Erstellungsflow

Ein Maestro-Projekt ist ein Verzeichnis mit einer project.uiproj, einer .bpmn -Datei und unterstützenden Metadatendateien (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

Erstellen von Befehlen

Befehl	Zweck
uip maestro init	Gerüst für ein neues Maestro-Projekt (BPMN-Starter)
uip maestro debug	Laden Sie in Studio Web hoch und führen Sie eine Debug-Sitzung aus
uip maestro pack	Sie können ein bereitstellbares erstellen .nupkg

Laufzeit

Zur Runtime wird ein veröffentlichtes Maestro-Paket zu einem Prozess des Typs ProcessOrchestration in Orchestrator. Beim Starten von eins wird eine Instanz erstellt; Jeder Ausführungsversuch ist ein Auftrag; Fehler als Vorfälle auftreten.

Befehl	Zweck
uip maestro process	Bereitgestellte Maestro-Prozesse auflisten und ausführen (list, get, run)
uip maestro processes	Ordnerübergreifende Prozesszusammenfassungen und Vorfälle pro Prozess
uip maestro instances	Überprüfen und steuern Sie die laufenden Instanzen (list, get, pause, resume, cancel, retry, migrate, goto, variables, …)
uip maestro incidents	Lesen Sie Zusammenfassungen und Details der Vorfälle
uip maestro job	Streamen Sie die Ablaufverfolgung (traces) und überprüfen Sie den Auftragsstatus

Aufträge und Prozesse auf Orchestrator-Ebene werden über das Orchestrator-Tool bearbeitet – siehe Orchestrator-Aufträge und Orchestrator-Prozesse.

Registrierung (BPMN)

Maestro liefert auch eine BPMN-Registrierung – uip maestro bpmn registry – zum Durchsuchen der Erweiterungstypen, Connectors und Prozesse, die in einem .bpmn verwendet werden können. Sie befindet sich noch nicht in der Seitenleiste, ist aber noch heute aufrufbar:

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>]

Datenstrukturen: RegistryPullSuccess (Anzahl: ExtensionTypeCount, ConnectorCount, ProcessCount), RegistryListSuccess / RegistrySearchSuccess (Data.ExtensionTypes[], Data.Connectors[], Data.Processes[]), RegistryGetSuccess (Data.ExtensionType, optional Data.ISEnrichment wenn sowohl --connection-id als auch --object-name bereitgestellt sind).

Konventionen

• Jeder uip maestro -Unterbefehl berücksichtigt die globalen Optionen (--output, --output-filter, --log-level, --log-file).
• Die Standardausgabe ist JSON.
• Austrittscodes folgen dem Standardvertrag.
• Die meisten Runtime-Befehle erfordern zuerst uip login – siehe Authentifizierung.

Siehe auch

• uip flow – diagrammähnliches Workflow
• Tools (Plugins)
• Authentication
• Globale Optionen, Beendigungscodes