EAS扩展脚本编写指南.doc

定制平台系列
扩展脚本编写指南
简介
扩展脚本运行引擎为Rhino,基于javascript语法,运行期解释执行。jvm中的类的方法和属性均可应用于脚本中,调用方式类似于java代码编写。
比如下面一段脚本:
//客户端设置编码规则脚本
var easNames = JavaImporter();
(.);
with(easNames){
var editData = ();
var Unit= ("Unit").getValue();
var number = ().getNumber(editData, ());
("txtNumber").setText(number);
}
其中
var easNames = JavaImporter();
(.);
.,CodingRuleManagerFactory 属于该包中的内容,但其处在with(easNames){ …}中,所以不需要指定其全路径,即可调用getRemoteInstance()方法。如果没使用with指定作用域,则必须使用全名称(包名+类名)。
变量的定义声明遵循javascript语法,接口实现使用function声明。比如给一些控件增加监听器:
//F7控件增加值改变监听
("").addDataChangeListener(function (event)
{
("DATA CHANGED:" +() + "$$$$" + ());
});
//KDTable增加表格编辑事件监听
("kdtEntrys").addKDTEditListener(function(event,methodName){
if(methodName == "editStopped")
{
("$$$$$EditStopped");
}
});
上下文
扩展脚本中封装了两种上下文,插件上下文(pluginCtx)和方法上下文(methodCtx)。这两种上下文为系统内置,无需额外的声明或获取。
pluginCtx主要存放当前执行环境的相关信息,比如服务端的Context,客户端的界面控件、界面状态、编辑对象等。methodCtx存放当前操作的相关信息,包含方法参数和方法返回值。
插件上下文:
客户端和服务端的插件上下文存储的内容不一样,实现方式上,...。这两个类中的方法均可以在脚本中直接使用。
上下文都存在get和put方法。脚本中直接使用get(key)获取值,put(key,value)设置值。
()获取服务端上下文,比如:
//服务端更新单据状态
var imp = JavaImporter();
(.);
with(imp){
var ctx = ();
var billId = (0);
var sql = "update T_SD_SALEORDER SET FBASESTATUS = " + status + " WHERE FID = '"+billId+"'";
(ctx, sql);
}
客户端插件上下文封装了部分常用的内容,具体如下:
//获取界面上下文
getUIContext()
//获取组织上下文
Context()
//获取界面状态,比