uip rpa run-file

「uip rpa run-file」の構文とオプション - ワークフローまたはコード化されたファイルを実行またはデバッグします (開始、一時停止、ステップ、ブレークポイントがサポートされています)。

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

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

注:

run-file は 非表示のレガシ エイリアス になりました。引き続き機能しますが、現在のソース (tool-names.ts、 CLI_DERIVED_COMMANDS) は、この同じ基になる操作を、検出可能な最上位の動詞ファミリに分割します。 uip rpa run (実行の開始)、 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、および uip rpa execution cancel ( stop-executionを置換) に分割されます。各派生動詞は、19 値のリストを含む 1 つの --command 列挙型ではなく、関連するフラグのみを取ります。このページ独自の例は、非表示のエイリアスを介して今日でも機能します (現在のプライマリ サーフェスの uip rpa run, debug & execution を参照してください)。

概要

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	フォーカスされたアクティビティからデバッグを開始します。それ以前のアクティビティはすべてスキップします。
GetDebugState	副作用のない現在のデバッグ セッションの状態を報告します (アクティブなセッションがない場合はNone )。Studio のバックエンドで常に即座に調査できます。Helm バックエンドでは、次の安定した状態をロングポーリングできます。
SetBreakpoints	アクティブなデバッグ セッションのブレークポイント セット全体を に置き換え --breakpoints。Helm バックエンドのみ — Studio のバックエンドでは、代わりに ToggleBreakpoint を使用するか、ブレークポイントを StartDebugging に渡してブレークポイントを設定します。
ApplyFileChanges	デバッグ セッションで一時停止/中断されているときに、ホット リロードによってディスク上のアクティビティ プロパティの編集内容を実行中のセッションに調整し、再起動せずに編集内容を取得するようにします。最初に ファイルを編集してから、変更された名前を付けます。実行結果の代わりに { applied, rejected, debugState } を返す — 構造的な (ホット リロード不可) 編集は拒否されるため、セッションを再実行する必要があります。

例

# 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 ツールの概要
• グローバル オプション
• 終了コード