运行脚本

当在 Analytics 中运行脚本时，将按顺序运行脚本中的每个命令，直到脚本结束。

脚本运行时，无法继续在 Analytics 中工作，并且每次只可运行一个脚本。但是，使用 DO SCRIPT 命令可以创建可调用和运行其他脚本的脚本。

脚本状态

当脚本正在运行时，Analytics 在状态栏上显示脚本或子脚本的处理状态和名称。

当脚本完成运行时，状态栏中会显示一个图标，指示脚本成功运行至完成 还是失败 。如果脚本失败，则发生错误的行将自动突出显示 在脚本编辑器中。

如果需要，您可以通过按下 Esc 键或关闭 Analytics 来停止脚本的处理。

从主菜单运行脚本

有两种不同的从主菜单运行脚本的方式：

  • 应用程序菜单 从自定义菜单中选择特定的脚本名称

    有关详细信息，请参见向 Analytics 主菜单添加自定义条目。

  • “工具”选项 访问一个项目中所有脚本的精选列表
    1. 选择工具 > 运行脚本。
    2. 在执行脚本对话框中，从该项目中的可用脚本列表中选择要运行的脚本。
    3. 如果您想要指定一个要使该脚本运行而必须满足的条件，请执行下列操作之一：
      • 在如果文本框中输入一个逻辑表达式
      • 单击如果以使用表达式生成器创建一个逻辑表达式

        只对该逻辑表达式求值一次，以确定该脚本是否应该运行。如果表达式值为假，则不运行脚本。

    4. 单击确定。

从“概览”选项卡运行脚本

在导航器的概览选项卡中，右键单击树状视图中的脚本，然后选择运行。

从脚本编辑器中运行脚本

在脚本编辑器中打开该脚本，然后单击脚本编辑器工具栏中的运行 。

如果您已在脚本编辑器中对脚本进行了更改，则当您运行该脚本时，更改会被自动保存。

从 Windows 命令行中运行脚本

您可以从 Windows 命令行或者从批处理文件 (*.bat) 运行脚本，这使您可以使用诸如 Windows 任务调度程序之类的实用工具调度该脚本，并且以无人看管方式运行它。

命令行语法使用以下基本形式：

acl 可执行文件路径和文件名 acl 项目路径和文件名 </vVarName=值> /b脚本名称 </min>

示例

下面的命令行语法打开 Sample Project.ACL 并运行一个名为 Calculate_Median_Value 的脚本。

"C:\Program Files (x86)\ACL Software\ACL for Windows 14\ACLWin.exe" "C:\Users\用户名\Documents\ACL Data\Sample Data Files\Sample Project.ACL" /vv_table_name="Ap_Trans" /vv_field_name="Invoice_Amount" /bCalculate_Median_Value

命令行语法

说明

指定 Analytics 可执行文件和 Analytics 项目的完整路径（包括文件名和文件扩展名）。如果该路径包含任何空格，请使用引号将该路径围起来。

参数 详情和示例
"ACL 可执行文件路径和文件名"

指定 Analytics 可执行文件路径和可执行文件名称 (ACLWin.exe)。

"C:\Program Files (x86)\ACL Software\ACL for Windows 14\ACLWin.exe"
"ACL 项目路径和文件名"

指定 Analytics 项目文件的路径和包含该脚本的项目 (*.acl) 的文件名。

"C:\Users\用户名\Documents\ACL Data\Sample Data Files\Sample Project.ACL"

/v

可选

指定变量名称并分配值。当 Analytics 项目打开时，变量被自动初始化。

不要在 /v 开关和变量名称之间输入空格。例如，对于变量 v_table_name：

/vv_table_name="Ap_Trans"

说明

被分配的值的数据类型必须与该脚本中变量的数据类型匹配。如果数据类型不匹配，则发生“表达式类型不匹配”错误，并且该脚本失败。

请使用引号限定字符值，使用反引号限定日期时间值。

字符变量 

/vv_table_name="Ap_Trans" /vv_field_name="Invoice_Amount"

数值变量 

/vv_materiality=10000

日期时间变量 

/vv_start_date=`20180101` /vv_end_date=`20180331`
/b

指定要运行的脚本的名称。

不要在 /b 开关和脚本名称之间输入空格。

/bCalculate_Median_Value

/min

可选

 指定 Analytics 在打开时最小化。

有关创建以无人看管方式运行的脚本的准则

避免用户交互

请勿包括下列任一用户交互命令：

  • DIALOG
  • ACCEPT
  • PASSWORD
  • PAUSE

相反，请使用上面解释的命令行语法指定所需的任何变量，并且分配值。

禁用确认对话框

在脚本的开头添加 SET SAFETY OFF 命令，以便可以根据需要覆盖文件，而不显示确认对话框。请在脚本末尾添加 SET SAFETY ON 命令以恢复默认行为。

在 DELETE 或 RENAME 等通常显示确认对话框的任何命令之后添加 OK 参数。

退出 Analytics

用 QUIT 命令结束该脚本以退出 Analytics。

从 Windows 快捷方式运行脚本

您可以从 Windows 快捷方式运行脚本。

  1. 为 Analytics 创建快捷方式。
  2. 右键单击该快捷方式并选择属性。
  3. 在目标域中输入适当的命令行语法（参见上文）。
  4. 单击确定。
  5. 双击该快捷方式以运行脚本。