EAS扩展脚本编写指南.doc

定制平台系列

扩展脚本编写指南

简介
扩展脚本运行引擎为Rhino，基于javascript语法，运行期解释执行。jvm中的类的方法和属性均可应用于脚本中，调用方式类似于java代码编写。
比如下面一段脚本：
//客户端设置编码规则脚本
vareasNames=JavaImporter();
easNames.importPackage(Packages.com.kingdee.eas.base.codingrule);
with(easNames){
vareditData=pluginCtx.getDataObject();
varbizOrgUnit=pluginCtx.getKDBizPromptBox("prmtSaleOrgUnit").getValue();
varnumber=CodingRuleManagerFactory.getRemoteInstance().getNumber(editData,bizOrgUnit.getId());
pluginCtx.getKDTextField("txtNumber").setText(number);
}其中
vareasNames=JavaImporter();
easNames.importPackage(Packages.com.kingdee.eas.base.codingrule);引入包com.kingdee.eas.base.codingrule，CodingRuleManagerFactory属于该包中的内容，但其处在with(easNames){…}中，所以不需要指定其全路径，即可调用getRemoteInstance()方法。如果没使用with指定作用域，则必须使用全名称（包名+类名）。

变量的定义声明遵循javascript语法，接口实现使用function声明。比如给一些控件增加监听器：
//F7控件增加值改变监听
pluginCtx.getKDBizPromptBox("prmtHROrg").addDataChangeListener(function(event)
{
java.lang.System.out.println("DATACHANGED:"+event.getOldValue()+"$$$$"+event.getNewValue());
});
//KDTable增加表格编辑事件监听
pluginCtx.getKDTable("kdtEntrys").addKDTEditListener(function(event,methodName){
if(methodName=="editStopped")
{
com.kingdee.eas.util.client.MsgBox.showInfo("$$$$$EditStopped");
}
});

上下文
扩展脚本中封装了两种上下文，插件上下文（pluginCtx）和方法上下文（methodCtx）。这两种上下文为系统内置，无需额外的声明或获取。
pluginCtx主要存放当前执行环境的相关信息，比如服务端的Context，客户端的界面控件、界面状态、编辑对象等。methodCtx存放当前操作的相关信息，包含方法参数和方法返回值。

插件上下文：
客户端和服务端的插件上下文存储的内容不一样，实现方式上，其分别对应于两个java类，com.kingdee.eas.ep.app.BeanParam和com.kingdee.eas.ep.client.UIParam。这两个类中的方法均可以在脚本中直接使用。

上下文都存在get和put方法。脚本中直接使用get(key)获取值，put(key,value)设置值。

服务端通过pluginCtx.getContext()获取服务端上下文，比如：
//服务端更新单据状态
varimp=JavaImporter();
imp.importPackage(Packages.com.kingdee.eas.util.app);
with(imp){
varctx=pluginCtx.getContext();
varbillId=methodCtx.getParamValue(0);
varsql="updateT_SD_SALEORDERSETFBASESTATUS="+status+"WHEREFID='"+billId+"'";
DbUtil.execute(ctx,sql);
}
客户端插件上下文封装了部分常用的内容，具体如下：
//获取界面上下文
java.util.MapgetUIContext()

//获取组织上下文
com.kingdee.bos.ContextgetMainOrgCon