PowerBuilder普升软件开发规范

湖南普昇科技有限公司 软件开发规范软件开发规范 一 目的一 目的 为规范软件开发流程 减少对象的重名率 方便开发人员进行对象的查找和修改以及 日后的维护工作 公司所有使用 PowerBuild 开发的开发人员都必须遵守该规范 二 适用范围二 适用范围 本规范适用于 PowerBuild 开发的应用程序 其他产品开发亦可以参照该规范 三 命名规范三 命名规范 1 1 PBLPBL 文件命名规范文件命名规范 PBL 文件根据功能模块来进行划分 因此命名亦根据功能模块来进行规范 每个 模块选用合适的简短缩写作为前缀 如果需要增加新的 pbl 文件 应经过讨论后选用合适 的缩写前缀 然后再增加 2 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 新建采购计划单明细 每个对象都必须在对象的说明属性每个对象都必须在对象的说明属性 CommentsComments 里面简要说明对象的用处 这样便里面简要说明对象的用处 这样便 于理解对象的作用 减少误删的情况 于理解对象的作用 减少误删的情况 2 报表类型窗口和数据窗口 窗口名称窗口名称 对象类型缩写对象类型缩写 模块简短缩写模块简短缩写 rpt rpt 窗口功能说明窗口功能说明 附加说明附加说明 中 间以 分隔 例 w sa rpt cust sale gather 往来单位销售汇总 w sa rpt art sale detail 品种销售明细 3 窗口标题 窗口标题应简明扼要 能清楚的说明窗口要实现的功能 并保持窗口名称所采用 的术语专业 同时 窗口的名称必须和 Action 或事务流程所描述的一致 以避免引起 用户对窗口功能的理解分歧 4 数据窗口标题 对 grid 类型的数据窗口 注意设置数据窗口的 is title 和 is subtitle 标题 此标题 将会影响打印的效果 四 界面效果规范四 界面效果规范 1 1 数据窗口规范数据窗口规范 a 窗口和数据窗口文字的字体一般采用 9 号的宋体字 对于单据头的文字 采 用蓝色的 22 号宋体字 b 窗口和数据窗口的字段名称统一采用 Erwin 图里面的字段名称 并保持同一 字段在不同窗口和数据窗口的一致性 c 数据窗口字段 如果是字符串一般左对齐 如果字段中列值的长度一样 也 可以居中 数字类型的字段右对齐 d 对于 Grid 类型的数据窗口 带区 Header 一般为 72 个 PBU 带区 Detail 一 般为 84 个 PBU Summary 和 Footer 同样也保持在 84 个 PBU 金额和数 量都要求有汇总 根据数据记录数的多少 如果数据记录数多可以把汇总放 湖南普昇科技有限公司 在 Footer 带区 否则放在 Summary 以方便用户查看 e FreeForm 类型的数据窗口 字段的高度一般为 68 个 PBU 可编辑的字段 使用白色背景 不可编辑的字段使用 ButtonFace 背景 如果字段的背景和 数据窗口的背景颜色一样 字段的背景则使用透明背景 TransParent 这样 方面用户进行自定义的背景设置 f 数量和金额字段 如果是负数则要显示红色 g 列的宽度以能够显示列的值为宜 让用户不需要拖动鼠标就能在界面上能看 到想要看到的数据 h FreeForm 类型的数据窗口应屏蔽鼠标右键功能 Grid 类型的数据窗口则需 要允许右键功能 同时对于允许导出的 Grid 表格数据 需要放开导出到 Excel 的功能 i Tab 页标签的名称和窗口名称以及系统菜单功能名称应保持一致 j 数据窗口中可选择查询数据的列后面都应该有可以使用鼠标的 按钮 在使用对象查找的对象里面应该有查询按钮 快捷键 Alt Q k 字段的可录入长度要考虑在各种界面的显示以及打印时能够完全打印 2 2 窗口规范窗口规范 a 界面应支持全键盘无鼠标操作 i 工具条的快捷键都应提供统一通用的快捷键 新增 Ctrl N 打开 Ctrl O 保存 Ctrl S 删除 Ctrl D 刷新 F5 打印 Ctrl P 关闭 Ctrl F4 提交 F12 ii 界面按钮栏中的按钮都应该有对应的快捷键 同一功能的按钮提供的快 捷键在整个系统中应保持一致 新增 N 修改 M 删除 D b 使用 tab 键或者方向键 能使光标跳转到每一个可选择或者可录入的栏目中 正向顺序和反向顺序应该正好对调 c 会弹出窗口的功能按钮 在按钮的名称后要加上三点 如新增 新增 N 按钮的长度以 PB 自动在文本的基础上扩展为宜 按钮之间的间距 保持在 20 d 非法录入时光标的位置 例如在 往来单位 栏键入并不存在的往来单位编 号 按回车键确认在弹出窗口中点击 确定 或者直接按 Esc 键退出时 不 接受数据 光标跳转 e 所有通过别名查询的都应同时支持半角的百分号 通配符和全角的百分 号 通配符 f 别名查找对象高度的大小为 1550 132 g 完成一个表单编辑后 如果是不可逆的前向操作 提交之后的单据无法撤销 湖南普昇科技有限公司 或者删除 在提交的时候应询问用户是否确定提交 h 所有的单据的退回 反审核 操作都应该询问用户是否确定退回 反审核 i 录入限制 对于可录入的栏目 栏目的宽度应该尽量与可录入的最大字符数 一致 并且可录入字符数与对应的类型保存时的长度一致 j 显示 同一字段在不同窗口显示的默认宽度 名称应该保