uip RPA run-file

ワークフローまたはコード化されたファイルを実行またはデバッグuip rpa run-file。同じ動詞が、 --command フラグによって選択される実行ライフサイクル全体 (開始、一時停止、再開、ステップ実行、再開、停止、ブレークポイントの切り替え) をカバーします。これは、スクリプトまたは AI エージェントから Studio のデバッガーへのブリッジとして機能します。

実行は Studio を介して行われるため、このコマンドは Windows ランナーでのみ機能します (Studio は Windows のみです)。Studio がまだ実行されていない場合は、ツールによって自動的に起動します。最初に Studio を実行するuip rpa start-studio任意ですが、専用のセットアップ手順で初期費用を支払いたい場合に便利です。

概要

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

オプション

フラグ	説明
--file-path <string>	必須。実行するファイルへのパス — ワークフロー .xaml またはコード化されたワークフロー .cs 。
--command <verb>	何をすべきか。既定値は [ StartExecutionです。以下の コマンド動詞 を参照してください。
--input-arguments <json>	プロジェクト レベルの入力引数を持つ JSON オブジェクト。すべてのコマンドで使用されます。StartExecution / StartDebuggingの場合、値はプレーンな JSON ({"name":"John","age":30}) です。TestActivity/StartDebuggingFromHereの場合、値は VB.NET または C# 式です。
--input-variables <json>	ワークフロー レベルの変数値を持つ JSON オブジェクト。TestActivity と StartDebuggingFromHereにのみ適用されます。値は言語式であり、リテラル JSON ではありません。
--log-level <level>	出力ストリームに含まれる最小ログ レベル — Verbose、 Trace、 Information、 Warning、 Error、 Critical。既定値は [ Traceです。
--skip-build	検証をスキップし、 StartExecution / StartDebugging用に構築します。プロジェクトがすでにビルドされていると仮定します — プロジェクトが変更されていない場合に迅速に再実行するために使用します。

インストールされているツールのバージョンの完全なオプションリストについては、以下を実行します。

uip rpa run-file --help

コマンド動詞

--command フラグは、非デバッグ実行とデバッガー制御の 2 つの実行モードをカバーします。動詞では大文字と小文字が区別され、Studio に渡されます。

実行

動詞	効果
StartExecution (既定)	--file-path時にワークフローを実行します。デバッガが接続されていません。
StartDebugging	ワークフローのデバッグ セッションを開始します。
Stop	現在の実行またはデバッグ セッションを停止します。
ForceSessionEnded	正常停止がハングした場合は、現在のセッションを強制終了します。

デバッガ制御

動詞	効果
Break	実行を一時停止します。
Continue	一時停止ステートから再開します。
Resume	中断ステートから再開します。
ContinueRetry	再開;例外で一時停止した場合は、現在のアクティビティをリトライします。
ContinueIgnore	再開;例外で一時停止した場合は、例外を飲み込みます。
StepInto / StepOver / StepOut	標準的なデバッガの意味でのステップ。
RestartFromTop	デバッグを最初からやり直します。
ToggleBreakpoint	フォーカスがあるアクティビティ (.xaml) または行 (.cs) でブレークポイントを切り替えます。XAML サイクルの有効化→無効化→なし。コード化されたワークフローのオン/オフが繰り返されます。
TestActivity	フォーカスされたアクティビティを分離して実行します。 --input-variables / --input-arguments でスコープ内の式が提供されます。
StartDebuggingFromHere	フォーカスされたアクティビティからデバッグを開始します。それ以前のアクティビティはすべてスキップします。

例

# 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

関連

• uip rpa start-studio — 専用のセットアップ手順で Studio の起動費用を支払います。
• uip rpa stop-execution — スタンドアロン動詞としての --command Stop に相当します。
• uip rpa get-errors — 実行後に診断を検査します。

参照

• RPA ツールの概要
• グローバル オプション
• 終了コード