UIP-RPA-Ausführungsdatei

Syntax und Optionen für „uip rpa run-file“, das einen Workflow oder eine codierte Datei ausführt oder debuggt, mit Unterstützung für Start, Pause, Schritt und Haltepunkte.

uip rpa run-file führt einen Workflow oder eine codierte Datei aus oder debuggt sie. Dasselbe Verb deckt den gesamten Ausführungslebenszyklus ab – starten, anhalten, fortsetzen, Schritt, neu starten, anhalten, einen Haltepunkt umschalten – ausgewählt durch das Flag --command . Es ist die Brücke von einem Skript oder KI-Agent zum Debugger von Studio.

Die Ausführung erfolgt über Studio, sodass der Befehl nur unter Windows-Ausführungen funktioniert (Studio ist nur für Windows verfügbar). Wenn Studio nicht bereits ausgeführt wird, wird es vom Tool automatisch ausgeführt – das Ausführen uip rpa start-studio zuerst ist optional, aber nützlich, wenn Sie möchten, dass die Startkosten in einem speziellen Setup-Schritt bezahlt werden.

Hinweis:

run-file is now a hidden legacy alias — it still works, but current source (tool-names.ts, CLI_DERIVED_COMMANDS) splits this same underlying operation into a discoverable family of top-level verbs: uip rpa run (start execution), uip rpa debug start / start-from-here / test-activity / break / continue / resume / continue-retry / continue-ignore / step-into / step-over / step-out / state / set-breakpoints / apply-file-changes / toggle-breakpoint / restart-from-top, and uip rpa execution cancel (replaces stop-execution). Each derived verb takes only the flags relevant to it, rather than one --command enum with the full 19-value list. This page's own examples still work today via the hidden alias — see uip rpa run, debug & execution for the current primary surface.

Zusammenfassung

uip rpa run-file --file-path <path> [--command <verb>] [options]

Optionen

Markieren	Beschreibung
--file-path <string>	Erforderlich. Pfad zur auszuführenden Datei – .xaml -Workflow oder .cs -codierter Workflow.
--command <verb>	Was zu tun ist. Die Standardeinstellung ist StartExecution. Siehe Befehlsverben unten.
--input-arguments <json>	JSON-Objekt mit Eingabeargumenten auf Projektebene. Wird von allen Befehlen verwendet. Für StartExecution / StartDebugging sind die Werte Nur-JSON ({"name":"John","age":30}). Für TestActivity / StartDebuggingFromHere sind die Werte VB.NET- oder C#-Ausdrücke.
--input-variables <json>	JSON-Objekt mit Variablenwerten auf Workflow-Ebene. Gilt nur für TestActivity und StartDebuggingFromHere. Werte sind Sprachausdrücke, keine Literal-JSON.
--log-level <level>	Mindestprotokollebene, die im Ausgabestream enthalten ist – Verbose, Trace, Information, Warning, Error, Critical. Standardmäßig auf Trace.
--skip-build	Validierung und Build für StartExecution / StartDebugging überspringen. Gehen Sie davon aus, dass das Projekt bereits erstellt wurde – für eine schnelle erneute Ausführung, wenn sich das Projekt nicht geändert hat.

Für die vollständige Optionsliste zu Ihrer installierten Toolversion führen Sie Folgendes aus:

uip rpa run-file --help

Befehlsverben

Das Flag --command deckt zwei Ausführungsmodi ab: Nicht-Debug-Ausführung und Debugger-Steuerelement. Bei Verben wird die Groß-/Kleinschreibung beachtet. Sie werden an Studio übergeben.

Ausführung

Verb	Auswirkung
StartExecution (Standard)	Führen Sie den Workflow unter --file-path aus. Kein Debugger angehängt.
StartDebugging	Starten Sie eine Debugging-Sitzung für den Workflow.
Stop	Beendet die aktuelle Ausführung oder Debugging-Sitzung.
ForceSessionEnded	Erzwingen Sie das Beenden der aktuellen Sitzung, wenn das ordnungsgemäße Beenden hängen bleibt.

Debugger-Steuerelement

Verb	Auswirkung
Break	Ausführung anhalten.
Continue	Aus einem angehaltenen Status fortsetzen.
Resume	Fortsetzen aus einem angehaltenen Status.
ContinueRetry	Fortsetzen; Wenn die Aktivität aufgrund einer Ausnahme angehalten wurde, wiederholen Sie die aktuelle Aktivität.
ContinueIgnore	Fortsetzen; Wenn bei einer Ausnahme angehalten wird, wird die Ausnahme verschachtelt.
StepInto / StepOver / StepOut	Schritt im Standard-Debugger-Modus.
RestartFromTop	Debuggen von Anfang an neu starten.
ToggleBreakpoint	Schalten Sie einen Haltepunkt an der fokussierten Aktivität (.xaml) oder Zeile (.cs) um. XAML-Zyklen aktiviert → deaktiviert → keine; codierte Workflows werden ein-/ausgeschaltet.
TestActivity	Isoliert und führt die fokussierte Aktivität aus, wobei --input-variables / --input-arguments In-Scope-Ausdrücke bereitstellt.
StartDebuggingFromHere	Beginnen Sie mit dem Debuggen von der fokussierten Aktivität und überspringen Sie alles davor.
GetDebugState	Report the current debug session state with no side effects (None when no session is active). Always an instant probe on the Studio backend; on the Helm backend it can long-poll for the next stable state.
SetBreakpoints	Replace the active debug session's whole breakpoint set with --breakpoints. Helm backend only — on the Studio backend, set breakpoints via ToggleBreakpoint or by passing them to StartDebugging instead.
ApplyFileChanges	While paused/suspended in a debug session, reconcile on-disk activity-property edits into the running session via hot-reload, so it picks them up without a restart. Edit the file first, then call this naming what changed. Returns { applied, rejected, debugState } instead of a run result — structural (non-hot-reloadable) edits are rejected and need a session restart.

Beispiele

# Run a workflow with input arguments
uip rpa run-file \
  --file-path ./Main.xaml \
  --input-arguments '{"customerId": "ACME-1234"}'

# Start a debug session
uip rpa run-file \
  --file-path ./Main.xaml \
  --command StartDebugging

# Toggle a breakpoint at the focused activity, then start debugging
uip rpa run-file --file-path ./Main.xaml --command ToggleBreakpoint
uip rpa run-file --file-path ./Main.xaml --command StartDebugging

# Test a single activity with a custom variable expression (VB.NET project)
uip rpa run-file \
  --file-path ./Main.xaml \
  --command TestActivity \
  --input-variables '{"greeting": "\"Hello World\""}'

# Stop a runaway session
uip rpa run-file --file-path ./Main.xaml --command Stop

Zugehörig

• uip rpa start-studio – Bezahlen Sie die Studio-Startkosten in einem speziellen Setup-Schritt.
• uip rpa stop-execution – Entspricht --command Stop als eigenständiges Verb.
• uip rpa get-errors – Überprüfen Sie die Diagnose nach einer Ausführung.

Siehe auch

• Übersicht über das RPA-Tool
• Globale Optionen
• Exitcodes