uip maestro flow job

Syntax and options for `uip maestro flow job`, which streams execution traces and fetches detailed status for individual Flow jobs.

uip maestro flow job überprüft einen einzelnen Flow-Auftrag – einen Ausführungsversuch einer Prozessinstanz –, indem seine Ablaufverfolgungen streamen oder seinen detaillierten Status abrufen.

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

Zusammenfassung

uip maestro flow job traces <job-key>
                    [-t, --tenant <name>] [--poll-interval <ms>]
                    [--traces-service <name>] [--pretty]
                    [--login-validity <minutes>]

uip maestro flow job status <job-key>
                    [-t, --tenant <name>] [--folder-key <key>] [--detailed]
                    [--login-validity <minutes>]

uip maestro flow job traces

Streamen Sie Ausführungs-Trace-Ereignisse für einen laufenden oder kürzlich abgeschlossenen Auftrag. Zeilen werden bei ihrem Eintreffen in Std. streamen; Der Endstatus und die Dauer werden ebenfalls gestreamt.

Argumente

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

Optionen

Option	Standard	Beschreibung
-t, --tenant <name>	authentifizierten Mandanten	Mandantenname.
--poll-interval <ms>	2000	Abrufintervall. Muss eine positive Zahl sein.
--traces-service <name>	llmopstenant_	Ablaufverfolgungendienstname (erweitert; nur überschreiben, wenn weitergeleitet).
--pretty	aus	Zitierte Trace-Ereignisse. Ohne diese wird jedes Ereignis als einzelne JSON-Zeile ausgegeben – zugänglich für Piping in jq.
--login-validity <minutes>	10	Schwellenwert für die Tokenaktualisierung.

Verhalten

• Schreibt eine Überschrift in standard: Streaming traces for job: <key> Polling every Ns...
• Streams jedes Trace-Ereignis über ScreenLogger.progress (stderr).
• Nach Abschluss wird Job <key>: <finalState> (<durationMs>ms) ausgegeben.
• Exitcode: 0 wenn der Auftrag erfolgreich war, 1 andernfalls (pro result.success).

Beispiele

# Raw JSON lines — best for piping
uip maestro flow job traces b2c3d4e5-… | jq -c 'select(.level=="error")'

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

# Slower polling for quiet jobs
uip maestro flow job traces b2c3d4e5-… --poll-interval 5000

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

uip maestro flow job status

Rufen Sie den Status eines Flow-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	Standard	Beschreibung
-t, --tenant <name>	authentifizierten Mandanten	Mandantenname.
--folder-key <key>	authentifizierten Ordner	Ordnerschlüssel (GUID).
--detailed	aus	Gibt die vollständige Antwort anstelle der 14-Felder-Zusammenfassung zurück.
--login-validity <minutes>	10	Schwellenwert für die Tokenaktualisierung.

Datenform (Standardzusammenfassung)

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

Mit --detailed ist Data das vollständige Orchestrator-Auftragsobjekt (alle Felder, nicht vereinfacht).

Hinweis:

Die vollständige Form der detaillierten Antwort ist das, was der Orchestrator zurückgibt, und wird nicht streng von der CLI eingegeben. Das Feld vorhanden ist kann zwischen Orchestrator-Versionen variieren – für Skripte, die bestimmte Felder analysieren, abfragen und @uipath/cli in CI anheften.

Beispiele

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

# Get the summary once the job is done
uip maestro flow job status "$JOB_KEY" --folder-key "<folder-key>"

# Full response
uip maestro flow job status "$JOB_KEY" --detailed

Siehe auch

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