K/3 Cloud BOS 插件开发百问百答
修订记录 Ver. No V1.0 日期 20150428 编制\\修订 张晋博 校对 丁振华 批准 赖碧云 修改的章节号 初始版本，共39个问题 问题和意见 如果你对文档有任何意见、问题或想法，或者你的问题未在此文档中找到答案，请通过电子邮件联系我们
jinbo_zhang@kingdee.com
目录
K/3 Cloud BOS 插件开发百问百答 ................................................................................................. 1 1. 入门篇....................................................................................................................................... 4
1.1. 如何创建并启用各类插件 ....................................................................................... 4
1.1.1. 如何创建并启用动态表单插件 ....................................................................... 4 1.1.2. 如何创建并启用单据编辑插件 ....................................................................... 8 1.1.3. 如何创建并启用基础资料编辑插件 ............................................................... 9 1.1.4. 如何创建并启用列表插件 ............................................................................. 10 1.1.5. 如何创建并启用操作插件 ............................................................................. 11 1.1.6. 如何创建并启用账表取数插件 ..................................................................... 15 1.1.7. 如何创建并启用单据转换插件 ..................................................................... 18 1.1.8. 如何创建并启用反写插件 ............................................................................. 18 1.2. 为何插件不起作用，如何排查 ............................................................................. 20 2. 进阶篇..................................................................................................................................... 21
2.1. 插件代码，如何自行调用单据操作服务 ............................................................. 21
2.1.1. 如何加载(Load)单据 ....................................................................................... 21 2.1.2. 如何调用保存(Save)操作 ............................................................................... 25 2.1.3. 如何调用提交(Submit)操作 ........................................................................... 28 2.1.4. 如何调用审核/反审核(Audit/UnAudit)操作 ................................................. 31 2.1.5. 如何调用禁用(Disabled)操作 ........................................................................ 34 2.1.6. 如何删除(Delete)单据 .................................................................................... 37 2.2. 调用单据操作后，如何判断结果，并处理交互提示 ......................................... 40 2.3. 插件给字段赋值后，为什么不执行字段”值更新属性”上配置的表单服务 ...... 44 2.4. 在动态表单插件中，如何修改界面数据 ............................................................. 46
2.4.1. 如何新增单据体行 ......................................................................................... 46 2.4.2. 如何删除单据体行 ......................................................................................... 48 2.4.3. 如何给普通字段赋值 ..................................................................................... 49 2.4.4. 如何给基础资料字段赋值 ............................................................................. 50 2.4.5. 如何动态设置下拉列表字段的可选项 ......................................................... 52 2.5. 字段标识(Key)、字段名(FieldName)、属性名(PropertyName)的差别 ............... 53 2.6. 在动态表单中，如何实现文件下载 ..................................................................... 53 2.7. 如何支持用户把本地文件上传到服务器 ............................................................. 57 2.8. 以实例说明如何为动态表单取数、填充 ............................................................. 58 2.9. 如何为预置账表，添加字段 ................................................................................. 60 2.10. 如何获取基础资料的属性值 ................................................................................. 60 2.11. 保存前，如何为新建的单据数据包、单据体行，填写主键 ............................. 61 2.12. 在动态表单插件中，如何显示指定界面 ............................................................. 62 2.13. 如何为收款单，往来单位类型，添加新的基础资料 ......................................... 64 2.14. 如何创建、调试自定义执行计划 ......................................................................... 66 2.15. 如何通过按钮实现F8选择返回效果 ................................................................... 67 2.16. 如何在操作插件中，自定义操作校验器并启用 ................................................. 69 2.17. 如何实现超链接，打开外部URL地址 ................................................................ 73 2.18. 如何获取基础资料字段的类别(FormId) ............................................................... 74
3.
高级篇..................................................................................................................................... 75 3.1. 如何给单据体表格，增加自定义过滤行 ............................................................. 75
1. 入门篇
1.1. 如何创建并启用各类插件 1.1.1. 如何创建并启用动态表单插件
创建插件工程
? 动态表单插件，运行在K/3 Cloud的Web服务层，需要建立一个独立的工程管理动态表
单插件类；
? 动态表单插件工程，建议命名格式为[开发商][.K3][.业务领域][.子系统].Business.PlugIn；
如JD.K3.SCM.PUR.Business.PlugIn；
? 创建工程过程：Visual Studio → New → Project
? Visual C# → Class Library →选择工程文件存放位置→ OK
? 工程References右键，添加工程引用，所添加组件都来自Cloud网站的website\\bin路
径
? 修改插件工程输出路径为Cloud网站路径website\\bin：选中插件工程→右键→ Property
（属性）→ Build页签→ Output Path（输出路径）