UiPath.Settings ファイルの説明

UiPath.Settings ファイルのパラメーターです。ロボット プロセスの実行を制御します。ファイルを直接編集するか、Orchestrator を使用して設定できます。

UiPath.Settings ファイルの説明

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

注:

Local system and administrator rights are required to modify these settings. Restart the UiPath Robot service (admin rights are required) and close the Robot tray for changes to take effect.

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

パラメーター	説明
NuGetApiKey	The API key of the NuGet feed. When not connected to Orchestrator, if you are using a local feed, it does not require an API key. If you use a private MyGet feed, this parameter is required. When connected to Orchestrator, this value is not taken into account.
NuGetServerUrl	The location where projects are pushed and from where they are retrieved. This can be either a local feed, such as a file system path, or a web feed that uses the NuGet protocol (NuGet, MyGet etc.). When not connected to Orchestrator, the default value is %ProgramData%\UiPath\packages (user mode) or `%. If you use a private MyGet feed, use the URL provided under Your pre-authenticated V2 URL (no basic authentication). This is not a free service from MyGet. When connected to Orchestrator, this value is not taken into account.
ActivitiesFeed	アクティビティが保存されるアドレスです。このフィールドは、Orchestrator に接続されていない場合にのみ設定されます。既定では、この値は ~/NuGetPackages/Activities です。Orchestrator に接続する場合、このフィールドは考慮されません。アクティビティ フィードの詳細と、ロボットのデプロイの種類に応じたパッケージのインストール先については、それぞれこちらのページとこちらのページをご覧ください。
UiPathServerUrl	Orchestrator インスタンスのアドレスです。Orchestrator に接続されてないときは、このパラメーターは空です。Orchestrator に接続されているときは、[Orchestrator の設定] ウィンドウで指定した URL が自動的に入力されます。
TracingLevel	Robot がログを記録するレベルです。使用できるオプションは、Verbose、Trace、Information、Warning、Error、Critical、Off です。 また、これは [Orchestrator の設定] ウィンドウの [ログ レベル] ドロップダウン リストから変更することもできます。
LowLevelTracing	トレース レベルで情報を記録すべきかどうかを示し、クラッシュやエラーなどの問題を解決するのに役立ちます。既定では、このパラメーターは false に設定されています。低レベル トレーシングを開始するには、このパラメーターの値を true に設定します。この値はコマンド ラインから変更することもできます。
SecureLicenseKey	Orchestrator への接続に使用するマシン キーです。このキーは DPAPI を使って UiPath.setting ファイルで暗号化されます。この値は、[Orchestrator の設定] ウィンドウで入力することも変更することもできます。Orchestrator に接続されていない場合、このパラメーターは空になります。
LoginToConsole	Robot がインストールされているマシンのコンソール セッションに接続できるようにします。また、複数ユーザーを使って複数のロボットを Orchestrator に接続できるか (高密度ロボット) どうかを指定します。既定では、この値は true です。高密度ロボットを有効化するには、値を false に設定します。
ResolutionWidth	マシンの表示解像度の幅。このオプションは既定で 0 に設定されていて、検出した解像度の幅が自動的に取得され、使用されます。ワークステーションが対応している範囲であれば、カスタム値を使用できます。
ResolutionHeight	マシンの表示解像度の高さ。このオプションは既定で 0 に設定されていて、検出した解像度の高さが自動的に取得され、使用されます。ワークステーションが対応している範囲であれば、カスタム値を使用できます。
ResolutionDepth	マシンの表示解像度の階調。このオプションは既定で 0 に設定されていて、検出した解像度の階調が自動的に取得され、使用されます。ワークステーションが対応している範囲であれば、カスタム値を使用できます。
FontSmoothing	テキスト認識を拡張します。True に設定されている場合は、RDP 接続でFont Smoothing オプションがオンになります。つまり、ターゲット マシンの ClearType がオンになります。
ConnectionString	Orchestrator で生成される文字列です。マシン名やマシン キーの入力なしで、ロボットを Orchestrator に登録できるようになります。
DisableWorkflowExecution	有効化すると、コマンド ラインからプロセスを実行することができなくなります。既定では、この機能は非表示であり、無効化されています。
webProxySettings	Robot のプロキシ設定を構成するためのパラメーター。詳しくは「Robot をプロキシ サーバー経由でリダイレクトする」というドキュメントをご覧ください。

UiPath Robot のシステム変数

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

重要:

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

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

• UIPATH_SESSION_TIMEOUT - 対話型セッションを作成するための既定の 60 秒のタイムアウトを変更します。ロボットが対話するシステムのパフォーマンスと読み込み時間に基づいてロボットの動作を適応させるには、この値を調整します。

  例：

  UIPATH_SESSION_TIMEOUT=75
  

• UIPATH_PIP_SESSION_TIMEOUT - ロボット セッションでプロセスを開始する場合の既定の 180 秒のタイムアウトを変更します。

  例：

  UIPATH_PIP_SESSION_TIMEOUT=60
  

• UIPATH_LANGUAGE - ロボットが動作する言語を設定します。優先順位は次のとおりです。

  1. UIPATH_LANGUAGE 件の値
  2. マシンの環境変数
  3. 現在のスレッドの UI の言語設定
  4. 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_PRE_LOADED_EXECUTOR=None
  

• 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
  

• 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
  

• UIPATH_SESSION_BEHAVIOR - ジョブ完了後のセッション復元動作を設定します。次のオプションが利用できます。

  • TryReuseAndRestoreSession — 既定のオプションです。ジョブの完了後に、セッションを再利用して以前のステートへの復元を試みます。再利用する初期セッションがない場合は、復元時にログオフします。
  • ForceNew — 以前のセッション ステートに関係なく、まったく新しいセッションを作成します。復元時には常にログオフします。
  • LeaveSessionActive — 初期セッション ステートの復元を防止します。
  • LeaveSessionDisconnected — 復元時に常にセッションを切断します。

  例：

  UIPATH_SESSION_BEHAVIOR = LeaveSessionDisconnected
  

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

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

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