LIST 命令

将 Analytics 表中的一个或多个域中的数据输出到按列格式化的显示。

语法

LIST {FIELDS 域名称 <AS 显示名称> <...n>|FIELDS ALL} <LINE 数字 域列表> <TO {SCREEN|文件名|PRINT}> <UNFORMATTED> <IF 测试> <WHILE 测试> <FIRST 范围|NEXT 范围> <HEADER 头文本> <FOOTER 尾文本> <SKIP 行数> <EOF> <APPEND>

参数

名称	描述
FIELDS 域名称 <...n> \| FIELDS ALL	要包括在输出中的域。 FIELDS 域名称包括指定的一个或多个域这些域被按照您列出它们的顺序包括在内。 FIELDS ALL 包括该表中的所有域这些域被按照它们出现在表布局中的顺序包括在内。
AS 显示名称可选	仅在使用 FIELDS 域名称列举数据时使用。输出中的域的显示名称（备选列标题）。如果您希望显示名称与域名称或源表中的现有显示名称相同，请不要使用 AS。请将显示名称指定为带引号的字符串。如果您希望列标题包含换行符，请在单词之间使用分号 (;)。
LINE 数字域列表可选	在每个记录的输出中使用多个行：数字行号，必须介于 2 和 60 之间（包括这两个值）域列表要包括在该行上的域
TO SCREEN \| 文件名\| PRINT 可选	要将命令结果发送到的位置：屏幕 – 在 Analytics 显示区域中显示结果提示您可以单击显示区域中的任何链接结果值以向下追溯到源表中的关联记录。文件名将结果保存至文件请将文件名指定为具有适当文件扩展名的带引号的字符串。例如：TO "Output.TXT" 默认情况下，该文件被保存到包含 Analytics 项目的文件夹。请使用绝对或相对文件路径将该文件保存到另外的现有文件夹： TO "C:\Output.TXT" TO "Results\Output.TXT" PRINT 将结果发送到默认打印机
UNFORMATTED 可选	输出被显示为非格式化文本。输出与 EXPORT ASCII 命令创建的输出相同。无格式数据可输出到文件，以供其他软件程序进一步处理。
IF 测试可选	一个条件表达式，它必须为真以便处理每个记录。仅对满足条件的那些记录执行该命令。说明在应用任何范围参数（WHILE、FIRST、NEXT）之后，仅针对表中的剩余记录评估 IF 条件。
WHILE 测试可选	一个条件表达式，它必须为真以便处理每个记录。该命令被一直执行到条件的计算结果为假或者到达表的末尾为止。说明如果您将 WHILE 与 FIRST 或 NEXT 结合使用，请在达到一个限制时立即记下处理步骤。
FIRST 范围 \| NEXT 范围可选	要处理的记录数： FIRST 从第一个记录开始处理，直到达到指定的记录数为止 NEXT 从当前选定的记录开始处理，直到达到指定的记录数为止请使用范围指定要处理的记录数。如果您省略 FIRST 和 NEXT，则会默认处理所有记录。
HEADER 头文本可选	要在报告的每个页面的顶部插入的文本。必须将头文本指定为带引号的字符串。该值将覆盖 Analytics HEADER 系统变量。
FOOTER 尾文本可选	要在报告的每个页面底部插入的文本。必须将尾文本指定为带引号的字符串。该值将覆盖 Analytics FOOTER 系统变量。
SKIP 行可选	将指定数量的空白行插入到列表中的各个记录之间。例如，LIST ALL SKIP 1 生成两倍行距列表（每条记录之间有一个空白行）。
EOF 可选	在到达文件末尾之后，再执行该命令一次。当位于 GROUP 命令内部时，这可以确保表中的最后一个记录得到处理。请仅当所有域为引用较早记录的计算域时才使用 EOF。
APPEND 可选	将命令输出附加到现有文件的末尾，而不是覆盖现有文件。

名称

描述

FIELDS 域名称 <...n> | FIELDS ALL

要包括在输出中的域。

FIELDS 域名称包括指定的一个或多个域
这些域被按照您列出它们的顺序包括在内。
FIELDS ALL 包括该表中的所有域
这些域被按照它们出现在表布局中的顺序包括在内。

AS 显示名称

可选

仅在使用 FIELDS 域名称列举数据时使用。

输出中的域的显示名称（备选列标题）。如果您希望显示名称与域名称或源表中的现有显示名称相同，请不要使用 AS。

请将显示名称指定为带引号的字符串。如果您希望列标题包含换行符，请在单词之间使用分号 (;)。

LINE 数字域列表

可选

在每个记录的输出中使用多个行：

数字行号，必须介于 2 和 60 之间（包括这两个值）
域列表要包括在该行上的域

TO SCREEN | 文件名| PRINT

可选

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

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

UNFORMATTED

可选

输出被显示为非格式化文本。输出与 EXPORT ASCII 命令创建的输出相同。无格式数据可输出到文件，以供其他软件程序进一步处理。

IF 测试

可选

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

说明

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

WHILE 测试

可选

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

说明

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

FIRST 范围 | NEXT 范围

可选

要处理的记录数：

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

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

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

HEADER 头文本

可选

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

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

FOOTER 尾文本

可选

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

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

SKIP 行

可选

将指定数量的空白行插入到列表中的各个记录之间。例如，LIST ALL SKIP 1 生成两倍行距列表（每条记录之间有一个空白行）。

EOF

可选

在到达文件末尾之后，再执行该命令一次。

当位于 GROUP 命令内部时，这可以确保表中的最后一个记录得到处理。请仅当所有域为引用较早记录的计算域时才使用 EOF。

APPEND

可选

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

示例

列出例外项并保存到文本文件

您使用 LIST 创建一个报告，以列出在库存表中识别的例外。该报告被另存为文本文件：

LIST 产品编号 描述 数量 单位成本 值 IF 数量 < 0 OR 单位成本 < 0 HEADER "负值" TO "Exceptions.txt"

备注

何时使用 LIST

使用 LIST 可打印数据，在屏幕上显示数据，或者将数据导出到文本文件。

格式化和合计

除非您指定 UNFORMATTED，否则以下信息会被自动包括在内：

页码
日期
时间
用户身份
列标题

另外还会自动合计数值列。