命令选项

使用命令选项卡中的选项来指定 Analytics 执行命令的方式。

自动执行命令

如果您启用此选项，则 Analytics 会立即使用视图中的选定域作为输入以执行某些命令。您无法编辑该命令或应用本地过滤器。该选项仅适用于某个命令，并且选定的输入域必须具有该命令需要的数据类型。

自动输出文件名

如果您启用此选项，则 Analytics 会为命令输出文件自动生成名称。自动生成的名称包含命令名称和一个从 01 开始的递增数字。您可以接受该名称，或者指定一个更有意义的名称。

使用输出表

如果您启用此选项，则默认情况下选择位于创建表的命令对话框中的使用输出表复选框。选择该复选框后，当您执行命令时，Analytics 会自动关闭活动表并打开该命令创建的表。如果您不希望输出表打开，则可以在运行命令后取消选择该复选框。

在日志中显示组测试

当您运行脚本时，此选项会影响组结果出现在命令日志中的显示方式。Analytics 在应用测试的命令的旁边显示 If、While、For 和 Next 测试的组结果。因为组中的一个以上测试可以应用于每个命令，所以语法可能变得非常长。

如果您禁用此选项，则 Analytics 在运行脚本时不显示测试。

对该设置的更改通过以下语法记录在日志中：

SET TEST {ON|OFF}

禁止以 XML 格式输出命令结果

选择此选项后，屏幕上的命令输出将以纯文本而不是格式化文本形式显示。

对该设置的更改通过以下语法记录在日志中：

SET SUPPRESSXML {ON|OFF}

为空域返回匹配值

此选项控制 Analytics 如何解释 null 字符值。字符值在为空且不包含数据时为“null”。例如，NAME="" 是一个具有 null 字符值的表达式：在引号之间没有任何内容。

选择此选项后，Analytics 会将 null 解释为通配符。例如，视图过滤器 NAME = "" 在 NAME 域中显示具有任何值的记录。

如果不选择此选项，则 Analytics 会将 null 照字面解释为 null。例如，视图过滤器 NAME = "" 只显示在 NAME 域中没有任何数据的记录。

自动计数筛选的记录

如果选中此选项，则当您将过滤器应用于视图时，Analytics 会自动统计剩余记录的数量。这个数字会显示在 Analytics 界面底部的状态栏中。例如，如果在对包含 772 条记录的表应用了过滤器之后剩余 588 条记录，则会显示：记录：588/772

已过滤的记录的自动计数只是一项用户界面功能，这个结果不会保存到日志中。这项功能适用于最多包含一百万条记录的表。若要统计包含超过一百万条记录的表中过滤后的记录数量，则需要手动执行 count 函数运算。

间隔

此选项指示默认情况下为层理或直方图选择的间隔数量。请输入一个从 1 到 255 的数字。默认值为 10。

错误限制

此选项设置 Analytics 默认情况下经过多少个错误才会停止处理 Sequence 或 Verify 命令。请输入一个从 1 到 255 的数字。默认值为 10。

重试命令尝试次数

说明

仅适用于 Analytics 脚本。不适用于 Analytics 用户界面。

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

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

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

对该设置的更改通过以下语法记录在日志中：

SET RETRY 数字

重试命令尝试次数适用于以下命令。

命令类别 特定命令
导入
  • ACCESSDATA
  • IMPORT GRCPROJECT
  • IMPORT GRCRESULTS
  • REFRESH

    （仅限于最初使用 ACCESSDATA 或 IMPORT SAP 创建的表）
SAP (Direct Link)
  • IMPORT SAP
  • RETRIEVE
导出
  • EXPORT . . . ACLGRC

    （导出到 Diligent One 结果应用程序）

最大类别数

此选项指定在被用作培训命令输入的字符键域中可以出现的唯一值的最大个数。请输入一个从 1 到 255 的数字。

“通知”设置

重试次数

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

“通知”操作未能发送电子邮件的一个可能的原因是电子邮件服务器不可用。

重试间隔（秒）

此选项指定在初始失败之后额外尝试发送电子邮件的时间间隔。请输入一个从 1 到 255 的数字。默认值是 10 秒钟。

如果通知失败，则停止脚本

如果您启用此选项，则 Analytics 会在“通知”操作失败后停止处理脚本。脚本在初始失败之后停止，或者如果尝试皆未成功，则在指定数量的重试尝试之后停止。默认设置为“关闭”，这样，即使“通知”操作失败，脚本也可以继续执行。

无论如何设置如果通知失败，则停止脚本，都不会将无效的电子邮件收件人视为“通知”操作的失败，并且不会导致脚本停止执行。