設定フィールド

Robot JavaScript SDK の [設定] プロパティを使用すると、ブラウザー アドオンの設定をカスタマイズし、制御を向上させることができます。

class Settings {
  portNumber: number;
  pollTimeInterval: number;
  disableTelemetry: boolean;
  appOrigin: string;
}

属性	説明
portNumber	Allows you to configure custom ports on which the back-end services run on. The default port number is 2323. Please note that this is only available for Enerprise installations.
pollTimeInterval	Robot JavaScript SDK が Web ページからのプロセスの実行を追跡する時間をミリ秒単位で指定できます。既定値は、250 ミリ秒です。この値は、Web ブラウザーからのポーリング間隔を決定します。
disableTelemetry	テレメトリ フラグを無効化できます。既定値は false です。
appOrigin	SDK を使用するアプリケーションを指定できます。既定値は、window.location.origin クラスから取得されます。

const robot = UiPathRobot.init();
robot.settings.portNumber = 1234;
robot.settings.pollTimeInterval = 1000;
robot.settings.disableTelemetry = true;
robot.settings.appOrigin = 'MyApp';

SDK の設定

class Settings {
  portNumber: number;
  pollTimeInterval: number;
  disableTelemetry: boolean;
  appOrigin: string;
}

属性	説明
portNumber	バックエンド サービスを実行するカスタム ポートを構成できます。既定のポート番号は 2323 です。これは、Enterprise Edition のインストールでのみ利用可能です。
pollTimeInterval	Allows you to specify the time in milliseconds in which the Robot JavaScript SDK keeps track of a process execution from a web page. The default value is 250 milliseconds. This value determines the polling frequency from the web browser
disableTelemetry	テレメトリ フラグを無効化できます。既定値は false です。
appOrigin	SDK を使用するアプリケーションを指定できます。既定値は、window.location.origin クラスから取得されます。

const robot = UiPathRobot.init();
robot.settings.portNumber = 1234;
robot.settings.pollTimeInterval = 1000;
robot.settings.disableTelemetry = true;
robot.settings.appOrigin = 'MyApp';

アドオンの設定

アドオン設定を変更するには、Robot アドオン フォルダー内に RobotJSAddOn.config という名前の構成ファイルを作成する必要があります。以下のようになります。

C:\ProgramData\UiPath\Robot JS Add-on\RobotJSAddOn.config

構成ファイルには、以下が含まれている必要があります。

<?xml version="1.0" encoding="utf-8"?>
<appSettings>
    <add key="ListenerPort" value="2323" />
    <add key="PortDiscoveryServiceEndpoint" value="http://127.0.0.1:2323" />
    <add key="TokenExpiryInDays" value="30" />
    <add key="AuthenticationProtocol" value="Custom" />
</appSettings>

属性	説明
ListenerPort	UiPath.RobotJS.ServiceHost.exe は設定されたポートで HttpListener を開始します。そのシステム上でアクティブなユーザー セッションからの他のローカル リスナーに関する情報を含みます。ここでのポート値は、SDK の設定で設定した値と一致する必要がある点にご注意ください。
PortDiscoveryServiceEndpoint	UiPath.RobotJS.UserHost.exe はランダムなポートで HttpListener を開始し、UiPath.RobotJS.ServiceHost.exe プロセスからリスナーが実行されている場合は登録します。ユーザー セッションで実行されているローカル リスナーは、UiPath.RobotJS.ServiceHost.exe からの HttpListener が実行されているポートとエンドポイントを認識する必要があります。
TokenExpiryInDays	Any request coming from a new domain needs to have consent from the user to allow access of UiPath® Robots from a web application. These consents are valid for the said number of days mentioned in this setting.
AuthenticationProtocol	HttpListener インスタンスは、インスタンス間の通信に暗号化されたユーザー情報を使用します。既定では、ロボットの要求に関するユーザー情報の決定には UiPath のカスタム暗号化が使用されます。この値を ““ に変更すると、Windows が提供する NTLM 認証を使用します。NTLM 認証を使用するように設定を変更した場合は、要求と一緒に Windows ユーザー名が送信されるよう、ブラウザーの設定も変更する必要があります。これは、次の手順で行います。 Internet Explorer > [ツール] > [インターネット オプション] > [セキュリティ] タブ > [ローカル イントラネット] または [信頼済みサイト] にアクセスします。 [サイト] ボタンをクリックして、サイト オプションを編集します。 [詳細設定] をクリックしてゾーンの URL のリストを編集します。 URL のリストに http://127.0.0.1 を追加し、NTLM 認証を有効化します。

既定のオーバーレイ

It is possible to customize the consent screen displayed when a request is raised from a new domain. There are currently two screens that are delivered with the Robot JavaScript SDK:

同意プロンプト

The consent-prompt overlay is displayed when a request to access the UiPath^® Assistant is raised from a new domain.

コンポーネントの不足

missing-components オーバーレイは、必要なアドオンがローカル マシンに存在しない場合に表示されます。

オーバーレイ メッセージは以下に示すように設定できます。

// Consent code will be written to the console instead of showing default overlay
// Error logged to console when required components are missing insread of showing
// default error overlay
const robot = UiPathRobot.init();
robot.on('consent-prompt', function(consentCode){ console.log(consentCode) });
robot.on('missing-components', function(){ console.log('Missing components') });