設定ファイル

構成ファイルを編集した場合、変更を有効にするには Robot の関連コンポーネントを再起動する必要があります。次の表に、さまざまなコンポーネントを再起動する方法を、Robot のインストール モードに基づいてまとめています。

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

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

uipath.config

UiPath.config ファイルには、Robot に不可欠な構成パラメーターが含まれています。管理者は、構成ファイルのパラメーターのリストを編集して、ロボットの動作をカスタマイズできます。

注:

環境ごとに固有の注意が必要な場合があるため、UiPath では、ロボットの現在の環境が開発、ステージング、運用のいずれであっても、その環境に基づいて異なる構成を適用できます。このファイルを編集するときは常に注意してください。設定が間違っていると、アプリケーションに問題が発生することがあります。

ファイルにアクセスする

Robot をインストールすると、UiPath.config ファイルが作成されます。

ログにアクセスするには、C:\Program Files\UiPath\Studio\UiPath.config に移動します。

カスタマイズ可能な設定

UiPath.config ファイルは、以下のパラメーターで構成されます。

構成セクション	データ型 + パラメーター名	説明	既定 (Default)	例
connectionSettings	文字列 DefaultServiceUrl	ロボットが Orchestrator に接続するために使用する既定のアドレスを設定します。	NA	string DefaultServiceUrl = "https://cloud.uipath.com"
	bool AutoSignIn	Assistant の自動サインイン機能を有効化します。	偽	bool AutoSignIn = true.
	bool EnforceDefaultServiceUrl	DefaultServiceUrl で指定したアドレスをすべてのユーザーに適用します。	偽	bool EnforceDefaultServiceUrl = true.
communicationSettings	byte MaxMessageSizeInMegabytes	システムが送受信できるメッセージの最大サイズを MB 単位で設定します。 大きすぎるメッセージを処理することによる過負荷やプロセスのクラッシュを防止するために使用します。	10 MB	byte MaxMessageSizeInMegabytes = 10;
	TimeSpan InstallPackageTimeout	パッケージのインストールの制限時間を設定します。 パッケージのインストールに定義された時間よりも長い時間がかかる場合、インストールは中止されます。 TimeSpan として表されます。	20 分	TimeSpan InstallPackageTimeout = TimeSpan.FromMinutes(20);
	TimeSpan RequestTimeout	システムが通信の応答を待機する時間を定義します。 設定された時間内に応答を受信しない場合、システムは停止して次の処理に進みます。 これにより、システムのハングアップを防止します。 TimeSpan として表されます。	40 秒	TimeSpan RequestTimeout = TimeSpan.FromSeconds(40);
packageSettings	文字列 PackagesInstallationFolder	パッケージをインストールする既定のディレクトリを設定します。	C:\UiPath\Packages
	bool SkipHttpConfigurationSources	HTTP 上に設定されているパッケージ ソース (NuGet フィードなど) をシステムが無視できるようにします。 つまり、システムはこれらのソースからパッケージを取得しません。このため、ソースが信頼できない場合や安全でない場合に便利です。	偽
	bool DisableSecureXaml	安全でない可能性があるワークフローの実行をロボットに許可します。	偽
	bool DirectDownload	ユーザーへの確認なしにパッケージを直接ダウンロードすることを許可します。	偽
	bool PackageSaveWithoutNupkg	パッケージを .nupkg ファイルなしで保存することを許可します。 ダウンロード サイズを減らすのに役立ちます。	偽
analyticsSettings	bool Telemetry.Enabled	UiPath が分析のために使用状況データを収集および送信することを許可します。	偽
webProxySettings	文字列 ScriptAddress	プロキシを使用する方法とタイミングを決定するスクリプトのアドレスを設定します。
	文字列 ProxyAddress	プロキシ サーバーのアドレス (IP またはドメイン名) を設定します。
	文字列 BypassList	プロキシ サーバーをバイパスしてインターネットに直接接続するアドレスのリストを含みます。
	bool BypassLocalAddresses	プロキシ サーバーをバイパスして、ローカル アドレスへの直接接続を許可します。	偽
	文字列 UserName	プロキシ サーバー認証用の資格情報のユーザー名を設定します。
	文字列 Password	プロキシ サーバー認証用のユーザー名に関連付けられたパスワードを設定します。
	文字列 Domain	認証に必要な、プロキシ サーバーが存在するドメインを設定します。
robotCacheSettings	TimeSpan SessionCacheDuration	特定のセッションのデータをキャッシュに保持して破棄するまでの期間を定義します。 変数の値や操作の詳細などのデータを、再作成または再取得するのではなく再利用する場合に便利です。 TimeSpan として表されます。	30 秒	TimeSpan SessionCacheDuration = TimeSpan.FromSeconds(30);
	TimeSpan GetResourceUrlCacheDuration	API や Web ページなどのリソースの URL をキャッシュに保存する期間を定義します。 ロボットが特定のリソースに何度もアクセスする必要がある場合にパフォーマンスを最適化するのに役立ちます。 TimeSpan として表されます。	1 時間	TimeSpan GetResourceUrlCacheDuration = TimeSpan.FromHours(1);
robotJsSettings	int ListenerPort	Robot.js が受信接続をリッスンするポート番号を設定します。 これにより、Robot サービスは、ローカル サーバーまたはリモート サーバーで実行されている Web アプリケーションと対話できます。	2323	int ListenerPort = 2323;
	int TokenExpiryInDays	Robot サービスによって生成される認証トークンの有効期間を日数で設定します。 Robot サービスは、他のソフトウェア コンポーネントやサービスと対話する際にこれらのトークンを使用して自身を認証します。	30 日	int TokenExpiryInDays = 30;
	文字列 AllowUrlList	Robot サービスがアクセスできる URL のリストを設定します。 Robot サービスが承認されたサービスとのみ対話するようにするのに役立ちます。		string AllowUrlList = "https://cloud.uipath.com";

重要:

• 変更を加える前に、必ず元の UiPath.config ファイルのバックアップを作成してください。問題が発生した場合に元の設定を復元するのに役立ちます。
• UiPath.config ファイルに加えた更新内容を適用するには、UiPath サービスまたはシステムを再起動します。
• UiPath.config ファイルでのローカルの設定は、Orchestrator での設定よりも優先されます。
• UiPath.config ファイル内の機密データを暗号化してセキュリティを強化できます。

UiPath Robot のシステム変数

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

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

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

システム変数	使用状況	例
UIPATH_SESSION_TIMEOUT	対話型セッションを作成する場合の既定の 60 秒のタイムアウトを変更します。 ロボットが対話するシステムのパフォーマンスと読み込み時間に基づいてロボットの動作を適応させるには、この値を調整します。	UIPATH_SESSION_TIMEOUT=75
UIPATH_SESSION_LEGACY
UIPATH_PIP_SESSION_TIMEOUT	ロボット セッションでプロセスを開始する場合の既定の 180 秒のタイムアウトを変更します。	UIPATH_PIP_SESSION_TIMEOUT=60
UIPATH_USER_SERVICE_PATH	ユーザー サービスのインストール パスを設定します。	UIPATH_USER_SERVICE_PATH=C://installation/folder/UiPath.Service.UserHost.exe
UIPATH_LANGUAGE	ロボットが動作する言語を設定します。 言語は次の順序で決定されます。 UIPATH_LANGUAGE 件の値 マシンの環境変数 現在のスレッドの UI の言語設定 UiPath の既定の言語 (英語)	UIPATH_LANGUAGE=French
UIPATH_DISABLE_MARKETPLACE_WIDGET	Assistant で必要です。Marketplace ウィジェットを無効化します。	// On Windows OS UIPATH_DISABLE_MARKETPLACE_WIDGET=True //On Mac OS, run the following command: launchctl setenv UIPATH_DISABLE_MARKETPLACE_WIDGET TRUE
UIPATH_HEADLESS_WITH_USER	Orchestrator に設定済みの特定のユーザーの資格情報を使用します。	UIPATH_HEADLESS_WITH_USER=True
UIPATH_PRE_LOADED_EXECUTOR	既定では、ロボットの起動時に、事前読み込み済みの Executor が起動します。この変数を使用して既定の動作を上書きすると、事前読み込み済みの Executor は最初のプロセスの実行時に起動するようになります。 以下のオプションを利用できます。 Windows レガシ エクスペリエンス ポータブル 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 をセミコロンで区切って指定できます。非標準のポートを使用する場合は、必ずポート番号を含めてください。
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