在本地部署机器人代理上配置

机器人代理的默认配置在安装期间设定。在使用机器人代理之前,请检查配置设置并确保它们适合您的组织。特别要确保适当设置了已允许文件上传

说明

本主题中的信息仅适用于使用本地部署机器人代理运行 ACL 机器人中的 ACL 脚本的组织。

订阅 ACL Robotics 专业版本的个人和组织没有本地部署机器人代理。HighBond 机器人和工作流机器人中运行的 Python/HCL 脚本不使用机器人代理。

在哪里指定配置设置

可以在两个位置指定机器人代理的配置设置:

  • 机器人应用程序中的代理管理屏幕
  • Windows 服务器上机器人代理安装目录中的 Agent.exe.config 文件

说明

代理管理屏幕中的配置设置优先于 Agent.exe.config 文件中的设置。

在代理管理屏幕中配置设置

说明

代理管理屏幕中的配置设置,会应用于多代理聚类中的所有代理。

  1. 登录到 Diligent One (www.highbond.com)。
  2. 从启动面板主页的审计与分析下,选择机器人应用程序。
  3. 在仪表盘的右上角,单击设置
  4. 在左侧窗格中,确保选择了代理管理
  5. 配置下,在已允许文件上传中选择适当选项。

    已允许文件上传控制哪些输出结果被从机器人代理上传到云端机器人应用程序:

    • 仅限结果文件和日志

      如果在分析标头中指定,则上传结果文件(如 Excel)和日志。也可以手动将相关文件上载到机器人应用程序输入/输出选项卡。

    • 结果表、文件和日志

      如果在分析标头中指定,则上传 Analytics 结果表、结果文件(如 Excel)和日志。也可以手动将相关文件上载到机器人应用程序输入/输出选项卡。

    • 不允许文件上传

      任何类型的文件都不能通过脚本或用户手动上传。不会运行带 //RESULT FILE//RESULT LOG 标记的 Analytic 脚本。

  6. 配置下,为路径配置指定适当的目录,然后单击保存
    • 数据存储

      Windows 服务器或网络目录,用于永久存储由带 //DATA 标记的分析脚本输出的 Analytics 数据表。

      单独的数据表目录,可以为仅定期访问的大型文件指定更经济的冷存储位置。

    • 结果路径

      分析脚本输出的 Analytics 结果表的带有 //RESULT TABLE 标签的 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 日志文件

  • 由失败的分析脚本输出的分析日志文件

默认的基本文件夹是 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

指定在机器人任务失败后是否保留临时分析作业文件夹。

  • true 任务失败后保留临时分析作业文件夹

  • false 任务失败后删除临时分析作业文件夹

    默认值为 false

说明

机器人任务成功后,KeepJobFolder 设置将会失效。成功执行任务后,会自动删除临时分析作业文件夹。

注意

可以将该值设置为true以保留文件进行故障排除。将该值永久设置为true可能会导致服务器硬盘或固态驱动器空间不足。

AllowExecuteCommand

指定当在分析脚本中遇到 EXECUTE 命令时,机器人代理如何处理此命令:

  • true EXECUTE 命令被处理

  • false 不处理 EXECUTE 命令,并且包含该命令的脚本会失败

    默认值为 false

    将向日志中写入一条消息,解释失败的原因。

MaxLogSizeKB

存档文件并创建新日志文件之前机器人代理日志文件的最大大小。

默认值为 102400 (100 MB)。

当前日志文件是 application.log。存档的日志文件与当前日志文件保存在同一个文件夹中,并赋予递增的数字后缀:application.0.logapplication.1.log,依此类推。

SkipPathAccessCheck

控制在读取/写入表或文件时,机器人代理可以访问哪些文件夹。

  • true 不检查文件夹访问权限。机器人代理运行的脚本可以读取/写入任意 ACL 机器人中的表或文件。

  • true 检查文件夹访问权限。机器人代理运行的脚本仅可读取/写入与脚本处于相同机器人中的表或文件。

    默认值为 false

将值设置为 true 然后跳过文件夹权限检查,这可能会提高机器人代理在某些环境中运行脚本时的性能。您还能跨机器人执行读取或写入操作。

注意

限制脚本的文件夹访问权限是机器人的一项安全功能,可防止意外或故意访问数据的违规行为。只有在您确定让 ACL 脚本能够读取/写入任意 ACL 机器人中的表或文件不会造成安全风险的情况下,才将值设置为 true

说明

SkipPathAccessCheck 设置不影响在机器人之间共享和链接特定 Analytics 数据表的功能。有关详细信息,请参阅共享和链接 ACL 机器人中的数据表

配置机器人代理以使用特定的代理服务器

您可以手动配置机器人代理,以使用您指定的代理服务器连接到机器人应用程序。要执行该手动配置,您需要执行以下操作:

  • Agent.exe.config 文件添加一个附加的节

  • 更新两个附加的配置文件:AgentService.exe.configWorker.exe.config

步骤

  1. 在安装了机器人代理的服务器上,转到机器人代理安装目录。

    该安装目录的默认位置为:

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

  2. 请参考下表,更新 \agent 子文件夹中的配置文件。

  3. 保存所有文件后,重新启动机器人代理 Windows 服务,以使用指定的代理服务器开始机器人代理和机器人应用程序之间的通信。

说明

可以使用不同的代理服务器配置设置。下面的配置信息示例可能与您的要求不完全匹配。有关详细信息,请参阅 Microsoft 技术文档:

文件名 配置信息
Agent.exe.config

通过在该示例中显示的位置添加<system.net>节更新此文件。

  • 为您的组织替换适当的代理服务器地址和端口。

  • useDefaultCredentials="true" 指定使用运行机器人代理 Windows 服务的帐户的凭据来访问代理服务器。

<?xml version="1.0" encoding="utf-8"?>
<configuration>
    <appSettings>
        <other configuration settings>
    </appSettings>
    <system.net>
        <defaultProxy useDefaultCredentials="true">
            <proxy proxyaddress="YOUR PROXY SERVER ADDRESS:YOUR PORT" bypassonlocal="true" />
        </defaultProxy>
    </system.net>
</configuration>

AgentService.exe.config

Worker.exe.config

在这两个文件中,根据下方显示的示例更新 <defaultProxy> 部分。

  • 为您的组织替换适当的代理服务器地址和端口。

  • useDefaultCredentials="true" 指定使用运行机器人代理 Windows 服务的帐户的凭据来访问代理服务器。

<?xml version="1.0" encoding="utf-8"?>
<configuration>
    <system.net>
        <defaultProxy useDefaultCredentials="true">
            <proxy proxyaddress="YOUR PROXY SERVER ADDRESS:YOUR PORT" bypassonlocal="true" />
        </defaultProxy>
    </system.net>
</configuration>