- Robot JavaScript SDK
Robot JavaScript SDK の前提条件と設定 (UiPath JavaScript アドオンのインストールやオリジンへのアクセス権の付与など)。
このページでは、ブラウザーとロボットの同意アクセスの設定、SDK のインストール、JavaScript アドオンの設定など、カスタム Web アプリケーションで Robot JavaScript SDK を使用するための前提条件と設定について説明します。
前提条件
オートメーション プロジェクトで Robot JavaScript SDK を使用するには、次の前提条件を満たす必要があります。
- バージョン 2021.10 以降の Studio と Robot がインストールされている
- ロボット端末に UiPath JavaScript アドオンがインストールされている
アクセスを許可する
UiPath Robot JavaScript アドオンを実行する場合、カスタム アプリケーションまたは Web ページをロボットに接続するためのアクセス権を付与する必要があります。アクセスは 2 段階のダイアログによって行われます。RobotJS を実行するには、両方の手順を確認する必要があります。どちらのダイアログも、以下のセクションで説明する自動化をサポートしています。
ブラウザーへのアクセス ダイアログ
1 つ目のダイアログでは、ブラウザーにより UiPath Assistant を開く権限が要求されます。
ブラウザーのアクセス ダイアログを自動的に受け入れる
uipath-web://*値は、ブラウザーの設定に信頼された URL として追加され、このダイアログによって自動化されます。uipath-web://*は、UiPath Robot Web プロトコル ハンドラーを指します。
使用するブラウザーによっては、異なる設定を行う必要があります。たとえば、Google Chrome を使用している場合は Google Chrome のドキュメントの [URLAllowList(https://chromeenterprise.google/intl/ja_jp/policies/#URLAllowlist)] に記載されている手順を実施します。
ロボットの同意ダイアログ
ロボットの同意ダイアログでは、Robot JavaScript SDK と Robot Executor 間の接続を許可します。
ロボットの同意ダイアログを自動的に受け入れる
UIPATH_ROBOTJS_ALLOWLIST システム環境変数は、ロボットの同意ダイアログを自動的に受け入れます。
変数値には、カスタム アプリケーションまたは Web ページの URL をセミコロンで区切って含める必要があります。URL にポート番号を含める必要があるのは、標準ポートを使用しない場合のみです (80 または 443)。
Robot JavaScript SDK
この SDK には、カスタム アプリケーションまたは Web ページに含めることができるすべての必要なメソッドとプロパティが含まれます。ダウンロードの手順は以下のとおりです。
NPM
npm パッケージは、TypeScript のバインディングで利用できます。このパッケージをプロジェクトに含めるには、以下の手順を実行します。
-
プロジェクト ディレクトリのルートで次のコマンドを実行します。
npm install --save @uipath/robotnpm install --save @uipath/robot
CDN
CDN の場合:
-
閉じる
</body>タグの前に、次のスクリプトタグを追加します。<body> ... ... <script href="//download.uipath.com/js/1.3.2/UiPathRobot.js"></script> </body><body> ... ... <script href="//download.uipath.com/js/1.3.2/UiPathRobot.js"></script> </body>
直接ダウンロード
Robot JavaScript SDK を ダイレクト ダウンロードでダウンロードします。
アドオンの設定
アドオンの設定を行うには、以下の手順を実行します。
- インストール フォルダーで
uipath.configファイルを開きます。 - [
ListenerPort] パラメーターと [TokenExpiryInDays] パラメーターを [<robotJsSettings>] セクションに追加します。既定では、このセクションにはキーは含まれません。
<robotJsSettings>
<add key="ListenerPort" value="2323" />
<add key="TokenExpiryInDays" value="30" />
</robotJsSettings>
<robotJsSettings>
<add key="ListenerPort" value="2323" />
<add key="TokenExpiryInDays" value="30" />
</robotJsSettings>
| 属性 | 説明 |
|---|---|
ListenerPort | この UiPath.RobotJS.ServiceHost.exe は、構成されたポートで HttpListener を開始し、そのシステム上のアクティブなユーザー セッションからの他のローカル リスナーに関する情報を含めます。ポートの値は、[ SDK の設定] で設定した値と一致する必要があります。 |
TokenExpiryInDays | 新しいドメインからの要求には、Web アプリケーションから UiPath Robots のアクセスを許可するためのユーザーの同意が必要です。この同意は、この設定で指定されている日数の間有効です。 |