PowerBuilder普升软件开发规范.doc

湖南普昇科技有限公司
软件开发规范
一．目的
为规范软件开发流程，减少对象的重名率，方便开发人员进行对象的查找和修改以及日后的维护工作。
公司所有使用PowerBuild开发的开发人员都必须遵守该规范。
二．适用范围
本规范适用于PowerBuild开发的应用程序，其他产品开发亦可以参照该规范。
三．命名规范
1．PBL文件命名规范
PBL文件根据功能模块来进行划分，因此命名亦根据功能模块来进行规范，每个
模块选用合适的简短缩写作为前缀，如果需要增加新的pbl文件，应经过讨论后选用合适的缩写前缀，然后再增加。
2．对象命名规范
对象命名采用“对象类型缩写_对象名称”的形式命名，其中，对象名称尽量使用有意义的英文单词或汉语拼音，多个单词之间用下划线(“_”)分隔。
对象类型缩写参照下表：
对象类型类型缩写可选缩写举例说明窗体ww_about,w_bill_list_report数据窗口dwddw_user_maintain可视用户对象uouuo_status_bar不可视用户对象nn_inv_stack菜单mm_sheet下拉数据窗口dddwdddw_stations独立函数ff_get_tax对象函数ofof_get_datetime窗体函数wfwf_center
为了保证窗口和数据窗口对象的不重名以及维护的方便性，对窗口和数据窗口的命名进行特别说明：
1）．功能类型窗口和数据窗口：
窗口名称=对象类型缩写+模块前缀+窗口功能说明+(附加说明)…,中间以‘_’分隔。
例：w_pu_plan_base--采购计划基类窗口
w_pu_plan_new--新建采购计划
w_pu_plan_list--采购计划列表
w_sa_sale_new_serial--批号销售开票
w_sa_sale_new_batch--批次销售开票
数据窗口名称原则上使用和窗口相同的规则，并尽量保持数据窗口和窗口的命名除类型缩写外一样，如果一个窗口有多个数据窗口，可以使用附近说明进行区分。
例：dw_pu_plan_list --采购计划列表
dw_pu_plan_new_header--新建采购计划单头
dw_pu_plan_new_detail--新建采购计划单明细
每个对象都必须在对象的说明属性Comments里面简要说明对象的用处，这样便于理解对象的作用，减少误删的情况。
2）．报表类型窗口和数据窗口
窗口名称=对象类型缩写+模块简短缩写+‘rpt’+窗口功能说明+(附加说明)…,中间以‘_’分隔。
例：w_sa_rpt_cust_sale_gather--往来单位销售汇总
w_sa_rpt_art_sale_detail--品种销售明细
3）．窗口标题
窗口标题应简明扼要，能清楚的说明窗口要实现的功能，并保持窗口名称所采用的术语专业。同时，窗口的名称必须和Action或事务流程所描述的一致，以避免引起用户对窗口功能的理解分歧。
4）．数据窗口标题
对grid类型的数据窗口，注意设置数据窗口的is_title和is_subtitle标题，此标题将会影响打印的效果。
四．界面效果规范
数据窗口规范
窗口和数据窗口文字的字体一般采用9号的宋体字，对于单据头的文字，采用蓝色的22号宋体字
窗口和数据窗口的字段名称统一采用Erwin图里面的字段名称，并保持同一字段在不同窗口和数据窗口的一致性。
数据窗口字段，如果是字符串一般左对齐，如果字段中列值的长度一样，也可以居中；数字类型的字段右对齐。
对于Grid类型的数据窗口，带区Header一般为72个PBU，带区Detail一般为84个PBU，Summary和Footer同样也保持在84个PBU。金额和数量都要求有汇总，根据数据记录数的多少，如果数据记录数多可以把汇总放在Footer带区，否则放在Summary，以方便用户查看。
FreeForm类型的数据窗口，字段的高度一般为68个PBU，可编辑的字段使用白色背景，不可编辑的字段使用ButtonFace背景。如果字段的背景和数据窗口的背景颜色一样，字段的背景则使用透明背景TransParent。这样方面用户进行自定义的背景设置。
数量和金额字段，如果是负数则要显示红色。
列的宽度以能够显示列的值为宜，让用户不需要拖动鼠标就能在界面上能看到想要看到的数据。
FreeForm类型的数据窗口应屏蔽鼠标右键功能，Grid类型的数据窗口则需要允许右键功能，同时对于允许导出的Grid表格数据，需要放开导出到Excel的功能。
Tab页标签的名称和窗口名称以及系统菜单功能名称应保持一致。
数据窗口中可选择查询数据的列后面都应该有可以使用鼠标的（…）按钮；在使用对象查找的对象里面应该有查询按钮（快捷键Alt+Q）。
字段的可录入长度要考虑