REPORT 命令

概念信息

基于打开的 Analytics 表格式化和生成报告。

语法

REPORT <ON 拆分域 <PAGE> <NODUPS> <WIDTH 字符数> <AS 显示名称>> <...n> FIELD 其他域 <WIDTH 字符数> <AS 显示名称> <...n> <SUPPRESS> <NOZEROS> <LINE n 其他域> <PRESORT <排序域>> <...n> <SUMMARIZED> <SKIP n> <EOF> <TO {SCREEN|PRINT|域名称  <HTML>}> 测试> <WHILE 测试> <FIRST 范围|NEXT 范围> <HEADER 头文本> <FOOTER 尾文本> <APPEND>

参数

名称	描述
ON 拆分域 PAGE NODUPS WIDTH 字符数 AS 显示名称 <...n> 可选	用来将该报告拆分为多个部分的一个或多个字符域。每当拆分域中的值更改时，都会创建一个新的报告节和小计。将报告拆分为多个节可使其更易于扫描。拆分域要用作拆分域的域要基于视图运行报告 (DO REPORT)，拆分域必须是视图中的最左侧字符域。 PAGE 在拆分域值更改时插入一个分页符 NODUPS 隐藏拆分域中的重复显示值例如，如果为每个发票记录列出客户名称，则可以通过仅列出每个客户名称的第一个实例提高报告的可读性。 WIDTH 字符数该域的输出长度（以字符为单位） AS 显示名称报告中的域的显示名称（备用列标题）请将显示名称指定为带引号的字符串。如果您希望列标题包含换行符，请在单词之间使用分号 (;)。如果您希望显示名称与域名称或源表中的现有显示名称相同，请不要使用 AS。说明您必须指定 ON 才能使用拆分域、PAGE、NODUPS 或 PRESORT。
FIELD 其他域 WIDTH 字符数 AS 显示名称 <...n>	要包括在报告中的域。 WIDTH 字符数该域的输出长度（以字符为单位） AS 显示名称报告中的域的显示名称（备用列标题）请将显示名称指定为带引号的字符串。如果您希望列标题包含换行符，请在单词之间使用分号 (;)。如果您希望显示名称与域名称或源表中的现有显示名称相同，请不要使用 AS。 SUBTOTAL 和 ACCUMULATE 关键字是 FIELD 的同义词，已被弃用。所有数值域都被自动小计。说明拆分域被自动包括在报告中，无须将其指定为其他域。
SUPPRESS 可选	从报告中排除空白详情行。
NOZEROS 可选	将域中的零值替换为空白值。例如，如果报告在某个域中包含大量零值，则如果该报告仅显示非零值，则其可读性会更高一些。
LINE n 其他域可选	指定该列中的输出行数和出现在行号 n 上的域。如果未指定值，则该列默认为单行列。n 的值必须在 2 和 60 之间（包括这两个值）。报告上的列标题完全由首行上的域确定。其他域指定适用于报告的相应域或表达式。
PRESORT `排序域` <...n> 可选	对拆分域进行排序（如果指定了一个或多个拆分域）。对`排序域`进行排序（如果指定了一个或多个排序域）。 PRESORT 不会对被列为其他域的域进行排序，除非它们还被列为`排序域`。
SUMMARIZED 可选	生成仅带小计和总计的报告，其中不带有细节行。小计是为唯一的拆分域值生成的。如果未指定 SUMMARIZED，则 Analytics 会生成包含明细行以及指定的每个键拆分域的小计的报告。
SKIP n 可选	在报告的详细信息行之间插入空白行。 n 必须是一个指定要插入的行数的整数。例如，SKIP 1 生成双倍行距报告。
EOF 可选	在到达文件末尾之后，再执行该命令一次。当位于 GROUP 命令内部时，这可以确保表中的最后一个记录得到处理。请仅当所有域为引用较早记录的计算域时才使用 EOF。
TO SCREEN \| PRINT\| 文件名 <HTML> 可选	要将命令结果发送到的位置：屏幕 – 在 Analytics 显示区域中显示结果提示您可以单击显示区域中的任何链接结果值以向下追溯到源表中的关联记录。文件名将结果保存至文件请将文件名指定为具有适当文件扩展名的带引号的字符串。例如：TO "Output.TXT" 默认情况下，该文件被保存到包含 Analytics 项目的文件夹。请使用绝对或相对文件路径将该文件保存到另外的现有文件夹： TO "C:\Output.TXT" TO "Results\Output.TXT" PRINT 将结果发送到默认打印机默认情况下，到文件的报告输出被保存为 ASCII 文本文件。如果您想要将该报告输出为 HTML 文件 (.htm)，请指定 HTML。如果您省略 TO，则该报告被输出到屏幕。
IF 测试可选	一个条件表达式，它必须为真以便处理每个记录。仅对满足条件的那些记录执行该命令。说明在应用任何范围参数（WHILE、FIRST、NEXT）之后，仅针对表中的剩余记录评估 IF 条件。
WHILE 测试可选	一个条件表达式，它必须为真以便处理每个记录。该命令被一直执行到条件的计算结果为假或者到达表的末尾为止。说明如果您将 WHILE 与 FIRST 或 NEXT 结合使用，请在达到一个限制时立即记下处理步骤。
FIRST 范围 \| NEXT 范围可选	要处理的记录数： FIRST 从第一个记录开始处理，直到达到指定的记录数为止 NEXT 从当前选定的记录开始处理，直到达到指定的记录数为止请使用范围指定要处理的记录数。如果您省略 FIRST 和 NEXT，则会默认处理所有记录。
HEADER 头文本可选	要在报告的每个页面的顶部插入的文本。必须将头文本指定为带引号的字符串。该值将覆盖 Analytics HEADER 系统变量。
FOOTER 尾文本可选	要在报告的每个页面底部插入的文本。必须将尾文本指定为带引号的字符串。该值将覆盖 Analytics FOOTER 系统变量。
APPEND 可选	将命令输出附加到现有文件的末尾，而不是覆盖现有文件。说明您必须确保命令输出的结构和现有文件完全相同：相同的域相同的域顺序匹配的域具有相同的长度匹配的域具有相同的数据类型 Analytics 将输出附加到现有文件，而无论其结构如何。如果输出的结构和现有文件不匹配，则可能生成混乱的、不完整的或不准确的数据。

名称

描述

ON 拆分域 PAGE NODUPS WIDTH 字符数 AS 显示名称 <...n>

可选

用来将该报告拆分为多个部分的一个或多个字符域。

每当拆分域中的值更改时，都会创建一个新的报告节和小计。将报告拆分为多个节可使其更易于扫描。

拆分域要用作拆分域的域
要基于视图运行报告 (DO REPORT)，拆分域必须是视图中的最左侧字符域。
PAGE 在拆分域值更改时插入一个分页符
NODUPS 隐藏拆分域中的重复显示值
例如，如果为每个发票记录列出客户名称，则可以通过仅列出每个客户名称的第一个实例提高报告的可读性。
WIDTH 字符数该域的输出长度（以字符为单位）
AS 显示名称报告中的域的显示名称（备用列标题）
请将显示名称指定为带引号的字符串。如果您希望列标题包含换行符，请在单词之间使用分号 (;)。如果您希望显示名称与域名称或源表中的现有显示名称相同，请不要使用 AS。

说明

您必须指定 ON 才能使用拆分域、PAGE、NODUPS 或 PRESORT。

FIELD 其他域 WIDTH 字符数 AS 显示名称 <...n>

要包括在报告中的域。

WIDTH 字符数该域的输出长度（以字符为单位）
AS 显示名称报告中的域的显示名称（备用列标题）
请将显示名称指定为带引号的字符串。如果您希望列标题包含换行符，请在单词之间使用分号 (;)。如果您希望显示名称与域名称或源表中的现有显示名称相同，请不要使用 AS。

SUBTOTAL 和 ACCUMULATE 关键字是 FIELD 的同义词，已被弃用。所有数值域都被自动小计。

说明

拆分域被自动包括在报告中，无须将其指定为其他域。

SUPPRESS

可选

从报告中排除空白详情行。

NOZEROS

可选

将域中的零值替换为空白值。

例如，如果报告在某个域中包含大量零值，则如果该报告仅显示非零值，则其可读性会更高一些。

LINE n 其他域

可选

指定该列中的输出行数和出现在行号 n 上的域。

如果未指定值，则该列默认为单行列。n 的值必须在 2 和 60 之间（包括这两个值）。

报告上的列标题完全由首行上的域确定。其他域指定适用于报告的相应域或表达式。

PRESORT 排序域 <...n>

可选

对拆分域进行排序（如果指定了一个或多个拆分域）。
对排序域进行排序（如果指定了一个或多个排序域）。

PRESORT 不会对被列为其他域的域进行排序，除非它们还被列为排序域。

SUMMARIZED

可选

生成仅带小计和总计的报告，其中不带有细节行。

小计是为唯一的拆分域值生成的。如果未指定 SUMMARIZED，则 Analytics 会生成包含明细行以及指定的每个键拆分域的小计的报告。

SKIP n

可选

在报告的详细信息行之间插入空白行。

n 必须是一个指定要插入的行数的整数。例如，SKIP 1 生成双倍行距报告。

EOF

可选

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

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

TO SCREEN | PRINT| 文件名 <HTML>

可选

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

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

默认情况下，到文件的报告输出被保存为 ASCII 文本文件。如果您想要将该报告输出为 HTML 文件 (.htm)，请指定 HTML。

如果您省略 TO，则该报告被输出到屏幕。

IF 测试

可选

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

说明

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

WHILE 测试

可选

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

说明

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

FIRST 范围 | NEXT 范围

可选

要处理的记录数：

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

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

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

HEADER 头文本

可选

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

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

FOOTER 尾文本

可选

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

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

APPEND

可选

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

说明

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

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

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

示例

生成 HTML 报告

您从 Ar 表生成一个报告，并将该报告输出至一个格式化的 HTML 文件：

OPEN 应收账款
REPORT ON No FIELD Due Type Amount TO "C:\Reports\AR.htm" HTML

REPORT 命令

语法

参数

示例

生成 HTML 报告

Page options

Is this page helpful?

Is this page helpful?