将 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. 从电脑中打开包含脚本的 Analytics 项目。

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

    如果出现错误消息，则在该项目中的一个或多个脚本的解析标头或脚本语法中可能存在问题。

    有关详细信息，请参见 Analytics 和 机器人 中的 ACL 脚本开发工作流程。

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

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

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

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

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

    说明

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

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

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

  6. 可选。在提交脚本成功对话框中，单击任一链接，以检查刚创建的机器人或者所提交的脚本。
  7. 单击确定以退出该对话框。

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

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

说明

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

  1. 从电脑中打开包含脚本的 Analytics 项目。

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

    如果出现错误消息，则在该项目中的一个或多个脚本的解析标头或脚本语法中可能存在问题。

    有关详细信息，请参见 Analytics 和 机器人 中的 ACL 脚本开发工作流程。

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

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

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

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

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

    这些脚本被提交至现有机器人。这些脚本的版本号取决于该机器人是已经包含脚本还是以前是空的。

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

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

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

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

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

说明

在开始任何编辑工作之前从机器人下载这些脚本是最佳做法。与本地存储的脚本不同，您可以确保所下载的脚本尚未被改变。

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

从机器人下载脚本

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

  1. 打开机器人应用程序。
  2. 从 机器人 的仪表盘中，选择 ACL 机器人。
  3. 导航到包含您要下载的脚本的机器人，然后选择该机器人以将其打开。

  4. 单击机器人应用程序右上角的生产或开发按钮，选择要使用的模式。

    有关更多信息，请参阅机器人 中的开发模式和生产模式。

  5. 执行以下操作之一：

    • 下载当前已激活的脚本版本

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

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

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

    • 下载较早的脚本版本

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

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

      3. 在版本详情面板中，单击下载。

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

    说明

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

  6. 可选。如果您想要在另一文件夹中使用包含所下载脚本的项目，请移动它。

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

  1. 从电脑中打开包含脚本的 Analytics 项目。

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

    说明

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

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

    如果出现错误消息，则在该项目中的一个或多个脚本的解析标头或脚本语法中可能存在问题。

    有关详细信息，请参见 Analytics 和 机器人 中的 ACL 脚本开发工作流程。

  4. 输入一个简短的提交消息以描述对所提交脚本进行的更改，然后单击确定。

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

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

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

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

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

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

  • 将脚本提交至新机器人
  • 将脚本提交至现有机器人

  1. 从电脑中打开包含脚本的 Analytics 项目。

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

    如果出现错误消息，则在该项目中的一个或多个脚本的解析标头或脚本语法中可能存在问题。

    有关详细信息，请参见 Analytics 和 机器人 中的 ACL 脚本开发工作流程。

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

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

  4. 执行以下操作之一：
    • 将脚本提交至新机器人在新建机器人字段中键入一个机器人名称，然后单击创建。

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

      说明

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

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

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

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

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

    脚本被提交至新创建的或现有的机器人。这些脚本的版本号取决于该机器人是已经包含脚本还是以前是空的。

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

  6. 可选。在提交脚本成功对话框中，单击任一链接，以检查刚创建的或现有的机器人或者所提交的脚本。
  7. 单击确定以退出该对话框。

使用机器人上传 ACL 脚本

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

说明

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

  1. 打开机器人应用程序。

  2. 从 机器人 的仪表盘中，选择 ACL 机器人。

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

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

  5. 在脚本版本选项卡上，单击上传。

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

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

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

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

  7. 键入一条提交消息，然后单击上传并提交。

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