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 ist jetzt ein ausgeblendetes Legacy-Alias – es funktioniert immer noch, aber die aktuelle Quelle (tool-names.ts, CLI_DERIVED_COMMANDS) teilt denselben zugrunde liegenden Vorgang in eine auffindbare Art von Verben der obersten Ebene auf: uip rpa run (Ausführung starten), 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 und uip rpa execution cancel (ersetzt stop-execution). Jedes abgeleitete Verb verwendet nur die für es relevanten Flags und nicht ein --command -Enum mit der vollständigen 19-Werte-Liste. Die eigenen Beispiele dieser Seite funktionieren noch heute über den ausgeblendeten Alias – siehe uip rpa run, debug & execution für die aktuelle primäre Oberfläche.

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	Melden Sie den aktuellen Status der Debugging-Sitzung ohne Nebenwirkungen (None wenn keine Sitzung aktiv ist). Immer ein sofortiger Test im Studio-Backend; Auf dem Helm-Backend kann er lange nach dem nächsten stabilen Status abgefragt werden.
SetBreakpoints	Ersetzen Sie den gesamten Haltepunktsatz der aktiven Debugging-Sitzung durch --breakpoints. Nur Helm-Backend – Legen Sie im Studio-Backend Haltepunkte über ToggleBreakpoint fest oder übergeben Sie sie stattdessen an StartDebugging.
ApplyFileChanges	Wenn Sie in einer Debugging-Sitzung angehalten/angehalten sind, stimmen Sie Änderungen an der Aktivitätseigenschaft auf der Festplatte über Hot-Reload mit der laufenden Sitzung ab, sodass sie ohne Neustart aufgenommen werden. Bearbeiten Sie zuerst die Datei und rufen Sie dann die Benennung auf, was sich geändert hat. Gibt { applied, rejected, debugState } anstelle eines Ausführungsergebnisses zurück – strukturierte (nicht Hot-Reload-fähig) Änderungen werden abgelehnt und erfordern einen Sitzungsneustart.

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