EOS快速开发平台项目开发规范草稿

1、开发规范说明1.构建包1.1.项目名称：com.skyg p.fastdevelo p1.2.构建包命名项目名称+构建包名（模块名）如：com.skyg p. fastdevel op .demo1.3.系统各业务构建包说明com.skyg p. fastdevel op .accOA财务处办公应用模块com.skyg p. fastdevel op .busOA企管处办公应用模块com.skyg p. fastdevel op .disOA总调办公应用模块com.skyg p. fastdevel op.engOA工程技术办公应用模块com.skyg p.fastdevelo p.hrOA人

2、事处办公应用模块com.skyg p. fastdevel op .i nfOA信息处办公应用模块com.skyg p.fastdevelo p.matOA物贸处办公应用模块com.skyg p. fastdevel op.offOA办公室办公应用模块com.skyg p. fastdevel op.p laOA规划处办公应用模块com.skyg p. fastdevel op.p ubOA公共办公应用模块com.skyg p. fastdevel op. quaOA质量处办公应用模块com.skyg p.fastdevelo p.safOA安全处办公应用模块com.skyg p. fastd

3、evel op .thoOA思政处办公应用模块com.skyg p. fastdevel op .jqueryMobile移动端应用模块com.skyg p. fastdevel op.bp sruleBPS参与者规则维护模块com.skyg p. fastdevel op.pub通用公共功能，如各种通用的公共组件com.skyg p. fastdevel op.main主模块，如系统主页面、系统设置、用户管理等功能com.skyg p. fastdevel op.ws对内、外服务接口功能以下部分构件包一般情况不需要做修改：org.gocom.ca p.workflow.clie nt.tas

4、k我的任务模块功能包|2.数据模型开发精选文库22.1.数据集一般根据业务名称或功能模块来命名数据集。22数据实体数据实体名称与数据库表名对应，如表 HR_OUT_LEAVE_APPLY应实体名为HrOutLeaveApply。2.2.1.主键生成一般业务表单数据主键用”自动生成uuid”2.2.2.字段类型日期（不保存时间）类型用Date； 日期时间（保存时间）类型用TimeStamp； 其它常规数据类型与数据库类型对应即可。3.JSP开发3.1. JSP创建通过功能向导自动生成必要jsp文件；每个页面的头部必须加上注释说明和资源引入，并在title中描述标题。3.1.1. 一般需求jsp示

5、例HrAnn ualLeaveA pp lyForm新增表单页面HrAnn ualLeaveA pp lyEdit修改编辑页面HrAnn ualLeaveA pp lyFormAudit表单审核页面HrAnn ualLeaveA pp lyList数据列表查询页面3.1.2.注释 3.1.3. head 标签精选文库3scri pt src=/pub/form/form.js typ e=text/javascri pt (fun ctio n()n ui.c on text=;)()；页面标题3.2.弹出窗口新增表单、编辑表单一般用弹出窗口形式，窗口一般最小宽度为800px,高度根据表单内容

6、决定; nui打开窗口时，页面数据传递，按收页面必须要clone后再使用，如：/页面间传输json数据fun cti on setFormData(data)/跨页面传递的数据对象，克隆后才可以安全使用var infos = n ui.cl on e(data);/保存list页面传递过来的页面类型：add表示新增、edit表示编辑 n ui.getbyName( pageT yp e).setValue(i nfos. pageT yp e);/如果是点击编辑类型页面 if (infos.p ageT ype = edit) var json = in fos.record;var form

7、 = new nui.Form(#dataform1);/ 将普通 form 转为 nui 的form form.setData(js on);form.setCha nged(false);33移动端 xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx34代码片段示例(eave.datascta(eave.datasctaqurNrOutLea/eAFpIvs.bi.qurNrOutLea/eAFpIvs.bi. 11 NrOuteaveApptyLiftjspNrOuteaveApptyLiftjsp 圏Hr0utLe9eApplyPornn.|q3

8、Hr0utLe9eApplyPornn.|q3pdgopdgo 丄anguage-anguage-勺cii/ocii/o ccrvtentTccrvtentTuhsuhs尸spt-t?TFspt-t?TF = = J?J? pogoEncoding-pogoEncoding-UTfiUTfi = = SS * * ! DODO匚TYPETYPE htnlhtnl PUQLICPUQLIC ” / /；W3C/DJDW3C/DJD 精选文库4HiTMLHiTML 4.014.01 transitional/transitional/； ENEN n n11p11p ； /ww/ww. . w3w

9、3. . o orgrg/ /THTH/ / - - FiJ E E丈塔-i i淫暮厲明- -AuthorsAuthors s s ) ) : : LiF-uLorLiF-uLor- -DateDate : : 2tJlS-J-2t2tJlS-J-2t- -De5cnipionDe5cnipion: :-結:耳-秆式引入-%5i(fflinclude5i(fflinclude f f ile=ile= V Vcommon/coatnoncommon/coatnon .jip.jip 幣%(ncludc%(ncludc file-file-/coframc/tooLs/sfzifis/coffi

10、fton.Jsp/coframc/tooLs/sfzifis/coffifton.Jsp盂：XipagG%iieta/SsiplSsipl 5 5广L-%L-%缸議或克攻f f克辿偉ptpt山/Artr/ArtrdF.dF. JiJi type-*te-type-*te-；f f t/JavuiLrxptt/JavuiLrxpt 3*3* (fundiDn(fundiDn ) ) nurnur. .cDnteKt=%=contGxtPathcDnteKt=%=contGxtPath 盟;)()()； i5cript 中卜乱请您申i i显冏“JL:tk“JL:tk心 MEME曲谯甲曲罹Funct

11、ionFunction Iodlnit04t4iIodlnit04t4i)()(w w p p protvisinstidprotvisinstid = = ibiwritvibiwritv pi-opert=pi-opert=i-ii-itein/proc11sInstlOtein/proc11sInstlO / j j /xizefii/pxizefii/p ococ：i i5.5.1 1 nstnst +D+DnuLnuL.get.get( (proceasin&tidproceasin&tid. .etValue(etValue(p p cessinttid);cessinttid);

12、V V厂 ja-ortja-ort = rhurhu J.J. - -ETIETI匚口JefJef ppcQLiinttJidppcQLiinttJid : : pretLidpretLidp p ajsxHajsxHrlrl : :匚 oaoa .5kygp*f3.5kygp*f3 5tdBjelop5tdBjelop .hrGA.hrGA - - hrhr outout leaveleave spplybiz.spplybiz. trettret hrOuthrOut Lea-,Lea-, pAyBYPLCKpAyBYPLCK电s s 三 irstidirstid . . bizbiz -

13、POST-POSTJhtdJhtd : : jDAjjDAjCh#Ch# S Siynciync LfBi*c/ALfBi*c/A ： ofcofc - - riijiriiji ,cec,cec odeode text)text) i i生岂toto砒訓心b b j j ) ) iwarwar tbtb： writewrite propentywcrkithi/worklteKlDpropentywcrkithi/worklteKlD /s;/s;nui.nui. _ _ Ec-tEc-t ( (J J _ _ actV-aluefactV-aluef workitrKxd)workitrK

14、xd); ;warwar vjDrkitornnvjDrkitornn jmajma = = &nui,get(%i5rkltn3rtie),itVdlLCworkHel*id好 t t bj(ibj(i rJfirJfi t t fmrtflBhP-=fmrtflBhP-= 別litcllllkillitcllllkil II I I wflrKwflrK i i +iiin#ni?+iiin#ni? T T ilfllfiilfllfi BiBi H H nuinui 5*t-5*t-； i iifaifaUditrp-Uditrp-)Hhi(ie()Hhi(ie()；v v / /戏作杆

15、倨T旨行4.逻辑构件开发丿0 0构件 田 corn.5corn.5 Icygp.fastdevelop,h(rOAIcygp.fastdevelop,h(rOAI 羁 Ih rannurannu a a lleauealleauea pplybiz.connpplybiz.conn porentlyporentlypepe 朝 Ihrfamilyleaveapplybiz.connponfrntTypeIhrfamilyleaveapplybiz.connponfrntType t 羁 h F FI I eavefiniseavefinis bapbap pliylpliyl血CompComp

16、 onon entryentry pepe 期 Ih routrout lele a a V V eded p p plpl y y bizbiz .co.co m m popo rrerre mtTymtTy pepe addHrOutLeaveApptylHrCutLawSpplyaddHrOutLeaveApptylHrCutLawSpply ICIC 籃三 auditHrOutLeaveAppauditHrOutLeaveApply(HrOutLealy(HrOutLeaveApveApply.ply. P P 谿 d d eleteHeleteH rOrO irtLeirtLe a

17、a wApwAp plysfHrOplysfHrO u u tLeatLea veAveA pppp I y y 韜韜 getAuditPartTreeNodeOgetAuditPartTreeNodeOnt,nt, String)String) 1019510195 1 益 gctHrOgctHrO utLeaveApputLeaveApply(Hly(HrOuOutLeaveAppIyppIyICT 鑑 getHgetH rOrO utLeutLe aveAppaveApp lyEyPrlyEyPr ocesoces TnTn 沆i i d d (Lo(Lo ng)ng) 镒：querHr

18、OutLeaveApplyquerHrOutLeaveApplys(crits(criteriaTeriaTy ype,pe, P Pageage u u pdpd arte H rOutLeaueAprOutLeaueAp p p lyly( (H H rOrO u+LeaveAu+LeaveA pppp ly.ly.精选文库54.1.逻辑构件命令规则实体名 + biz,全部小写，如 hroutleaveappiybiz； 通过功能向导自动生成必要逻辑构件。4.2.逻辑构件示例一般表单审核业务需要逻辑构件示例说明4.2.1.addHrOutLeaveApply(HrOutLeaveAppiy

19、)添加表单逻辑流精选文库6get PrimaryKey设置主键AgetPrinidiyKeygetPrinidiyKey创建流程实例主要操作说明create Pr ocess In sta neecrcr e e ateate FrccssFrccss tntn &la&la neeneestart Process InstAndFi nishFirstWorkItem启动流程实例并完成第一工作项grtPr-grtPr- laryKcylaryKcyC C rcAlrPrE3cxJn5tBnLrrcAlrPrE3cxJn5tBnLr=冷皱一工他环交核 BHEjjha司姑砂精选文库7精选文库8审

20、批逻辑流不会自动生成,事务处理4.22 auditHrOutLeaveApply(HrOutLeaveAppiy, PubBpsAudit, Long, DataObject)表单审批逻辑流?s|?s|queryquery W/kltW/klt 害賈DtwiDtwi I I需要手动创建（一般从其它功能中复制粘贴、修改而来）。clPriiTifliyfcyclPriiTifliyfcy nacinaci tEndttEndtipighV/crWtsipighV/crWts精选文库9参数、变量参考示例精选文库10sisi主要操作说明queryWorkItemDetail查询工作项明细，为后续操作提

21、供数据i i uditHrOutLveApplyuditHrOutLveApply痼述O hnoutleveapplyhnoutleveapplyG G HrOutLeveApplyHrOutLeveApply表羊站u pubbplauditpubbplauditQ Q PdbBpsAuditPdbBpsAudit审核igig录碎0 0須O worlcitemicJF F LongLong工作项IDID| |輸入变氏:接旻外部事却攏：S设走西流的伍用或 公肓C 融有queryWjkltehqueryWjklteh etail赋值对审核记录数据赋值精选文库11fini shWorkItem完成工

22、作项审核不通过退回申请人修改事务处理affiKSiSzKSiSz pupu bbpfubbpfu d d；#a#a uditTimeuditTimentWntW D*0D*0传引用pupu b b bpsaudit/suditUsebpsaudit/suditUse rlrl d dm m：u u serObyect/userObyect/u sese HdHdpubbpubb已！ddit/tredtuTimeddit/tredtuTimenewnew DatDat亡0 0传引用pupu b b bpiaudit/crt-ateUserbpiaudit/crt-ateUsernrnr u u

23、serOserO bect/ubect/u ss ridridpupu b b b b p p S3S3 u u dit/procedit/proce (sir(sir &tid&tidwowo f f kftem/pkftem/p rocessrirocessri nstinsti D Dpupu b b bpi-bpi-idit/activityinstididit/activityinstidwqwq rldterldte rry/sctJrry/sctJ vitylnvityln 詛 0椿引用pupu bbpbbp 占auau 占itMQrkiitMQrki 七亡 rtiiMrtiiM

24、wOrlcrtrrtsdwOrlcrtrrtsd传引用423. deleteHrOutLeaveApplys(HrOutLeaveApply)删除数据逻辑流activityRollBack精选文库12参数、变量参考示例d d G eteete H H rOutLearOutLea veApveAp p p lybizxlybizxcS iri? 0 0 算1数迴血0須0 0 hnoutleveapplyshnoutleveapplys r*r* HrOutLeveApplyHrOutLeveApplyL L Z Z 1 1 .輸入变长:接旻外部事鈿专邊：S S设走置辑流的作用或 ？公肓匚私有取

25、消)*j dmldml皆雄 EntilyCdHEntilyCdH 呂 d d歩坯S S称 temptemp1313 H H rOkitLeaveApplyrOkitLeaveApply精选文库134.24 getOffWorkResApplyByProcessinstid(Long根据流程实例 ID 查询表单数据精选文库1404)赋值exex p p a a ndnd E E rrtityrrtity ByTByT eimeim pbtepbtegetUserOrggetUserOrg参数、变量参考示例g g ctHctH rOrO utLeaveAputLeaveAp plyByPrplyB

26、yPr ocessinocessin 或 idid设置g g etHetH rOutLedveArOutLedveA p p plyByPplyByP rocroc eses sinsin stisti dd的荷息窖称C?C? ti?ti? 令匚 M M0 0 pror#ipisticlpror#ipisticl回 LongLong0 0 hroutleaveapplyhroutleaveapply HrOHrO utLeave-ApplyutLeave-Apply【0 0返回值o o extext9 9 DataData ObjectObject扩谨卧鹽鼠叱：LJ接爰外部事芻传谨：d d42

27、5. updateHrOutLeaveApply(HrOutLeaveApply,String)更新表单数据精选文库15参数、变量参考示例逻犒和1性设置X蔓U U pdateHpdateH rOutLeaveAxrOutLeaveAxiSSiSS updupd ateHateH rOrO utLeutLe a a veApplyveApply bizxbizx的信息&设S S EfEf碗香文档g称IX X令 g g M! !B B主要操作说明赋值对修改人和修改时间赋值顒直屋性设置描述几 hroutleveapplyhroutleveapplyQ Q HrOHrO

28、 utLedveApplyutLedveApplyO O wOrkitemidwOrkitemid| |F F StringString1C?C? 11?11? 了 厂 *施辰：EsH设置盘直的僖慝序号左ii右這右iOlSlI1 1Q Q hroutlhroutl eaveappeaveapp ly/modityTi.ly/modityTi.r r ewew DateODateO传引用2 2& & hroutleaveapply/modiryU.hroutleaveapply/modiryU.fn:ufn:u serOserO ect/uect/u serldserld传引用V 凶 3 U -

29、；确运勒H H精选文库16回退提交对回退后重新编辑提交业务的处理（提交到审核不通过节点）H-5.命名sql开发5.1.命名sql集命名规则根据功能对应数据实体命名，如实体HrOutLeaveApply对应命名sql集为hrOutLeaveApply.namingsqb。52代码片段示例精选文库17readltreadltrQKultrQKult resultresult rKultnctxlinUIF-a?!=字如author;author; IflIfl =-、V V ! ! = = HMeHMe =r4KultMapid-dic.teolun*dicttypcideolun*dicttyp

30、cid jovoType-*jovoType-*stringstring propertydictTypcId/propertydictTypcId/ eolijrh-dirtideolijrh-dirtid jswBTy|!-jswBTy|!-tning*tning* pi*&p*r+y-dictId/pi*&p*r+y-dictId/ colunntiiLtdtJMccolunntiiLtdtJMc J J a a vaTyp=vaTyp= *st*st r r irir iiziiz propflrty=dicLNjiiu/propflrty=dicLNjiiu/ coluni*pfl*

31、9ntSdcoluni*pfl*9ntSd 3iBtfBTyp*itping3iBtfBTyp*itping prop#prop#rtyip*r#ntrtyip*r#ntIdId/ calunn-&nijcalunn-&nij javaT/p-javaT/p- property-property- i iL L；4N4NU U/IDittGyOicfiringIDittGyOicfiring !CrnATAtslpctslpct dicttyp*iddicttyp*id dictiddictid diedie七EAEPEAEPpjirentid,pjirentid, spqinaspqina

32、fromfrom PO.PO. dictdict FntryFntry nhprpnhprp d d ictnjini*=MdictfJip#ictnjini*=MdictfJ1 6.运算逻辑开发6.1.开发规则业务性（当前业务功能相关）的运算逻辑，根据业务数据实体名称分包和命名，要有详细注释说明62代码片段示例L n厂 i iiweniiweni unun* * ltdltd ateate 2U1L.2U1L. d4d4 2J2J lb:lb: UliUli J_|J_|世酣亠z (jaffl(jaffl劃IfIf遙publicpublic clatEclatE CumiiQuurDdtJC

33、umiiQuurDdtJ 辿EzhiEzhi广世用0(w0(w朋I I户亘诲月百闕寻第3 3丢驾可员11话门山茁曲?抹当皑乱工丄聆?6 6卿rosKrosK議闫毗照捋SuTSuT丄服九曲3Ei?epdrMUnad3Ei?epdrMUnad publicpublic staticstatic ObOb jetjet t t J J getget 匚 DAByDirzDAByDirz illill yLedder$yLedder$ hip(hip( StringString oryldoryld StringString 油此少出)(M*pStringM*pStrin pampam - - nNn

34、N HdshMapCStringHdshMapCString” String(String(););p parni,put(orgTd*,arni,put(orgTd*, orgid);orgid);p pa a广mputmputVcVc育L电p.p. degree);degree);ObjeettJObjeettJ Xpjrt(nntl-lfijd&-Xpjrt(nntl-lfijd&- DjlJbAzExtDjlJbAzExt *Mr*Mr创卅倔亦讥血和bdl*,bdl*,ccfl.ccfl. b b kygpkygp. . fafa t t tdvIop.tdvIop. pub.pub.

35、 cun)riKtiK)LyDdtacun)riKtiK)LyDdta . . blctUfcrOnHEpblctUfcrOnHEp pm);pm);r*tr*t urrturrtrn*rn* ntHntH ; ;publicpublic EtatKEtatK ObjectObject EetU&erSupeEetU&erSupe广ioPres(StrineioPres(Strine orgld,orgld, StringString parentorBitJparentorBitJ MjpStrinflMjp5trinfl prvprv - - nHnH H&hMdpStrinfH&hMdp

36、StrinB ( () )； piirni.piirni. pu+CorIdpu+CorId , , arTd)arTd)； pj-rmpj-rm. . putput( ( pappn+curdlpappn+curdl , , pAPpntpAPpnt 口广用i i d d ););ObjectObject DepartmentHeadsDepartmentHeads D.tabasfFxtD.tabasfFxt. . q q ueryByinieueryByinie d d t t (def(def aulf,aulf, cofflsk/fip.cofflsk/fip. fistJefist

37、Je wewe lop,lop, pub.pub. conwiReqveyDaticonwiReqveyDati selectselect UsUs erJne,erJne, parpar町； rwturnrwturn DepjrtmentHead;DepjrtmentHead;7.流程定义规则精选文库187.1.流程定义规则根据业务数据实体名称命名,如实体 HrOutLeaveApply对应 bps 流程名称为 hrOutLeaveApply.workflowx ；各图元应该间距适中,不能相互重叠；亦I I时r r IEIE ncU-iuditncU-iuditWAPPiudiuP.#y-W

38、APPiudiuP.#y- - -hfhf氏口曰砂直典活动项名称应简明;上线后，流程定义中的活动项名称 不能随意变更（可能在业务处理中使用了定义的名称）。7.2.流程相关数据设置hrOirtlHwftpply.warirdewHhrOirtlHwftpply.warirdewH咚 fl卜 rOLTiLMi/frApOrOLTiLMi/frApO如,wflfVflndTwflfVflndT 馬唱知;SiSirisrrisr二业舅芬劇-兀疲*s s件旳ijBijB切一用5S5S湘-l-l 0 0 _F F ftringftring 1 1 MPMP- - J?J? vdlop.hrOAJfsw.H

39、rfRrTljvpArp*vdlop.hrOAJfsw.HrfRrTljvpArp*r r StringString tjiqueryMnWIctwOA/odilLpHtjiqueryMnWIctwOA/odilLpHji/Hrji/Hr OuftOuft r r Ji-ppljAudit.jtpJi-ppljAudit.jtp* * SiiifHJSiiifHJ/|qu#ryMobl|OA/aijiUttv*-riJy/Ha/|qu#ryMobl|OA/aijiUttv*-riJy/Ha i i fAppljffOfinfAppljffOfin i.jifii.jifi 旺* sgsg印;P

40、OName必须，对应业务实体全名MAP PAudiu Page移动端功能必须，移动端审核页面精选文库19活动1D1D；mjnuolArtivimjnuolArtivityty亢沪代淫;分S S爭券;描述:替术壬鸵澄pupu塢农单嗝诡貝面曲 TpyURL wesJCSlMAPP Edit Page移动端功能必须，移动重新编辑页面7.3.填写表单活动项_总:頂弓请假单园工、 nxs T義羊时钢刨鬥多工佗项I邑雜盘詡牛訂冋逅匠言庄逍胃启确恰广通知3T T /hrOAyoLitLeaveApply/HrCutLeeApplyEeitjp/hrOAyoLitLeaveApply/HrCutLeeAppl

41、yEeitjp7.4.活动项 参与者规则逻辑分两种情况：一般情况根据业务要求，选择 指定参与者 或根据规则逻辑自动获取参与者 两种方式。7.4.1.指定参与者当明确指定某人或机构时，可以直接指定参与者。精选文库20TAiissnirfiswAiissnirfisw吐圣丰百笑，目至K 蒜与音 二義判科时聊刨已多工佗项gfe陵斟I昌亘劉囲言期IS启和旬6厂通知3O咸址纺！1表获僚令*站劳1D充肯刍養南pfEas如表指诚活:孝与百 I面早冃寸书，活动的行音742.规则逻辑参与者不能具体指定到人或机构，而要根据申请信息去自动计算获取参与者，就需要在com.skyg p.fastdevelo p.b p

42、srule包中自已开发对应业务的规则逻辑，这里选择即可。精选文库21a规则濯牵科氏设查r*旳拳匀荀言B B雷基壬B券与育2衷羊I M时乖E制昜工恒项|兰軼竝事斗可g=庄诜同启站篦卿E 翻 气.：列表灵得;拿FIFI 口_允右甘老舌訣焜卿上F F一克指派舌荒辱写咅:站哥颐则;*按尤手说;趙crrvi.p_faAVFAVFIr-p.hprule.romm.3P*omnFrripl mlgptF”pLPVFPVFL.K?L.K?3JSS一般规则逻辑开发是一些 运算逻辑,m中已提供了一些通用的规则逻辑，可以直接使用。通用规则逻辑说明:com.skyg p. fastdevelo p.b m.B PSc

43、ommE mp Level 获取各种领导的方法getEmpLevel_CZ（）获取处室处长、分公司经理（2级单位正职领导）； getEmpLevel_FCZO获取处室副处长、分公司副经理（2级单位副职领导）;getEmpLevel_CZandFCZO获取处室正副处长、分公司正副经理（2级单位正副职领导）;getEmpLevel_KZ（）获取科长（3级单位正职领导）； getEmpLevel_FKZ（）获取副科长（3级单位副职领导）； getEmpLevel_KZandFKZO 获取正副科长（3级单位领导）；getEmpLevel_ZJLO获取总经理（总公司领导）； getEmpLevel_FZJL（）获取副总经理（总公司副职领导）;getEmpLevel_ZJLandFZJLO 获取正副总经理（总公司正副职领导）;精选文库22所以如：财务_资金申请m.BPScommImmediateSupervisor 获取员工的直属上司getImmediateSu pervisor()通过部门和职级获取员工的直属上司7.5.活动项触发事件CSCS右二拳与者I I匚砂 匚甘邨關！匚娈二住喷血想辜+ .込 n n目3A3A 0 0鱼僚e e二曲q q展Sai