- Überblick
- Erste Schritte
- Konzepte
- Verwenden der UiPath CLI
- Anleitungen
- CI/CD-Rezepte
- Befehlsreferenz
- Überblick
- Exitcodes
- Globale Optionen
- UIP-codierter Agent
- UIP-Coded
- UIP-Kontextgrundlage
- UIP-Dokumentation
- UIP-Funktion
- UIP-Leitplanken
- uip llm-configuration
- uip llm-gateway
- UIP Maestro-Erstellung
- UIP Maestro-Registrierung
- UIP-Modellhub
- Aktivitäten finden
- get-standard-xaml
- Analysieren
- Analyseregeln-Liste
- Erstellen
- Bereinigung
- data-fabric-entities installieren
- data-fabric-entities-Liste
- Dateien differenzieren
- Get-Library-Object-Repository
- Get-Object-Repository
- Init
- Instanzenliste
- Packen
- Pakete überprüfen
- Pakete installieren
- Paketversionen
- Veröffentlichen
- Remote
- restore
- Ausführen, Debuggen & Ausführung enthält
- Einstellungen
- Studio-Start
- Vorlagensuche
- Testdaten-Add-Entität
- Testdaten-Warteschlange hinzufügen
- Testdaten-Hinzufügevariante
- TM
- UIA
- Überprüfen
- Workflow-Beispiele abrufen
- Workflow-Beispiele
- UIP-Aufgaben
- Anhang
- benutzerdefiniertes Feld
- Defects
- Ausführungen
- Exportaufträge
- Migration
- Objektbeschriftung
- Packen
- perf-szenario
- Perf-Szenario-Lastgruppen
- Ausführungsdaten für perf-szenario
- Perf-Szenario-Bericht
- Projekt
- Projektberechtigungen
- Aufforderungen
- Melden
- Anforderungen
- Ergebnis
- Ausführen
- Zeitpläne
- scopes
- Testfallprotokoll
- Testfälle
- Testsätze
- Testschrittprotokoll
- Benutzer
- Warten
- UIP-Ablaufverfolgungen
- Feedback zu UIP-Ablaufverfolgungen
- Migration
- Referenz und Support
UIP Maestro Flow-Debugging
Syntax und Optionen für „uip Maestro Flow Debugging“, der ein lokales Flow-Projekt in Studio Web hochlädt und eine serverseitige Debugging-Sitzung mit gestreamten Statusaktualisierungen ausführt.
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> | --folder-key <key> | --folder-path <path>]
[--poll-interval <ms>] [--timeout <seconds>]
[-i, --inputs <json>]
[--entry-point <id>]
[--attachment <name=path>]...
[--summary]
[--open-in-browser]
[--login-validity <minutes>]
uip maestro flow debug <project-path>
[--folder-id <id> | --folder-key <key> | --folder-path <path>]
[--poll-interval <ms>] [--timeout <seconds>]
[-i, --inputs <json>]
[--entry-point <id>]
[--attachment <name=path>]...
[--summary]
[--open-in-browser]
[--login-validity <minutes>]
Erfordert uip login. Beachten Sie globale Optionen. Austrittscodes folgen dem Standardvertrag.
Argumente
<project-path>(erforderlich) – Der Pfad zum Flow-Projektverzeichnis. Mussproject.uiprojenthalten.
Optionen
| Option | Standard | Beschreibung |
|---|---|---|
--folder-id <id> | Automatisch erkennen | Orchestrator-Ordner (OrganizationUnitId), ein positiver Integer. Sich gegenseitig mit --folder-key/--folder-path ausschließen. Wenn keiner der drei angegeben ist, wird der Ordner in der aktuellen Anmeldesitzung verwendet. |
--folder-key <key> | – | Orchestrator-Ordnerschlüssel (UUID) – von der CLI in die Ordner-ID aufgelöst. Sich gegenseitig mit --folder-id/--folder-path ausschließen. |
--folder-path <path> | – | Orchestrator-Ordnerpfad, z. B. Shared/Sub – wurde von der CLI in die Ordner-ID aufgelöst. Sich gegenseitig mit --folder-id/--folder-key ausschließen. Verwenden Sie uip or folders list, um gültige Schlüssel/Pfade zu erkennen. |
--poll-interval <ms> | 2000 | Abrufintervall in Millisekunden, während darauf gewartet wird, dass Studio Web die Sitzung weiterleitet. |
--timeout <seconds> | Keine Beschränkung | Maximale Sekunden, die bis zum Abschluss der Debugausführung gewartet werden soll. Wenn sie abläuft, schlägt der Befehl mit ErrorCode: timeout und Retry: RetryLater fehl und Data hat instanceId, jobKey, lastStatus und timeoutSeconds. Die Ausführung wird nicht angehalten. Dies hat keine Auswirkungen auf einen Konversationsfluss, der ohne Abruf übergeben wird. |
-i, --inputs <json> | – | Geben Sie Argumente als JSON-Zeichenfolge oder @path/to/file.json zum Lesen aus einer Datei ein. |
--entry-point <id> | Standard-Trigger | Einstiegspunktknoten-ID – eine Triggerknoten-ID aus der .flow -Datei. Standardmäßig wird der markierte Trigger verwendet isDefaultEntryPoint, andernfalls der erste Trigger. Eine ID, die mit keinem Trigger übereinstimmt, schlägt mit Exitcode 3 fehl. |
--attachment <name=path> | – | Laden Sie eine lokale Datei in den Orchestrator hoch und binden Sie sie als Eingabevariable vom Typ Datei. Wiederholbar, z. B --attachment file1=./resume.pdf). Überschreibt denselben Variablennamen, wenn er auch in --inputs vorhanden ist. |
--summary | – | Nur den Ausführungsstatus, die nicht abgeschlossenen Elemente und die deklarierten Ausgaben des Flows anstelle der unformatierten Ausgabe jedes Knotens zurückgeben. Siehe Zusammenfassungsausgabe. |
--open-in-browser | – | Öffnen Sie die URL der Studio Web-Sitzung in einem Browser, sobald sie verfügbar ist. |
--login-validity <minutes> | 10 | Mindestens Minuten vor dem Tokenablauf zum Auslösen einer automatischen Aktualisierung. |
Verhalten
- Validiert die Anmeldung und ruft die Organisation, den Mandanten, die Basis-URL, den Organisationsnamen und das Authentifizierungstoken aus der Sitzung ab.
- Refreshes the solution's resources. If the flow binds a resource that does not exist in Orchestrator, or a connection that does not exist in Resource Catalog, the command fails before anything is uploaded, lists the missing resources, and
Instructionssay how to bind them. A conversational flow is uploaded and handed off anyway. A Data Fabric node that names an entity of the solution with no Entity binding also fails the command before upload (exit code3), withInstructionsnaming the node to configure. - Lädt das Projekt in Studio Web unter dem Zielordner hoch.
- Abfragen nach einem endgültigen Status, wobei Statuszeilen pro Element ausgegeben werden wie:
A status poll that fails with HTTP 403 or a 5xx error is retried twice before the command fails.
Status: InProgress (2/5 elements completed) v Node_1 [Completed] > Node_2 [InProgress] - Node_3 [NotStarted]Status: InProgress (2/5 elements completed) v Node_1 [Completed] > Node_2 [InProgress] - Node_3 [NotStarted] - Gibt bei Vorfällen während der Ausführung eine Warnzeile aus.
0wird beendet, wennfinalStatusCompletedoderSuccessfulist;1andernfalls.
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
# Start from a specific trigger and stop waiting after 10 minutes
uip maestro flow debug ./invoice-flow --entry-point trigger_2 --timeout 600
# Read only the verdict and the declared outputs
uip maestro flow debug ./invoice-flow --summary
# 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
# Start from a specific trigger and stop waiting after 10 minutes
uip maestro flow debug ./invoice-flow --entry-point trigger_2 --timeout 600
# Read only the verdict and the declared outputs
uip maestro flow debug ./invoice-flow --summary
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": {}
}
}
{
"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.
Zusammenfassende Ausgabe
Das vollständige Ergebnis enthält die Ausgabe jedes Knotens neben den deklarierten Ausgaben des Flows, einschließlich ganze HTTP-Antwortkörper und Header. Mit --summary enthält Data nur das, was Sie zur Beurteilung der Ausführung benötigen:
{
"Code": "FlowDebug",
"Data": {
"finalStatus": "Completed",
"instanceId": "c3d4e5f6-0000-0000-0000-000000000001",
"studioWebUrl": "https://cloud.uipath.com/org/tenant/studio_/debug/e5f6a7b8",
"solutionId": "e5f6a7b8-0000-0000-0000-000000000001",
"failed": [],
"outputs": { "weatherVerdict": "warm office today" },
"fullOutputPath": "/path/to/solution/.flow-debug/invoice-flow.json"
}
}
{
"Code": "FlowDebug",
"Data": {
"finalStatus": "Completed",
"instanceId": "c3d4e5f6-0000-0000-0000-000000000001",
"studioWebUrl": "https://cloud.uipath.com/org/tenant/studio_/debug/e5f6a7b8",
"solutionId": "e5f6a7b8-0000-0000-0000-000000000001",
"failed": [],
"outputs": { "weatherVerdict": "warm office today" },
"fullOutputPath": "/path/to/solution/.flow-debug/invoice-flow.json"
}
}
| Feld | Beschreibung |
|---|---|
failed | Elementausführungen, die nicht abgeschlossen wurden, als { elementId, status }. Leer für eine saubere Ausführung. |
outputs | Die deklarierten Ausgabevariablen des Flows (out und inout) nach ID. Abwesend, wenn die Variablen nicht gelesen werden konnten. variablesError gibt dann den Grund an und die Ausgaben sind unbekannt und nicht leer. |
missingOutputs | Deklarierte Ausgaben, die der Datensatz der Ausführung nicht durchgeführt hat. |
incidents | Vorfälle, die während der Ausführung ausgelöst wurden, wenn welche vorhanden sind. |
fullOutputPath | Wo das vollständige Ergebnis geschrieben wurde. |
fullOutputError | Warum das vollständige Ergebnis nicht geschrieben werden konnte. Die Zusammenfassung steht weiterhin. |
Das vollständige Ergebnis – was der Befehl ohne --summary ausgibt – wird in <solution>/.flow-debug/<project>.json geschrieben, wobei <solution> der Ordner ist, der die .uipx -Datei enthält, und <project> der Projektpfad relativ dazu ist. Die Datei wird bei jeder Ausführung ersetzt.
Die Datei enthält Mandantendaten, sodass die CLI auch .flow-debug/.gitignore mit * schreibt und uip solution pack sowie uip solution upload den Ordner überspringen.
Übergabe des Konversations-Triggers
Ein Flow, dessen Einstiegspunkt core.trigger.conversation ist, kann nur von einer Chat-UI gesteuert werden – die CLI kann keine Debugging-Sitzung dafür starten. Stattdessen wird das Projekt in Studio Web hochgeladen und übergeben:
{
"Code": "FlowDebugStudioWebHandoff",
"Data": {
"solutionId": "e5f6a7b8-0000-0000-0000-000000000001",
"studioWebUrl": "https://cloud.uipath.com/org/studio_/designer/a1b2c3d4?solutionId=e5f6a7b8",
"handedOff": true
}
}
{
"Code": "FlowDebugStudioWebHandoff",
"Data": {
"solutionId": "e5f6a7b8-0000-0000-0000-000000000001",
"studioWebUrl": "https://cloud.uipath.com/org/studio_/designer/a1b2c3d4?solutionId=e5f6a7b8",
"handedOff": true
}
}
Es sind keine elementExecutions/finalStatus -Felder vorhanden – es wurde nichts ausgeführt, also gibt es nichts abzurufen. Übergeben Sie --open-in-browser, damit die CLI studioWebUrl automatisch öffnet.
Fehlerhafte Ausführung – Inline-Vorfälle
Eine fehlerhafte Ausführung wird als Result: "Failure" -Umschlag (Exitcode 1) zurückgegeben, wobei die Details zum Vorfall bereits inline auf Data.incidents enthalten sind – es ist kein Folgebefehl erforderlich, um zu sehen, was funktioniert hat:
{
"Code": "FlowDebug",
"Data": {
"jobKey": "b2c3d4e5-0000-0000-0000-000000000001",
"instanceId": "c3d4e5f6-0000-0000-0000-000000000001",
"runId": "d4e5f6a7-0000-0000-0000-000000000001",
"finalStatus": "Faulted",
"incidents": [
{
"incidentId": "inc-1",
"elementId": "Node_3",
"errorCode": "Process.UnhandledException",
"errorMessage": "Object reference not set to an instance of an object."
}
]
}
}
{
"Code": "FlowDebug",
"Data": {
"jobKey": "b2c3d4e5-0000-0000-0000-000000000001",
"instanceId": "c3d4e5f6-0000-0000-0000-000000000001",
"runId": "d4e5f6a7-0000-0000-0000-000000000001",
"finalStatus": "Faulted",
"incidents": [
{
"incidentId": "inc-1",
"elementId": "Node_3",
"errorCode": "Process.UnhandledException",
"errorMessage": "Object reference not set to an instance of an object."
}
]
}
}
On a faulted run, the error Instructions point you at uip maestro flow debug-instances incidents <instanceId> to inspect the raw backend payload. Refer to debug-instances for that lower-level control surface.
Siehe auch
uip maestro flow debug-instances– Schritt-für-Schritt-Steuerung über eine Debug-Sitzung zum Erstellen benutzerdefinierter Toolsuip maestro flow validate– statische Prüfung vor der Ausführunguip maestro flow process run– Führen Sie einen veröffentlichten Prozess ausuip maestro flow jobs traces– Stream-Ablaufverfolgungen für einen bereits gestarteten Auftrag- Authentication
- Flow-Übersicht