TC程序的调用函数

报告测试进展与结果

针对用于测试的自动化程序，需要报告测试结果和测试进展，FWScript提供一套接口用于报告测试进展与结果，依据自动化测试的执行环境，BizAT将自动判断是否与服务器交互。

代码描述
@% update d
report d		报告测试进展与结果，依据d的值进行解释，1,2,3表示告诉服务器当前的执行结果为 PASS/FAIL/OMIT，0表示Omit步骤，后面跟两个整数, 4-9 都具有特殊的意义
@%0 omits begin，end设定Omit的区间
@%1 pass
reportpass		报告结果为Pass
@%2 fail str
reportfail str		报告结果为fail
@%3 omit
reportomit 		报告结果为omit
@%4 tellexitnext告知SUTAgent 转为执行下一步，一般要紧跟重启的 【无需保存环境】
@%5 TellProgress ReportProgress 报告当前执行次数已开始。后面可以跟一个整数或者变量，若没有值，则使用BizRunner里面的当前次数。
@%6 FlowOrder设定当前的执行次数。后面可以跟一个整数或者变量。（reboot）
@%7 ReportInfo报告当前的执行情况，后跟一个字符串，若为空，则使用特殊变量@的值
@%8 ReportErrorInfo报告出现的错误信息，后跟一个字符串，若为空，则使用特殊变量@的值
@%9 ReportError ReportErrorFlow报告出错所在的执行次数以及出错信息，使用BizRunner中的当前次数，后跟一个字符串，若为空，则使用特殊变量@的值
@^ ReportData 报告测试数据，后跟一个字符串或 < expr. （即使用表达式的值），若为空，则使用特殊变量@的值

服务器交互

要求服务器端要做的动作

代码描述实例
todo cmd param要求服务器端要做的动作@!1 start
todo cmd waitseconds,param要求服务器端等待一段时间后要做的动作@!1 20,start

告知SUTAgent的行为

当需要重启机器的时候，需要通知SUTAgent先退出来

代码描述
)d reboot, shutdown, logoff, winre 告诉SUTAgent，需要临时退出；BizRunner保存执行环境，同时自己启动关机重启命令，后跟一个数字d，则代表不同的关机的指令
@) TellExit 告诉SUTAgent，需要退出，而BizRunner 不做任何事情（即不保存环境）。由后续代码负责BizRunner的退出与重启（使用 ))d）
)( ToReboot 告诉SUTAgent，需要临时退出，而BizRunner 需要保存当前的环境，以便下次启动BizRunner时从)处开始运行。由后续代码负责bizrunner的退出与重启（使用 ))d）
@%4 TellExitNext告知SUTAgent转为执行下一次的循环，然后退出。由后续代码负责bizrunner的退出与重启（使用 ))d）
@| TellAbort @) TellExit ))d ireboot 告知SUTAgent已中止任务的运行，要求其退出；后面自己重启
@! ToDo 让服务器一定时间后执行动作

报告测试结束及最终结果

当测试结束的时候，报告给BizAT相关信息。

代码描述
@| TellAbort告诉SUTAgent，程序异常结束了
|| theend programexit程序执行正常结束了。相当于这个程序的执行自然结束
|! taskabort程序执行全部结束。针对于单次类型的feature，意味着后面无需再执行下去了
|$ NotReady报告SUTAgent, 当前执行的程序为测试条件检查程序，检查结果不满足条件
|? ScriptError报告SUTAgent, 出现了自动化程序脚本错误，或者程序执行出现了意想不到的情况