GAPS 命令

概念信息

测试间隔

检测 Analytics 表中的数值或日期时间域是否在序列数据中包含一个或多个间隙。

语法

GAPS <ON> 键域 <D> <UNFORMATTED> <PRESORT> <MISSING 限额> <HEADER 头文本> <FOOTER 尾文本> <IF 测试> <WHILE 测试> <FIRST 范围|NEXT 范围> <TO {SCREEN|表名称|文件名|PRINT}> <LOCAL> <APPEND> <OPEN>

参数

名称 描述
ON 键域 D

要检查是否存在间隔的域或表达式。

包括 D 可按降序对键域进行排序。默认的排序顺序为升序。

UNFORMATTED

可选

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

PRESORT

可选

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

说明

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

MISSING 限制

可选

输出结果包含独立的丢失条目而不是间隔范围。

限制值指定每个确定间隔要报告的最大丢失条目数。默认值为 5。如果对于特定间隔,超过该限制,则丢失的条目被报告为该特定间隔的范围。

限制值并不限制报告的丢失条目的总数,仅限制在某特定间隔报告的丢失条目数量。

HEADER 头文本

可选

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

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

FOOTER 页脚文本

可选

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

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

IF 测试

可选

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

说明

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

WHILE 测试

可选

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

说明

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

FIRST 范围 | NEXT 范围

可选

要处理的记录数:

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

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

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

TO SCREEN | 表名称 | 文件名 | PRINT

可选

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

  • 屏幕 – 在 Analytics 显示区域中显示结果

    提示

    您可以单击显示区域中的任何链接结果值以向下追溯到源表中的关联记录。

  • 表名将结果保存到一个 Analytics 表

    请将表名指定为具有 .FIL 文件扩展名的带引号的字符串。例如:TO "Output.FIL"

    默认情况下,表数据文件 (.FIL) 被保存到包含 Analytics 项目的文件夹。

    请使用绝对或相对文件路径将该数据文件保存到另外的现有文件夹:

    • TO "C:\Output.FIL"
    • TO "Results\Output.FIL"

    说明

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

  • 文件名将结果保存至文件

    请将文件名指定为具有适当文件扩展名的带引号的字符串。例如:TO "Output.TXT"

    默认情况下,该文件被保存到包含 Analytics 项目的文件夹。

    请使用绝对或相对文件路径将该文件保存到另外的现有文件夹:

    • TO "C:\Output.TXT"
    • TO "Results\Output.TXT"
  • PRINT 将结果发送到默认打印机

LOCAL

可选

请将输出文件保存在与 Analytics 项目相同的位置。

说明

仅当针对服务器表运行该命令并且输出文件为 Analytics 表时适用。

LOCAL 参数必须紧跟在 TO 参数后面。

APPEND

可选

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

说明

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

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

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

OPEN

可选

在命令执行后打开该命令创建的表。仅当该命令创建输出表时有效。

Analytics 输出变量

名称 包含
GAPDUPn

该命令识别出的间隔、重复或模糊重复组的总数。

示例

测试是否存在缺少的发票编号

您使用 GAPS 确保 Invoices 表不缺少发票编号:

OPEN 发票
GAPS ON 发票编号 PRESORT TO "发票间隙.fil"

备注

有关此命令工作方式的详细信息,请参见测试间隔

对字符域使用 GAPS

除了测试数值或日期时间域以外,您还可以测试出现在字符域中的数值数据间隔。例如,您可以测试通常被格式化为字符数据的支票号码。

如果字母和数字一起出现在字符域中,仅测试数字,会忽略字母。