UIP Maestro BPMN-Auftrag

Syntax und Optionen für „uip Maestro BPMN Job“, der Ausführungsablaufverfolgungen streamt und den detaillierten Status für einzelne BPMN-Aufträge abruft.

uip maestro bpmn job überprüft einen einzelnen Maestro-Auftrag – einen Ausführungsversuch einer Prozessinstanz –, indem seine Traces streamen oder seinen detaillierten Status abrufen. Er wird unter der Verzweigung bpmn registriert.

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

Zusammenfassung

uip maestro bpmn job traces <job-key>
                       [-f, --folder-key <key>] [--poll-interval <ms>]
                       [--traces-service <name>] [--pretty]
                       [--login-validity <minutes>]

uip maestro bpmn job status <job-key>
                       --folder-key <key> [--detailed]
                       [--login-validity <minutes>]

uip Maestro BPMN-Auftragsablaufverfolgungen

Streamen Sie Ausführungs-Trace-Ereignisse für einen laufenden oder kürzlich abgeschlossenen Auftrag.

Argumente

• <job-key> (erforderlich) – Auftragsschlüssel (GUID von process run).

Optionen

Option	Standard	Beschreibung
-f, --folder-key <key>	–	Ordnerschlüssel (GUID). Optional – wird nur verwendet, um den Scope der Ablaufverfolgungsanforderung zu ermitteln.
--poll-interval <ms>	2000	Abrufintervall. Muss eine positive Zahl sein.
--traces-service <name>	llmopstenant_	Ablaufverfolgungendienstname.
--pretty	aus	Zitierte Trace-Ereignisse. Ohne diese wird jedes Ereignis als einzelne JSON-Zeile ausgegeben.
--login-validity <minutes>	10	Schwellenwert für die Tokenaktualisierung.

Verhalten

• Schreibt eine Überschrift: Streaming traces for job: <key> Polling every Ns...
• Streams jedes Trace-Ereignis über ScreenLogger.progress (stderr).
• Nach Abschluss wird Job <key> completed with state <finalState> (<durationMs>ms) ausgegeben.
• Exitcode: 0 bei result.success, andernfalls 1 .

Beispiele

# Raw JSON lines
uip maestro bpmn job traces b2c3d4e5-… | jq -c 'select(.level=="error")'

# Human-readable
uip maestro bpmn job traces b2c3d4e5-… --pretty

# Slower polling
uip maestro bpmn job traces b2c3d4e5-… --poll-interval 5000

# Scope the trace request to a folder
uip maestro bpmn job traces b2c3d4e5-… --folder-key <folder-key>

Ausgabe: Ablaufverfolgungen werden direkt gestreamt – keine endgültige Data -Nutzlast.

uip Maestro BPMN-Auftragsstatus

Rufen Sie den Status eines Maestro-Auftrags ab. Gibt standardmäßig eine kuratierte 14-Felder-Zusammenfassung zurück; --detailed gibt die vollständige Orchestrator-Antwort zurück.

Argumente

• <job-key> (erforderlich) – Auftragsschlüssel (GUID).

Optionen

Option	Erforderlich	Standard	Beschreibung
--folder-key <key>	ja	–	Ordnerschlüssel (GUID, von process list). Kein Standard – jeder Aufruf muss ihn explizit übergeben.
--detailed	nein	aus	Gibt die vollständige Antwort anstelle der 14-Felder-Zusammenfassung zurück.
--login-validity <minutes>	nein	10	Schwellenwert für die Tokenaktualisierung.

Datenform (Standardzusammenfassung)

{
  "Code": "MaestroJobStatus",
  "Data": {
    "key":             "b2c3d4e5-…",
    "state":           "Successful",
    "runtimeType":     "…",
    "processType":     "ProcessOrchestration",
    "startTime":       "2025-04-15T10:30:00Z",
    "endTime":         "2025-04-15T10:32:11Z",
    "creationTime":    "2025-04-15T10:29:58Z",
    "inputArguments":  "{}",
    "outputArguments": "{}",
    "info":            "",
    "releaseName":     "InvoiceOrchestration",
    "processKey":      "a1b2c3d4-…",
    "robotName":       "…",
    "hostMachineName": "…"
  }
}

Mit --detailed ist Data das vollständige Orchestrator-Auftragsobjekt.

Beispiele

# Start a job, capture the key, stream traces to completion
JOB_KEY=$(uip maestro bpmn process run "InvoiceOrchestration:1.0.0" "<folder-key>" \
           --release-key <release-key> --inputs '{}' --output-filter "jobKey" --output plain)
uip maestro bpmn job traces "$JOB_KEY" --pretty

# Summary once done
uip maestro bpmn job status "$JOB_KEY" --folder-key "<folder-key>"

# Full response
uip maestro bpmn job status "$JOB_KEY" --folder-key "<folder-key>" --detailed

Siehe auch

• uip maestro bpmn process run – Einen Auftrag starten
• uip maestro bpmn instance – Die Instanzansicht derselben Ausführung
• Orchestrator-Aufträge
• Maestro-Übersicht