UiPath.Settings ファイルの説明

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	アクティビティが保存されるアドレスです。このフィールドは、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. サービスを右クリックし、[再起動] を選択します。
  • ユーザー モードのインストール - 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. [ウィジェットを再読み込み] を選択します。