导入 Diligent One 结果 数据

概念信息

IMPORT GRCRESULTS 命令

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

说明

在结果中，控制测试被称为“数据解析”。

如何使用该信息

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

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

如果您要在结果和Analytics之间双向传输数据，您需要确保结果表中的所有域名称都满足更严格的Analytics域名称要求。否则，您会承担 Analytics 和结果数据不匹配的风险。

例如，当结果应用程序域名称被导入到Analytics时，结果包含的任何特殊字符都被自动转换为下划线，这意味着这些域名称不再匹配结果中的原始名称。如果您随后将 Analytics 数据重新导出到结果中的原始表，则这些域不再被正确匹配。

要使您打算双向传输的数据避免出现该问题，请您在将数据从 CSV 或者 Excel 文件上传到结果之前，数据满足下列 Analytics 域名称要求：

  • 不包含特殊字符或者空格
  • 不以数字开头
  • 只包含字母数字字符或下划线字符 ( _ )

记录长度限制

您可以导入到 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 扩展名。该名称可以包括下划线字符 ( _ )，但不能包括其他特殊字符或任何空格。该名称不能以数字开头。

密码要求

无需提供密码

如果您使用在线激活方式激活了您的 Diligent One 副本，则无需指定密码即可从 Analytics 导入。因为会基于您计算机上存储的激活信息自动创建密码，并将密码发送到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 令牌侧面板中，指定以下信息：

        域或选项 描述
        描述

        输入提供有用信息的描述，例如：

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

        说明

        贵组织可能制定了一项安全政策，要求令牌在一定时间之后到期。创建包含有效期的令牌是一种好做法。Diligent One 会在到期日之前，向您发送一封自动电子邮件通知。
        即将在…到期 指定距离令牌到期日之前的天数（1 到 365 天）。
        密码 输入您的 Diligent One 账户密码。

      3. 单击生成令牌。

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

        提示

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

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

    Analytics 用户界面

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

    Analytics 脚本

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

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

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

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

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