UIP-RPA-Ausführung, Debugging & Ausführung enthält

Syntax und Optionen für „uip rpa run“ Verben.

uip rpa run, uip rpa debug * und uip rpa execution cancel führen einen Workflow oder eine codierte Datei über Studio aus und debuggen sie. Alle 17 Verben auf dieser Seite werden in dieselben zwei zugrunde liegenden Tools verteilt, die uip rpa run-file und uip rpa stop-execution als eine breite --command -Aufzählung bereitstellen – dies ist die aktuelle, primäre, auffindbare Form derselben Funktionalität, aufgeteilt in ein Verb pro Verhalten anstelle eines Flags mit 19 Werten. run-file/stop-execution funktionieren weiterhin (sie werden als ausgeblendete Kompatibilitäts-Alias für installierte Fähigkeiten beibehalten), aber diese Seite ist das, was --help tatsächlich anzeigt.

Die Ausführung erfolgt über Studio, sodass diese Befehle nur unter Windows-Ausführungen funktionieren (Studio ist nur für Windows). Wenn Studio nicht bereits ausgeführt wird, wird es automatisch bereitgestellt – führen Sie uip rpa start-studio zuerst aus, wenn Sie möchten, dass die Startkosten in einem eigenen Einrichtungsschritt bezahlt werden.

Zusammenfassung

uip rpa run --file-path <path> [--input-arguments <json>] [--log-level <level>] [--skip-build] [--profiling] [--profiling-mode endOfRun|stream] [--remote]

uip rpa debug start --file-path <path> [same options as run] [--breakpoints <json>]
uip rpa debug start-from-here [--input-arguments <json>] [--input-variables <json>] [--log-level <level>] [--profiling] [--profiling-mode <mode>]
uip rpa debug test-activity [--input-arguments <json>] [--input-variables <json>] [--log-level <level>] [--profiling] [--profiling-mode <mode>]
uip rpa debug break [--wait-timeout-seconds <n>]
uip rpa debug continue [--wait-timeout-seconds <n>]
uip rpa debug resume [--wait-timeout-seconds <n>]
uip rpa debug continue-retry [--wait-timeout-seconds <n>]
uip rpa debug continue-ignore [--wait-timeout-seconds <n>]
uip rpa debug step-into [--wait-timeout-seconds <n>]
uip rpa debug step-over [--wait-timeout-seconds <n>]
uip rpa debug step-out [--wait-timeout-seconds <n>]
uip rpa debug state [--wait-timeout-seconds <n>]
uip rpa debug set-breakpoints --breakpoints <json>
uip rpa debug apply-file-changes --file-changes <json>
uip rpa debug toggle-breakpoint
uip rpa debug restart-from-top

uip rpa execution cancel

Konzepte

• Eines von zwei Backends. Sowohl Studio Desktop als auch das monitorlose Helm-Backend implementieren diese; Mehrere Optionen (--profiling-mode stream, debug set-breakpoints, debug apply-file-changes und Long-Polling --wait-timeout-seconds) gelten nur für Helm und werden ignoriert oder sind auf dem Studio-Backend nicht verfügbar – wie unten pro Verb angegeben.
• --remote (nur auf run/debug start/debug start-from-here/debug test-activity ) wird auf dem konfigurierten Remote-Agenten (ein Orchestrator Unattended Robot) statt lokal ausgeführt – unter uip rpa remote finden Sie weitere Informationen zum Konfigurieren des Ziels.
• Jeder Befehl während der Sitzung wird beim nächsten stabilen Status zurückgegeben. continue/resume/continue-retry/continue-ignore/die Schrittverben/break/state warten alle, bis die Sitzung einen stabilen Status erreicht (Paused, Suspended oder Completed) ) vor der Rückkehr; Wenn innerhalb von --wait-timeout-seconds keine erreicht wird, wird DebugState: "Running" zurückgegeben, anstatt sich aufzuhängen.

uip-rpa-ausführung

Führen Sie einen Workflow oder eine codierte Datei über Studio aus, ohne dass ein Debugger angehängt ist.

Optionen

Long	Wert	Beschreibung
--file-path <path>	string	Erforderlich. Pfad zum .xaml -Workflow oder zur codierten .cs -Datei.
--input-arguments <json>	JSON-Objekt	Eingabeargumente auf Projektebene als einfaches JSON, z. B {"customerId":"ACME-1234"}).
--log-level <level>	Verbose|Trace|Information|Warning|Error|Critical	Mindestprotokollebene im Ausgabestream. Der Standardwert ist Trace.
--skip-build	Markieren	Validierung/Erstellung überspringen, unter der Annahme, dass das Projekt bereits erstellt wurde. Verwenden Sie diese Option für die schnelle erneute Ausführung, wenn sich nichts geändert hat.
--profiling	Markieren	Sammeln Sie Profilerstellungsdaten pro Aktivität, die als Profiling -Feld zurückgegeben werden. Erfordert ein Studio Development-Profil mit dem festgelegten EnableProfiling – wenn nicht verfügbar, wird die Ausführung dennoch abgeschlossen und Profiling wird einfach weggelassen. Standard: false.
--profiling-mode <mode>	endOfRun|stream	Bereitstellungszeit für Profilerstellungsdaten. endOfRun (Standard) gibt die Zusammenfassung einmal nach Abschluss zurück; stream aktiviert auch die Sammlung für sich selbst und leitet zusätzlich jeden Eintrag pro Aktivität live als [Profiling] -Zeile weiter und schreibt die vollständigen Daten in die .uistat -Datei der Ausführung. Nur Helm-Backend; wird bei der Ausführung von Remote ignoriert.
--remote	Markieren	Wird auf dem konfigurierten Remote-Agent anstelle von lokal ausgeführt. Konfigurieren Sie das Ziel zuerst mit uip rpa remote configure. Standard: false.

Beispiel

uip rpa run --file-path ./Main.xaml --input-arguments '{"customerId": "ACME-1234"}'

Datenform (--output json)

{ "Code": "RunResult", "Data": { "DebugState": "Completed", "Result": {} } }

Die genaue Data -Form ist die Nutzlast des zugrunde liegenden Tools – siehe uip rpa run-file für den vollständigen Ergebnisvertrag (beide Verben geben die gleiche Form zurück).

UIP-RPA-Debugging starten

Starten Sie eine Debugging-Sitzung für einen Workflow oder eine codierte Datei. Die gleichen Optionen wie run, plus --breakpoints.

Optionen

Alle Optionen von run sowie:

Long	Wert	Beschreibung
--breakpoints <json>	JSON-Array	Anfänglicher Haltepunkt festgelegt. Jeder Eintrag: workflowFile (erforderlich, Pfad relativ zum Projektstamm), activityIdRef (das sap2010:WorkflowViewState.IdRef der Aktivität aus der XAML-Datei – die stabile Methode zur Lösung des Problems) oder activityId (Laufzeit-ID), plus optionales condition (VB/C#-Ausdruck; wird nur bei „true“ unterbrochen), hitCount (Unterbrechung nur beim n-ten Treffer), enabled (Standard: true). Wiederholbare durch Komma getrennte key=value -Elemente, ein Array-Eintrag pro Vorkommen oder eine JSON-Datei über @breakpoints.json / --breakpoints-file.

Beispiel

uip rpa debug start --file-path ./Main.xaml \
  --breakpoints 'workflowFile=Main.xaml,activityIdRef=Assign_1'

Datenform (--output json)

Die gleiche Form wie run; Eine Sitzung, die einen Haltepunkt erreicht, meldet DebugState: "Paused" mit der Aktivität und lokalen Variablen in DebugDetails.

UIP-RPA-Debugging ab hier

Beginnen Sie mit dem Debuggen von der aktuell fokussierten Aktivität und überspringen Sie alles davor. Kein --file-path – Es arbeitet mit dem, was im geöffneten Projekt fokussiert ist.

Optionen

Long	Wert	Beschreibung
--input-arguments <json>	JSON	Eingaben auf Projektebene. Im Gegensatz zu run/debug start sind hier Werte VB.NET- oder C#-Ausdrücke, keine einfachen JSON-literale.
--input-variables <json>	JSON	Variablenwerte auf Workflow-Ebene zum Seeding-Scope-Status (Ausdrücke, keine Literal).
--log-level <level>	gleiche Aufzählung wie run	Minimale Protokollebene.
--profiling / --profiling-mode <mode>	–	Wie run.

Beispiel

uip rpa debug start-from-here --input-variables '{"greeting": "\"Hello World\""}'

UIP RPA Debug Testaktivität

isolieren und führen Sie die aktuell fokussierte Aktivität aus, indem Sie --input-arguments/--input-variables (Ausdrücke, gleiche Konvention wie start-from-here) verwenden, um den In-Scope-Status zu seeden.

Optionen

Wie debug start-from-here.

Beispiel

uip rpa debug test-activity --input-variables '{"greeting": "\"Hello World\""}'

Unterbrechung des UIP-RPA-Debugging

Hält die Ausführung bei der nächsten ausgeführten Aktivität in der aktiven Sitzung an.

Optionen

Long	Wert	Beschreibung
--wait-timeout-seconds <n>	Nummer	Max. Sekunden, die auf den nächsten stabilen Status gewartet werden muss, bevor DebugState: "Running" zurückgegeben wird. Der Standardwert ist 120. Nur Helm-Backend – Das Studio-Backend wendet seine eigene feste 120er-Grenze an und ignoriert einen expliziten Wert.

UIP RPA Debugging fortfahren/fortsetzen/fortsetzen/Wiederholen/Ignorieren

Ausführung in der aktiven Sitzung fortsetzen. continue wird aus dem Anhalten fortgesetzt; resume wird aus ausgesetzten fortgesetzt; continue-retry setzt die Aktivität fort, die gerade ausgelöst wurde, und versucht sie erneut; continue-ignore wird fortgesetzt und übernimmt die Ausnahme von der Aktivität, die gerade ausgelöst wurde.

Optionen

Identisch mit --wait-timeout-seconds wie debug break.

uip rpa debug-step-into/Step-over/Step-out

Standard-Debugger-Schritte in der aktiven Sitzung. step-out, die ohne aktive Sitzung aufgerufen wird, startet eine vor der ersten Aktivität angehaltene Sitzung.

Optionen

Identisch mit --wait-timeout-seconds wie debug break.

UIP-RPA-Debugging-Status

Melden Sie den Status der aktiven Debugging-Sitzung (Running/Paused/Suspended/Completed/None) ohne Nebenwirkungen.

Optionen

Long	Wert	Beschreibung
--wait-timeout-seconds <n>	Nummer	Lange Abfragen einer laufenden Sitzung auf den nächsten stabilen Status. Standard: 0 (ein sofortiger Test). Nur Helm-Backend – im Studio-Backend ist dies immer ein sofortiger Test.

Haltepunkte für das UIP-RPA-Debugging

Ersetzen Sie den gesamten Haltepunktsatz der aktiven Debugging-Sitzung. Nur Helm-Backend – verwenden Sie auf dem Studio-Backend debug toggle-breakpoint oder übergeben Sie stattdessen Haltepunkte an debug start.

Optionen

Long	Wert	Erforderlich	Beschreibung
--breakpoints <json>	JSON-Array	ja	Die gleiche Form wie die Form debug start von --breakpoints. Ersetzt den gesamten Satz, keine Zusammenführung.

UIP-RPA-Debugging-Apply-File-Changes

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 Workflowdatei und rufen Sie dann die Benennung auf, was sich geändert hat.

Optionen

Long	Wert	Erforderlich	Beschreibung
--file-changes <json>	JSON-Array	ja	Ein Objekt pro bearbeiteter Eigenschaft: workflowFile (erforderlich), activityIdRef sowie der geänderte Eigenschaftsname/-wert. Wiederholbares key=value -Formular oder @changes.json / --file-changes-file.

Datenform (--output json)

{ "Code": "ApplyFileChanges", "Data": { "applied": [], "rejected": [], "debugState": "Paused" } }

applied Bearbeitungen sind live in der Sitzung (z. B continue-retry führt eine fehlerhafte Aktivität mit der Fehlerbehebung erneut aus); rejected -Bearbeitungen (jeweils mit einem Grund) sind strukturierte Änderungen, die einen Neustart der Sitzung erfordern, um wirksam zu werden.

Umschalter-Haltepunkt für UIP-RPA-Debugging

Schalten Sie einen Haltepunkt an der aktuell fokussierten Aktivität (.xaml) oder Zeile (.cs) um. Keine Optionen. XAML-Zyklen aktiviert → deaktiviert → keine; codierte Workflows werden ein-/ausgeschaltet.

Neustart des UIP-RPA-Debugging von oben

Starten Sie die aktive Debugging-Sitzung von Anfang an. Keine Optionen.

UIP-RPA-Ausführung abgebrochen

Abbrechen der aktuell aktiven Ausführung oder Debugging-Sitzung – funktioniert sowohl für run als auch für debug start einheitlich. Keine Optionen.

Beispiel

uip rpa execution cancel

Zugehörig

• uip rpa run-file / uip rpa stop-execution – die ausgeblendeten Legacy-Alias, die diese Verben ersetzt haben; die gleichen zugrunde liegenden Tools.
• uip rpa start-studio – Bezahlen Sie die Studio-Startkosten in einem speziellen Setup-Schritt.
• uip rpa remote – Konfigurieren Sie das Ziel für --remote.
• uip rpa get-errors – Überprüfung der Diagnose nach einer Ausführung.

Siehe auch

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