《EOS快速开发平台项目开发规范草稿.docx》由会员分享，可在线阅读，更多相关《EOS快速开发平台项目开发规范草稿.docx（14页珍藏版）》请在taowenge.com淘文阁网|工程机械CAD图纸|机械工程制图|CAD装配图下载|SolidWorks_CaTia_CAD_UG_PROE_设计图分享下载上搜索。
1、EOS快速开发平台项目开发规范草稿开发 规范说明 1. 构建包1.1. 项目名称: com.skygp.fastdevelop1.2. 构建包命名 项目名称+构建包名（模块名）如: com.skygp.fastdevelop.demo 1.3. 系统 各业务构建包 说明 com.skygp.fastdevelop.accOA 财务处办公应用模块com.skygp.fastdevelop.busOA 企管处办公应用模块com.skygp.fastdevelop.disOA 总调办公应用模块com.skygp.fastdevelop.engOA 工程技术办公应用模块com.skygp.fastde
2、velop.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.
3、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. 数据模型
4、开发精选文库2.1. 数据集 一般依据业务名称或功能模块来命名数据集。2.2. 数据实体 数据实体名称与数据库表名对应，如表 HR_OUT_LEAVE_APPLY 对应实体名为 HrOutLeaveApply。2.2.1. 主键生成 一般业务表单数据主键用自动生成 uuid 2.2.2. 字段类型 日期(不保存时间)类型用 Date； 日期时间(保存时间)类型用 TimeStamp； 其它常规数据类型与数据库类型对应即可。3. JSP 开发3.1. JSP 创建 通过功能向导自动生成必要 jsp 文件； 每个页面的头部必需加上注释说明和资源引入，并在 title 中描述标题。3.1.1. 一般
5、需求 jsp 示例 HrAnnualLeaveApplyForm 新增表单页面HrAnnualLeaveApplyEdit 修改编辑页面HrAnnualLeaveApplyFormAudit 表单审核页面HrAnnualLeaveApplyList 数据列表查询页面 3.1.2. 注释 <%- Author(s): 开发员拼音驼峰全名(如:LiLong) - Date: 2015-03-01 日期- Description: 功能说明及一些重要流程说明描述-%>3.1.3. head 标签 <head>精选文库<%include file=/common/comm
6、on.jsp%> <%include file=/coframe/tools/skins/common.jsp %> <meta http-equiv=content-type content=text/html; charset=UTF-8 /> <script src=<%=contextPath %>/pub/form/form.js type=text/javascript ></script> <script type=text/javascript>(function()nui.context=<%
7、=contextPath %> )();</script><title>页面标题 </title> </head>3.2. 弹 弹 出窗口 新增表单、编辑表单一般用弹出窗口形式, 窗口一般最小宽度为 800px，高度依据表单内容确定； nui 打开窗口时，页面数据传递，按收页面必需要 clone 后再运用，如：/页面间传输json数据 function setFormData(data) /跨页面传递的数据对象，克隆后才可以平安运用 var infos = nui.clone(data); /保存list页面传递过来的页面类型：add表示新
8、增、edit表示编辑 nui.getbyName(pageType).setValue(infos.pageType); /假如是点击编辑类型页面 if (infos.pageType = edit) var json = infos.record; var form = new nui.Form(#dataform1);/将一般form转为nui的form form.setData(json); form.setChanged(false); 精选文库 3.3. 移动端 xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx3.4. 代码片段示例精选文库4
9、. 逻辑构件开发 4.1. 逻辑构件吩咐规则 实体名 + biz，全部小写，如 hroutleaveapplybiz； 通过功能向导自动生成必要逻辑构件。4.2. 逻辑构件示例 一般表单审核业务须要逻辑构件示例说明 4.2.1. addHrOutLeaveApply(HrOutLeaveApply) 添加表单逻辑流精选文库 主要操作说明 getPrimaryKey设置主键 createProcessInstance创建流程实例 startProcessInstAndFinishFirstWorkItem 启动流程实例并完成第一工作项精选文库事务处理4.2.2. auditHrOutLeaveA
10、pply(HrOutLeaveApply, PubBpsAudit, Long, DataObject) 表单审批逻辑流审批逻辑流不会自动生成，须要手动创建（一般从其它功能中复制粘贴、修改而来）。参数、变量参考示例精选文库 主要操作说明 queryWorkItemDetail 查询工作项明细，为后续操作供应数据 赋值对审核记录数据赋值精选文库finishWorkItem完成工作项 activityRollBack审核不通过退回申请人修改 事务处理4.2.3. deleteHrOutLeaveApplys(HrOutLeaveApply) 删除数据逻辑流精选文库 参数、变量参考示例4.2.4.
11、getOffWorkResApplyByProcessinstid(Long) 依据流程实例 ID 查询表单数据精选文库 参数 、变量参考示例4.2.5. updateHrOutLeaveApply(HrOutLeaveApply,String) 更新表单数据精选文库 参数、变量参考示例主要操作说明 赋值对修改人和修改时间赋值精选文库回退提交对回退后重新编辑提交业务的处理(提交到审核不通过节点) 事 务处理精选文库5. 命名 sql 开发5.1. 命名 sql 集命名规则 依据功能对应数据实体命名，照实体 HrOutLeaveApply 对应命名 sql 集为 hrOutLeaveApply.
12、namingsqlx。5.2. 代码片段示例6. 运算逻辑开发6.1. 开发规则 业务性(当前业务功能相关)的运算逻辑，依据业务数据实体名称分包和命名，要有具体注释说明 6.2. 代码片段示例精选文库 7. 流程定义规则精选文库7.1. 流程定义 规则 依据业务数据实体名称命名 ，照实体 HrOutLeaveApply 对应 bps 流程名称为 hrOutLeaveApply.workflowx； 各图元应当间距适中， 不能相互重叠 ； 活动项名称应简明； 上线后，流程定义中的活动项名称 不 能随意变更 (可能在业务处理中运用了定义的名称)。7.2. 流程 相关数据设置POName 必需，对应
13、业务实体全名MAPPAudiuPage 移动端功能必需，移动端审核页面MAPPEditPage 移动端功能必需，移动重新编辑页面7.3. 填写表单 活动项精选文库 7.4. 活动项 参加 者规则 逻辑 分两种状况：一般状况依据业务要求，选择 指定 参加者 或 依据规则 逻辑 自 动获得 参加者 两种方式。7.4.1. 指定参 与 者 当明确指定某人或机构时，可以干脆指定参加者。精选文库 7.4.2. 规则 逻辑 参加者不能详细指定到人或机构，而要依据申请信息去自动计算获得参加者，就须要在com.skygp.fastdevelop.bpsrule 包中自已开发对应业务的规则逻辑，这里选择即可。精
14、选文库 一般规则逻辑开发是一些 运算逻辑 ，m 中已供应了一些通用的规则逻辑，可以干脆运用。通用规则 逻辑 说明：m.BPScommEmpLevel 获得各种领导的方法 getEmpLevel_CZ() 获得处室处长、分公司经理 (2 级单位正职领导 ) ；getEmpLevel_FCZ() 获得处室副处长、分公司副经理 (2 级单位副职领导 ) ；getEmpLevel_CZandFCZ() 获得处室正副处长、分公司正副经理 (2 级单位正副职领导 ) ；getEmpLevel_KZ() 获得科长 (3 级单位正职领导 ) ；getEmpLevel_FKZ() 获得副科长 (3 级单位副职领
15、导 ) ；getEmpLevel_KZandFKZ() 获得正副科长 (3 级单位领导 ) ；getEmpLevel_ZJL() 获得总经理 ( 总公司领导 ) ；getEmpLevel_FZJL() 获 取副总经理 ( 总公司副职领导 ) ；getEmpLevel_ZJLandFZJL() 获得正副总经理 ( 总公司正副职领导 ) ；精选文库 m.BPScommImmediateSupervisor 获得员工的直属上司 getImmediateSupervisor() 通过部门和职级获得员工的直属上司 7.5. 活动项 触发事务流程定义中，每一个（或须要给工作项参考者发送手机消息推送的）活动
16、项加上触发事务，触发时机为工作项创建后，事务动作是调用逻辑流com.skygp.fastdevelop.pub.PartcipantBiz.sendMessagePart，三个参数取值分别为thisWorkItem/workItemID工作项 ID 101表示待办任务提示 thisProcessInst/processInstID流程实例 ID当审核不通过回退给表单申请人时，发送手机消息给申请人的操作封装在了回退操作逻辑流中，所以流程定义时，填写申请表单活动项不须要设置触发事务。系统规则 手机程序相关8. 数据库表设计8.1. 表名 表名中文名（前缀）：简称_表名如：财务_资金申请精选文库表名
17、英文名（前缀）：表名前缀编码_表名。说明：数据表英文名称全为大写，必需以有特征含义的单词或缩写组成，中间可以用_分割，例如：ACC_APPLY_INFO。表名称不能用双引号包含。表名前缀定义如下：No 业务分类 简称 表名前缀编码 1 财务处 财务 ACC 2 企管处 企管 BUS 3 总调 总调 DIS 4 工程技术 工程 END 5 人事处 人事 HR 6 信息处 信息 INF 7 物贸处 物贸 MAT 8 办公室 办公 OFF 9 规划处 规划 PLA 10 公共信息 消息 POA 11 质量处 质量 QUA 12 平安处 平安 SAF 13 思政处 思政 THO 14 系统公共 公共
18、PUB 8.2. 字段名 字段名称全为大写，必需用字母开头，采纳有特征含义的单词或缩写，不能用双引号包含。固定字段定义规则：字段 数据类型 字段说明 ID Char(32) 业务表主键 PROCESSINSTID VARCHAR(32) 流程实例 ID ACTIVITYINSTID VARCHAR(32) 活动实例 ID WORKITEMID VARCHAR(32) 工作项 ID ENABLE_FLG INT 有效标记(1:有0：无效) CREATE_TIME TIMESTAMP 创建时间 CREATE_USER_ID VARCHAR(32) 创建人 MODIFY_TIME TIMESTAMP
19、 修改时间 MODIFY_USER_ID VARCHAR(32) 修改人 SORT_NO INT 排序号字段后缀 后缀备注精选文库_ID 外键字段_IFLG 整型不行维编码_SFLG 随意型不行维编码_ICD 整型可维编码_SCD 随意型不行维编码_ICODE 整型单编码表_SCODE 随意型单编码表_DATE 日期类型_TIME 日期时间类型_INFO1 长文字=100 位 小于 100 字段不加后缀 _INFO2 长文字 200 位以内_INFO5 长文字 500 位以内_INFO9 长文字 500 位以上_CNT 数量 数据类型：int _NUM 金额 数据类型：number _NO 编
20、号/号 8.3. 英文常用语 中文名 英文 备注 人 USER单位 ORG增加 ADD保存 SAVE删除 DEL修改 CHANGE审请 APPLY注册 REG流程 FLOW活动 ACT审核 AUDIT工作 WORK内容 CONT地址 ADDR项目 PROJ 8.4. 其它 数据字典变量定义规则 变量名：表名前缀编码+状态或标记类字段+自定义编码 如:ACC_SCD_XXXXXX_XXXXX;精选文库INF_SFLG_XXXXX_XXXX;以下是本系统定义规则，并不表示数据库数据中数据类型自身含义 Char(32)：定长字符串，主要用于 UUID 主键字段或外键字段 VARCHAR(32)：变长字符串，主要适用于值不包含全角字符、中文状况 NVARCHAR2：变长字符串，主要适用于值包含全角字符、中文等状况