設定ファイル

UiPath.Settings ファイルの説明

UiPath.Settings ファイルには、Robot によるプロセスの実行に関する必要な詳細がすべて含まれています。これらの設定は、このファイルと該当するフィールドを直接編集して変更できます。また、Orchestrator の [設定] タブからも変更できます。

注:

これらの設定を変更するためには、ローカル システムでの管理者権限が必要です。また、UiPath Robot サービスを再起動し (管理者権限が必要です)、ロボット トレイを閉じて変更した内容を有効化する必要があります。

UiPath.Settings ファイルは、Robot をユーザー モードでデプロイする場合は %localappdata%\UiPath\ フォルダーに格納され、Robot をサービス モードでデプロイする場合は %programdata%\UiPath\ に格納されます。このファイルは UiPath Robot サービスを初めて起動したときに作成されます。このファイルには、次の各パラメーターが記述されています。

パラメーター	説明
NuGetApiKey	NuGet フィードの API キーです。 Orchestrator に接続されてないとき、ローカル フィードを使用している場合は、API キーは必要ありません。プライベート MyGet フィードを使用する場合は、このパラメーターが必要です。 Orchestrator に接続されているときは、この値は考慮されません。
NuGetServerUrl	プロジェクトがプッシュされる場所、またはプロジェクトが取得される場所です。ファイル システム パスなどのローカル フィード、または NuGet プロトコルを使用する Web フィード (NuGet、MyGet など) です。 Orchestrator に接続されていないときは、既定値は %ProgramData%\UiPath\packages (ユーザー モード) または `% です。個人の MyGet フィードを使用している場合は、事前認証済み V2 URL (基本認証なし) で提供される URL を使用してください。これは、MyGet の無償サービスではないことに、ご注意ください。 Orchestrator に接続されているときは、この値は考慮されません。
ActivitiesFeed	The address where the activities are stored. This field is only populated if you are not connected to Orchestrator. By default, the value is ~/NuGetPackages/Activities. If you connect to Orchestrator, this field is not taken into account. Find out more about the activities feeds on this page, as well as where packages are installed based on the Robot deployment type.
UiPathServerUrl	Orchestrator インスタンスのアドレスです。 Orchestrator に接続されてないときは、このパラメーターは空です。 When connected to Orchestrator, it is automatically filled in with the URL you provided in the Orchestrator Settings window.
TracingLevel	The level at which the Robot should log information. The following options are available: Verbose,Trace,Information,Warning,Error,Critical and Off. また、これは [Orchestrator の設定] ウィンドウの [ログ レベル] ドロップダウン リストから変更することもできます。
LowLevelTracing	Indicates whether or not to log information at a trace level, to help you with troubleshooting crashes and errors. By default, this parameter is set to false. To start low level tracing, set the value of this parameter to true. You can also change this value from the command line.
SecureLicenseKey	Orchestrator への接続に使用するマシン キーです。このキーは DPAPI を使って UiPath.setting ファイルで暗号化されます。この値は、[Orchestrator の設定] ウィンドウで入力することも変更することもできます。Orchestrator に接続されていない場合、このパラメーターは空になります。
LoginToConsole	Enables the Robot to connect to the console session of the machine where it is installed. Additionally, it indicates if you can connect multiple Robots to Orchestrator using multiple users (High-Density Robots) or not. By default, the value is true. To enable High-Density Robots, set the value to false.
ResolutionWidth	マシンの表示解像度の幅。このオプションは既定で 0 に設定されていて、検出した解像度の幅が自動的に取得され、使用されます。ワークステーションが対応している範囲であれば、カスタム値を使用できます。
ResolutionHeight	マシンの表示解像度の高さ。このオプションは既定で 0 に設定されていて、検出した解像度の高さが自動的に取得され、使用されます。ワークステーションが対応している範囲であれば、カスタム値を使用できます。
ResolutionDepth	マシンの表示解像度の階調。このオプションは既定で 0 に設定されていて、検出した解像度の階調が自動的に取得され、使用されます。ワークステーションが対応している範囲であれば、カスタム値を使用できます。
FontSmoothing	テキスト認識を拡張します。True に設定されている場合は、RDP 接続でFont Smoothing オプションがオンになります。つまり、ターゲット マシンの ClearType がオンになります。
ConnectionString	Orchestrator で生成される文字列です。マシン名やマシン キーの入力なしで、ロボットを Orchestrator に登録できるようになります。
DisableWorkflowExecution	有効化すると、コマンド ラインからプロセスを実行することができなくなります。既定では、この機能は非表示であり、無効化されています。
webProxySettings	Parameter used to configure Proxy Settings for the Robot. Find out more in the Redirecting Robots Through a Proxy document.

UiPath Robot のシステム変数

システム環境変数を使用して、さらに細かくカスタムの動作を設定できます。

重要:

いずれかのシステム変数を変更したら、Robot サービスを再起動してください。

次のリストは、最も一般的なユース ケースをまとめたものです。

システム変数	使用状況	例
UIPATH_SESSION_TIMEOUT	対話型セッションを作成する場合の既定の 60 秒のタイムアウトを変更します。 ロボットが対話するシステムのパフォーマンスと読み込み時間に基づいてロボットの動作を適応させるには、この値を調整します。	UIPATH_SESSION_TIMEOUT=75
UIPATH_PIP_SESSION_TIMEOUT	ロボット セッションでプロセスを開始する場合の既定の 180 秒のタイムアウトを変更します。	UIPATH_PIP_SESSION_TIMEOUT=60
UIPATH_LANGUAGE	ロボットが動作する言語を設定します。 言語は次の順序で決定されます。 UIPATH_LANGUAGE 件の値 マシンの環境変数 現在のスレッドの UI の言語設定 UiPath の既定の言語 (英語)	UIPATH_LANGUAGE=French
UIPATH_HEADLESS_WITH_USER	Orchestrator に設定済みの特定のユーザーの資格情報を使用します。	UIPATH_HEADLESS_WITH_USER=True
UIPATH_PRE_LOADED_EXECUTOR	既定では、ロボットの起動時に、事前読み込み済みの Executor が起動します。 この動作を変更し、最初のプロセスの実行時にのみ事前読み込み済みの Executor を起動するには、この変数を None に設定します。	UIPATH_PRE_LOADED_EXECUTOR=None
UIPATH_DISABLE_PRE_LOADED_EXECUTOR	事前読み込みされた実行機能を無効化します。	UIPATH_DISABLED_PRE_LOADED_EXECUTOR=True
UIPATH_ROBOTJS_ALLOWLIST	Robot JS SDK と Robot Executor 間の接続を確立するときに、ロボットの同意ダイアログを自動的に受け入れます。 この変数には、複数のカスタム アプリケーションの URL をセミコロンで区切って指定できます。ポート番号が標準のポート (80 または 443) と異なる場合は、URL にポート番号を含めてください。	UIPATH_ROBOTJS_ALLOWLIST=cloud.uipath.com;mydomain.com;
UIPATH_DNS_MACHINENAME	RDP セッションの作成時にローカルホストに DNS ホスト名を使用することを許可します。RDP に Kerberos 認証を使用する環境で無人ジョブを実行するには、この値を True に設定します。	UIPATH_DNS_MACHINENAME=True
UIPATH_PROXY_USE_DEFAULT_CREDENTIALS	ロボットが Windows 資格情報を認証に使用するプロキシ構成を処理できるようにします。	UIPATH_PROXY_USE_DEFAULT_CREDENTIALS=True
NUGET_FALLBACK_PACKAGES	フォールバック パッケージ フォルダーへのパスを設定します。複数のパスを区切るには、セミコロンを使用します。 この変数がない場合、ロボットはフォールバック パッケージ フォルダーを Nuget.config ファイル内で検索します。
NUGET_SCRATCH	同じマシン上の複数のユーザー モードの Robot が、パッケージを保存するローカル パスを共有できるようにします。 この値は、NuGet のインストール フォルダーとは異なるパスにする必要があります。また、これは NuGet の一時フォルダーとして機能します。 設定する一時フォルダーは、NUGET_SCRATCH 変数でのみ使用してください。	NUGET_SCRATCH=C:\NuGetTempFolder
UIPATH_PRESERVE_CREDENTIALS_CASE	ログ記録用の資格情報の、元の大文字と小文字 (ドメイン\ユーザー名) を保持します。	UIPATH_PRESERVE_CREDENTIALS_CASE = True

Robot のコンポーネントを再起動する

保存していない作業が失われることがないよう、再起動する前に必ず進行中の作業を保存してください。

• Robot サービス
  • サービス モードのインストール
    1. [タスク マネージャー] > [サービス] を開きます。
    2. UiPathRobotSvc サービスを探します。
    3. サービスを右クリックし、[再起動] を選択します。
  • ユーザー モードのインストール - Assistant を終了して再起動します。または、以下の手順を実行します。
    1. [タスク マネージャー] > [詳細] を開きます。
    2. UiPath.Service.UserHost.exe プロセスを選択します。
    3. [タスクの終了] を選択します。
• 更新サービス
  1. [タスク マネージャー] > [サービス] を開きます。
  2. UiPath.UpdateService.Agent サービスを探します。
  3. サービスを右クリックし、[再起動] を選択します。
• UiPath RobotJS ServiceHost
  1. [タスク マネージャー] > [サービス] を開きます。
  2. UiPath.RobotJS.ServiceHost サービスを探します。
  3. サービスを右クリックし、[再起動] を選択します。
• UiPath Assistant
  1. Assistant で、[設定] を選択して、[終了] を選択します。
  2. Assistant を再起動します。
• ウィジェット - Assistant を再起動します。または、以下の手順を実行します。
  1. タスクバーの Assistant のアイコンを右クリックします。
  2. [ウィジェットを再読み込み] を選択します。