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

精选文库开发规范说明1. 构建包1.1. 项目名称:com.skygp.fastdevelop1.2. 构建包命名项目名称+构建包名（模块名）如: com.skygp.fastdevelop.demo1.3. 系统各业务构建包说明com.skygp.fastdevelop.accOA财务处办公应用模块com.skygp.fastdevelop.busOA企管处办公应用模块com.skygp.fastdevelop.disOA总调办公应用模块com.skygp.fastdevelop.engOA工程技术办公应用模块com.skygp.fastdevelop.hrOA人事处办公应用模块com.skygp.fastdevelop.infOA信息处办公应用模块com.skygp.fastdevelop.matOA物贸处办公应用模块com.skygp.fastdevelop.offOA办公室办公应用模块com.skygp.fastdevelop.plaOA规划处办公应用模块com.skygp.fastdevelop.pubOA公共办公应用模块com.skygp.fastdevelop.quaOA质量处办公应用模块com.skygp.fastdevelop.safOA安全处办公应用模块com.skygp.fastdevelop.thoOA思政处办公应用模块com.skygp.fastdevelop.jqueryMobile 移动端应用模块com.skygp.fastdevelop.bpsrule BPS参与者规则维护模块com.skygp.fastdevelop.pub 通用公共功能，如各种通用的公共组件com.skygp.fastdevelop.main 主模块，如系统主页面、系统设置、用户管理等功能com.skygp.fastdevelop.ws 对内、外服务接口功能以下部分构件包一般情况不需要做修改：org.gocom.cap.workflow.client.task 我的任务模块功能包2. 数据模型开发.2.1. 数据集一般根据业务名称或功能模块来命名数据集。2.2. 数据实体数据实体名称与数据库表名对应，如表HR_OUT_LEAVE_APPLY对应实体名为HrOutLeaveApply。2.2.1. 主键生成一般业务表单数据主键用”自动生成uuid”2.2.2. 字段类型日期(不保存时间)类型用Date；日期时间(保存时间)类型用TimeStamp；其它常规数据类型与数据库类型对应即可。3. JSP开发3.3.1. JSP创建通过功能向导自动生成必要jsp文件；每个页面的头部必须加上注释说明和资源引入，并在title中描述标题。.. 一般需求jsp示例HrAnnualLeaveApplyForm 新增表单页面HrAnnualLeaveApplyEdit 修改编辑页面HrAnnualLeaveApplyFormAudit 表单审核页面HrAnnualLeaveApplyList 数据列表查询页面3.1.2. 注释3.1.3. head标签 script src=/pub/form/form.js type=text/javascript (function()nui.context=;)(); 页面标题 3.2. 弹出窗口新增表单、编辑表单一般用弹出窗口形式, 窗口一般最小宽度为800px，高度根据表单内容决定；nui打开窗口时，页面数据传递，按收页面必须要clone后再使用，如：/页面间传输json数据function setFormData(data)/跨页面传递的数据对象，克隆后才可以安全使用var infos = nui.clone(data);/保存list页面传递过来的页面类型：add表示新增、edit表示编辑nui.getbyName(pageType).setValue(infos.pageType);/如果是点击编辑类型页面if (infos.pageType = edit) var json = infos.record;var form = new nui.Form(#dataform1);/将普通form转为nui的formform.setData(json);form.setChanged(false);3.3. 移动端xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx3.4. 代码片段示例4. 逻辑构件开发.4.4.1. 逻辑构件命令规则实体名 + biz，全部小写，如hroutleaveapplybiz；通过功能向导自动生成必要逻辑构件。4.2. 逻辑构件示例一般表单审核业务需要逻辑构件示例说明4.2.1. addHrOutLeaveApply(HrOutLeaveApply) 添加表单逻辑流主要操作说明getPrimaryKey 设置主键createProcessInstance 创建流程实例startProcessInstAndFinishFirstWorkItem 启动流程实例并完成第一工作项事务处理 4.2.2. auditHrOutLeaveApply(HrOutLeaveApply, PubBpsAudit, Long, DataObject)表单审批逻辑流审批逻辑流不会自动生成，需要手动创建（一般从其它功能中复制粘贴、修改而来）。参数、变量参考示例主要操作说明queryWorkItemDetail 查询工作项明细，为后续操作提供数据赋值 对审核记录数据赋值finishWorkItem 完成工作项activityRollBack 审核不通过退回申请人修改事务处理 4.2.3. deleteHrOutLeaveApplys(HrOutLeaveApply)删除数据逻辑流参数、变量参考示例4.2.4. getOffWorkResApplyByProcessinstid(Long)根据流程实例ID查询表单数据参数、变量参考示例4.2.5. updateHrOutLeaveApply(HrOutLeaveApply,String) 更新表单数据参数、变量参考示例主要操作说明赋值 对修改人和修改时间赋值回退提交 对回退后重新编辑提交业务的处理(提交到审核不通过节点)事务处理 5. 命名sql开发5.5.1. 命名sql集命名规则根据功能对应数据实体命名，如实体HrOutLeaveApply 对应命名sql集为hrOutLeaveApply.namingsqlx。5.2. 代码片段示例6. 运算逻辑开发6.1. 开发规则业务性(当前业务功能相关)的运算逻辑，根据业务数据实体名称分包和命名，要有详细注释说明6.2. 代码片段示例7. 流程定义规则7.1. 流程定义规则根据业务数据实体名称命名，如实体HrOutLeaveApply对应bps流程名称为hrOutLeaveApply.workflowx；各图元应该间距适中，不能相互重叠；活动项名称应简明；上线后，流程定义中的活动项名称不能随意变更(可能在业务处理中使用了定义的名称)。7.2. 流程相关数据设置POName 必须，对应业务实体全名MAPPAudiuPage移动端功能必须，移动端审核页面MAPPEditPage 移动端功能必须，移动重新编辑页面7.3. 填写表单 活动项7.4. 活动项 参与者规则逻辑分两种情况：一般情况根据业务要求，选择指定参与者或根据规则逻辑自动获取参与者两种方式。...1. 指定参与者当明确指定某人或机构时，可以直接指定参与者。7.4.2. 规则逻辑参与者不能具体指定到人或机构，而要根据申请信息去自动计算获取参与者，就需要在com.skygp.fastdevelop.bpsrule包中自已开发对应业务的规则逻辑，这里选择即可。一般规则逻辑开发是一些运算逻辑，m中已提供了一些通用的规则逻辑，可以直接使用。通用规则逻辑说明：m.BPScommEmpLevel获取各种领导的方法getEmpLevel_CZ()获取处室处长、分公司经理(2级单位正职领导)；getEmpLevel_FCZ()获取处室副处长、分公司副经理(2级单位副职领导)；getEmpLevel_CZandFCZ()获取处室正副处长、分公司正副经理(2级单位正副职领导)；getEmpLevel_KZ()获取科长(3级单位正职领导)；getEmpLevel_FKZ()获取副科长(3级单位副职领导)；getEmpLevel_KZandFKZ()获取正副科长(3级单位领导)；getEmpLevel_ZJL()获取总经理(总公司领导)；getEmpLevel_FZJL()获取副总经理(总公司副职领导)；getEmpLevel_ZJLandFZJL()获取正副总经理(总公司正副职领导)；m.BPScommImmediateSupervisor 获取员工的直属上司getImmediateSupervisor()通过部门和职级获取员工的直属上司7.5. 活动项触发事件流程定义中，每一个（或需要给工作项参考者发送手机消息推送的）活动项加上触发事件，触发时机为“工作项创建后”，事件动作是调用逻辑流“com.skygp.fastdevelop.pub.PartcipantBiz.sendMessagePart”，三个参数取值分别为“thisWorkItem/workItemID”工作项ID“101”表示待办任务提醒“thisProcessInst/processInstID”流程实例ID当审核不通过回退给表单申请人时，发送手机消息给申请人的操作封装在了回退操作逻辑流中，所以流程定义时，“填写申请表单”活动项不需要设置触发事件。系统规则手机程序相关8. 数据库表设计8.1. 表名表名中文名（前缀）：简称_表名 如：财务_资金申请表名英文名（前缀）：表名前缀编码_表名。说明：数据表英文名称全为大写，必须以有特征含义的单词或缩写组成，中间可以用“_”分割，例如：ACC_APPLY_INFO。表名称不能用双引号包含。表名前缀定义如下：No业务分类简称表名前缀编码1财务处财务ACC2企管处企管BUS3总调总调DIS4工程技术工程END5人事处人事HR6信息处信息INF7物贸处物贸MAT8办公室办公OFF9规划处规划PLA10公共信息消息POA11质量处质量QUA12安全处安全SAF13思政处思政THO14系统公共公共PUB8.2. 字段名字段名称全为大写，必须用字母开头，采用有特征含义的单词或缩写，不能用双引号包含。固定字段定义规则：字段数据类型字段说明IDChar(32)业务表主键PROCESSINSTIDVARCHAR(32)流程实例IDACTIVITYINSTIDVARCHAR(32)活动实例IDWORKITEMIDVARCHAR(32)工作项IDENABLE_FLGINT有效标记(1:有 0：无效)CREATE_TIMETIMESTAMP创建时间CREATE_USER_IDVARCHAR(32)创建人MODIFY_TIMETIMESTAMP修改时间MODIFY_USER_IDVARCHAR(32)修改人SORT_NOINT排序号字段后缀后缀备注_ID外键字段_IFLG整型不可维编码_SFLG任意型不可维编码_ICD整型可维编码_SCD任意型不可维编码_ICODE整型单编码表_SCODE任意型单编码表_DATE日期类型_TIME日期时间类型_INFO1长文字=100位小于100字段不加后缀_INFO2长文字200位以内_INFO5长文字500位以内_INFO9长文字500位以上_CNT数量数据类型：int_NUM金额数据类型：number_NO编号/号8.3. 英文常用语中文名英文备注人USER单位ORG增加ADD保存SAVE删除DEL修改CHANGE审请APPLY