UIP-RPA-Ausführungsdatei

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.

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.

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