UIP Maestro BPMN

Befehle zum Erstellen, Packen, Debuggen und Ausführen von UiPath Maestro BPMN-Orchestrierungsprojekten mit dem Tool „uip Maestro BPMN“.

uip maestro bpmn erstellt, verpackt, debuggt und verwaltet UiPath Maestro- Projekte – BPMN 2.0-Orchestrierungen von Geschäftsprozessen mit langlaufender, menschlicher Eingriffe. Maestro ist eine von drei gleichgeordneten Orchestrierungsoberflächen: BPMN (diese Seite), Flow (uip maestro flow) und Fallverwaltung (uip maestro case). Wählen Sie BPMN für eine Standard-BPMN-Semantik (Benutzeraufgaben, Grenzereignisse, Timer, Teilprozesse), Flow für ein Knoten-und-Edge-Diagramm agentischer oder steckverbinder-Schritte und Fallverwaltung für eine langlaufende, von Menschen gesteuerte Einheit der Arbeit, die als Phasen/Aufgaben/SLAs und nicht als linearer Prozess modelliert wird.

Das Tool wird als @uipath/maestro-tool -Plugin ausgeliefert. Jeder Befehl auf dieser Seite wird unter der bpmn -Verzweigung registriert – der echte Aufruf ist immer uip maestro bpmn <verb>, niemals ein leerer uip maestro <verb>. 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 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>

Erstellen von Befehlen

Befehl	Zweck
uip maestro bpmn init	Gerüst für ein neues Maestro-Projekt (BPMN-Starter)
uip maestro bpmn debug	Laden Sie in Studio Web hoch und führen Sie eine Debug-Sitzung aus
uip maestro bpmn validate	Validieren Sie das BPMN und die Metadaten eines Projekts ohne Packen
uip maestro bpmn format	Automatisches Formatieren und Bereinigen einer .bpmn -Datei
uip maestro bpmn refresh	Generierte Projektdateien aus den aktuellen neu generieren .bpmn
uip maestro bpmn update-metadata	(Veraltet – refresh verwenden) Aktualisieren Sie generierte Metadatendateien
uip maestro bpmn pack	Sie können ein bereitstellbares erstellen .nupkg
uip maestro bpmn process publish	Packen und Veröffentlichen im Orchestrator in einem Schritt

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 bpmn process	Bereitgestellte Maestro-Prozesse auflisten und ausführen (list, get, run, publish)
uip maestro bpmn processes	Prozesszusammenfassungen über Ordner hinweg, prozessspezifische Vorfälle und Diagnosen (list, incidents, diagnose, error-codes)
uip maestro bpmn instance	Überprüfen und steuern Sie die laufenden Instanzen (list, get, pause, resume, cancel, retry, migrate, goto, variables, message send, element cancel/)retry, …)
uip maestro bpmn debug-instance	Debuggen Sie interaktiv eine bestimmte laufende Instanz
uip maestro bpmn incident	Lesen Sie Zusammenfassungen und Details der Vorfälle
uip maestro bpmn 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>] [--operation <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 bpmn -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 maestro flow – diagrammähnliches Workflow
• uip maestro case – gleichgeordnetes Element der Fallverwaltung
• Tools (Plugins)
• Authentication
• Globale Optionen, Beendigungscodes