UIP Maestro BPMN Init

Syntax und Optionen für „uip Maestro bpmn init“, das ein neues Maestro-Projekt mit einem gültigen BPMN 2.0-Starter und Orchestrator-Metadatendateien erstellt.

uip maestro bpmn init erstellt ein Gerüst für ein neues Maestro-Projektverzeichnis mit einem gültigen BPMN 2.0-Starter und den Metadatendateien, die der Orchestrator für Prozessorchestrierungspakete erwartet. Er wird unter der Verzweigung bpmn registriert.

Zusammenfassung

uip maestro bpmn init <name> [--process-id <id>] [--force] [--skip-solution-registration]

Beachten Sie globale Optionen. Austrittscodes folgen dem Standardvertrag.

Argumente

• <name> (erforderlich) – Name des Projektordners. Validiert gegen VALID_PROJECT_NAME_REGEX: Nur Buchstaben, Ziffern, Unterstriche (_) und Bindestriche (-).

Optionen

Option	Beschreibung
--process-id <id>	BPMN-Prozess-ID, die in die generierte Vorlage geschrieben werden soll. Standard: Process_1.
--force	Initialisieren Sie auch dann, wenn das Zielverzeichnis vorhanden und nicht leer ist. Vorhandene Dateien werden nicht gelöscht – Dateien werden daneben geschrieben; Dies ist nützlich für die Neuinitialisierung innerhalb eines vorab erstellten Ordners.
--skip-solution-registration	Registrieren Sie dieses Projekt nicht automatisch in der Umgebungslösung (siehe Verhalten unten).

Verhalten

Erstellt <name>/ im aktuellen Arbeitsverzeichnis und schreibt sechs Dateien:

Datei	Zweck
project.uiproj	{ "Name": "<name>", "ProjectType": "ProcessOrchestration" }
operate.json	Laufzeitmetadaten – targetFramework: "Portable", contentType: "processOrchestration", runtimeOptions.isAttended: false.
entry-points.json	Ein Einstiegspunkt, der auf Event_start innerhalb des Start-BPMN verweist, mit leeren Eingabe-/Ausgabeschemas.
bindings_v2.json	{ "version": "2.0", "resources": [] }.
package-descriptor.json	Dateimanifest, das vom Packer verbraucht wird.
<name>.bpmn	Start-BPMN mit Event_start → _Implicit_EndEvent, verbunden mit einer uipath:entryPointId -Erweiterung über --process-id (Standard: Process_1).

Das Start-BPMN wird vor dem Schreiben durch bpmn-moddle geparst; wenn strukturierte Warnungen (nicht von UiPath-Extension) angezeigt werden, schlägt der Befehl mit BPMN validation failed: … fehl.

Wenn <name> bereits vorhanden und nicht leer ist und --force nicht festgelegt ist, schlägt der Befehl mit einem Fehler fehl.

Automatische Registrierung der Lösung: Wenn --skip-solution-registration nicht übergeben wird, sucht init nach einer umgebenden Lösung. Wenn es innerhalb eines ausgeführt wird, wird das neue Projekt darin registriert. Wenn die Ausführung außerhalb einer Lösung erfolgt, wird automatisch ein Gerüst für ein übergeordnetes <name>Solution erstellt und das Projekt darin verschachtelt – dies geschieht standardmäßig, nicht nur, wenn es explizit angefordert wird.

Beispiele

# Create a new project in ./invoice-orchestration
uip maestro bpmn init invoice-orchestration

# Set a custom BPMN process ID
uip maestro bpmn init invoice-orchestration --process-id InvoiceApproval

# Reinitialize into an existing non-empty folder
uip maestro bpmn init invoice-orchestration --force

# Scaffold standalone, without touching any surrounding solution
uip maestro bpmn init invoice-orchestration --skip-solution-registration

Datenform (--output json)

{
  "Code": "MaestroInit",
  "Data": {
    "Status": "Created successfully",
    "Path": "/workspace/invoice-orchestration",
    "SolutionRegistration": { "...": "registration outcome against the surrounding or newly created solution" },
    "AutoCreatedSolution": { "...": "present only when a parent <name>Solution was scaffolded automatically" },
    "ProjectArtifacts": { "...": "present only when additional project artifacts were generated" },
    "NextSteps": "present only when SolutionRegistration carries follow-up instructions"
  }
}

AutoCreatedSolution, ProjectArtifacts und NextSteps werden vollständig weggelassen, wenn sie nicht zutreffend sind – nur Status, Path und SolutionRegistration sind immer vorhanden. Bei einem Fehler enthält die Antwort Result: "Failure", Message und Instructions.

Siehe auch

• uip maestro bpmn pack – Packen Sie das Gerüst-Projekt
• uip maestro bpmn debug – Führen Sie es über Studio Web aus
• uip maestro bpmn validate – Vor dem Packen validieren
• Maestro-Übersicht