uip maestro flow debug

Syntax and options for `uip maestro flow debug`, which uploads a local Flow project to Studio Web and runs a server-side debug session with streamed status updates.

uip maestro flow debug lädt ein lokales Flow-Projekt in Studio Web hoch und führt eine serverseitige Debugging-Sitzung durch, wobei Statusaktualisierungen pro Element zurück an die Konsole streamt und einen endgültigen Status zurückgibt.

Zusammenfassung

uip maestro flow debug <project-path>
               [--folder-id <id>]
               [--poll-interval <ms>]
               [-i, --inputs <json>]
               [--login-validity <minutes>]

Erfordert uip login. Beachten Sie globale Optionen. Austrittscodes folgen dem Standardvertrag.

Argumente

• <project-path> (erforderlich) – Der Pfad zum Flow-Projektverzeichnis. Muss project.uiproj enthalten.

Optionen

Option	Standard	Beschreibung
--folder-id <id>	Automatisch erkennen	Orchestrator-Ordner (OrganizationUnitId). Wenn keine Angabe erfolgt, wird der Ordner der aktuellen Anmeldesitzung verwendet. Als Integer geparst.
--poll-interval <ms>	2000	Abrufintervall in Millisekunden, während darauf gewartet wird, dass Studio Web die Sitzung weiterleitet.
-i, --inputs <json>	–	Geben Sie Argumente als JSON-Zeichenfolge oder @path/to/file.json zum Lesen aus einer Datei ein. Lesen Sie auch aus Standard, wenn keines angegeben ist (über uip maestro flow process run, nicht hier – debug akzeptiert JSON-String oder nur @file ).
--login-validity <minutes>	10	Mindestens Minuten vor dem Tokenablauf zum Auslösen einer automatischen Aktualisierung.

Verhalten

1. Validiert die Anmeldung und ruft die Organisation, den Mandanten, die Basis-URL, den Organisationsnamen und das Authentifizierungstoken aus der Sitzung ab.
2. Lädt das Projekt in Studio Web unter dem Zielordner hoch.
3. Abfragen nach einem endgültigen Status, wobei Statuszeilen pro Element ausgegeben werden wie:

   Status: InProgress (2/5 elements completed)
     v Node_1 [Completed]
     > Node_2 [InProgress]
     - Node_3 [NotStarted]
   

4. Gibt bei Vorfällen während der Ausführung eine Warnzeile aus.
5. 0 wird beendet, wenn finalStatus Completed oder Successful ist; 1 andernfalls.

Beispiele

# Debug a local project, auto-detect folder, default poll interval
uip maestro flow debug ./invoice-flow

# Debug against a specific folder with inline JSON inputs
uip maestro flow debug ./invoice-flow --folder-id 2553016 \
  --inputs '{"amount":100,"customer":"Acme"}'

# Debug with inputs from a file
uip maestro flow debug ./invoice-flow --inputs @inputs.json

# Slower polling for long-running flows
uip maestro flow debug ./invoice-flow --poll-interval 5000

Datenform (--output json)

{
  "Code": "FlowDebug",
  "Data": {
    "jobKey": "b2c3d4e5-0000-0000-0000-000000000001",
    "instanceId": "c3d4e5f6-0000-0000-0000-000000000001",
    "runId": "d4e5f6a7-0000-0000-0000-000000000001",
    "finalStatus": "Completed",
    "solutionId": "e5f6a7b8-0000-0000-0000-000000000001",
    "studioWebUrl": "https://cloud.uipath.com/org/tenant/studio_/debug/e5f6a7b8",
    "elementExecutions": [
      { "elementId": "Node_1", "status": "Completed" }
    ],
    "variables": {}
  }
}

Öffnen Sie studioWebUrl in einem Browser, um die Sitzung interaktiv zu überprüfen.

Siehe auch

• uip maestro flow validate – statische Prüfung vor der Ausführung
• uip maestro flow process run – Führen Sie einen veröffentlichten Prozess aus
• uip maestro flow job traces – Stream-Ablaufverfolgungen für einen bereits gestarteten Auftrag
• Authentication
• Flow-Übersicht