UIP Maestro Flow-Auftrag

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

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 list  [--folder-key <key>] [--state <state>] [--process-name <name>]
                    [-l, --limit <n>] [--offset <n>] [--sort-by <field>] [--all-fields]
                    [--login-validity <minutes>]

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

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

UIP Maestro Flow-Auftragsliste

Listen Sie Flow-Aufträge in einem Ordner auf.

Optionen

Option	Standard	Beschreibung
--folder-key <key>	authentifizierten Ordner	Ordnerschlüssel (GUID).
--state <state>	–	Nach Auftragsstatus filtern: Pending, Running, Successful, Faulted, Stopped, Stopping, Suspended, Resumed, Terminating.
--process-name <name>	–	Filtern nach Flow-Prozessname (enthält Übereinstimmung).
-l, --limit <n>	50	Anzahl der zurückzugebenden Elemente.
--offset <n>	0	Anzahl der zu überspringenden Elemente.
--sort-by <field>	Serverstandard	Sortieren Sie die Ergebnisse nach Feld, z. B 'Id desc').
--all-fields	aus	Geben Sie alle Felder aus der API-Antwort anstelle einer kuratierten Zusammenfassung zurück.
--login-validity <minutes>	10	Schwellenwert für die Tokenaktualisierung.

Beispiel

uip maestro flow job list --folder-key c3d4e5f6-… --limit 2

Datenform (Standardzusammenfassung)

{
  "Code": "FlowJobList",
  "Data": [
    {
      "key": "b2c3d4e5-…",
      "state": "Successful",
      "processName": "InvoiceFlow",
      "source": "Manual",
      "startTime": "2025-04-15T10:30:00Z",
      "endTime": "2025-04-15T10:32:11Z"
    }
  ]
}

Mit --all-fields hat jedes Element das vollständige Orchestrator-Auftragsobjekt anstelle dieser kuratierten Zusammenfassung.

Traces von UIP Maestro Flow-Aufträgen

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
--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 Auftragsstatus

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
--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