将异常数据导出到 Diligent One 中的结果应用程序

Concept Information

EXPORT 命令

如果您使用 Diligent One，则可以将 Analytics 表中的异常数据导出到结果应用程序中的表。要导出异常数据，您需要使用标准程序从 Analytics 导出数据，有少许不同。

结果应用程序是一个补救和工作流自动化应用程序，用于管理异常数据，通过调查问卷添加人文环境，让您使用触发器和度量持续监测。要了解更多信息，请参见在结果应用程序中处理数据。

安全要求

要将异常数据导出到结果应用程序中的控制测试，需要特定的 Diligent One 角色分配或管理权限：

  • 对结果应用程序集合具有“专业用户”或“专业经理”角色的用户可以将结果导出到该集合中的任何控制测试。

    说明

    只有具有“专业经理”角色的用户可以覆盖控制测试中的现有数据。

  • Diligent One 账户管理员和结果应用程序管理员可自动在其管理的 Diligent One 实例中的所有集合中获取“专业经理”角色。

有关更多信息，请参阅结果应用程序权限。

导出限制

在导出到结果应用程序中的控制测试时适用的限制如下所示。

在这些限制内，可以多次导出到同一个控制测试。如果控制测试中已经存在数据，您可以选择覆盖它，或附加新的数据。

说明

虽然可以导出多达 100,000 个记录到一个控制测试，但更好的做法是创建较小的、更有重点的异常集。

条目 最大值
每次导出的记录数 100,000
每个控制测试的记录数 100,000
每个记录的域数 500
每个域的字符数 256

在 Analytics 和结果应用程序之间保持域的一致性

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

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

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

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

说明

在将数据附加到调查问卷域时，结果应用程序中的列的显示名称仍然是在调查问卷配置中指定的名称，即使您更改了 Analytics 中的显示名称。

覆盖选项和结果应用程序主键

当您将异常数据从 Analytics 导出至现有结果应用程序表时，您可以选择将导出的数据附加到该表，或者完全覆盖该表。

如果结果应用程序表将某个字段指定为主键，并且您要导出的数据包含一个相应的字段，则导出行为有所不同。（有关在结果应用程序中指定主键的详细信息，请参见指定主键。）结果

下面总结了不同的可能性。

  结果应用程序中无主键 结果应用程序中的主键
未选择覆盖选项 导出的数据被附加到现有结果应用程序表
  • 匹配值如果匹配值存在于结果应用程序中的主键字段和从 Analytics 导出的相应字段中，则会用导出的记录中存在的值更新结果应用程序中的记录
  • 无匹配值如果匹配值不存在于结果应用程序中的主键字段和从 Analytics 导出的相应字段中，则不会更新结果应用程序中的记录，并且会将导出的记录附加到该表
已选择覆盖选项 导出的数据替换（覆盖）现有结果应用程序表 导出的数据替换（覆盖）现有结果应用程序表

将异常导出至结果应用程序

说明

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

指定要导出的域

  1. 打开包含您想要导出的异常数据的表。
  2. 选择数据 > 导出。
  3. 在主要选项卡上，选择下列选项之一：
    • 域指定您想要导出的域

      当您选择此选项时，这些域被使用表布局中的物理域名称导出。

      有关重命名域的信息，请参见在表布局中重命名一个域。

    • 视图导出当前视图中的所有域

      当您选择此选项时，这些域被使用列显示名称导出。这些域被按它们在视图中出现的相同顺序导出。

      有关重命名列的信息，请参见重命名视图中的列。

  4. 如果选择域，请执行以下操作之一：
    • 从导出域列表中选择要导出的域。

      提示

      您可以使用 Ctrl+单击选择多个不相邻的域，使用 Shift+单击选择多个相邻的域。

    • 单击导出字段可选择字段，或创建一个表达式。

选择导出选项

  1. 在导出为下拉列表中，选择 HighBond。
  2. 执行以下操作之一：
    • 附加到结果应用程序表

      如果想要将导出的数据附加到结果应用程序中的现有表中，请取消选择覆盖。

      说明

      Analytics 域只有在具有与现有结果应用程序域匹配的物理域名称时才能被附加到后者，而无论它们在任一应用程序中的显示名称是什么。在 Analytics 中，物理字段名称是表格布局中的名称。

      这两个应用程序内的字段的顺序不会影响字段名称匹配。

      如果导出字段的物理名称不匹配结果应用程序表中的字段的物理名称，则会在该表中创建新列。

    • 替换（覆盖）结果应用程序表

      如果想要替换结果应用程序中的现有表，请选择覆盖。

    有关详细信息，请参见覆盖选项和结果应用程序主键。

  3. （可选）如果您想要将列显示名称导出至结果应用程序，请选择包括域显示名称。

    选择此选项可使结果应用程序中的显示名称和物理名称与 Analytics 中的名称相同。

    如果您不选择包括域显示名称，则结果取决于您是按字段导出还是按视图导出：

    导出字段导出视图
    选择了包括域显示名称结果应用程序中的字段名称就是 Analytics 中的字段名称。结果应用程序中的显示名称是 Analytics 中的显示名称。
    未选择包括域显示名称结果应用程序中的字段名称和显示名称就是 Analytics 中的字段名称。

    结果应用程序中的域名称和显示名称是 Analytics 中的显示名称。

    说明

    如果您要将一个视图附加到一个结果应用程序表，而该表是您通过从其版本低于 14.1 的 Analytics 中导出视图而创建的，请勿选择包括域显示名称。否则，可能使导出的列所包含的字段名称与结果应用程序中的名称不同，而这会导致在结果应用程序中创建新列并使得各个应用程序之间的数据不协调。

完成导出

  1. 如果当前视图中有想要从处理中排除的记录，请在如果文本框中输入一个条件，或单击如果使用表达式生成器创建 IF 声明。

    说明

    在应用任何范围选项（前、后、当）之后，仅针对表中的剩余记录评估如果条件。

    IF 声明中考虑到了视图中的所有记录，滤除那些不满足指定条件的记录。

  2. 执行以下操作之一：

    如果您知道您要导出到的表的 ID 编号，请：

    在到文本框中输入该编号。

    • 输入不带任何引号的数字 - 例如，99
    • 仅输入数字。不要输入文件名。
    • 如果您要导出到北美地区（美国）以外的数据中心，您还必须指定数据中心代码。控制测试 ID 编号和数据中心代码必须使用 @ 符号加以分隔，例如，99@eu。数据中心代码指定您要将数据导出到哪个地区的 Diligent One 服务器。

      • af – 非洲（南非）
      • ap – 亚太（新加坡）
      • au – 亚太（澳大利亚）
      • ca – 北美（加拿大）
      • eu – 欧洲（德国）
      • jp – 亚太（东京）
      • sa – 南美（巴西）
      • us – 北美（美国）

      您只能使用为贵组织的 Diligent One 实例授权的数据中心代码。北美（美国）数据中心是默认的，因此指定 @us 是可选操作。

    如果您不知道要导出到的表的 ID 编号，或者如果您想要创建一个新的表，请：

    1. 单击到，然后在选择目标测试对话框中导航到适当的分析文件夹。
    2. 执行以下操作之一：
      • 选择一个现有的表，然后单击确定。
      • 在新建数据解析字段中输入一个名称，然后单击创建。

      您将返回到导出对话框，且控制测试 ID 编号和数据中心代码会被预填到到文本框中。

  3. 单击更多选项卡。

  4. 在范围面板中，选择适当的选项：

    • 全部
    • 前
    • 下一页
    • While
    范围选项 详情
    全部 （默认）指定处理视图中的所有记录。
    前 在文本框中输入一个数字。从视图中的第一个记录开始处理，并且仅包括指定数量的记录。
    下一页 在文本框中输入一个数字。从视图中当前选择的记录开始处理，并且仅包括指定数量的记录。必须在视图最左边的列中选择实际记录数量，而不是行中的数据。
    While

    使用 WHILE 语句，根据特定条件或条件组来限制对视图中的记录进行处理。

    在 While 文本框中输入一个条件，或者单击 While 使用表达式生成器创建一个 WHILE 语句。

    只有当指定条件值为真时，WHILE 声明才允许对视图中的记录进行处理。当条件变为假时，处理立即终止，不再考虑剩余的记录。

    可将当选项与全部、前或后选项结合使用。在达到一个限制后，请立即记下处理步骤。

    说明

    前或后选项会参考表中记录的物理顺序或索引顺序。前或后选项会忽略应用于表视图的任何过滤器或快速排序。但是，分析操作的输出结果会遵守已应用的过滤器。

    如果视图进行了快速分类，后和前操作相同。

  5. 单击确定。

    在将异常数据导出到结果应用程序时，会出现进度提示。完成导出操作时，会在日志中创建一个条目。

密码要求

无需提供密码

如果您使用在线激活方式激活了您的 Analytics 副本，则无需指定密码即可导出至结果应用程序。该密码被基于您的计算机上存储的激活信息自动创建并发送到结果应用程序。

必须提供密码

在以下任一情况下，您需要指定密码才能导出到结果应用程序：

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

  • 使用脚本导出到结果应用程序，然后在机器人中运行脚本

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

获取 HighBond 访问令牌

注意

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

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

  1. 执行以下操作之一：

    • 从 Analytics 主菜单中，选择工具 > HighBond 访问令牌。

    • 在脚本编辑器中，右键单击并选择插入 > HighBond 令牌。

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

    通过 Analytics 访问管理 API 令牌页面是一项便利功能。Analytics您还可以登录到 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. 在启动面板中，关闭包含该令牌的对话框或侧面板。

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

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