金蝶云星空协同开发云——动态表单、系统参数金蝶云星空生态与平台开发支持部Content0102搭建开发环境表单插件搭建开发环境、配置开发环境、代码调试、3程序集包程序集包：主要用于管理插件工程/第三方组件/配置文件等站点文件的注册/管理/开发1.插件工程/.Net工程：用于插件/服务.Net组件的开发2.其他资源：注册管理第三方组件/配置文件等非组件文件4SVN源码管理插件•【我的应用】-账号上右击菜单，选择【更改SVN密码】•从工具箱里下载SVN源代码管理插件5搭建开发环境•开发环境搭建，根据需求，选择对应的安装环境，最好选择与数据中心版本相同的安装环境。•此过程先下载7.0及其选择环境的安装包，下载完成后会自动释放组件到应用的k3cloud的目录下，释放完成后会启动开发站点。6配置开发环境•自动匹配IISExpress，匹配不到需要手动安装•可以自定义所需要启动的管理中心，输入对应的管理中心地址即可注:必须保证该管理中心的数据库服务器端口是开放的•自定义启动方式•生成bat脚本，桌面一键启动7新建表单插件工程•工程命名注意金蝶二开规范•引用/输出目录默认输出应用k3cloud目录下的bin文件夹•引入DotNet工程：需要把插件工程放在应用目录下的Code文件夹下，然后再引用，符合无效8关联源代码管理插件•AnkhSVN暂时不支持VisualStudio2019版本，在修改完插件之后，记得在应用的Code目录下将工程签入到SVN9工程属性设置编译版本：v4.0输出目录：默认应用k3cloud的Bin目录下10添加插件选择对应的插件类型模板，模板中提供常用的方法，且一些注意事项。Content0102搭建开发环境表单插件案例搭建开发环境、配置开发环境、代码调试、12案例一：单据上新增按钮，并弹出对话框在单据上新增一个按钮，点击按钮，弹出对话框13添加菜单按钮在单据的菜单集合中，添加新按钮14注册插件组件编译生成的路径是应用下的k3cloud/bin目录下选中编译好的组件后，会加载出程序集，勾选需要注册的程序集15点击按钮，弹出对话框BarItemClick和AfterBarItemClick的区别：BarItemClick：点击按钮，最先执行AfterBarItemClick：点击按钮，后执行16案例二：表单插件，赋值和取值（GetValue和SetValue）【备注1】文本框获取【备注】文本框的值17取值，赋值取值：this.View.Model.GetValue(字段key).ToString();赋值：this.View.Model.SetValue(字段key,value)18案例三：单据体赋值通过物资内码给单据体的第一行赋值通过物资编码给单据体的第四行赋值19赋值通过物资内码id，给单据体第一行赋值：this.View.Model.SetItemValueByID(key,id,RowNumber);)通过物资编号，给单据体第四行赋值：this.View.Model.SetItemValueByNumberkey,number,RowNumber);20案例三：常用方法获取单据标题：this.View.GetFormTitle()获取单据内码：this.View.Model.DataObject["Id"].ToString()设置焦点：this.View.GetControl(key).SetFocus()字段锁定：this.View.GetControl(key).Enabled=false隐藏字段：this.View.GetControl(key).Visible=false锁定按钮：this.View.GetMainBarItem(key).Enabled=false前台刷新，不和服务器交互：this.View.UpdateView(key)整个页面刷新，要和服务器交互，把后台数据库数据刷新过来：this.View.Refresh()点击按钮,调用保存：this.View.InvokeFormOperation("Save")删除单据体信息：this.View.Model.DeleteEntryData(key)刷新,单据体界面：this.View.UpdateView(key)逐行,删除单据体分录，0代表第1行：this.View.Model.DeleteEntryRow(key,RowNumber)单据体新增行：this.View.Model.CreateNewEntryRow(key)注：与新增分录事件一样，这个是从后台创建行，写入数据单据体复制行：this.View.Model.CopyEntryRow(“FSaleOrderEntry”,0,1,false);注：0代表第1行;1代表复制到第2行;false代表不携带源单关系获取单据体第一行内码：this.View.Model.GetEntryPKValue(“FSaleOrderEntry”,0)注：方便后续的从数据库操作获取单据体行数：this.View.Model.GetEntryRowCount("FSaleOrderEntry")错误信息，对话框：this.View.ShowErrMessage("")询问式，提示信息框，是否：this.View.ShowMessage(“错误提示,是否继续？”,MessageBoxOptions.YesNoCancel,newAction((result)=>{这里根据result的返回值，编写逻辑}));21案例四：BeforeSave点击事件如果备注是空,弹出对话框,是否继续如果点击否,不保存如果点击是,保存22调用事件如果点击是,直接调用保存按钮事件23AfterSave，保存成功后保存成功后，触发的事件比如：销售订单下推销售出库单，在销售出库单填写项目名称，点保存，反写到销售订单上面24案例五：DataChanged，值更新后，触发供应商改变后，备注提示信息25字段值改变界面数据发生变化后，需要处理的逻辑这里是供应商发生改变后，在备注文本框中提示一下26字段改变后，获取新值，旧值当供应商的值更新后，获取更新前的值和更新后的值27单据体变化行当单据体中物资编码发生改变后，自动给单据体另一字段赋值e.Row代表行号28案例六：BeforeF7Select事件打开供应商基础资料，实现过滤29过滤条件显示基础资料列表之前调用通过重载本事件，可以设置必要的过滤条件，以限定检索范围；30案例六：AfterBindData事件打开单据，判断是什么单据状态，然后触发相应的操作如果是新增操作，便给备注文本框赋值31数据加载后需要处理功能这个是一个数据绑定后事件这个事件是单据新增，编辑，查询加载后最后一个事件。这个方法是判断单据状态。有四种：ADDNEW、EDIT、VIEW、DISASSEMBLY新增、编辑、查看、卸载32案例七：读写数据库点击按钮，执行数据库，更新全部单据中备注信息字段，并显示出更新条数33读写数据库添加引用Kingdee.BOS.AppUsingKingdee.BOS.App.Data34读写数据库获取全部的物资35读写数据库•单据数据包DynamicObject，相当于一个有层次结构的数据字典：•第一层包含全部的单据头字段以及单据体行集合；单据体数据行集合、基础资料字段，则需要通过第二层的DynamicObject来展示。•基本特征：1.包含了全部单据头字段值2.包含了单据体行集合对象3.字段通过Key+Value，形成一个键值对，占据DynamicObject的一个节点4.字段在数据包中的Key，使用的是字段的属性名5.基础资料字段的值，也是一个DynamicObject对象，其中嵌套包含了各个引用属性的值Thanksterimakasih感謝谢谢ありがとうขอบคุณ
