uip rpa start-studio

uip rpa start-studio Studio インスタンスを起動し、準備完了が報告されるまで待機します。Studio を動かすほとんどの uip rpa 動詞はオンデマンドでインスタンスを起動するため、 start-studio 明示的にインスタンスを呼び出すことはほとんどありません。スクリプトの先頭で Studio をウォームアップする場合 (そのため、最初の下流の動詞で起動コストが発生しないようにするため)、Studio のインストールにアクセスできることを確認する場合に使用します。

このコマンドは短絡セーフです。解決済みのプロジェクト ディレクトリに Studio インスタンスがすでに一致している場合は、そのインスタンスが再利用されます。それ以外の場合は、新しい接続が開始されます。

注:

Studio は Windows 専用です

Studio は Windows でのみ動作します。したがって、uip rpa start-studio は Windows ランナーでのみ機能します。パッケージャーの動詞 (pack、 build、 analyze、 restore) は Studio を必要とせず、.NET ランタイム要件を満たす任意の OS で実行されます。

概要

uip rpa start-studio [options]

この動詞は引数もコマンドごとのオプションも受け取りません。解像度の動作は、すべての uip rpa 動詞で共有される親レベルのオプションによって制御されます。

親オプション	説明
--project-dir <path>	実行中の Studio インスタンスとの照合に使用されるプロジェクト ディレクトリです。デフォルトは、現在の作業ディレクトリです。
--studio-dir <path>	検出で Studio が自動的に見つからない場合の、Studio のインストールへのパスです。
--timeout <seconds>	Studio インスタンスの準備が整うまで待機する最大時間。既定値は [ 300] です。
--verbose	IPC リゾルバからの詳細ログを有効にします。

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

uip rpa start-studio --help
uip rpa --help

動作

解像度ウォーターフォール:

1. プロジェクト ディレクトリで一致 — 実行中の Studio インスタンスで、要求された --project-dir が開かれていると、そのインスタンスが再利用されます。
2. アイドル状態のインスタンス — Studio インスタンスが実行されていても、プロジェクトが開いていない場合は、そのインスタンス内でプロジェクトが開きます。
3. 新しい Studio を開始する — 準備が完了していない場合は、新しい Studio プロセスが開始され、準備ができたと報告されるまでポーリングされます。

成功すると、このコマンドは解決されたインスタンスのプロセス ID を出力します。コマンドの終了後もインスタンスは実行され続けます — uip rpa start-studio Studio プロセスのライフサイクルを所有しません。Studio を閉じるかどうかはユーザーに委ねられています。

例

# Bring up Studio for the current directory
uip rpa start-studio

# Bring up Studio for a specific project
uip rpa start-studio --project-dir ./MyProject

# Verbose, so you can see where the resolver is looking
uip rpa start-studio --verbose

ウォームアップパターン

他の動詞は Studio をオンデマンドで自動解決しますが、セッションの最初の動詞で起動コストが支払われます。そのコストをセットアップステップにシフトするには:

uip rpa start-studio --project-dir ./MyProject

# downstream verbs reuse the warmed-up instance
uip rpa get-errors
uip rpa find-activities --query "Click"

関連

• uip rpa list-instances — リゾルバーから見える実行中の Studio インスタンスを一覧表示します ( --helpでは非表示で、直接呼び出すことができます)。

参照

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