导入 Diligent One 结果应用程序数据

您可以通过从 Diligent One 结果应用程序中您有权使用的集合导入数据来创建 Analytics 表。 您可以从单个控制测试导入数据表和解释。

说明

在结果应用程序中,控制测试被称为“数据解析”。

如何使用该信息

从结果应用程序向 Analytics 导入数据的能力使您可以对异常执行辅助或跟进分析。执行分析后,您可以在双向流程中将数据重新导出至结果应用程序。有关详细信息,请参阅将异常数据导出到 Diligent One 中的结果应用程序

双向传输结果应用程序数据时的域名注意事项

If you are round-tripping data between 结果 and Analytics, you need to ensure that all field names in the 结果 table meet the more stringent Analytics field name requirements.If you do not, you risk misaligning your Analytics and 结果 data.

For example, any special characters in 结果 field names are automatically converted to underscores when they are imported into Analytics, which means the field names no longer match the original names in 结果.If you then export the Analytics data back to the original table in 结果, fields are no longer correctly matched.

To avoid this problem with data that you intend to round-trip, make sure that before you upload the data to 结果 from CSV or Excel files it meets these Analytics field name requirements:

  • no special characters or spaces
  • does not start with a number
  • contains only alphanumeric characters, or the underscore character ( _ )

记录长度限制

您可以导入到 Analytics 的最大记录长度是 32,767 个字符或 16,383 个 Unicode 字符。

如果尝试从结果应用程序导入的数据超过了最大字符长度限制,则会收到一个错误消息,并且导入失败。请尝试从导入操作中移除大型叙述性域以减小记录长度。

另一种方法是使用 Analytics 命令行中的 IMPORT GRCRESULTS 命令执行导入。使用这个命令时,可以添加 CHARMAX 参数,借助此参数可以指定每个导入字段中的最大字符数。有关详细信息,请参见IMPORT GRCRESULTS 命令

步骤

说明

连接到 Diligent One 时,您可能需要指定密码。有关详细信息,请参阅密码要求

  1. 选择导入 > Diligent One > 结果应用程序
  2. 选择要导入的数据对话框中,双击组织文件夹。
  3. 导航到适当的控制测试。

    说明

    在下列情况下,您没有访问该数据所需的权限:

    • 包含控制测试的集合未显示
    • 当您尝试访问控制测试时,出现消息检索解释列表时出错

    有关详细信息,请参阅在结果应用程序中分配特权和角色。

    要获得权限方面的帮助,请与贵公司的 Diligent One 账户管理员或结果应用程序管理员联系。

  4. 选择下列表之一以导入到 Analytics:
    • 解释(如果存在)
    • 审计轨迹
    • 注释
    • 结果表(双击表域选择文件夹)

    说明

    一次只能将一个表导入到 Analytics。

    提示

    您可以使用“记录 ID”作为键域,在 Analytics 中联接结果表、审计轨迹和评论。使用结果表作为联接中的主表。

  5. 如果您要导入结果表,请从以下类别中选择您想要导入的单个域:
    • 包含用户生成的和系统生成的工作流信息的元数据
    • 额外集合和控制测试名称以及记录 ID

      如果您打算在 Analytics 中联接结果表,请确保选择记录 ID。

    • 包含被导入到结果应用程序的数据或结果应用程序调查问卷答案的数据
    • 全选导入整个表
  6. 单击确定

    数据被从结果应用程序导入。

  7. 数据文件另存为对话框中,输入 Analytics 数据文件的名称,如果有需要,请修改该文件的保存位置并单击保存
  8. 为您要添加到 Analytics 项目中的 Analytics 表输入一个名称,或者保留默认名称,然后单击确定

    说明

    Analytics 表名称限制为 64 个字母数字字符,且不包括 .FIL 扩展名。该名称可以包括下划线字符 ( _ ),但不能包括其他特殊字符或任何空格。该名称不能以数字开头。

密码要求

无需提供密码

如果您使用在线激活方式激活了您的 Analytics 副本,则无需指定密码即可从 Diligent One 导入。根据计算机上存储的激活信息,自动创建密码并将其发送到 Diligent One。

必须提供密码

在以下任一情况下,您确实需要指定密码才能从 Diligent One 导入:

  • 使用离线激活方式激活 Analytics 副本

  • 使用脚本从 Diligent One 导入,然后在机器人应用程序中运行脚本

所需的密码值是 Diligent One 访问令牌。

获取 Diligent One 访问令牌

注意

像保护任何账户密码一样保护您的访问令牌。它包含您的 Diligent One 账户所独有的信息。您不应该共享访问令牌。

除非有充分的理由创建新令牌,否则请使用现有令牌。如果现有令牌不工作,请创建一个新的令牌。使用现有令牌可削减您需要管理的令牌数。

  1. 执行以下操作之一:

    • 从 Analytics 主菜单中,选择工具 > Diligent One 访问令牌

    • 脚本编辑器中,右键单击并选择插入 > Diligent One 令牌

    管理 API 令牌页面将在您的浏览器中打开。您可能需要先登录到 Diligent One。

    通过 Analytics 访问管理 API 令牌页面是一项便利功能。您还可以登录到 Diligent One,然后通过用户个人资料访问该页面,而无需使用 Analytics。

  2. 执行以下操作之一:

    • 使用现有令牌

      1. 令牌列中,单击要使用的已部分屏蔽的令牌。

      2. 输入您的 Diligent One 账户密码,然后单击确认

        未屏蔽的令牌被显示。

      3. 单击复制以复制该令牌。

        提示

        在成功粘贴该令牌之前,请勿关闭包含该令牌的对话框。

    • 创建新令牌

      1. 单击添加令牌 > Analytics

      2. 新建 Analytics 令牌侧面板中,指定以下信息:

        域或选项 描述
        描述

        输入提供有用信息的描述,例如:

        • 令牌的用途
        • 令牌的使用场景 – 例如,分析脚本的名称和位置,或者机器人任务的名称和位置
        令牌有效期
        • 已启用令牌将在您指定的天数之后到期
        • 已禁用令牌永不过期

        说明

        贵组织可能制定了一项安全政策,要求令牌在一定时间之后到期。创建包含有效期的令牌是一种好做法。Diligent One 会在到期日之前,向您发送一封自动电子邮件通知。

        即将在…到期 指定距离令牌到期日之前的天数(1 到 365 天)。
        密码 输入您的 Diligent One 账户密码。
      3. 单击生成令牌

      4. 单击复制以复制该令牌。

        提示

        在成功粘贴该令牌之前,请勿关闭包含该令牌的侧面板。

  3. 根据您使用的数据访问和密码定义方法,执行以下操作之一:

    Analytics 用户界面

    将复制的令牌粘贴到手动访问 Diligent One 时出现的密码提示中。

    Analytics 脚本

    • PASSWORD 命令将复制的令牌粘贴到执行脚本过程中出现的密码提示中。

    • SET PASSWORD 命令将复制的令牌粘贴到脚本中 SET PASSWORD 命令语法的适当位置。

  4. 在启动面板中,关闭包含该令牌的对话框或侧面板。

    如果您创建了新令牌,则该令牌的部分屏蔽版本被添加到您的令牌列表的顶部。

    有关更多信息,请参阅创建和管理 Diligent One 访问令牌