金蝶BOS6.1平台开发笔记-入门实战篇

1、金蝶BOS平台开发笔记入门篇。新建、修改一个主从表1.建主表第一步，在业务建模视图下，新建业务单元。31打开赛源目录 r MJ ViUU 电丿彳点击下一步，创建方式选择“直接新建”，完成。业箸单元管理1IUL)IL IIIPIB'nilIIP-III 111 111 “L，“团mm +1 G= Item+： oa 3"一+1r p tsffisem'3 & St +iwm1+1 &财务垂= a Q咆联戊 创&电底主： 3&供应雜 0 &基谥系1 ± &基础妾i H &人力贯； '3宙薛宏涛Q设蒼

2、解决方案辱出d）目引入业务单芫邇合并口片C）小组（1 比较対象仏） 从本地历史记录逗原（1）.-近主从義演示我们新建一个名为 MainChild_Demo的单元，别名起为“主从表演示”。««创建业穷单元回区创建业勢单元请录入业务数据的基本信息源文件夹 ）：包名 鱼）： I C g m Li n gde e. & a s. x ueho xig L a o. al别名CA）；名称血）:flainCkild D«mo描述©:<Jz 一专下一步完成®取稍创建业穷单元fnfx新建业勢单元选S即建方式业勞屋性业药荚到忑）: 业等属性:基础資

3、翘无VV诘选样创建方式 c直接新連迦 r：煌制基础檯稅 O复制苴它槻扳C复制己定义业务单元© O邁迪引入刨建G2-步J_开 Q.|)11 完成（X）1 取稍1生成的主表如下图：系统自动创建了4个编辑字段（另有一些字段未在本界面显示，在此不做详述。）100_.i300400500CH措述一CHi Si2. 新增单据体。仍然在业务视图下，在生成的“主从表演示”界面上右键，选择“单据信息”，点击“新增单据体”。 新增的单据体即是从表。|uai iChLl<.Dei«o业务展性：业劳状态宇段：体冈E生成实现类分录信息名称标題僦_I 耽肖预留业务单元确定9 I取消©

4、应坪3. 字段管理在界面上右键选择“字段管理”，弹出字段管理界面。新增主表字段:mainfieldl ”,在左侧选择“主从表演示”，然后点击“新增字段”即可增加主表字段。我们新增一个“ 字段描述“主表字段1 ”。如下图：字see理用干中囁举慣(T'r声冊旳* 畸、S?JW1t»ilDnir(FiiR*单IS孚址 录入血理舷 gi刖PiiTSS预a-a»孚褒定宝曰曰全ft习主4.衣但帚0 » rU呂商初乞mb前 J-seriolLCfi siipl Alhn# creatort我时"|-1*中.kLclfEuT liistLJklaLriv CU:

5、E亦虚性7用密彷i"miEiMLift迫jC：kIL新增从表字段:在左侧选择“第一个表体”，然后点击“新增字段”即可增加从表字段。我们新增一个“ childFieldl ”，字段描述为“从表字段1 ”，如下图:4. 点击保存5. 查看新建单元所产生的对象:打开业务设计视图。在目录下找到本次新建单元产生的所有对象。见下图中选中部分:二 kin耳deet) KUehoiLlaciI dnoUiiiiChil J_Demo. enti ly UlaluChi 1 J_D emcE 1. erttity_ Cr_DEM_WiinCtild_DeBe, t讥"n CT_)EH_H4i

6、nChild_DeiioEl. tabl BO R_(lalnChi 11_Eem o_Nla.iiiChi 1 d_DemoE 1. relati oil 口 WaiiiCh】ld-D 4m©Query, qusry=MainChi 1 J_DftmoRulftStf ruJ&se t甘“& client； ® Wai uChi ld_D ernoE di tUI. ui'(g MainChi ld_DemoLietUI. ui® D en oRes oinrc e_ re soior c e%tit MainChiLd._l)emo.b

7、iz'unitluehanetac. package各扩展名结尾文件的含义如下：Entity :实体对象。Table :数据表。Query :查询表。Relation :实体关系表。即实体间对应关系。Ruleset:Ui:界面。Bizunit:业务对象。6. 修改实体对象1）主表实体对象的基本信息:双击打开Ma in Child_Demo.e ntity。首先展示的是实体对象的基本信息，见下图:I' hl =从T1 M«nL i s 4MaInChll d_Denioin 基确脂&加個：遊卿!：回播3：融闿：ERIHS-1肿耶!眄；15刊8訂砂3 :打 1 L

8、l 咤血 A-i=.dtfi fe r-aiiirLiId_lcci kLiLdAc. tu. n-Lkcnc'i-b. den >. inaJL：id_Dtc«n. tLHrdAt. bu.Jen ». r-uiOulZ D snCEc-i &. ?pJk 711-wci. <3ffi». IP<iJiJl liJ IdJTn七*. ItLy壮:匕 d<±.dM*.VfclhJ-Mllki ikJv*uO.J 切pg VriJ rf llil'l仃fc fcLItfiJ-r »!,.屹b g -

9、jmin > W'rIId,c*i kLTLf4«*. Q匸dm*.轉# VtiiChildL丄咤dGiw血jflrt旧diTClnl 4;！匕Ldz氐4 tiT.日B»p. aiithlliLi.rK.dGvafikVorV 魅于 HAldBawriIg输utJ niiluitglM，jgg； ufF，CV_Jin_yu| 口-扩曜凤性单钳笛丸岸忡甦出卢芽祥|滋岸再.in J眸*0（麗 耐口父实体对象:是 Mai nChild_Demo实体对象的父类。 可以看到它继承自com.kingdee.eas.framework.app.Database对象。从这个对

10、象继承过来的对象,拥有数据库编辑方面的功能。对应表对象:这个是实体对应的物理数据表，可以看到，它对应的是com.kingdee.eas.xuehongtao.demo.a pp.CT_DEM_MainChild_Dem(蓝色部分是数据表路径，根据每个人新建单元时选择的文件夹不同而不同）2）从表实体对象的基本信息双击打开 MainChild_DemoE1.entity，如下图:Pt=丛 fc属帚nhiiiCiJLdJla -ini"MflinChilriJXrrioFI 的卅倍島一誉冥HU言見询削科1：业蜩=1：咼d醉S矣： limtt匹何帅"；FTPISSJ应: 烟怖确：

11、划应;和嫌： n3hS.»tt.-*S5t：.1 "CKTmITuc"! tLiLZ'dAt E3. fth<-nct-aj&. Ten >. P-u.iLdld_r =nccn. bLUjda*. b*s_z.t. DI a: =Oll1 d 2)4匚 1 tin-ziffr- C4. ?e-Jw nl-oo.t. P<iiiL .h: IdJIm±*n. tLdjQt. a-li. hcQu占如.F-uuLd Iai斗 ki rudjv* WE.舉a. 3m * Bp. VaJjfLnJ7*» IfLy也L

12、 au.:ncJucn£<4.占彌p. Vtinhi丄出T khiT" u.b血啊 ho 弘呼 hpi= Vuirfhilde*i hiiLfd*-hi忒hll山Q<.卜EfJx附Eg, dtfi*. atp.c«i ki Lj-d*-?n<krn(l> dn« yp；*n tkUJ如 4电工.仃 V耳wgrk 忖p. 了）匚凸1口734乂勺Ij* fciTLgiqjmE, lEflJwngttff, jwmd CT JCLTtl T涯折祥耐岸範阴（TWiioflas焉皆a父实体对象:Mai nChild_DemoE1 实体对象的

13、父类为 com.kingdee.eas.framework.a pp .BillEntryBase? 对应表对象:3）主表实体对象的属性点击下方的页签“属性”，可以打开实体对象的属性页。如下图:stHfre両云唾丽ii?丽丽砂W ±1 T2rrhild_lUiiiT 口日山CM dia节匚fWg十T _迓 f t/jnhFJ Lpii Ah3 TiFitl if-K-trt B ±1 bbjclB LiuJcr卡bThi>K二1已换耶仏杠”三ft fl ia=t7pdi.i-i7irJ EE期匚7 id?iOMW；W£aTFt ；斤毘 3炸译 rtffwdi

14、HJF| J笊叱EESifi 诵世 11展开左侧属性树，可以看到实体的继承层次，及各层次下继承来的属性。 黄色钥匙符号的字段为自有属性，蓝色圆球符号的为连接属性。其中E1为我们所建立的连接从表的连接属性，mainfieldl是我们建立的主表的自有属性。TpbiiiTSJUJa .nlilFhl丽毎融注t£ J身自隹展回T底塵NinJlill J_JhIiuS： . Htlt： Ij ?-I 計 TMrChi】4t E tJiF E LlUnvytlifeE川TH C吓甘1口血百许on辛0 =tq.J TC c叶冒EdPT7 Jd冋下关爭：Ul宇參：叫SI3单绪估屯|岸忡I方范出耐岸範

15、in 醸和0*5疑 焉+*H 其中P are nt属性为从表关联主表的属性， 段处，该字段关联主表字段的值为：Childfield1为从表的自有属性。主从表实体对象的关联，就是通过主表的该属性是连接属性。可以看到，在编辑关联属性所对应的字FParen tID。E1字段，和从表的 parent字段进行关联的。4）从表实体对象的属性5）修改主表实体对象属性字段E1：该字段用于与从表的关联，从“主表实体对象的属性”图可以看出该字段还未指定在主表 中的对应字段。这里我们选择FID字段作为关联从表的字段。KW C T_DEl_la inChi 1 d_ D eao名称婪型FHameITVAKCHARFN

16、iunWriTVAKCmFD&seiiptiflitIfVAECHARFSimrlsNsnimKCMAJlFinVARCHIARFCr*itftrlEYAKCHARFC r#it sT im 电DA.TETIHIFLastJpditlTs erlDVARCHARFListUii+乜TimeDKTETIHJFControlUnitlBVARCHARCPHiinfiITVAECJO确定取消7.查看主从表实体对象关系双击打开 R_Mai nChild_Demo_Mai nChild_DemoE1.relatio n。1N iJliL 1 J_JwiiijE1 . Mtti ly 55h. i

17、fbj 1 J_5#i uE：. r »! j on 二I' hl =丛r hi j£ Mi LiJ fl «nl i lyRMlElHId-门旳脚kLDRmrf I的疋义信& ! -ftfsfttj-書S皆：h Sr In-t -ty Ihd耳斥 KPfmfrf 4 d 釘 n nji上口该实体关系的类型为：Com po sition ClientEntity :主表实体对象。SupplierEntity :从表实体对象。多重性：表明了主从表之间是“一对一” 这里默认为一对多的关系。、“多对多”、还是“一对多”的关系。8.测试主从表1）在客户端创

18、建自己的菜单:在业务视图模式下，在业务单元管理里随便选中一个文件夹, 如下图：然后点击菜单“方案”->“主菜单管理”：吨主養单倉理冈?!匚-.a转换为厅业解决方宪©1+1 G -0 G團主菜单营連通）C ©权限菅理（£）日吉管理匸）可;P*岡塔互斥首理+1 L替换无数据00I审G3E+1 G13 Q出C71 G13 &人力資源3齡薛宏涝F 命 Eemq 磐芟姚表演示菩检w元数据© 检查数曙表辽） 51解压元數据也）费井级元数据片段 童丑级无数S ®V|工員g tn在弹出的主菜单管理管理界面，可以在根菜单下建立自己的子菜单目录，也可

19、以直接在根菜单下直接建立菜单项。如下图，我们创建了“薛宏涛”目录，并在“薛宏涛”目录下创建了子菜单项“测试” 通过点击浏览按钮，找到刚刚创建的“主从表演示”业务，确定。SIO冀也也FF新建菜单爼 新建菜单项 删除迦 毘上 上移也）下移©星下请选擢帐套（E）: xue-EASSERVEHGVI主菜单主菜单+S国+E0*1±E+1捞同平台CS）面业分析 基础数据昔理 宙）库存业务莒理 谓肓与分销管 主产制造CS）厳量甘理C3供匝管理C3）m务合计（5）昔理会计CS）资产甘理的资金管理人力资源営理（5）系统平倉业第单无 业务单元：主从表演示浏K序时簿V测唸堪）.洁琮©

20、根限:-蜩I:Q学主亡测试£G）计量检斤-的主产管理质爭莒理71111 >取消2）运行客户端点击菜单“运行”-> “启动客户端”，或者从工具栏直接点击“启动客户端”按钮，运行客户端。运行工耳 业务单元 格式（W 浏01）搜索 项a吃固用O © y聽疊出.-严：g 1-iinmi iiiphii iMiiBmBiiia-iiiBimiii rwii immi ph ii phi iimii m iii- i iii rwi i“ii10Q£(JQIII. IH LHJI ILUJIIBH HIM »IIUUII LH LMIBMUIMBIHIB

21、MIUII MB Jill EKJ IIUUIB讹 启动服务器1） 启动客尸喘I B着动瀏试C -r +7 9 :O停止测试©单站转换甌试（1） 商輪码规则测试Q） n界面师试IWQ重启F1yEb应用iiB 'h征页面側试囲分录序列号从親工囲3）测试主从表启动客户端，输入用户名密码，登录成功后，可以看到我们刚刚创建的菜单项: IE功能亮单消息中心萇资金管理 器稍書与势销管理 够生产制造 福财务会计商业滴e 基础数jg管理母）粟言克平台双击“测试”，即弹出主从表的List界面。点击菜单“文件”-> 可以输入数据和分录：“新增”，或者从工具栏点击最左侧的新增按钮，弹出编辑界

22、面，直接在里面就输入数据保存后，就可以在List界面看到数据记录了。9.后记通过以上几步操作，我们就实现了最简单的主从表，不用写一行代码，可以进行简单地数据录入及列 表展示。最后，想要补充说明的一点是：金蝶的 SDK都是教你如何在设计视图模式下，从新建实体（entity）->生成物理表（table）-新建实体关系（relation）->新建查询（query）-新建编辑和列表界面（ui），步步实现 以上操作的，作为一名求甚解的合格的程序员（嘿嘿），理论上这么做可以让我们快速地了解整个二次开发平台的原理，可惜的是，金蝶的SDK写得实在太浅显了，而且没能完整地教你如何实现一个业务。本人在

23、学习的时候，也曾试图走一遍设计视图下实现的模式，最终因为对整个平台不够熟悉， 再加上金蝶自身的 BUG较多、约束较多而流产。所以，如果你是初学，还是先走一遍上面这个例子 吧。为按钮控件（KDButton）添加事件假设在ClientlnfoListUI界面添加一个按钮kDButton11.方法1:2.1） 双击该按钮会生成如下代码（注：不要直接在该处写 留一个接口）：Java代码，此功能金蝶尚未开发，仅ClientI nfoListLH.uifutile void. fDButtQnl actionPe 110riredCjava, avt.event.ActiOBEvsnt e) :/Lrir

24、s VC JIr.e2）保存！发布 ClientlnfoListUl.ui ！3）切换到Java视图，找到对应的Java类，选中该类所在的父节点（本例为Client节点）。刷新!1>Jjj Ab itm rtCl I er tl nfo E d rtUl ,j a(ASCII -kkv)li > Ab?trartCIS ertlrfoListU Lj ava(ASCII -kh/)& > A b 5tr CtClil eritl ntoTrd itUI J 3 vg (AS匚 H -kk皿AbstracdmportMa砧FblmUI ja也(砧CH -kkv屈 >

25、;Client|nfcrEditUljavatfAS匚II -Ickvl叮曾 A 匚lientJnfoListUI.java(ASCII -kkv)|F 广 I ； J-I nl-l rif c T" rri 小匚11ft C Cl I PJIbi j i则在抽象类AbstractClientinfoListUl.java中已经生成了按钮的单击事件:.kDButtorl_acti on Performed (Actio n Events4） 在实现类ClientlnfoListUl.java中重写该方法即可:protecrtfd Toi ri lr3Bji11cncticn PeTf

26、onnede J tTiTowa Eiczepi ii (/ T ? A.J- u-g二nnrnLnV Tr*=-"hc'ri 启tuhanpfT*. (tDRu- t rani acTt iorPFr fcttrfrt t a b ；int TAiult： =- pRoTrConTi TTP (mill ,"咿? ?")；if (result = MjtjBox.UbBox. jhwTnfo;方法2 :1)在设计视图下，打开ClientlnfoListUI，然后打开大纲视图 IIH Jill 10丿卜 CS ToolEarPandI：苗 MeriuBark 竜 D岀ta Objects 丄 Cl Actionu谴頂* artionPageSelup ( ArtionPageSetupJB u 继母 n action Exit Current ArtionEiitC-urrent J2)在Actio ns节点上右键，选择 < 新建Actio n>，输入类和实例名，完成!Action董名:虹tionKDBirttonlAction 奠甕名:a|t:tiorKDeutto