EAS扩展脚本编写指南汇.docVIP

定制平台系列 扩展脚本编写指南 简介 扩展脚本运行引擎为Rhino，基于javascript语法，运行期解释执行。jvm中的类的方法和属性均可应用于脚本中，调用方式类似于java代码编写。 比如下面一段脚本： //客户端设置编码规则脚本 var easNames = JavaImporter(); easNames.importPackage(P.kingdee.eas.base.codingrule); with(easNames){ var editData = pluginCtx.getDataObject(); var bizOrgUnit= pluginCtx.getKDBizPromptBox(prmtSaleOrgUnit).getValue(); var number = CodingRuleManagerFactory.getRemoteInstance().getNumber(editData, bizOrgUnit.getId()); pluginCtx.getKDTextField(txtNumber).setText(number); } 其中 var easNames = JavaImporter(); easNames.importPackage(P.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(DATA CHANGED: +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()获取服务端上下文，比如： //服务端更新单据状态 var imp = JavaImporter(); imp.importPackage(P.kingdee.eas.util.app); with(imp){ var ctx = pluginCtx.getContext(); var billId = methodCtx.getParamValue(0); var sql = update T_SD_SALEORDER SET FBASESTATUS = + status + WHERE FID = +billId+; DbUtil.execute(ctx, sql); } 客户端插件上下文封装了部分常用的内容，具体如下： //获取界面上下文 java.util.Map getUIContext() //获取组织上下文 com.kingdee.bos.Context getMainOrgCon