1993-2017金蝶国际软件集团有限公司金蝶云星空客户化开发规范管理部门：总部交付支持部时间：2019.6.112目录目前现状分析升级和补丁规范现场管理规范BOS设计器规范代码规范规范管理数据库规范目前金蝶云星空二次开发突出问题分析设计和开发能力不足不规范管理薄弱性能问题严重开发的东西不能满足客户需求不按星空二开标准进行开发程序运行超慢甚至崩溃文档缺失缺乏相关修改记录需求把控能力薄弱未确认好需求就开发开发的东西问题多、质量差未经严格测试就直接部署生产环境未达到上线要求硬上线开发的东西设计不合理、性能差现场管理规范问题现场多环境管理比较混乱，问题比较多，也是交付过程中遇到问题最多，最头痛的问题严禁将不仅过测试环境的测试，就直接将开发环境的代码或者数据库脚本直接更新到正式环境开发环境测试环境生产环境问题列举管理要求直接在生产环境上修改数据库直接从测试环境修改数据库开发环境、测试环境、生产环境未保存一致数据未保持一致，更新到生产环境出错二开时命名不规范，造成与标准产品命名冲突，升级时出错建议统一使用协同开发平台现场环境必须有开发环境、测试环境、生产环境，并且保存环境一致禁止直接修改测试环境和生产环境部署时必须按从开发环境->测试环境->生产环境规范执行，测试环境与生产环境的数据也必须保存一致，测试没问题时才更新到生产环境二开必须按二开的规范进行编码二开时需做好版本和补丁规范管理，并对二开部分需做修改记录直接修改直接修改升级和补丁规范管理补丁管理在打补丁时需按照补丁的要求，正确的打补丁，补丁会对应到产品版本，遵循不能打的补丁坚决不能打，需要打的补丁必须的原则打全的原则打补丁时必须在测试环境先打补丁，测试没问题后才打到正式环境，需注意不是一台应用服务器对应的正式账套和测试账套测试环境的应用服务器环境和数据库环境需保持一致，否则可能造成虽然测试环境正常但是到正式生产环境出问题的情况升级管理升级前必须做好备份升级时需先升级管理中心，再升级业务中心.客户对已使用金蝶云星空进行升级时工作量评估时必须要包括大量的测试时间及问题修改时间，否则造成时间严重不够，对升级工作造成影响标准化规范管理BOSIDE权限管控客户方对于BOSIDE只允许管理员能修改，对普通用户不允许修改，否则可能对标准产品或者二次开发的成果随便改动，可能会对业务产生影响，也很难追溯到谁修改的，因为现在很多对BOSIDE无修改记录每次改动都要有记录每次二开记录修改都必须按标准模板填写修改记录，修改记录模板如右附件需求控制二次开发需求控制是非常重要的一个环节，对于未经客户确认的需求不能进行后续的设计和开发工作。完整的开发方案对应开发内容多，开发实现复杂的项目必须有完整的开发方案并与客户确认开发计划及周报开发部分必须有对应的开发计划，并根据计划进行跟踪，并需将开发进度与实施进度结合每周汇报给客户需要使用协同平台协同平台集金蝶云星空产品的开发、测试、检测、构建、发布及运维于一体，提供过程管理，与SVN和VS高度集成，既方便又能进行规范管理代码规范容错处理为了保证系统的稳定性和系统正确性，对于某些可能会出异常的地方加try{}catch{},在异常做日志记录，或者给某些字段做对应的其他赋值处理，让程序继续执行完，不影响别的程序执行，对于见到错误就退出的，则加个对应的提示，然后退出程序执行，对于多线程更应考虑.日志记录为了排查和跟踪问题，则需要增加日志记录，特别是集成，最理想的是两边都加日志记录，以便查出出问题的环节数据完整性和正确性保障1.事物处理：对于业务关联性很强的数据处理，必须加事物，必须都成功写入时才可以成功提交。2.字段类型控制：必须保障所加入字段为正确类型，比如时间以时间类型，不要以文本随便输入，数值类型，必须保障输入的值为数值，并且有小数位数控制，邮箱格式，必须输入邮箱格式进行验证。3.必填字段：有些关键字段不能为空，则必须设置为必填字段。4.数据范围和字段长度：有些字段数据只能在某些数值范围之内，在必须控制这些字段的输入值在某些范围之内5.唯一性控制：当某些单据和基础资料需要保障以某字段或者组合字段进行唯一性控制，避免重复6.不能修改和删除的数据控制：对于有些不能修改的一些参数等则控制为不可编辑，对于不能删除的预制数据则需控制为不可删除，否则对系统的逻辑产生巨大影响代码中杜绝死循环的控制逻辑和死锁的情况，需要释放的资源比较及时释放代码规范插件继承体系•派生插件基类，重载事件处理•需根据领域类型，派生不同的插件基类，能重载的事件也有所不同•插件基类在Kingdee.BOS.Core.dll领域类型基类命名参考动态表单–维护AbstractDynamicFormPlugInExpressionEdit业务单据–维护AbstractBillPlugInPurchaseOrderEdit业务单据–列表AbstractListPlugInPurchaseOrderList基础资料–维护AbstractBasePlugInMaterialEdit基础资料–列表AbstractListPlugInMaterialList代码注释说明•类说明（说明其用途，与其类的关系）•方法说明（说明定义这个方法的用途，对于修改时方法时需注明修改的原因，还需要参数进行说明）•属性及变量说明（说明属性和变量的用途）•关键代码说明（说明关键代码的作用，要实现的效果）尽量少用SQL直接保存和更新数据•尽量模拟真实的单据的保存和修改的实现方式，调用平台提供的方法，尽量少用SQL语句直接用insert或者update去插入数据和修改数据代码规范命名空间规范•命名要求表达准确，无歧义•技术名称和功能均使用Pascal大小写•格式：{ISV标识}[.K3][.业务系统][.模块][.功能]•ISV标识：=开发商标识符，如LT•业务系统：=K/3业务系统标识符•模块：=K/3模块标识符•功能：=功能标识符•如：LT.K3.SCM.PUR.Business.PlugIn(采购系统业务对象界面插件)•如：LT.K3.SCM.PUR.Service.PlugIn(采购系统业务对象操作插件)•如：LT.K3.SCM.PUR.Report(采购系统报表插件)程序集•保持与命名空间一致BOS设计器规范问题金蝶云星空BOS设计器•对标准产品的修改，需通过“扩展”方式•新建业务对象编码(FormId)•自动生成，GUID•{ISV标识}_{业务对象标识}，如：LT_PurchaseOrder•元素Key•不允许重复•F_{ISV标识}_{元素含义}，如F_LT_Qty•包括字段、单据体、控件等…•物理字段名建议同字段Key•字段名•不允许重复•F[_]{ISV标识}_{元素含义}，如FLT_Qty•实体名•不允许重复•{ISV标识}_{元素含义}，如LT_Qty数据库规范数据库对象规范•避免扩展冲突•函数、触发器不建议使用数据类型规范•建议采用的字段类型•CHARNCHAR•VARCHARNVARCHAR•BLOBNCLOB•SMALLINTINT•DECIMAL•DATETIME数据库规范数据类型对应关系数据类型长度SqlserverOracleCHAR[1,254]CHAR[(n)]CHAR[(n)]VARCHAR[1,4000]VARCHAR[(n)]VARCHAR2(n)NCHAR[1,2000]NCHAR[(n)]NCHAR[(n)]NVARCHAR[1,4000]NVARCHAR[(n)]NVARCHAR2(n)BLOB[1,]IMAGEBLOBNCLOB[1,]NTEXTNCLOBINT,INTEGER[-2^31,2~31-1]INTNUMBER(10)SMALLINTSMALLINTNUMBER(5)DATETIMEDATETIMEDATEBIGINT[-2^63,2^63-1]BIGINTNUMBER(19)NUMERICDECIMALNUMBERDECIMALDECIMALNUMBER数据库规范数据库对象命名规范•表格命名•{ISV标识}_T_{子系统}_{表名}•如LT_T_PUR_Order•表格名称长度<30字符•字段命名•F[_]{ISV标识}_{字段名}•如FLT_Qty•字段名称长度<30字符数据库规范数据库对象命名规范•其他各种对象命名规则及示例对象命名规则最大长度示例视图{ISV标识符}_V_{名称}30LT_V_USER存储过程{ISV标识符}_P_{名称}30LT_P_GETUSERLIST主键{ISV标识符}_PK_{名称}30LT_PK_USER索引{ISV标识符}_IX_{表缩写}_{字段缩写}30LT_IX_USER_FID缺省值{ISV标识符}_DF_{名称}30LT_DF_USER_FID函数{ISV标识符}_FN_{名称}30LT_FN_GETCOUNT触发器{ISV标识符}_TRG_{名称}30LT_TRG_USERINS序列Z_{ISV标识符}_T_{名称}30Z_LT_T_USER基础资料预插数据内码分配•FID>=100,000•系统自动分配，请避免占用•FID<10,000•K/3Cloud标准产品预插数据内码，且勿占用1993-2017金蝶国际软件集团有限公司Thankyou!
