将数据从 Analytics 导出到指定的文件格式或 HighBond 结果应用程序。

EXPORT {<FIELDS> 域名称 <AS 导出名称> <...n>|<FIELDS> ALL} <UNICODE> 导出类型 <SCHEMA> PASSWORD 数字 TO {文件名|aclgrc_id} <OVERWRITE> <IF 测试> <WHILE 测试> <{FIRST 范围|NEXT 范围}> <APPEND> <KEEPTITLE> <SEPARATOR 字符> <QUALIFIER 字符> <WORKSHEET 工作表名称> <DISPLAYNAME>
名称 描述
FIELDS 域名称 AS 导出名称 <...n> | FIELDS ALL

要导出的域。

  • 域名称导出指定的一个或多个域

    单独请用空格分隔域名称。

    您可以选择使用 AS 导出名称为导出文件中的域包括一个不同的名称。 请将导出名称放在引号中。

    如果您正导出到 HighBond 结果应用程序 (ACLGRC)，则可以将 AS 与 DISPLAYNAME 参数组合使用。 有关详细信息，请参见在导出至 HighBond 结果应用程序时，DISPLAYNAME 如何与 AS 交互？。

  • ALL 导出该表中的所有域

UNICODE

可选

仅在 Unicode 版的 Analytics 中可用。 仅适用于文本 (ASCII)、分隔文本 (DELIMITED) 和 XML 文件和 Windows 剪贴板 (CLIPBOARD) 输出。

导出应用了 Unicode UTF-16 LE 字符编码的Analytics 数据。

  • 如果您要导出的数据包含不受扩展 ASCII (ANSI) 支持的字符，请指定 UNICODE
  • 如果您要导出的数据中的所有字符都受到扩展 ASCII (ANSI) 的支持，请勿指定 UNICODE

    导出的数据被编码为扩展 ASCII (ANSI)。

    说明

    任何不受支持的字符都被从导出的文件中省略。

有关详细信息，请参见 Galvanize Unicode 产品。
导出类型

使用下列选项之一的输出文件格式或目标位置：

  • ACCESS Microsoft Access 数据库文件 (.mdb)

    默认情况下，数据被导出为 Unicode。

  • ACLGRC HighBond 结果应用程序
  • ASCII ASCII 纯文本 (.txt)
  • CLIPBOARD Windows 剪贴板
  • DBASE dBASE 兼容文件 (.dbf)
  • DELIMITED 分隔文本文件 (.del) 或者逗号分隔值文件 (.csv)
  • EXCEL 与 Excel 1997 至 2003 兼容的 Microsoft Excel 文件 (.xls)
  • JSON JSON 文件 (.json)
  • LOTUS Lotus 123 文件
  • WDPF6 Wordperfect 6 文件
  • WORD MS Word 文件 (.doc)
  • WP Wordperfect 文件
  • XLS21 Microsoft Excel 版本 2.1 文件
  • XLSX Microsoft Excel .xlsx 文件

    默认情况下，数据被导出为 Unicode。

  • XML XML 文件 (.xml)
架构

可选

仅适用于 XML 文件输出。

在导出的 XML 文件中包括 XML 架构。 XML 架构包含描述 XML 文件结构（包括域的数据类型）的元数据。

在导出文件后，您可以根据该架构验证文件。
PASSWORD 数字

仅适用于 HighBond 结果应用程序 (ACLGRC)。

要使用的密码定义。

您不使用 PASSWORD 数字 提示用户提供或者指定实际密码。 密码定义是指先前使用 PASSWORD 命令、SET PASSWORD 命令或 PASSWORD 分析标记提供或设置的密码。

数字是密码定义的编号。 例如，如果先前已在脚本中或者在调度分析时提供或设置了两个密码，则 PASSWORD 2 指定使用密码 #2。

有关提供或设置密码的详细信息，请参见：

必须将 PASSWORD 数字放在 TO 之前紧邻位置或命令语法字符串的末尾。

所需的密码值是 HighBond 访问令牌。 有关详细信息，请参见导出至 HighBond 结果应用程序。

说明

PASSWORD 未必是必需的，具体取决于该脚本的运行环境：

Analytics

（在线激活）

PASSWORD 不是必需的。

当前用户的 HighBond 访问令牌被自动使用。

Analytics

（离线激活）

PASSWORD 是必需的。
机器人
Analytics Exchange
分析应用程序窗口
TO 文件名 | aclgrc_id

导出目标位置：

  • TO 文件名将数据导出至文件

    如果需要，您可以包括绝对或相对文件路径，但 Windows 文件夹必须已经存在。 必须将文件名值指定为带引号的字符串。

    说明

    要导出至逗号分隔值文件 (*.csv)，您必须将 .csv 文件扩展名指定为文件名的一部分。 例如：vendors.csv

  • TO aclgrc_id 将数据导出到 HighBond 结果应用程序

    aclgrc_id 值必须包括控制测试 ID 编号，并且如果您导出到北美以外的数据中心，则必须包括数据中心代码。 aclgrc_id 值必须用引号围起来。

    控制测试 ID 号和数据中心代码必须使用 @ 符号加以分隔。 例如，TO "99@eu"。

    如果您不知道控制测试 ID 号码，请使用 Analytics 用户界面开始导出至结果应用程序。 一旦您已经识别了控制测试 ID 号，请取消导出。 有关详细信息，请参见将异常导出到 HighBond 结果应用程序。

    数据中心代码指定您将数据导出到哪个地区的 HighBond 服务器：

    • ap – 亚太地区
    • au – 澳大利亚
    • ca – 加拿大
    • eu – 欧洲
    • us – 北美

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

可选

仅适用于 HighBond 结果应用程序 (ACLGRC)。

  • 指定 OVERWRITE导出的数据覆盖了目标控制测试（表）中的任何现有数据。 您必须在目标集合中具有专业经理角色才能覆盖数据。
  • 省略 OVERWRITE导出的数据被附加至目标控制测试（表）中的任何现有数据。 有关详细信息，请参见导出至 HighBond 结果应用程序。

与目标控制测试（表）相关的任何解释都会动态更新以反映所导入的数据，无论您是覆盖还是附加。
IF 测试

可选

一个条件表达式，它必须为真以便处理每个记录。 仅对满足条件的那些记录执行该命令。

说明

在应用任何范围参数（WHILE、FIRST、NEXT）之后，仅针对表中的剩余记录评估 IF 条件。
WHILE 测试

可选

一个条件表达式，它必须为真以便处理每个记录。 该命令被一直执行到条件的计算结果为假或者到达表的末尾为止。

说明

如果您将 WHILE 与 FIRST 或 NEXT 结合使用，请在达到一个限制时立即记下处理步骤。
FIRST 范围 | NEXT 范围

可选

要处理的记录数：

  • FIRST 从第一个记录开始处理，直到达到指定的记录数为止
  • NEXT 从当前选定的记录开始处理，直到达到指定的记录数为止

请使用范围指定要处理的记录数。

如果您省略 FIRST 和 NEXT，则会默认处理所有记录。
APPEND

可选

仅适用于文本 (ASCII) 及分隔文本 (DELIMITED) 文件。

将命令输出附加到现有文件的末尾，而不是覆盖现有文件。

说明

您必须确保命令输出的结构和现有文件完全相同：

  • 相同的域
  • 相同的域顺序
  • 匹配的域具有相同的长度
  • 匹配的域具有相同的数据类型

Analytics 将输出附加到现有文件，而无论其结构如何。 如果输出的结构和现有文件不匹配，则可能生成混乱的、不完整的或不准确的数据。
KEEPTITLE

可选

仅适用于文本文件 (ASCII) 以及分隔文本文件和逗号分隔值文件 (DELIMITED)。

请在导出数据中包括 Analytics 域名称。 如果被省略，则没有域名称会出现在输出文件中。

SEPARATOR 字符

可选

仅适用于分隔文本文件和逗号分隔值文件 (DELIMITED)。

要用作域之间的分隔符的字符。 您必须将该字符指定为带引号的字符串。

默认情况下，Analytics 使用逗号。 如果您要导出至逗号分隔值文件，请勿指定除逗号以外的任何字符。

QUALIFIER 字符

可选

仅适用于分隔文本文件和逗号分隔值文件 (DELIMITED)。

要用作文本限定符以便环绕和标识域值的字符。 您必须将该字符指定为带引号的字符串。

默认情况下，Analytics 使用双引号。

WORKSHEET 工作表名称

可选

仅适用于 Microsoft Excel (.xlsx) 文件。

在新的或现有 Excel 文件中创建的 Excel 工作表的名称。

默认情况下，Analytics 使用您要导出的 Analytics 表的名称作为工作表名称。

工作表名称只能包含字母数字字符或下划线字符 ( _ )。 该名称不能包含特殊字符、空格或以数字开头。 将值放在引号内是可选的。

有关在导出时覆盖 Excel 工作簿和工作表的详细信息，请参见WORKSHEET 参数和覆盖。

DISPLAYNAME

可选

仅适用于 HighBond 结果应用程序 (ACLGRC)。

将域名称导出为域名称，将显示名称导出为显示名称，因此，显示名称出现在结果应用程序中的列标题中，而不会影响实际域名称。

可以将 DISPLAYNAME 与 AS 组合使用。 有关详细信息，请参见在导出至 HighBond 结果应用程序时，DISPLAYNAME 如何与 AS 交互？。

将数据导出至 Excel .xlsx 文件

您将特定域从 Vendor 表导出到一个 Excel .xlsx 文件：

OPEN 供应商
EXPORT FIELDS Vendor_No Vendor_Name Vendor_City XLSX TO "VendorExport"

将数据导出至 Excel .xlsx 文件并指定工作表名称

您将特定域从 Vendor 表导出到一个 Excel .xlsx 文件中的名为 Vendors_US 的工作表：

OPEN 供应商
EXPORT FIELDS Vendor_No Vendor_Name Vendor_City XLSX TO "VendorExport" WORKSHEET Vendors_US

将所有域导出到一个分隔文件

您将 Vendor 表中的所有域导出至一个分隔文件：

OPEN 供应商
EXPORT FIELDS ALL DELIMITED TO "VendorExport"

将所有域导出至逗号分隔值文件

您将 Vendor 表中的所有域导出至一个逗号分隔值文件：

OPEN 供应商
EXPORT FIELDS ALL DELIMITED TO "VendorExport.csv"

使用 GROUP 将数据导出至多个分隔文件

您将特定域从 Vendor 表导出至两个分隔文件：

  • 一个文件包含从 "A" 到 "M" 的供应商名称
  • 一个文件包含从 "N" 到 "Z" 的供应商名称

使用 GROUP 命令，您用 IF 条件测试每个记录的供应商名称：

GROUP
  EXPORT FIELDS Vendor_No Vendor_Name DELIMITED TO "AtoM" IF BETWEEN(UPPER(VENDOR_NAME), "A", "M")
  EXPORT FIELDS Vendor_No Vendor_Name DELIMITED TO "NtoZ" IF BETWEEN(UPPER(VENDOR_NAME), "N", "Z")
END

将数据导出至 HighBond 结果应用程序

您将特定域从 AR_Exceptions 表导出至 HighBond 结果应用程序。 您覆盖目标控制测试（表）中的现有数据：

OPEN 应收账款异常
EXPORT FIELDS No Due Date Ref Amount Type ACLGRC PASSWORD 1 TO "10926@us" OVERWRITE

说明

有关此命令工作原理的详细信息，请参见 Analytics 帮助。

将 EXPORT 与 GROUP 命令结合使用

对于大多数导出格式，您可使用 GROUP 命令将数据同时导出到多个文件。

当向 Microsoft Excel 和 Microsoft Access 导出数据时，一次仅可创建一个文件。

导出至 Excel

在将数据导出到 Excel 文件时，适用下列限制：

记录数
  • Excel 2007 和更高版本 (*.xlsx) 最多 1,048,576 个记录
  • Excel 97 和 2003 最多 65,536 个记录

超过这些最大数量的 Analytics 表可成功导出，但过剩的记录将被忽略而不是被导出。
域长度
  • 无特定域长度限制
  • 组合域长度不能超过记录长度总限制 32 KB

    （在非 Unicode Analytics 中为 32,765 个字符，在 Unicode Analytics 中为 16,382 个字符）

  • 对于 Excel 2.1，最多 247 个字符
域名称的长度
  • 最多 64 个字符
  • 对于 Excel 2.1，最多 248 个字符

WORKSHEET 参数和覆盖

下面解释了在从 Analytics 表导出到 Excel 文件时使用或不使用 WORKSHEET 参数的结果：

匹配

描述

 使用 WORKSHEET 参数 不使用 WORKSHEET 参数
没有匹配的 Excel 文件名
  • 目标文件名值不匹配任何现有 Excel 文件名
 使用具有指定名称的工作表创建一个新的 Excel 文件 使用与导出的 Analytics 表同名的工作表创建一个新的 Excel 文件

匹配的 Excel 文件名

没有匹配的工作表名称
  • 目标文件名值和一个现有的 Excel 文件名相同
  • WORKSHEET 工作表名称不匹配该 Excel 文件中的工作表名称
 一个具有指定名称的工作表被添加到现有 Excel 文件 现有 Excel 文件被一个新的 Excel 文件覆盖，其工作表与导出的 Analytics 表同名
匹配的 Excel 文件名和工作表名称
  • 目标文件名值和一个现有的 Excel 文件名相同
  • WORKSHEET 工作表名称匹配该 Excel 文件中的工作表名称

如果现有工作表最初是从 Analytics 创建的，则具有指定名称的工作表会覆盖该工作表。

如果现有工作表最初是直接在 Excel 中创建的，则会出现错误消息并且导出操作被取消。

 现有 Excel 文件被一个新的 Excel 文件覆盖，其工作表与导出的 Analytics 表同名

导出至 HighBond 结果应用程序

下表包含有关导出至结果应用程序中的控制测试的附加信息。

项目

详情

必需的权限

要将结果导出至结果应用程序中的控制测试，需要特定的 HighBond 角色分配或管理特权：

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

    说明

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

  • HighBond 系统管理员和结果应用程序管理员可自动在其管理的 HighBond 组织中的所有集合中获取“专业经理”角色。

导出限制

导出控制测试时，以下限制适用：

  • 每次最多导出 100,000 个记录
  • 每个控制测试最多 100,000 个记录
  • 每个记录最多 500 个域
  • 每个域最多 256 个字符

您可以多次导出到相同的控制测试，但是您不能超出总体限制。

附加域

（未指定 OVERWRITE）

无论它们在 Analytics 表中的顺序如何，如果导出的域具有匹配的物理域名称，则都会被附加到控制测试中的现有域。

在 Analytics 中，物理字段名称是表格布局中的名称。 与任何已有域名称不匹配的导出域会作为附加列被添加到“结果”中的表。

Analytics 中和结果应用程序中的域的显示名称不会被考虑。 但是，如果您使用可选的 AS 导出名称参数，并且您不使用 DISPLAYNAME，则导出名称值被用作物理域名称。

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

如果目标控制测试指定了一个主键字段，则附加的工作方式会不同。 有关详细信息，请参见将异常导出到 HighBond 结果应用程序。

说明

如果您在结果应用程序和 Analytics 之间双向传输数据，并且数据最终在结果应用程序中未对齐，您很可能拥有不匹配的域名称。

有关详细信息，请参见导入和导出结果应用程序数据时的域名称注意事项。

创建密码定义并指定密码值

PASSWORD 命令

如果您使用 PASSWORD 命令创建用于连接至 HighBond 的编号密码定义，且未指定密码值，则在脚本试图连接时，将显示密码提示窗口。

有关详细信息，请参见PASSWORD 命令。

SET PASSWORD 命令

如果您使用 SET PASSWORD 命令创建用于连接至 HighBond 的编号密码定义，且指定密码值，则不会显示密码提示窗口，这对于旨在以无人看管方式运行的脚本而言是适当的。

有关详细信息，请参见 SET PASSWORD 命令。

获取 HighBond 访问令牌

无论您使用哪个方法来创建密码定义，所需的密码值都是用户可在 Launchpad 中生成的 HighBond 访问令牌。

注意

生成的访问令牌与用于登录 Launchpad 的账户匹配。 作为脚本编写者，如果该脚本将供他人使用，则在脚本中指定您自己的访问令牌可能不适当。

  1. 执行以下操作之一：
    • 从 Analytics 主菜单中选择工具 > HighBond 访问令牌。
    • 在脚本编辑器中，右键单击并选择插入 >HighBond 令牌。

    管理 API 令牌页面在您的浏览器中打开。 您可能需要首先登录启动面板。

  2. 执行以下操作之一：
    • 使用现有令牌在令牌列中，单击您想要使用的部分屏蔽令牌并输入您的 HighBond 账户密码。 未屏蔽的令牌被显示。

      提示

      除非您有理由创建新的令牌，请使用现有令牌。 如果现有令牌不工作，请创建一个新的令牌。

      使用现有令牌可削减您需要管理的令牌数。

    • 创建新令牌单击创建令牌 > Analytics 并输入您的 HighBond 账户密码。

      一个新的 Analytics 令牌被创建。

      说明

      如果您是启动面板系统管理员，您还可以选择创建 API 令牌。 您应该保留 API 令牌以用于其预期用途，即对 HighBond 平台进行编程访问。

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

    提示

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

  4. 在 Analytics 中，执行下列操作之一：
    • 将该令牌粘贴到密码提示窗口中
    • 将该令牌粘贴到脚本中 SET PASSWORD 命令语法的适当位置
  5. 在启动面板中，关闭包含该令牌的对话框。

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

    有关详细信息，请参见创建和管理访问令牌。

在导出至 HighBond 结果应用程序时，DISPLAYNAME 如何与 AS 交互？

下面的矩阵显示了在将域名称从 Analytics 导出至结果应用程序时，DISPLAYNAME 参数如何与 AS 交互。

  不带 AS 带 AS
不带 DISPLAYNAME 结果应用程序中的域名称和显示名称是 Analytics 中的域名称。 结果应用程序中的域名称和显示名称是 AS 参数中的显示名称。
带 DISPLAYNAME 结果应用程序中的域名称是 Analytics 中的域名称。 结果应用程序中的显示名称是 Analytics 中的显示名称。 结果应用程序中的域名称是 Analytics 中的域名称。 结果应用程序中的显示名称是 AS 参数中的显示名称。