DEP扩展脚本编写指南.docVIP

动态扩展平台扩展脚本编写指南 EAS产品部技术架构部 贺召军 导读 阐述基于动态扩展平台DEP开发的扩展脚本编写指南和相关注意事项，通过本规范指导开发工作。 适用读者 实施人员、现场二次开发人员、研发中心客户化开发人员。 适用范围 金蝶 EASV7.0SP1。  简介 3 指定作用域 3 变量 4 函数 4 使用扩展脚本 5 第一章 上下文 5 1.1插件上下文（pluginCtx） 5 1.1.1获取服务端上下文 6 1.1.2获取客户端上下文 7 1.1.3获取界面控件 7 1.2方法上下文（methodCtx） 8 1.2.1获取方法参数 8 1.2.2获取方法返回值 8 1.2.3设置方法返回值 8 1.2.4方法上下文常用方法 8 1.3快速插入上下文脚本 9 第二章 调用业务方法 9 2.1调用方式 10 2.1.1客户端调用业务方法方式 11 2.1.2服务器端调用业务方法方式 13 2.2快速插入业务方法调用 13 第三章 自定义异常 14 3.1定义自定义异常 14 3.2脚本中调用自定义异常 14 3.2.1服务器端调用异常方式 14 3.2.2客户端异常调用方式 15 3.3快速插入自定义异常调用 15 第四章 自定义基础资料或单据 16 4.1 获取自定义基础资料和单据远程接口 16 4.2 传入参数 17 4.3 返回值类型 18 4.4 示例脚本 19 第五章 给常用控件添加事件 20 5.1 F7 20 5.2 CheckBox 21 5.3 ComboBox 21 5.4 Button 21 5.5 TextFiled 21 5.6 Tree 23 5.7 TabledPane 23 5.8 Table 23 第六章 使用函数库 24 6.1 定义函数库 24 6.2 使用函数库 26 第七章 打点提示——快速编写脚本 27 7.1环境准备 27 7.2使用打点提示 29 第八章 调试脚本 29 8.1 调试准备 29 8.1.1 客户端调试 29 8.1.2服务器端调试 30 8.2 进行调试 31 8.2.1 变量查看 32 8.2.2 使用脚本控制台 32 8.3 监听事件方法内部调试 33 8.4 调试完成 33 第九章 常见问题 34 9.1 在脚本里添加里添加了监听器，在代码里删除监听器的时候的报中断错误 34 9.2 扩展脚本不能调用当前类的private方法，不能用super来调用父类方法 35 9.3 扩展脚本中不能使用强制类型转换 35 附录一 关于Rhino 37 Rhino语法简介 37 历史简介 37 JavaScript 中的 Java 38 Rhino和java语言的具体区别 39 数组 39 联合数组 39 通过属性进行循环 40 正则表达式 40 函数显式声明 41 添加方法 42 添加更多的方法 42 使用原型 43 无类编码 43 基于类的语言与基于原型的语言的比较 44 附录二 案例脚本 45  简介 扩展脚本运行引擎为Rhino，基于javascript语法，运行期解释执行。jvm中的类的方法和属性均可应用于脚本中，调用方式类似于代码调试。 比如下面一段脚本： //客户端设置编码规则脚本 //定义引入变量 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()); //设置TextField编码 pluginCtx.getKDTextField(txtNumber).setText(number); } 指定作用域 在示例代码中 var easNames = JavaImporter(); easNames.importPackage(P.kingdee.eas.base.codingrule); 和java中import类似，这里使用JavaImporter()的im