ロボット・エージェントの構成ファイルの更新
すべてのロボット・エージェントには、ロボット・エージェントの名前、シークレット、およびサービス・インスタンスのプロパティを含む構成ファイルが含まれています。 ロボット・エージェントごとに、ロボット・エージェントの名前を入力する必要があります。 また、ロボット・エージェントが機密アプリケーションと通信する場合は、ほかにもいくつかのプロパティを更新する必要があります。
ノート:
rpaAgentEnvDiagnosisスクリプトを実行して、ロボット環境の完全な診断チェックを実行して、現在の環境ステータスを確認できます。 RCCランタイム・パス、ChromeおよびChromeDriverの可用性、WebDriverキャッシュ、プロキシおよびネットワーク接続、SSLアクセスおよびChrome起動機能をヘッドレス・モードで検証します。
- Linux:
[AGENT_HOME]/scripts/rpaAgentEnvDiagnosis.sh - Windows (PowerShell):
[AGENT_HOME]/scripts/rpaAgentEnvDiagnosis.ps1
- 機密アプリケーションからクライアント・シークレットおよびスコープ値を取得します。
これらのステップは、ロボット・エージェントが、組織が作成した機密アプリケーションと通信する場合にのみ必要です。 Oracleが作成したデフォルトの機密アプリケーションを使用している場合は、次のステップに進みます。
- Oracle Cloudコンソールにサインインします。
- ナビゲーション・メニューを開き、「アイデンティティ&セキュリティ」を選択します。 「アイデンティティ」で、「ドメイン」を選択します。
「ドメイン」ページが表示されます。
- まだ選択されていない場合は、機密アプリケーションを含むドメインを保持する「コンパートメント」を選択します。
- 「名前」列で、機密アプリケーションを保持するドメインを選択します。
ドメインの「概要」ページが表示されます。
- アイデンティティ・ドメインの下の左側のメニューで、「統合アプリケーション」を選択します。
- 表の上にある検索ボックスで、機密アプリケーションを検索します。
Oracleが作成した機密アプリケーションの名前は、
RPA_AGENT_DEFAULT_APPで終わり、その説明は「Integration Cloud Services RPAエージェント」です。 - 下にスクロールして、クライアント・シークレットおよびスコープ値を見つけます。
これらの値は機密であるため、コピー後に配置する場所には注意してください。
必要な価値 どこで見つけるか クライアントID 「一般情報」見出しの下にある「クライアントID」エントリを見つけて、値をコピーします。
クライアント・シークレット 「一般情報」見出しの下にある「クライアントの秘密」エントリを見つけます。
「秘密の表示」を選択し、値をコピーします。
有効範囲 「トークン発行」ポリシー見出しの下、「リソース」見出しの下にある表内のエントリを確認します。
複数のエントリが表示された場合は、
consumer::allで終わる値をコピーします。
- ロボット・エージェントをインストールしたコンピュータで、エージェントとその関連ファイルを含むフォルダを開きます。
InstallerProfile.cfgファイルをノート帳などのテキスト・エディタで開きます。ファイルには、次のプロパティが含まれます。
DISPLAY_NAME=プロパティは空白ですが、その他のプロパティには値が指定されています。DISPLAY_NAME= IDCS_CLIENT_ID= IDCS_CLIENT_SECRET= IDCS_SCOPE= IDCS_URL= SERVICE_INSTANCE_ENDPOINT= SERVICE_INSTANCE_ID= POLLING=- 必要に応じて、ファイル内のプロパティを更新します。
プロパティ 入力する値 DISPLAY_NAME=Oracleが作成したデフォルトの機密アプリケーションを使用している場合は、定義する必要がある唯一のプロパティです。
Oracle Integrationにロボット・エージェントの名前を入力します。
値を慎重に選択し、ロボットの命名規則を作成することを検討してください。 たとえば、個人のローカル・コンピュータとロボットをホストする仮想マシン(VM)を区別し、各ロボットのVMを区別することもできます。
IDCS_CLIENT_ID=IDCS_CLIENT_SECRET=IDCS_SCOPE=ロボット・エージェントが組織が作成した機密アプリケーションを使用している場合は、機密アプリケーションを参照するように値を更新します:
IDCS_CLIENT_ID=: ロボット・エージェントが使用する機密アプリケーションのクライアントID。IDCS_CLIENT_SECRET=: ロボット・エージェントが使用する機密アプリケーションのクライアント・シークレット。IDCS_SCOPE=: ロボット・エージェントが使用する機密アプリケーションのスコープ。
このステップの前のステップでは、これらの値の検索方法について説明します。
IDCS_URL=SERVICE_INSTANCE_ENDPOINT=SERVICE_INSTANCE_ID=ロボット・エージェントが組織が作成した機密アプリケーションを使用している場合でも、これらのプロパティの値は更新しないでください。
POLLING=デフォルト値はPOLLING=fixedです。 アダプティブ・ポーリングを有効にするには、値をPOLLING=adaptiveに変更します。
デフォルトでは、ロボット・エージェントは固定ポーリング間隔時間を使用して新しいメッセージをチェックします。
最近のアクティビティに基づいてポーリング頻度を調整する適応ポーリングを使用することもできます。 まだポーリングする時間がない場合、プロセスはただちに終了します。
新しいメッセージを受信したり、エラーが発生した場合は常に、ポーリング間隔時間が最小値にリセットされ、数サイクル保持されます。
新しいメッセージが到着せず、システムが最近のアクティビティーの時間間隔ウィンドウ内に残っている場合、ロボット・エージェントは最小間隔時間でポーリングを続行します。 アクティビティーが長時間続くと、ロボット・エージェントは、定義された最大時間値(デフォルトでは30秒)に達するまで、指数関数的なバックオフを使用してポーリング間隔時間を徐々に増やします。 評価のたびに、現在のバックオフ値に基づいて次のポーリング時間が更新されます。
- ファイルを保存して閉じます。
- 取り付けたほかのロボット・エージェントについて、必要に応じてこれらのステップを繰り返します。