SEQUENCE 命令

概念信息

确定 Analytics 表中的一个或多个域是否按顺序排列，并且识别顺序错误的条目。

语法

SEQUENCE <ON> {<FIELDS> 键域 <D> <...n>|<FIELDS> ALL <EXCLUDE 域名称 <...n>>} <UNFORMATTED> <ERRORLIMIT n> <IF 测试> <WHILE 测试> <FIRST 范围|NEXT 范围> <TO {SCREEN|文件名|PRINT}> <APPEND> <HEADER 页眉文本> <FOOTER 页脚文本> <PRESORT> <ISOLOCALE 区域设置代码>

参数

名称	描述
ON FIELDS 键域 D <...n> \| FIELDS ALL	要测试是否存在顺序次序的一个或多个字符、数值或日期时间域。 FIELDS 键域测试指定的一个或多个域多个域必须由空格分隔，并且可以具有不同的数据类型。如果您按一个以上的域测试，则这些域会被按照您列出它们的顺序测试。包括 D 可按降序测试键域。默认的测试顺序为升序。 FIELDS ALL测试该表中的所有域如果您按所有域测试，则这些域会被按照它们出现在表布局中的顺序测试。按升序测试键域值是 FIELDS ALL 的唯一选项。说明当您按一个以上的域测试时，您是在测试源表中是否存在嵌套顺序次序。SEQUENCE 的有效用法要求您按照与源表中的现有嵌套顺序次序相同的顺序指定测试域。多个测试域被作为嵌套组测试。它们并非相互独立接受测试。
EXCLUDE 域名称可选	仅在使用 FIELDS ALL 测试是否存在顺序次序时有效。要从该命令中排除的一个或多个域。EXCLUDE 让您可以通过排除指定的域，来调整 ALL 关键字。如果要添加源自一个或多个相关表的字段，则 EXCLUDE 必须紧跟在 FIELDS ALL 之后，或 ALL 关键字最后一次出现的位置之后。例如： FIELDS ALL EXCLUDE 域 1 域 2 FIELDS ALL 关联表名称.ALL EXCLUDE 域 1 域 2
UNFORMATTED 可选	在把结果输出至文件时消除页标题和分页符。
ERRORLIMIT n 可选	允许的误差数，达到此数量就会终止该命令。默认值为 10。
IF 测试可选	一个条件表达式，它必须为真以便处理每个记录。仅对满足条件的那些记录执行该命令。说明在应用任何范围参数（WHILE、FIRST、NEXT）之后，仅针对表中的剩余记录评估 IF 条件。
WHILE 测试可选	一个条件表达式，它必须为真以便处理每个记录。该命令被一直执行到条件的计算结果为假或者到达表的末尾为止。说明如果您将 WHILE 与 FIRST 或 NEXT 结合使用，请在达到一个限制时立即记下处理步骤。
FIRST 范围 \| NEXT 范围可选	要处理的记录数： FIRST 从第一个记录开始处理，直到达到指定的记录数为止 NEXT 从当前选定的记录开始处理，直到达到指定的记录数为止请使用范围指定要处理的记录数。如果您省略 FIRST 和 NEXT，则会默认处理所有记录。
TO SCREEN \| 文件名\| PRINT 可选	要将命令结果发送到的位置：屏幕 – 在 Analytics 显示区域中显示结果提示您可以单击显示区域中的任何链接结果值以向下追溯到源表中的关联记录。文件名将结果保存至文件请将文件名指定为具有适当文件扩展名的带引号的字符串。例如：TO "Output.TXT" 默认情况下，该文件被保存到包含 Analytics 项目的文件夹。请使用绝对或相对文件路径将该文件保存到另外的现有文件夹： TO "C:\Output.TXT" TO "Results\Output.TXT" PRINT 将结果发送到默认打印机
APPEND 可选	将命令输出附加到现有文件的末尾，而不是覆盖现有文件。说明您必须确保命令输出的结构和现有文件完全相同：相同的域相同的域顺序匹配的域具有相同的长度匹配的域具有相同的数据类型 Analytics 将输出附加到现有文件，而无论其结构如何。如果输出的结构和现有文件不匹配，则可能生成混乱的、不完整的或不准确的数据。
HEADER 头文本可选	要在报告的每个页面的顶部插入的文本。必须将头文本指定为带引号的字符串。该值将覆盖 Analytics HEADER 系统变量。
FOOTER 尾文本可选	要在报告的每个页面底部插入的文本。必须将尾文本指定为带引号的字符串。该值将覆盖 Analytics FOOTER 系统变量。
PRESORT 可选	在执行该命令之前，请按键域对该表进行排序。说明在 GROUP 命令内部不可使用 PRESORT。
ISOLOCALE 区域设置代码可选	说明仅在 Unicode 版 Analytics 中可用。采用语言_国家/地区格式的系统区域设置。例如，要使用加拿大法语，请输入 fr-ca。使用以下代码：语言 ISO 639 标准语言代码国家/地区 ISO 3166 标准国家/地区代码如果您未指定国家/地区代码，则使用该语言的默认国家/地区。如果您不使用 ISOLOCALE，则会使用默认系统区域设置。

名称

描述

ON FIELDS 键域 D <...n> | FIELDS ALL

要测试是否存在顺序次序的一个或多个字符、数值或日期时间域。

FIELDS 键域测试指定的一个或多个域
多个域必须由空格分隔，并且可以具有不同的数据类型。
如果您按一个以上的域测试，则这些域会被按照您列出它们的顺序测试。
包括 D 可按降序测试键域。默认的测试顺序为升序。
FIELDS ALL测试该表中的所有域
如果您按所有域测试，则这些域会被按照它们出现在表布局中的顺序测试。
按升序测试键域值是 FIELDS ALL 的唯一选项。

说明

当您按一个以上的域测试时，您是在测试源表中是否存在嵌套顺序次序。SEQUENCE 的有效用法要求您按照与源表中的现有嵌套顺序次序相同的顺序指定测试域。多个测试域被作为嵌套组测试。它们并非相互独立接受测试。

EXCLUDE 域名称

可选

仅在使用 FIELDS ALL 测试是否存在顺序次序时有效。

要从该命令中排除的一个或多个域。EXCLUDE 让您可以通过排除指定的域，来调整 ALL 关键字。

如果要添加源自一个或多个相关表的字段，则 EXCLUDE 必须紧跟在 FIELDS ALL 之后，或 ALL 关键字最后一次出现的位置之后。例如：

FIELDS ALL EXCLUDE 域 1 域 2

FIELDS ALL 关联表名称.ALL EXCLUDE 域 1 域 2

UNFORMATTED

可选

在把结果输出至文件时消除页标题和分页符。

ERRORLIMIT n

可选

允许的误差数，达到此数量就会终止该命令。默认值为 10。

IF 测试

可选

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

说明

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

WHILE 测试

可选

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

说明

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

FIRST 范围 | NEXT 范围

可选

要处理的记录数：

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

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

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

TO SCREEN | 文件名| PRINT

可选

要将命令结果发送到的位置：

屏幕 – 在 Analytics 显示区域中显示结果
提示
您可以单击显示区域中的任何链接结果值以向下追溯到源表中的关联记录。
文件名将结果保存至文件
请将文件名指定为具有适当文件扩展名的带引号的字符串。例如：TO "Output.TXT"
默认情况下，该文件被保存到包含 Analytics 项目的文件夹。
请使用绝对或相对文件路径将该文件保存到另外的现有文件夹：
- TO "C:\Output.TXT"
- TO "Results\Output.TXT"
PRINT 将结果发送到默认打印机

APPEND

可选

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

说明

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

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

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

HEADER 头文本

可选

要在报告的每个页面的顶部插入的文本。

必须将头文本指定为带引号的字符串。该值将覆盖 Analytics HEADER 系统变量。

FOOTER 尾文本

可选

要在报告的每个页面底部插入的文本。

必须将尾文本指定为带引号的字符串。该值将覆盖 Analytics FOOTER 系统变量。

PRESORT

可选

在执行该命令之前，请按键域对该表进行排序。

说明

在 GROUP 命令内部不可使用 PRESORT。

ISOLOCALE 区域设置代码

可选

说明

仅在 Unicode 版 Analytics 中可用。

采用语言_国家/地区格式的系统区域设置。例如，要使用加拿大法语，请输入 fr-ca。

使用以下代码：

语言 ISO 639 标准语言代码
国家/地区 ISO 3166 标准国家/地区代码
如果您未指定国家/地区代码，则使用该语言的默认国家/地区。

如果您不使用 ISOLOCALE，则会使用默认系统区域设置。

Analytics 输出变量

名称	包含
WRITEn	该命令识别出的顺序错误总数。

示例

测试是否存在失序的员工 ID

您将在 EmployeeID 域中识别的任何序列错误写入到文本文件中：

SEQUENCE ON EmployeeID ERRORLIMIT 10 TO "SequenceErrors.txt"

备注

有关此命令工作方式的详细信息，请参见测试序列顺序。

在 GROUP 内部使用 SEQUENCE

如果您在 GROUP 命令内部使用 SEQUENCE，则该命令会执行以避免干扰组的处理，但不再报告数据序列错误。