オンプレミスロボット エージェントの設定

ロボットエージェントのデフォルトの構成はインストール時に設定されます。 ロボットエージェントを使用する前に、構成の設定をレビューし、これが組織に適していることを確認してください。 特に、許可されたファイル アップロードが適切に設定されていることを確認します。

メモ

このトピックの情報は、オンプレミスのロボットエージェントを使用して、ACL ロボットで ACLスクリプトを実行する組織にのみ適用されます。

ACL Robotics Professional Edition を有する個人および組織にはオンプレミスロボット エージェントがありません。 HighBond ロボットとワークフロー ロボットの Python/HCL スクリプトはロボット エージェントを使用しません。

構成設定の指定場所

ロボットエージェントの構成設定は、2 つの場所で指定します。

  • ロボットのエージェント管理画面
  • Windows サーバー上のロボットエージェントのインストールディレクトリにある Agent.exe.config ファイル

メモ

エージェント管理画面の構成設定が Agent.exe.config ファイルの設定に優先します。

エージェント管理画面の構成設定

メモ

エージェント管理画面の構成設定は、マルチエージェントクラスターのすべてのエージェントに適用されます。

  1. Diligent One (www.highbond.com) にサインインします。
  2. Launchpad ホームページの［監査とアナリティクス］の下で、ロボット アプリをクリックします。
  3. ダッシュボードの右上隅で［設定］をクリックします。
  4. 左側のペインで、［エージェント管理］が選択されていることを確認します。
  5. ［構成］から、［許可されたファイル アップロード］に適切なオプションを選択します。

    許可されたファイル アップロードは、クラウドのロボットエージェントからロボットアプリに対し、どの出力結果がアップロードされるかを制御します：

    • 結果ファイルとログのみ

      アナリティクスヘッダーで指定されている場合は、結果ファイル（Excel など）とログがアップロードされます。関連ファイルをロボットの［入力/出力］タブに手動でアップロードすることもできます。

    • 結果テーブル、ファイル、ログ

      アナリティクスヘッダーで指定された場合、Analytics の結果テーブル、結果ファイル（Excel など）、およびログがアップロードされます。関連ファイルをロボットの［入力/出力］タブに手動でアップロードすることもできます。

    • ファイル アップロードは許可されていません

      どの種類のファイルもスクリプトで、またはユーザーが手動でアップロードすることはできません。//RESULT FILE タグまたは //RESULT LOG タグの付いたアナリティクススクリプトは実行されません。

  6. ［構成］の下で、［パスの設定］に該当するディレクトリを指定し、［保存］をクリックします。
    • データ ストレージ

      //DATA タグでアナリティクススクリプトによって出力される、Analytics データテーブルの永続ストレージ用 Windows サーバーまたはネットワークディレクトリ。

      データテーブル のディレクトリが別々になっていることにより、定期的にのみアクセスする大規模ファイルに対し、もっと経済的なコールドストレージロケーションを指定できます。

    • リザルトパス

      //RESULT TABLE タグでアナリティクス スクリプトによって出力される、Analytics の結果テーブル向け Windows サーバーまたはネットワーク ディレクトリ。

    重要

    ［構成］の下で指定したディレクトリにはロボット エージェントまたはすべてのエージェント（マルチエージェント クラスターを使用している場合）からアクセスできる必要があります。指定したディレクトリごとに、エージェントを実行するサービス アカウントに対して読み取り/書き込み/リスト権限を付与する必要があります。詳細については、オンプレミス ロボット エージェントのセキュリティを参照してください。

Agent.exe.config ファイルで設定を構成

構成の設定を更新するには、ロボットエージェントのインストールディレクトリにある Agent.exe.config ファイルを編集し、次にロボットエージェント Windows サービスを再起動します。

構成ファイルのデフォルトロケーション:

C:\Program Files (x86)\ACL Software\Robots Agent\agent\Agent.exe.config.

メモ

変更が有効になるように、ロボット エージェント サービスを再起動する必要があります。

マルチエージェントのインストールでは、Agent.exe.config ファイルを更新し、ロボットエージェントサービスを各Windows サーバーで再起動する必要があります。 各エージェントの構成設定は、お客様の特定のニーズに応じて、同一または異なることができます。

Agent.exe.config における構成プロパティ

キー 値
RuntimeBasePath

基本フォルダ:

  • 一時的なアナリティクスジョブフォルダー

  • //RESULT FILE タグでアナリティクススクリプトによって出力される Analytics 以外の結果ファイル

  • //RESULT LOG タグでアナリティクススクリプトによって出力される Analytics のログファイル

  • 失敗したアナリティクススクリプトによって出力される Analytics のログファイル

デフォルトの基本フォルダーは C:\acl\robots\data\ にあります

ランタイム基本フォルダーが別々になっているため、ソリッドステートドライブ (SSD) のような高速の高パフォーマンスドライブ上で処理するアナリティクスジョブを探すことができます。

ユーザーが構成する基本フォルダーによるアナリティクスジョブフォルダーへの完全なパスの例: E:\acl\robots\runtime\Production\Robot12\Task1\Run29\Temp
DataBasePath

//DATA タグでアナリティクススクリプトによって出力される、Analytics データテーブルの永続ストレージ用基本フォルダー。

デフォルトの基本フォルダーは C:\acl\robots\data\ にあります

Analytics データテーブルの基本フォルダーが別々になっていることにより、定期的にのみアクセスする大規模ファイルに対し、もっと経済的なコールドストレージロケーションを指定できます。

ユーザーが構成する基本フォルダーによるデータファイルフォルダーへの完全なパスの例: D:\acl\robots\data\Production\Robot12\Data

メモ

異なる値が、ロボットの［エージェント管理］画面にあるデータストレージの構成設定に表示された場合は、DataBasePath の値は使用されません。

詳細については、「エージェント管理画面の構成設定」を参照してください。
ResultsBasePath

//RESULT TABLE タグでアナリティクススクリプトによって出力される、Analytics の結果テーブル向け基本フォルダー。

デフォルトの基本フォルダーは C:\acl\robots\data\ にあります

ユーザーが構成する基本フォルダーによる結果フォルダーへの完全なパスの例: C:\acl\robots\results\Production\Robot12\Task1\Run29\Results\Prohibited transactions

メモ

異なる値が、ロボットの［エージェント管理］画面にある結果パスの構成設定に表示された場合は、ResultsBasePath の値は使用されません。

詳細については、「エージェント管理画面の構成設定」を参照してください。
AclSEProfileBase

ロボットデータサービスを使用して、Analytics からロボットエージェントに接続する際のテーブル作業用の基本フォルダー。

デフォルトの基本フォルダーは C:\acl\robots\aclse\ にあります
LogFile

ロボットエージェントのログファイルのファイルパスと名前。

デフォルトのパスと名前は C:\acl\robots\logs\application.log です。
EnginePath

タスクを実行する実行可能ファイルのファイル パス。

デフォルトのファイルパスは、C:\Program Files (x86)\ACL Software\Robots Agent\AclScript.exe です。
KeepJobFolder

ロボットのタスクが失敗した場合は、一時 Analytics ジョブフォルダーを保持するかどうかを指定します。

  • true タスクの失敗後も一時 Analytics ジョブフォルダーは保持されます。

  • false タスクの失敗後に一時 Analytic ジョブフォルダーは削除されます

    デフォルト値は false です。

メモ

ロボットのタスクが正常に実行された場合は、KeepJobFolder 設定による影響はありません。 タスクが正常に実行されると、一時 Analytics ジョブフォルダーは自動的に削除されます。

注意

値を true に設定し、トラブルシューティングの目的でファイルを保持できます。 値を永続的に true と設定したままにすると、サーバーのハードドライブ、すなわちソリッドステートドライブが容量不足になる場合があります。
AllowExecuteCommand

アナリティクス スクリプトで発生したときに、ロボット エージェントが EXECUTE コマンドを処理する方法を指定します。

  • true EXECUTE コマンドが処理されます。

  • false EXECUTE コマンドは処理されず、このコマンドを含むスクリプトは失敗します

    デフォルト値は false です。

    失敗の理由を説明したメッセージがログに書き込まれます。
MaxLogSizeKB

ファイルがアーカイブされ、新しいログファイルが作成される前のロボットエージェントのログファイルの最大サイズ。

デフォルト値は 102400 (100 MB) です。

現在のログファイルは application.log です。アーカイブされたログファイルが現在のログファイルと同じフォルダーに保存され、増分の数値サフィックス：application.0.log、application.1.log などが与えられます。
SkipPathAccessCheck

ロボット エージェントがテーブルやファイルで読み取りまたは書き込みを行う際にアクセスできるフォルダーを制御します。

  • true フォルダーアクセスはチェックされません。 ロボット エージェントが実行するスクリプトは、任意の ACL ロボットのテーブルまたはファイルで読み取りまたは書き込みができます。

  • false フォルダーアクセスはチェックされます。 ロボット エージェントが実行するスクリプトは、スクリプトと同じロボット内のテーブルまたはファイルのみで読み取りまたは書き込みができます。

    デフォルト値は false です。

この値を true に設定し、フォルダーアクセスのチェックをスキップすることで、環境によってはロボット エージェントがスクリプトを実行する際のパフォーマンスが向上する可能性があります。 また、ロボット全体で読み取りまたは書き込みの操作を実行できるようになります。

注意

スクリプトがアクセスできるフォルダーを制限することは、偶発的または意図的なデータアクセス違反を防止するロボットのセキュリティ機能です。 ACL スクリプトが任意の ACL ロボットのテーブルやファイルでの読み取りまたは書き込みを許可しても、セキュリティ上のリスクを引き起こさないと確信できる場合のみ、値を true に設定します。

メモ

The SkipPathAccessCheck setting has no effect on the ability to share and link specific Analytics data tables between robots. For more information, see ACL ロボットでのデータ テーブルの共有と関連付け.

特定のプロキシ サーバーと動作するようにロボット エージェントを構成する

指定したプロキシ サーバーを使用して、ロボット アプリに接続するように、ロボット エージェントを手動で構成できます。 手動構成を実行するには、次の手順を実行する必要があります。

  • Agent.exe.config ファイルに追加のセクションを追加する

  • AgentService.exe.config と Worker.exe.config という 2 つの追加設定ファイルを更新します。

手順

  1. ロボット エージェントがインストールされているサーバーで、ロボット エージェント インストール ディレクトリに移動します。

    インストール ディレクトリのデフォルトの場所：

    C:\Program Files (x86)\ACL Software\Robots Agent\agent\

  2. 以下のテーブルを参照して、\agent サブフォルダ内の構成ファイルを更新してください。

  3. すべてのファイルを保存した後、ロボット エージェント Windows サービスを再起動し、指定したプロキシ サーバーを使用して、ロボット エージェントとロボット アプリの間の通信を開始します。

メモ

異なるプロキシ サーバー設定が可能です。 次の構成情報の例は、お客様の要件と正確には一致しない場合があります。 詳細については、Microsoft テクニカル ドキュメントを参照してください。

ファイル名 構成情報
Agent.exe.config

例で示される場所に <system.net> セクションを追加して、このファイルを更新します。

  • 組織の適切なプロキシ サーバー アドレスとポートを入力します。

  • useDefaultCredentials="true" は、Robots Agent Windows サービスを実行するアカウントの資格情報がプロキシ サーバーにアクセスするために使用されることを指定します。

<?xml version="1.0" encoding="utf-8"?>
<configuration>
    <appSettings>
        <other configuration settings>
    </appSettings>
    <system.net>
        <defaultProxy useDefaultCredentials="true">
            <proxy proxyaddress="プロキシ サーバー アドレス:ポート" bypassonlocal="true" />
        </defaultProxy>
    </system.net>
</configuration>

AgentService.exe.config

Worker.exe.config

これらのファイルの両方で、以下に示す例に基づいて <defaultProxy> セクションを更新します。

  • 組織の適切なプロキシ サーバー アドレスとポートを入力します。

  • useDefaultCredentials="true" は、Robots Agent Windows サービスを実行するアカウントの資格情報がプロキシ サーバーにアクセスするために使用されることを指定します。

<?xml version="1.0" encoding="utf-8"?>
<configuration>
    <system.net>
        <defaultProxy useDefaultCredentials="true">
            <proxy proxyaddress="プロキシ サーバー アドレス:ポート" bypassonlocal="true" />
        </defaultProxy>
    </system.net>
</configuration>