将 ACL 脚本提交(上传)到机器人应用程序

可采用两种不同方法,将 ACL 脚本提交或上传到机器人应用程序:

  • 将脚本从 Analytics 提交到机器人应用程序

  • 使用机器人应用程序上传 ACL 脚本

    说明

    使用机器人应用程序上传 ACL 脚本这种方法,与使用机器人应用程序将 ACL 脚本首次上传到新建的机器人有所不同。有关详细信息,请参阅向机器人添加脚本自动化

两种方法的比较

提交脚本的每一种方法所得到的最终结果是相同的:在目标机器人中创建新的脚本版本。但是,这两种方法之间存在以下差异:

  • 语法验证 从 Analytics 提交脚本时,会执行自动语法验证。使用机器人上传脚本时,不会进行任何验证。

  • 项目-机器人关联 包含脚本和目标机器人的 Analytics 项目在从 Analytics 提交脚本时,会自动将脚本与目标机器人关联起来。使用机器人上传脚本时,则不会进行任何关联。

语法验证以及项目-机器人关联都是实用的功能,因此,推荐的方法是从 Analytics 将脚本提交到机器人。建立项目-机器人关联之后,您可以将从机器人内上传作为一项便利功能,而对于次要脚本更新,绕过语法验证不算什么问题。

提交脚本的工作原理

当您将脚本提交至机器人应用程序时,该 Analytics 项目中的所有脚本都被提交,并且一起成为关联的 ACL 机器人中的“一个版本”。您不能有选择地提交项目中的脚本。有关详细信息,请参阅Analytics 和机器人应用程序中的 ACL 脚本开发工作流

要向机器人应用程序提交脚本,您必须被赋予机器人应用程序中的适当角色。有关详细信息,请参阅机器人应用程序权限

将脚本从 Analytics 提交到机器人应用程序

当您从 Analytics 向机器人应用程序中的 ACL 机器人提交或上传脚本时,存在多种可能性。

了解各种可能性的最轻松方式是将 Analytics 项目和 ACL 机器人视为两个各自容纳可被相互关联的脚本的容器。在将脚本相互关联后,您可以将脚本的连续版本从该项目提交至机器人。

操作 提交后的结果
将脚本提交至新的 ACL 机器人

将创建一个包含已提交脚本的版本 1 的新的 ACL 机器人。

将脚本提交至现有 ACL 机器人

现有 ACL 机器人包含已提交的脚本,其版本号取决于机器人是否已包含脚本。

将编辑后的脚本提交至 ACL 机器人

新版本的脚本被提交至与项目关联的 ACL 机器人。

将脚本提交至其他 ACL 机器人

脚本被提交至新创建的 ACL 机器人或现有的 ACL 机器人。

该项目和之前机器人之间的关联被删除。

将脚本提交至新的 ACL 机器人

将脚本首次提交至机器人应用程序以创建一个包含所提交脚本的新的 ACL 机器人。

  1. From your computer, open the Analytics project that contains the scripts.

  2. 从 Analytics 主菜单中选择文件 > 提交脚本

    If an error message appears, there may be a problem with the analytic header, or the script syntax, in one or more of the scripts in the project.

    For more information, see Analytics 和机器人应用程序中的 ACL 脚本开发工作流.

  3. 如果需要,则请在选择目标对话框中,双击适当的 Diligent One 实例。

    将会显示机器人集合,其中包含现有机器人的列表。

  4. 新建机器人字段中键入一个机器人名称,然后单击创建

    将创建该机器人,并且自动生成一个机器人 ID。

    包含这些脚本的 Analytics 项目和新机器人现在会被关联,以便后续的提交不需要您手动定位机器人。

    说明

    请勿在机器人名称中任何位置使用下列字符:"$"、"€"。

  5. 输入一个简短的提交消息以描述所提交的脚本,然后单击确定

    脚本的版本 1 被提交至新创建的机器人。此时,脚本仅在开发模式下存在。

  6. 可选。在提交脚本成功对话框中,单击其中一个链接以检查新创建的机器人或已提交的脚本。
  7. 单击确定以退出该对话框。

将脚本提交至现有 ACL 机器人

将脚本提交至已存在的 ACL 机器人,以填充机器人。现有机器人可能已经包含脚本,也可能是空的。

说明

如果该项目尚未与机器人相关联,请使用此方法。如果该项目已经与机器人相关联,请参阅将脚本提交至其他 ACL 机器人

  1. From your computer, open the Analytics project that contains the scripts.

  2. 从 Analytics 主菜单中选择文件 > 提交脚本

    If an error message appears, there may be a problem with the analytic header, or the script syntax, in one or more of the scripts in the project.

    For more information, see Analytics 和机器人应用程序中的 ACL 脚本开发工作流.

  3. 如果需要,则请在选择目标对话框中,双击适当的 Diligent One 实例。

    将会显示机器人集合,其中包含现有机器人的列表。

  4. 在机器人列表中,选择要提交脚本的机器人,然后单击确定

    包含这些脚本的 Analytics 项目和现有机器人现在会被关联,以便后续的提交不需要您手动定位机器人。

  5. 输入一个简短的提交消息以描述所提交的脚本,然后单击确定

    脚本被提交至现有机器人。脚本的版本号取决于机器人是否已包含脚本,或其先前是否为空。

    此时,脚本仅在开发模式下存在。

  6. 可选。在提交脚本成功对话框中,单击其中一个链接以检查现有机器人或已提交的脚本。
  7. 单击确定以退出该对话框。

将编辑后的脚本提交至 ACL 机器人

提交已编辑的脚本,从而在关联的机器人中创建新版本的 ACL 脚本。

在提交脚本之前,存在两种编辑脚本的方法。您可以编辑关联项目中的脚本,或者也可以将脚本从机器人下载至新的 Analytics 项目,并编辑新项目中的脚本。

说明

最好在开始任何编辑工作之前,从机器人下载脚本。与本地存储的脚本不同的是,您可以确保所下载的脚本未被更改。

在单个脚本编写会话期间,如果您是处理脚本的唯一人员,则通常可以直接从项目提交脚本的迭代版本,而无需在迭代之间下载。

从机器人下载脚本

如果您想要处理包含在机器人应用程序中的脚本而不是已经在您的本地计算机上的脚本,请执行此部分步骤。

  1. 从启动面板主页 (www.highbond.com) 中,选择机器人应用程序以将其打开。

    如果您已经进入 Diligent One,可以使用左侧导航菜单切换到机器人应用程序。

  2. 从机器人应用程序中的仪表盘中选择 ACL 机器人
  3. 导航到包含您要下载的脚本的机器人,然后选择该机器人以将其打开。
  4. 单击机器人应用程序右上角的生产开发按钮,选择要使用的模式。

    有关详细信息,请参阅机器人应用程序中的开发模式和生产模式

  5. 执行以下操作之一:
    • 下载当前已激活的脚本版本

      在生产模式中,单击下载机器人

    • 下载最新的开发脚本版本

      在开发模式中,单击下载机器人

    • 下载较早的脚本版本

      1. 在开发模式中,选择脚本版本选项卡。

      2. 脚本版本列表中,选择要下载的版本。

      3. 版本详情面板中,单击下载

    选定的脚本版本会下载到计算机上的默认“下载”文件夹中。脚本被包含在新创建的 Analytics 项目中,其名称与您下载的机器人的名称相同。该项目和该机器人被自动关联。

    说明

    机器人现在与两个项目相关联: 刚通过下载创建的项目,以及之前用于提交脚本的项目。一个机器人可与多个项目关联。

  6. 可选。如果要在另一个文件夹中使用包含所下载脚本的项目,则请将其移动。

在 Analytics 中编辑这些脚本并提交它们

  1. From your computer, open the Analytics project that contains the scripts.

  2. 编辑脚本并保存更改。

    说明

    您还可以在必要时添加或删除脚本。

  3. 从 Analytics 主菜单中选择文件 > 提交脚本

    If an error message appears, there may be a problem with the analytic header, or the script syntax, in one or more of the scripts in the project.

    For more information, see Analytics 和机器人应用程序中的 ACL 脚本开发工作流.

  4. 输入描述已提交脚本变化的简短的提交消息,然后单击确定

    脚本将被提交至关联的机器人,并将其保存为新版本。机器人中现有的脚本版本不会被覆盖。

    如果出现错误消息,声称找不到关联的机器人,请核实该机器人存在于机器人应用程序中,并且您的角色允许提交脚本。

  5. 可选。在提交脚本成功对话框中,单击其中一个链接以检查机器人或新版本的脚本。
  6. 单击确定以退出该对话框。

将脚本提交至其他 ACL 机器人

将脚本提交至其他 ACL 机器人,以将一个版本的脚本添加至机器人,并更改与项目关联的机器人。可以是已编辑的脚本或未编辑的脚本。

将脚本提交至不同的机器人时存在两种可能性:

  • 将脚本提交至新机器人
  • 将脚本提交至现有机器人
  1. From your computer, open the Analytics project that contains the scripts.

  2. 从 Analytics 主菜单中选择文件 > 脚本提交为

    If an error message appears, there may be a problem with the analytic header, or the script syntax, in one or more of the scripts in the project.

    For more information, see Analytics 和机器人应用程序中的 ACL 脚本开发工作流.

  3. 如果需要,请在选择目标对话框中导航到适当的 Diligent One 实例。

    将会显示机器人集合,其中包含现有机器人的列表。

  4. 执行以下操作之一:
    • 向新机器人提交脚本新机器人字段中输入机器人名称,然后单击创建

      将创建该机器人,并且自动生成一个机器人 ID。现已关联包含脚本的 Analytics 项目和新机器人。

      说明

      请勿在机器人名称中任何位置使用下列字符:"$"、"€"。

    • 向现有机器人提交脚本在机器人列表中,选择要提交脚本的机器人,然后单击确定

      现已关联包含脚本的 Analytics 项目和现有机器人。

    该项目和之前机器人之间的关联被删除。

  5. 输入一个简短的提交消息以描述所提交的脚本,然后单击确定

    脚本被提交至新创建的或现有的机器人。脚本的版本号取决于机器人是否已包含脚本,或其先前是否为空。

    此时,脚本仅在开发模式下存在。

  6. 可选。在提交脚本成功对话框中,单击其中一个链接以检查新创建的或现有的机器人或已提交的脚本。
  7. 单击确定以退出该对话框。

使用机器人应用程序上传 ACL 脚本

您可以使用机器人应用程序上传 ACL 脚本,无需打开 Analytics。这种上传脚本的方法会绕过语法验证,因此,请仅在上传之前已经过脚本验证的次要脚本更新时采用这种方法。

说明

这种方法不适用于将 ACL 脚本首次上传到新建的机器人。

  1. 从启动面板主页 (www.highbond.com) 中,选择机器人应用程序以将其打开。

    如果您已经进入 Diligent One,可以使用左侧导航菜单切换到机器人应用程序。

  2. 从机器人应用程序中的仪表盘中选择 ACL 机器人

  3. 单击 ACL 机器人将其打开。

  4. 单击机器人应用程序右上角的开发按钮,即可切换到开发模式。

  5. 脚本版本选项卡上,单击上传

  6. 在显示的对话框中执行以下操作:

    1. 单击从计算机中选择,然后导航到包含脚本的 Analytics 项目。

    2. 选择该项目,然后单击打开

      还可以将 Analytics 项目拖放到上传脚本区域。

  7. 键入一个提交消息,然后单击上传并提交

    脚本会成功上传到机器人,并在脚本版本列表顶部创建一个新脚本版本。