UIP Maestro BPMN-Prozess und UIP Maestro BPMN-Prozesse

Syntax und Optionen für „uip Maestro BPMN Process“ und „UIP Maestro BPMN Processes“, die ordner- und mandantenweit veröffentlichte Maestro BPMN-Prozessvorgänge abdecken.

Sobald ein BPMN-Paket von Maestro im Orchestrator veröffentlicht wurde, wird es zu einem Prozess des Typs ProcessOrchestration. Beide folgenden Befehlsgruppen werden unter der Verzweigung bpmn registriert. Diese Seite behandelt zwei verwandte Befehlsgruppen:

• uip maestro bpmn process – Vorgänge pro Ordner für eine einzelne Prozessdefinition (Liste in einem Ordner, Schema abrufen, ausführen, packen und veröffentlichen).
• uip maestro bpmn processes (Plugin) – mandantenweite Zusammenfassungen, Vorfallssuche pro Prozess und Diagnosen.

Zusammenfassung

# Singular — per-folder, operational
uip maestro bpmn process list    -f <folder-key> [--filter <odata>] [--login-validity <minutes>]
uip maestro bpmn process get     <process-key> <feed-id> -f <folder-key> [--login-validity <minutes>]
uip maestro bpmn process run     <process-key> <folder-key> --release-key <key>
                                  [-i, --inputs <json>] [--feed-id <id>] [--robot-ids <ids>]
                                  [--login-validity <minutes>]
uip maestro bpmn process publish <project-path> [output-path] -f <folder-key>
                                  [-n, --name <name>] [--process-name <name>] [-v, --version <version>]
                                  [-i, --inputs <json>] [--feed-id <id>] [--entry-point <path>]
                                  [--wait [--timeout <seconds>] [--poll-interval <seconds>]] [--login-validity <minutes>]

# Plural — tenant-wide summary, incidents, and diagnostics
uip maestro bpmn processes list       [--folder-key <key>] [-l <limit>] [--offset <n>] [--status <status>]
uip maestro bpmn processes incidents  <process-key> --folder-key <key>
uip maestro bpmn processes diagnose   <process-key> --folder-key <key>
uip maestro bpmn processes error-codes <process-key> --folder-key <key>

Alle Unterbefehle erfordern uip login und berücksichtigen globale Optionen. Austrittscodes folgen dem Standardvertrag.

---

UIP Maestro BPMN-Prozessliste

Listen Sie verfügbare Maestro-Prozesse (Releases) in einem bestimmten Ordner auf.

Optionen

Option	Erforderlich	Beschreibung
-f, --folder-key <key>	ja	Ordnerschlüssel (GUID).
--filter <odata>	nein	Zusätzlicher OData-Filter serverseitig angewendet.
--login-validity <minutes>	nein	Schwellenwert für die Tokenaktualisierung (Standard: 10).

Datenform (--output json)

{
  "Code": "MaestroProcessList",
  "Data": [
    {
      "name":           "InvoiceOrchestration",
      "processKey":     "a1b2c3d4-0000-0000-0000-000000000001",
      "processVersion": "1.0.0",
      "packageId":      "a1b2c3d4-0000-0000-0000-000000000001",
      "packageVersion": "1.0.0",
      "releaseKey":     "e5f6a7b8-0000-0000-0000-000000000001",
      "folderKey":      "c3d4e5f6-0000-0000-0000-000000000001",
      "feedId":         "default",
      "folderId":       42,
      "active":         "Yes",
      "latest":         "Yes"
    }
  ]
}

---

UIP Maestro BPMN Process Get

Rufen Sie das Einstiegspunktschema (JSON-Schemas für Eingabe/Ausgabe) für einen Maestro-Prozess ab.

Argumente

• <process-key> (erforderlich) – Prozessschlüssel.
• <feed-id> (erforderlich) – Feed-ID (von list).

Optionen

• -f, --folder-key <key> (erforderlich)
• --login-validity <minutes> (Standard: 10)

Datenform

{
  "Code": "MaestroProcessGet",
  "Data": [
    {
      "Path":         "/content/main.bpmn#Event_start",
      "DisplayName":  "Manual trigger",
      "Type":         "processorchestration",
      "InputSchema":  "{\"type\":\"object\",\"properties\":{}}",
      "OutputSchema": "{\"type\":\"object\",\"properties\":{}}"
    }
  ]
}

InputSchema und OutputSchema sind erneut stringifizierte JSON-Schema-Strings.

---

Ausführung des UIP Maestro BPMN-Prozesses

Starten Sie einen Maestro-Auftrag für einen veröffentlichten Prozess.

Argumente

• <process-key> (erforderlich) – versionierter Paketprozessschlüssel von process list, zum Beispiel MyProcess:1.0.0.
• <folder-key> (erforderlich) – Ordnerschlüssel (GUID).

Optionen

Option	Erforderlich	Beschreibung
--release-key <key>	ja	Versionsschlüssel (GUID) – von process list.
-i, --inputs <json>	nein	Eingaben als JSON-Zeichenfolge oder @path/to/file.json. Wenn sie weggelassen wird und eine Standardeinstellung über die Pipeline übergeben wird, wird Standarddaten geparst.
--feed-id <id>	nein	Feed-ID für die Paketsuche (optional).
--robot-ids <ids>	nein	Durch Kommas getrennte Roboter-IDs (optional).
--login-validity <minutes>	nein	Schwellenwert für die Tokenaktualisierung (Standard: 10).

Für diesen Befehl gibt es keine --validate -Option – Eingaben werden unverändert gesendet; Der Prozess selbst ist für die Ablehnung falscher Eingaben verantwortlich.

Eingabepriorität: --inputs <json> / --inputs @file.json > ständig > leeres Objekt {}.

Beispiele

# Inline JSON
uip maestro bpmn process run "InvoiceOrchestration:1.0.0" "<folder-key>" \
  --release-key <release-key> --inputs '{"amount":100}'

# From a file
uip maestro bpmn process run "InvoiceOrchestration:1.0.0" "<folder-key>" \
  --release-key <release-key> --inputs @inputs.json

# Piped stdin
echo '{"amount":100}' | uip maestro bpmn process run "InvoiceOrchestration:1.0.0" "<folder-key>" --release-key <release-key>

Datenform

{
  "Code": "MaestroJobStarted",
  "Data": {
    "jobKey":  "b2c3d4e5-0000-0000-0000-000000000001",
    "state":   "Pending",
    "traceId": "d4e5f6a7-0000-0000-0000-000000000001"
  }
}

Nächster Schritt: uip maestro bpmn job traces <jobKey> für die Stream-Ausführung oder uip maestro bpmn job status <jobKey> für die Abfrage.

---

UIP Maestro BPMN Prozessveröffentlichung

Packen Sie ein Maestro BPMN-Projektverzeichnis in ein .nupkg und veröffentlichen Sie es als Orchestrator-Prozessrelease in einem Schritt.

Argumente

• <project-path> (erforderlich) – Der Pfad zum BPMN-Projektverzeichnis von Maestro.
• [output-path] (optional) – Ausgabeverzeichnis für die generierte .nupkg. Standardmäßig ein temporäres Verzeichnis.

Optionen

Option	Beschreibung
-f, --folder-key <key>	Erforderlich. Ordnerschlüssel (GUID).
-n, --name <name>	Paketname. Standard: Der Name des Projektordners.
--process-name <name>	Name der Prozessversion. Standard: Der Paketname.
-v, --version <version>	Paketversion Der Standardwert ist 1.0.0.
-i, --inputs <json>	Standardeingabeparameter als JSON-Zeichenfolge, @file.json oder - für Standardeingabeparameter.
--feed-id <id>	Feed-ID für den Paketupload (optional).
--entry-point <path>	Einstiegspunktpfad für den Prozess.
--wait	Warten Sie, bis die Einstiegspunkte des veröffentlichten Pakets verfügbar sind, anstatt sofort nach dem Upload zurückzukehren.
--timeout <seconds>	Maximale Sekunden, die auf die Veröffentlichungsweitergabe gewartet werden soll, wenn --wait festgelegt ist. Der Standardwert ist 300.
--poll-interval <seconds>	Sekunden zwischen den Prüfungen der Veröffentlichungsweitergabe, wenn --wait festgelegt ist. Der Standardwert ist 5.
--login-validity <minutes>	Schwellenwert für die Tokenaktualisierung. Der Standardwert ist 10.

Beispiel

uip maestro bpmn process publish ./invoice-process \
  --folder-key <folder-key> --version 1.2.0 --wait

Datenform

{
  "Code": "MaestroProcessPublished",
  "Data": {
    "Package": "invoice-process@1.2.0",
    "PackagePath": "/tmp/maestro-process-publish-.../invoice-process.processOrchestration.ProcessOrchestration.1.2.0.nupkg",
    "ProcessKey": "invoice-process.processOrchestration.ProcessOrchestration",
    "ProcessVersion": "1.2.0",
    "ReleaseKey": "e5f6a7b8-0000-0000-0000-000000000001",
    "ReleaseName": "invoice-process",
    "Action": "Created",
    "Upload": [
      { "key": "invoice-process.processOrchestration.ProcessOrchestration", "status": "Created" }
    ],
    "EntryPoints": 1
  }
}

Action ist "Created" bei der ersten Veröffentlichung eines bestimmten Prozessschlüssels, "Updated" bei nachfolgenden Veröffentlichungen.

---

UIP Maestro BPMN-Prozessliste

Mandantenweite (oder ordnerbezogene) Zusammenfassung von Maestro-Prozessen. Im Gegensatz zum Singular process list wird kein processType -Filter serverseitig angewendet – der mehrere Befehl wird für alle Tools (Maestro, Flow, Case) freigegeben und ist nicht ProcessOrchestration zugeordnet.

Optionen

Option	Beschreibung
--folder-key <key>	Optional. Grenzen Sie die Zusammenfassung auf einen Ordner ein.
-l, --limit <number>	Anzahl der zurückzugebenden Elemente (1–10.000).
--offset <number>	Anzahl der zu überspringenden Elemente (0-1000000). Der Standardwert ist 0.
--status <status>	Nach Prozessstatus filtern.

Datenform

{
  "Code": "ProcessList",
  "Data": [ /* array of Maestro process summaries */ ]
}

Hinweis:

Der genaue Feldsatz einer jeden Prozesszusammenfassung wird von der Maestro-Runtime festgelegt und kann sich weiterentwickeln; Führen Sie den Befehl einmal mit --output json für einen Mandanten mit Daten aus, um die Felder anzuzeigen, die Sie verbrauchen, und heften Sie @uipath/cli in CI an, wenn Sie bestimmte Felder parsen.

---

UIP Maestro BPMN Process Vorfälle

Rufen Sie alle Vorfälle für eine bestimmte Maestro-Prozessdefinition ab.

Argumente

• <process-key> (erforderlich) – Prozessdefinitionsschlüssel.

Optionen

• --folder-key <key> (erforderlich)

Datenform

{
  "Code": "ProcessIncidents",
  "Data": [ /* array of process incidents */ ]
}

---

Diagnose von UIP Maestro BPMN-Prozessen

Korrelieren Sie die Zusammenfassung, Vorfälle und Fehlercodes eines Prozesses in einem einzigen Aufruf – ein Convenience-Wrapper über processes list, processes incidents und processes error-codes.

Argumente

• <process-key> (erforderlich) – Prozessdefinitionsschlüssel.

Optionen

• --folder-key <key> (erforderlich)

Datenform

{
  "Code": "ProcessDiagnostics",
  "Data": {
    "ProcessKey": "InvoiceOrchestration",
    "FolderKey": "c3d4e5f6-0000-0000-0000-000000000001",
    "Summary": { /* the matching process summary object, or null if not found */ },
    "FaultedCount": 2,
    "RunningCount": 5,
    "Incidents": [ /* array of incident objects */ ],
    "IncidentCount": 1,
    "ErrorCodes": [ /* array of error code strings */ ],
    "ErrorCodeCount": 1
  }
}

---

uip Maestro BPMN verarbeitet Fehlercodes

Rufen Sie die eindeutigen Fehlercodes ab, die von Vorfällen für einen bestimmten Prozess ausgelöst wurden.

Argumente

• <process-key> (erforderlich) – Prozessdefinitionsschlüssel.

Optionen

• --folder-key <key> (erforderlich)

Datenform

{
  "Code": "ProcessIncidentErrorCodes",
  "Data": [ /* array of error code strings */ ]
}

Siehe auch

• uip maestro bpmn instances – Überprüfen und steuern Sie die laufenden Ausführungen
• uip maestro bpmn job – Ablaufverfolgungen und Status für einen einzelnen Auftrag
• uip maestro bpmn incidents – Zusammenfassungen und Details der Vorfälle
• Orchestrator-Aufträge, Orchestrator-Prozesse
• Maestro-Übersicht