SET 命令

SET BEEP 数值

SET BEEP 2

指定命令处理完成后发出蜂鸣音的次数。

数值参数必须在 1 和 255 之间。

SET CENTURY 数值

SET CENTURY 40

指定两位数年份格式的世纪起点年份。

数值参数必须是 0 到 99。

将世纪起点值设置为 40 意味着两位数的年份 40 到 99 被解释为 1940 到 1999，而两位数的年份 00 到 39 被解释为 2000 到 2039。

SET CLEAN {ON | OFF}

SET CLEAN ON

如果启用此选项，则 Analytics 会将无效字符数据替换为空白，将无效数值数据替换为 0。

SET DATE <TO> {0 | 1 | 2 | 字符串}

SET DATE "YYYY/MM/DD"

指定 Analytics 在视图、报告和导出的文件中显示日期以及日期时间的日期部分的方式。

• SET DATE 0 将日期设置为 MM/DD/YYYY 格式

• SET DATE 1 将日期设置为 MM/DD/YY 格式

• SET DATE 2 将日期设置为 DD/MM/YY 格式

• SET DATE "<字符串>" 将日期设置为您指定的自定义格式

  在使用 SET DATE 命令指定自定义日期格式时，您必须对日使用 'D'，对月使用 'M'，对年使用 'Y' ，即使您已经在选项对话框中指定了不同的日期格式字符。例如：

  SET DATE "DD MMM YYYY"

SET DELETE_FILE {ON | OFF}

SET DELETE_FILE ON

默认设置：OFF

指定 ON 可在您删除表布局时自动删除关联数据文件。

指定 OFF 可避免在您删除表布局时删除关联数据文件。

您必须在 DELETE_FILE 中包括下划线 ( _ ) 。

在命令行指定不带任何参数的 SET DELETE_FILE 时，会显示 DELETE_FILE 当前是打开还是关闭。

SET DESIGNATION 值

SET DESIGNATION "Produced by ABC Corporation"

值参数是带引号的字符串，用于指定在每个打印页面顶部显示的标签。

SET ECHO {ON | NONE}

SET ECHO NONE
脚本中的 COM 命令和结果被从日志中排除。
SET ECHO ON

指定 NONE 可停止将脚本中的命令和结果写入 Analytics 命令日志。指定 ON 可恢复日志记录。

SET ECHO 命令仅适用于脚本中的命令和结果日志记录。通过用户界面执行或从命令行发出的命令及其产生的任何结果始终被记录下来，而无论您如何设置 ECHO。

您可以在脚本中或从命令行发出 SET ECHO NONE/ON 命令，但是无论您是在哪里发出该命令，它都只影响脚本中命令和结果的日志记录。

在命令行指定不带任何参数的 SET ECHO 时，会显示在脚本中记录命令和结果的功能当前是打开还是关闭。

SET EXACT {ON | OFF}

SET EXACT ON

默认设置：OFF

控制 Analytics 比较字符域、表达式或字面量值的方式。

• SET EXACT 为 OFF Analytics 在比较两个长度不相等的字符串时使用较短的字符串。比较从最左侧的字符开始并向右移动。

  例如，"AB" 等于 "AB"，而且还被认为等于 "ABC"。

• SET EXACT 为 ON 比较字符串必须完全相同才能形成匹配。在比较两个长度不相等的字符串时，Analytics 用后继空格填充较短的字符串，以匹配较长字符串的长度。

  例如，"AB" 等于 "AB"，但它不会被视为等于 "ABC"。

有关说明 SET EXACT 的更多示例，请参见“表”选项卡（“选项”对话框）中的“精确字符比较”。

您可以使用 ALLTRIM( ) 函数移除前导和后继空格，并且确保只对文本字符和内部空格进行比较。

例如：当这些值被用 ALLTRIM( ) 包裹时，ALLTRIM(" AB") = ALLTRIM("AB") 为真，否则为假。

一些 Analytics 命令和函数受到 SET EXACT 的影响，而另一些则不会受影响：

SET FILTER <TO> {测试|过滤器名称}

SET FILTER TO 产品编号 = "070104347"

SET FILTER TO ProdNoFilter

在打开的表上创建一个全局过滤器（视图过滤器），并且指定一个逻辑测试或者现有已保存过滤器的名称。

指定不带任何参数的 SET FILTER 可从打开的表中删除任何过滤器。

SET FOLDER 文件夹路径

为命令输出指定概览选项卡的 Analytics 项目文件夹。默认输出文件夹为包含活动表的文件夹。

这是使用 /文件夹名/子文件夹名格式的 DOS 样式路径，其中，起始斜杠 (/) 表示概览选项卡中的根级别。您必须指定完整文件路径。

• SET FOLDER /表/结果 将输出文件夹设置为“结果”子文件夹。如果“结果子文件夹”不存在，则创建它。

• SET FOLDER / 将输出文件夹设置为概览选项卡中的根级别。

• SET FOLDER 将输出文件夹设置为默认文件夹（包含活动表的文件夹）

输出文件夹按照您的设置保持，除非您重设或关闭项目。打开项目时，输出文件夹还原成活动表文件夹的默认状态。

SET FORMAT {ON | OFF}

SET FORMAT ON

默认设置：OFF

如果使用 ON 参数，Analytics 会在您打开新表时自动显示当前表布局和计算域定义。结果将显示在命令日志中。

SET FUZZYGROUPSIZE <TO> 数值

SET FUZZYGROUPSIZE TO 10

指定在输出结果中可显示在模糊重复组中的条目最大值。数值参数不能小于 2 或大于 100。默认大小为 20。指定的大小在 Analytics 会话持续期间保持有效。

SET GRAPH 类型

SET GRAPH LINE

指定所有后续生成图表要使用的图表类型。命令运行必须与指定图表类型兼容。例如，BENFORD 命令不能生成 PIE2D 或 PIE3D 图。如果指定了不兼容图表类型，则使用默认图表类型 (BAR3D)。

类型参数必须是以下之一：

• PIE2D

• PIE3D

• BAR2D

• BAR3D – 这是默认图表类型。

• STACKED2D

• STACKED3D

• LAYERED

• LINE

• BENFORD – 结合 2D 条形图和 2D 线形图。

SET HISTORY <TO> 数值

SET HISTORY TO 50

指定要保留的表历史记录条目的最大值。值参数必须在 1 和 100 之间。

SET INDEX <TO> 值

SET INDEX TO "CustomerCode.INX"

指定要应用到活动表的索引。

SET LEARN <TO> 脚本

SET LEARN TO InventoryRec

指定脚本记录器用来记录命令的脚本文件的名称。

SET LOG <TO> {文件 | OFF}

SET LOG TO "analysis.log"

SET LOG OFF

第一个命令将日志记录切换到指定的日志。如果指定的日志不存在，则创建它。

第二个命令将日志记录恢复到原始 Analytics 命令日志。

SET LOOP <TO> 数值

SET LOOP TO 20

指定 LOOP 命令在被终止前可以执行的最大循环数。

数字范围介于 0 到 32767 之间，其中 0 用于关闭循环测试。

SET MARGIN 边缘 <TO> 值

SET MARGIN TOP TO 100

为边缘参数指定左、右、上或下。如果要更改所有边缘的边距，则需使用独立的 SET MARGIN 命令指定每个边距。指定值 100 会创建 1 英寸的边距。

SET MATH <TO> {FIRST | LAST | MIN | MAX}

SET MATH TO MIN

默认设置：MAX

指定在数值表达式中评估两个运算数时，小数精度如何工作。

• FIRST 使用运算数对中的第一个运算数的小数位数
• LAST 使用运算数对中的最后一个运算数的小数位数
• MIN 使用运算数对中的最小小数位数
• MAX 使用运算数对中的最大小数位数

在多运算数表达式中，SET MATH 设置在成对基础上工作，将指定的设置应用于每个运算数对，并且在按照标准数学顺序 (BOMDAS) 评估它们的过程中根据需要取整。

如果 SET MATH 设置减少结果中的小数位数，则结果被取整，而不是被截断。

有关详细信息，请参见控制数值表达式中的取整和小数精度。

SET MONTHS <TO> 字符串

指定月份名称的默认 3 字符缩写。字符串参数是以逗号分隔的月份缩写列表。

SET NOTIFYFAILSTOP {ON | OFF}

SET NOTIFYFAILSTOP ON

默认设置：OFF

• NOTIFYFAILSTOP 为 OFF 即使脚本中的 NOTIFY 命令失败，Analytics 也允许该脚本继续执行。
• NOTIFYFAILSTOP 为 ON 如果脚本中的 NOTIFY 命令失败，则 Analytics 会停止处理该脚本，并且向日志中写入一条消息。脚本在初始失败之后停止，或者如果尝试皆未成功，则在指定数量的 NOTIFYRETRYATTEMPTS 之后停止。

SET NOTIFYRETRYATTEMPTS <TO> 数量

SET NOTIFYRETRYATTEMPTS TO 10

指定 NOTIFY 命令在初始尝试不成功之后尝试发送电子邮件的次数。输入一个从 0 到 255 的数字。如果您输入 0，则在初始失败之后不再进行附加尝试。默认值为 5。

NOTIFY 命令未能发送电子邮件的一个可能的原因是电子邮件服务器不可用。

SET NOTIFYRETRYINTERVAL <TO> 秒数

SET NOTIFYRETRYINTERVAL TO 30

指定各个 NOTIFYRETRYATTEMPTS 之间的间隔时间（秒）。请输入一个从 1 到 255 的数字。默认值是 10 秒钟。

SET ORDER <TO> 数值

指定字符域的排序顺序。数值参数列出选定排序顺序的所有字符。

SET OVERFLOW {ON | OFF}

SET OVERFLOW OFF

默认设置：ON

如果指定 OFF，则 Analytics 在发生溢出错误时不会停止处理。

SET PASSWORD 数字 <TO> 字符串

SET PASSWORD 1 TO "password123"

用于为无人看管方式下的脚本执行创建密码定义和指定密码值。

数值参数唯一标识密码定义，并且必须是从 1 到 10 的值。请将密码值指定为带引号的字符串。

SET PERIODS <TO> 值 <,...n>

SET PERIODS TO "0,30,90,180,10000"

指定 AGE 命令所用的默认帐龄分析周期。

SET PICTURE 格式

SET PICTURE "(9,999,999.99)"

指定数值类型值的默认格式。

SET READAHEAD <TO> 大小

指定读取数据块的大小。只有当“支持”建议您更改此设置时，方可这样做。

SET RETRY <TO> 数字

SET RETRYIMPORT <TO> 数字

SET RETRY TO 50

指定 Analytics 在初始尝试不成功时尝试导入或导出数据的次数。输入一个从 0 到 255 的数字。如果您输入 0，则在初始失败之后不再进行附加尝试。默认值为 0。

在重试尝试之间没有等待期。在之前的失败之后立即进行各个后继尝试。

当连接到可能暂时不可用的数据库或云数据服务时，指定重试尝试次数的能力是有用的。

适用于下列命令：

• ACCESSDATA
• IMPORT GRCPROJECT
• IMPORT GRCRESULTS
• IMPORT SAP
• RETRIEVE
• REFRESH

  （仅限于最初使用 ACCESSDATA 或 IMPORT SAP 创建的表）

• EXPORT . . . ACLGRC

  （导出到 HighBond 结果应用程序）

SET SAFETY {ON | OFF}

SET SAFETY OFF

指定 ON 可在覆盖下列任一项时显示确认对话框：

• 表布局中的域

• Analytics 表

• 文件，包括 Analytics 数据文件 (.fil)

指定 OFF 可防止显示对话框。

在命令行指定不带任何参数的 SET SAFETY 时，将显示 SAFETY 当前是打开还是关闭。

SET SEPARATORS <TO> 值

SET SEPARATORS TO ".,,"

指定 Analytics 使用的默认小数位、千位和列表分隔符。SET SEPARATORS 值必须为采用如下次序的三个有效分隔符字符：

• 小数位（句号、逗号或空格）

• 千位（句号、逗号或空格）

• 列表（分号、逗号或空格）

在这三个分隔符中，小数位分隔符必须唯一。在使用命令时，您必须指定全部三个分隔符。列表分隔符主要用于分隔函数参数。

SET SESSION <会话名称>

SET SESSION

SET SESSION "分析"

在 Analytics 命令日志中创建一个新会话。该会话由当前时间戳标识。

可选的会话名称使您可以添加多达 30 个字符的附加标识信息。允许但不需要引号。

SET SORTMEMORY 数值

SET SORTMEMORY 800

指定为排序和建立索引过程所分配的最大内存值。数值必须是 0 到 2000 兆字节 (MB) 之间的数值，输入的增量为 20MB。如果排序内存设置为 0，Analytics 会使用当前可用内存。

SET SUPPRESSTIME {ON | OFF}

SET SUPPRESSTIME ON

默认设置：OFF

仅在定义使用 ODBC 数据源（IMPORT ODBC 命令）或直接数据库访问（DEFINE TABLE DB 命令）的 Analytics 表时使用。

如果您使用 ON 参数，则在定义表时，Analytics 会隐藏日期时间值的时间部分。例如，20141231 235959 被读取和显示在视图中，并且随后被处理为 20141231。

如果在假定日期时间数据的时间部分将被截断的尚未采用日期时间的 Analytics 脚本（低于 v.10.0）中包括此命令，将使该脚本可在支持日期时间的 Analytics 版本中运行。

Analytics 通过只使用日期时间格式的日期部分来隐藏时间部分。时间数据仍然出现在 .fil 文件或数据库表中。如果需要，您可以重新定义域或定义新的域以包括该数据的时间部分。

如果 SET SUPPRESSTIME = OFF，则使用 ODBC 或直接数据库访问定义的 Analytics 表将包括完整的日期时间值。

您可以在脚本中或从命令行发出 SET SUPPRESSTIME ON/OFF 命令。

在命令行指定不带任何参数的 SET SUPPRESSTIME 时，将显示隐藏日期时间数据的时间部分的功能当前是打开还是关闭。

SET SUPPRESSXML {ON | OFF}

SET SUPPRESSXML ON

默认设置：OFF

指定命令输出将是纯文本形式，而不是带格式的文本形式。

SET TEST {ON | OFF}

SET TEST ON

指定与 GROUP 命令关联的 IF、WHILE、FOR 和 NEXT 测试的结果是否应记录在日志中。

SET TIME <TO> 字符串

SET TIME "hh:mm:ss PM"

指定 Analytics 在视图、报告和导出的文件中显示日期时间的时间部分和独立时间值的方式。

在使用 SET TIME 命令指定时间格式时，您必须使用“h”代表小时，使用“m”代表分钟，使用“s”代表秒钟，即使您已经在选项对话框中指定不同的日期格式字符，也是如此。例如：

SET TIME TO "hh:mm"

SET UTCZONE {ON | OFF}

SET UTCZONE OFF

默认设置：ON

• UTCZONE 为 ON Analytics 会将带有 UTC 偏移量的本地时间的显示更改为本地时间的 UTC 等效值。（UTC 为协调世界时，即经度为零处的时间）。
• UTCZONE 为 OFF Analytics 会显示带有 UTC 偏移量的本地时间，而不会将其转换为 UTC。

例如：

• 01 一月 2015 04:59:59 (SET UTCZONE ON)
• 31 十二月 2014 23:59:59-05:00 (SET UTCZONE OFF)

将本地时间转换为 UTC 只是为了进行显示，不会影响源数据。您可以在两个不同的显示模式之间任意切换。

SET VERIFY {ON | OFF | BLANK}

SET VERIFY ON

如果指定为 ON，Analytics 会自动检查数据域的内容是否与表布局（不论表何时打开）中的域数据类型一致。如果指定 BLANK，则除了所述的与 ON 参数有关的验证以外，Analytics 还会将无效字符数据替换为空白，将无效数值数据替换为零。

SET WIDTH <TO> 字符数

SET WIDTH TO 20

指定当 Analytics 无法确定最大宽度时数值计算域或临时数值表达式的默认显示宽度（单位为字符）。