Script 1.8.1

scriptRun

原型:

scriptRun(name, scriptFile)

描述:

运行指定脚本文件,通过该函数可以实现同时运行多脚本的目的。脚本文件可为 JS 文件,也可为 SCP 文件。

参数:

name: 别名,该脚本运行的别名。
scriptFile:脚本文件路径。可以使用文件绝对路径,也可使用相对于 TC 脚本默认路径的相对路径。

关于脚本路径的具体说明:
1.绝对路径:指定scriptFile的绝对路径

2.相对路径:相对路径有两种,一个是用户预定义路径,另一个是TC脚本缺省路径
a)用户预定义路径:
i.如果用户的脚本中有如下定义:
i.define('scriptPath', 'c:\\...');
ii.则会到scriptPath对应的路径下寻找脚本,然后执行。

b)TC脚本缺省路径:
i.如果用户的脚本中未定义scriptPath,则会查找<我的文档>/Scripts下是否有对应JS或SCP文件,如有,则执行,如无,进入下一个选项
ii.其次,查找%appdata%\Sigma-RT\Total Control\Scripts下是否有对应JS或SCP文件,如有,则执行,如无,则报错

注意,脚本路径的具体执行顺序如下:
如果是绝对路径,直接执行。
如果自定义了脚本路径,则检查该脚本路径下脚本文件是否存在,若存在,则执行;若不存在,则报错,错误是:找不到该脚本文件。
如果未自定义脚本路径,则先找”我的文档”/scripts下是否有该文件,若存在,则执行;若不存在,继续到”%appdata%/\Sigma-RT\Total Control\Scripts\下找是否有该文件,若存在,则执行;若不存在,则报错,错误是:找不到该脚本文件。

返回值:

>0 : 运行ID值
<=0: 失败
异常:lastError();

示例:
// 运行绝对路径指定的脚本文件
scriptRun('checkImage', 'd:/checkImage.js');
// 运行TC脚本默认路径下的脚本文件
scriptRun('runApp', 'runAppjs.js'); //运行目录:/此电脑/文档/Scripts/runAppjs.js
// 运行用户指定路径目录
define('scriptPath', 'd:/');
scriptRun('runApp', 'runApk.js'); //运行目录:d:/runApk.js