开发规范说明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. 数据模型开发1.2.1.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中描述标题。1.2.3.3.1.3.1.1. 一般需求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. 逻辑构件开发1.2.3.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. 活动项 参与者规则逻辑分两种情况：一般情况根据业务要求，选择指定参与者或根据规则逻辑自动获取参与者两种方式。6.7.7.1.7.2.7.3.7.4.7.4.1. 指定参与者当明确指定某人或机构时，可以直接指定参与者。精选文档7.4.2. 规则逻辑参与者不能具体指定到人或机构，而要根据申请信息去自动计算获取参与者，就需要在com.skygp.fastdevelop.bpsrule包中自已开发对应业务的规则逻辑，这里选择即可。精选文档一般规则逻辑开发是一些运算逻辑，com.skygp.fastdevelop.bpsrule.comm中已提供了一些通用的规则逻辑，可以直接使用。通用规则逻辑说明：com.skygp.fastdevelop.bpsrule.comm.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()获取正副总经理(总公司正副职领导)；精选文档com.skygp.fastdevelop.bpsrule.comm.BPScommImmediateSupervisor 获取员工的直属上司getImmediateSupervisor()通过部门和职级获取员工的直属上司7.5. 活动项触发事件流程定义中，每一个（或需要给工作项参考者发送手机消息推送的）活动项加上触发事