企业财务管理系统源码规范设计

1 本源码下载地址： 财务及企业管理软件开发规范 财务及企业管理软件开发规范 文档类别及使用对象文档类别及使用对象 文档类别 该文档是为浪潮软件通用软件公司财务产品部财务产品开发提供一个规范性文件。 使用对象 该文档的使用对象为财务产品部分析人员、设计人员、程序员、测试员及项目管理人员 和质量保证人员。 未经财务产品部负责人许可， 该文档不得提供上述规定对象以外的人员阅 读或使用。 第一章 第一章 导言导言 一、一、 目的目的 该文档是为财务产品部进行财务软件开发提供的规范，其目是： 为各类开发、测试文档的编写提供标准 保证软件实现时有统一的标准可参照 使产品结构的组织方式统一 保证软件测试时遵循一定的方法及规范 能够合理的管理及使用公用资源 二、二、 范围范围 本文档描述了财务产品部进行财务软件开发时提供的需求规格说明书、 软件设计说明书 的标准内容，给出了软件实现过程中的所依据的标准，软件在测试过程中工作内容，以及公 用资源库的管理和使用办法。 2 三、三、 术语定义术语定义 子系统： 模块： 四、四、 参考资料参考资料 1 计算机软件工程规范国家标准汇编 中国标准版出版社 1992 2 企业管理信息系统开发指南 浪潮集团山东通用软件有限公司 1997.8 五、五、 版本更新记录版本更新记录 版本版本/修订版 修订版 日期 日期 修改记录 修改记录 备注备注 1.0 98.10 初始版本 第二章 第二章 开发文档规范开发文档规范 第一节 第一节 业务流程图业务流程图 一一采用工具采用工具 采用 VISIO 系列工具。 二二书写规定书写规定 在充分了解用户业务的基础上，采用 VISIO 工具书写流程图。 1按某一具体的业务形成一个文件。 例如： “采购计划”的流程图存放成一个文件， “采购核算”的流程图存放成另 一文件。其中“采购计划” 、 “采购核算”是两种具体业务。 3 2文件的开始内容，是所描述业务的名称。 例如： “采购计划”流程图文件的第一页的题目是“采购计划” 。 3在文件的 Properties 属性中，写明文件的“Title” 、 “Subject” 、 “Creator”及简单 的描述“Description” 。 4多页描述 业务内容较多，不能在一页内完整描述时，分页描述。业务的起始内容书写在第一 页，以后的内容放在后页中。 5页大小一般采用 A4 纸的大小，可以根据不同情况调整。 三三书写格式书写格式 流程图中所涉及的不同对象、不同的表达方式采用以下规定。 1业务名称。 汉字书写，字号为 14，黑体，居中或左对齐。 2各种对象的表示符号 A人员，例如操作员、记帐员、客户、供应商等，采用圆圈内书写人员的方式。 B判断，例如审核等，采用菱形符号，其判断结果为“Yes”或“No” ，并且使 用箭头指出。 C操作，例如记帐、材料出入库等，采用矩形符号，其中写明操作方式。 一般来说，操作是由人员执行的，执行人在操作左边或上面表示，用箭头连接。 制单 人 审核 Yes No 记帐 制单 人 4 D输入操作，例如单据输入等，采用梯形符号，其中写明操作方式。 E实物，例如材料、产成品等，采用平行四边形符号，其中写明实物名称。 F单据，例如入库单、记帐凭证等，采用下面符号，其中写明单据名称。 前者表示一张单据，后者表示多张单据。 G存档结果，采用下面符号，其中写明操作方式。 3表示符号的大小及字体规格 各种表示符号不能忽大忽小，应在美观、流畅基础上设置，一般采用以下规格： 圆圈大小直径为 2 cm，其他符号横向纵向比例为 3：2，既横向为 3cm，纵向为 2cm 。当然根据需要进行整体整体的适当放大放大。 字体规格：字型为 Arial, 字号为 10Pt. 可随符号的放大，字体增大。 4表示符号的顺序及连接 根据业务的流程，表示符号从左到右排列，之间采用箭头连接，并且箭头的两端分 别连接符号的中间；对于分支的连接方式采用树状符号。 例如： 记帐 员 记帐 记帐 材料 记帐凭证 销售发票 输入 存档 存档 记帐 员 No 5 四四输出规定输出规定 在打印输出时，设置打印格式，预留装订线的位置。 装订时，按照业务流程从上到下排列纸张顺序。 第二节 第二节 类图类图 一一使用工具使用工具 Rational Rose 二操作步骤二操作步骤 21 找准对象，将各对象的描述信息写好。 22 画出对象间一般到特殊（继承） 、整体到部分（聚簇） 、依赖、联系等的关系，可 以对应相应的描述信息。 23 标记出一对多，多对一的关系。 24 在对象上添上属性，属性的类型要表达出来（例如：主键、外键） 。 25 在对象上添加上方法，可对应相应的描述信息。 26 检查对象的关系是否合理。 27 检查对象上的方法是否实现了所有功能。 28 重新抽象对象，重新调整关系。 三书写规定三书写规定 在划类图时应坚持以下原则： 31 类图以清晰表达对象间的关系为目的，一个系统可画若干类图，一张图可只表达 关系紧密的几个对象，不一定必须将所有对象放到一张图中表达。 32 各对象之间的关系线，以不交叉为原则。 3 3 对象一定得找全、找准 四、输出规定输出规定 41 类图 42 rose 的 report （word 文挡） 第三节 第三节 软件需求规格说明书软件需求规格说明书 该说明书应按照以下格式编写，具体如下： 文档类别及使用对象文档类别及使用对象 制单 人 录入 凭证 记帐 帐薄 审核 6 1导言导言 11 目的目的 说明编写这份软件需求规格说明书的目的。 . 2 范围范围 描述本文档所涉及的范围及未涉及的内容。 13 术语定义术语定义 列出本文件中用到的专门术语的定义和外文首字母组词的原词组。 14 参考资料参考资料 列出用得着的参考资料。 15 版本更新记录版本更新记录 记录本文档的版本更新过程。 2任务概述任务概述 21 目标目标 叙述该项软件开发的意图、 应用目标、 作用范围以及其他应向读者说明的有关该软件开 发的背景材料。 解释被开发软件与其他有关软件之间的关系。 如果本软件产品是一项独立的 软件，而且全部内容自含，则说明这一点。如果所定义的产品是一个更大的系统的一个组成 部分， 则应说明本产品与系统中的其他各组成部分之间的关系， 为此可使用一张方框图来说 明该系统的组成和本产品同其他各部分的联系和接口。 22 用户的特点用户的特点 列出本软件的最终用户的特点，充分说明操作人员、维护人员的教育水平和技术专长， 以及本软件的预期使用频度。这些是软件设计工作的重要约束。 23 假定和约束假定和约束 列出进行本软件开发工作的假定和约束，例如经费限制、开发期限等。 3需求规定需求规定 31 对功能的规定对功能的规定 用列表的方式（例如 IPO 图） ，逐项定量和定性地叙述对软件所提出的功能要求，说明 输入什么量、经怎样的处理、得到什么输出，说明软件应支持的终端数和应支持的并行操作 的用户数。 32 对性能的规定对性能的规定 321 精度精度 说明对该软件的输入、输出数据精度的要求，可能包括传输过程中的精度。 322 时间特性要求时间特性要求 说明对于该软件的时间特性要求，如对： A响应时间； B更新处理时间； C数据的转换和传送时间； D解题时间； 等的要求。 323 灵活性灵活性 说明对该软件的灵活性的要求， 即当需求发生某些变化时， 该软件对这些变化的适应能 力，如： A操作方式的变化； B运行环境的变化； 7 C同其他软件的接口的变化； D精度和有效时限的变化； E计划的变化或改进。 对于为了提供这些灵活性而进行的专门设计的部分应该加以标明。 33 输入输出要求输入输出要求 解释各输入输出数据类型，并逐项说明其媒体、格式、数值范围、精度等。对软件的数 据输出及必须标明的控制输出量进行解释并举例，包括对硬拷贝报告（正常结果输出、状态 输出以及异常输出）以及图形或显示报告的描述。 34 数据管理能力要求数据管理能力要求 说明需要管理的文卷和记录的个数、 表和文卷的大小规模， 要按可预见的增长对数据及 其分量的存储要求作出估算。 35 故障处理要求故障处理要求 列出可能的软件、硬件故障以及对各项性能而言所产生的后果和对故障处理的要求。 36 其他专门要求其他专门要求 如用户单位对安全保密的要求，对使用方便的要求，对可维护性、可补充性、易读性、 可告性、运行环境可转换性的特殊要求等。 4运行环境规定运行环境规定 41 设备设备 列出运行该软件所需要的硬设备。说明其中的新型设备及其专门功能，包括： A处理器型号及内存容量； B外存容量、联机或脱机、媒体及其存储格式，设备的型号及数量； C输入及输出设备的型号和数量，联机或脱机； D数据通信设备的型号和数量； E功能键及其他专用硬件。 42 支持软件支持软件 列出支持软件，包括要用到的操作系统、编译（或汇编）程序、测试支持软件等。 43 接口接口 说明该软件同其他软件之间的接口、数据通信协议等。 44 控制控制 说明控制该软件的运行的方法和控制信号，并说明这些控制信号的来源。 第四节 第四节 软件设计规格说明书软件设计规格说明书 该说明书应按照以下格式编写，具体如下： 文档类别及使用对象文档类别及使用对象 描述本文档的类别、使用对象及使用对象外的对象在什么情况下可以使用本文档。 1导言导言 11 目的目的 描述本文档的编写目的。 12 范围范围 描述本文档所涉及的内容范围。 13 术语定义术语定义 对本文档所涉及的一些语述进行解释。 8 14 参考资料参考资料 描述本文档的参考资料 15 版本更新记录版本更新记录 记录本文档的版本更新记录。 2产品框架结构图产品框架结构图 产品框架结构图描述整产品的体系结构，应包含如下内容：整个产品的体系结构图（模 块图） ，各模块接口关系。 3软件处理流程图软件处理流程图 该流程图应是基于模块的。 每个模块的流程图分主流程图和细化的流程图。 细化的流程 图的划分标准，以一个独立的业务对象或功能对象为依据。 软件处理流程图的内容：功能处理流程的描述，主要处理方法的描述，主要系统参数的 定义，与其他系统接口的描述。 4功能层次图功能层次图 是软件完成需求规格、处理流程的具体表现形式。功能层次应与业务流程相对应，以便 于在精简或增加业务流程时，从功能层进行相应的减少或扩充。主要有以内容： 功能层次图 功能层次图以树状结构描述，功能层次图中，每一项功能都应规定字的功能号，这里的 功能将是在软件实现时进行权限控制及作其它引用的功能号，因此在定义时必须遵循规定， 这里规定功能号的格式如下： 系统编号（两位系统编号（两位）+功能层次号（功能层次号（4 位）位） 系统编号的规定参见附录； 系统菜单 定义出模块的下拉主菜单， 各菜单中也要体现中功能号， 以便于了解功能层次图同系统 菜单各项的联系。 5详细设计详细设计 详细设计应基于功能层次图及以前各部分资料， 其主要内容包括界面设计、 程序处理流 程、方法、说明等等，是程序员进行程序设计的依据。具体内容如下： 任务编号名称：作为某一任务的标识。 背景描述：对这一任务的背景进行简单的描述。 涉及数据表（主要相关） ：该任务涉及到的主要操作表及相关操作表。 界面：该任务所用到的所有界面的描述。 界面中所涉及到的项目的解释。 功能、性能：该任务要提供的功能及其描述，以及应达到的性能要求。 处理：该任务的处理流程。对于简单任务，可不进行描述。 主要算法设计：该任务所涉及到的主要算法及描述，对于简单或常用的算法 可不必进行描述。 注意事项：对于一些特别需求注意的事项要在此注明。 6数据结构设计数据结构设计 包括以下内容： 9 表名识别名称：任为表的标识。 属性描述：描述该表的所有属性及各属性的属性，主外键描述等，具体格式 如下： 表名 表的命名，命名规范 识别名称 表示意议的汉字名称 索引 如有多个索引，分别列出 序号 序号 名称 名称 识别名 识别名 类型 类型 空否 空否 缺省 缺省 检查 检查 主外键 主外键 备注备注 主键用表示，外键用表示，如果为外键，则要在备注中指明引用的表。 该项内容也可以直接从类图生成的资料成获得，按原格式即可。 索引描述：描述该表的索引，将所有的索引都列示出来，具体格式： 索引：名称，unique,clustered,列名 涉及方法：该表所涉及的操作。 第三章 第三章 软件实现规范软件实现规范 第一节 第一节 组织方式组织方式 产品的结构应遵守的原则：执行方便、登录简单、相互联系、风格流行。执行方便是指 在用户在操作时能够很方便的操作国强财务软件能中的任何一个模块； 登录简单是指用户在 登录国强财务软件时是不需录经过太复杂的过程， 能够很直接的进行系统进行操作； 相互联 系是指用户登录进行某一个子系统后， 不需要再重新登录就能直接转换到其它子系统下进行 操作； 风格流行是指产品的形式、 结构要符合当前流行软件及同类产品中一些优秀软件的形 式和结构。签于以上原则，建议国强财务软件的组织方式如下： 国强财务软件按照子系统进行划分， 每一个子系统作为一个应用软件， 建立一个独立的 图标，建立国强财务软件组，各子系统的图标均在该组内。 各个子系统的应用菜单中，应均有一项联接其它子系统的菜单。 各个子系统的登录方式如下： 执行程序时首先显示一欢迎窗口， 该窗口应以简炼、 精致、 准确反映信息为原则；显示完迎窗口后显示登录窗口，在该窗口中应允许输入登录编号、登 录口令、选择帐套，可以新建帐套、新建用户；登录信息输入正确后进行该套帐进行操作。 具体如下图： 各子系统的操作主画面还是以传统的下拉式菜单加 TOOL BAR 的方式，第一行为主操 作菜单，第二行为 TOOL BAR，最后一行为运行状态。对于各个具体操作功能，也以下拉 菜单加 TOOL BAR 的方式进行操作。具体如下： 执行图标 显示欢迎信息 登录窗口 主操用界面 菜单区 TOOL BAR 区 操作区 10 第二节 第二节 命名规范命名规范 一、数据库对象命名规范 一、数据库对象命名规范 【目 【目 的】的】 使本产品的所有系统既相互联系，又相互独立。既能单独运行于特定的数据库，又能同 时运行于特定的数据库。使所有系统设计人员及程序员在设计数据库对象时有据标准可依。 使整个产品不仅在界面、风格上一致，在内部结构上也采用相同的风格，以利于整个的产品 的共同发展。 【定义内容】【定义内容】 需定义的内容包括所有数据库对象：表、视图、存储过程、触发器及表的列。 【命名规则】【命名规则】 前缀前缀+表意名表意名 表意名以汉字拼音简写或英文单词。 【详细内容】【详细内容】 1、表、表 前缀前缀=系统编号系统编号 表名最长为 13 位。 所有字符均以大写字母表示。 如帐务系统中的科目字典： ZWKMZD 如销售中的产品字典： XSCPZD 2、列、列 前缀前缀=表名表名_ 表意名最长为 15 位。 所有字符均以大写字母表示。 如科目字典中的科目编号： 操作员 会计日期 当前日期 时间 软件名称 使用单位 11 ZWKMZD_KMBH 3、视图、视图 前缀前缀= vw_ 表意串中所有字符均以小写字母表示，表意串即为对应的表名。 如帐务中关于专项核算的视图： vw_gszwhszd 4、存储过程、存储过程 前缀前缀=pr+变量类型变量类型 表意串中的各意义段的第一个字符为大写字母。 如取得两字符串中不同部分的存储进程： prsTwoStr 5、触发器、触发器 命名规则不同于以上： 前缀前缀+对应表名对应表名+后缀 后缀 前缀前缀=tr_ 后缀根据触发器的性质决定：后缀根据触发器的性质决定： 插入触发器插入触发器 _ins 删除触发器删除触发器 _del 更新触发器更新触发器 _upt 如：科目字典增加触发器： tr_gszwkmzd_ins 6、部分表义名的构成： 、部分表义名的构成： 代表意义 代表意义 标识符 标识符 编号编号 Bh 名称名称 Mc 金额金额 Je 数量数量 Sl 外币外币 Wb 单价单价 Dj 汇率汇率 Hl 字典字典 Zd 明细明细 Mx 级数级数 Js 二、二、PowerBuilder 对象命名规范对象命名规范 12 【目 【目 的】的】 使程序员能够进行无私程序设计，即避免程序员与其所产生的代码之间的关系过于密 切。提高程序代码的规范化程度，使程序代码易读易懂，并能够达到程序员之间相互进行程 序维护。 【定 【定 义】义】 变量类型：在本规范中，用于定义变量的 PowerBuilder 数据类型和 PowerBuilder 对象类型统称为变量类型。 【命名规则】【命名规则】 所有对象的命名皆依据下列规则： 前缀前缀 + 表意字串表意字串。 该规则由两部分构成： 前缀部分依据不同类型的对象进行不同的规则定义； 表意字串部 分一般是指该对象的含义或功能描述。含义或功能描述应做到言简意赅，可采用纯中文(指 汉字拼音的首字母)，纯西文及中西结合的方法进行描述。 对于 PowerBuilder Controls 的名字，不要使用 PowerBuilder 提供的缺省的纯阿拉伯数 字，而要使用含义明确的表意字串。 变量和对象的命字由程序员自由定义，下面的命名规范主要是对 PowerBuilder 对象 的前缀部分进行规则定义。 【书写标准】【书写标准】 前缀部分皆用小写字母书写； 名字部分的每一个语义段的首字母的皆用大写书写， 也可 以在前缀和表意串之间或表意串各语义段之间以下划线连接。其他字母用小写书写。 【主要内容】【主要内容】 以下为本规范中涉及的主要的 PB 对象： Windows，DataWindows，UserObjects； PowerBuilder Controls； Objects in DataWindow； Functions； Variables； 临时表等。 1、 Window，DataWindow，UserObject 命名规范命名规范 （1） Window 前缀：前缀： w_ + 系统名称系统名称 + _表意字串表意字串 例如： 帐务系统中的科目字典维护窗口: w_zw_KmzdWh （2） DataWindow 前缀：前缀： dw_ + 系统名称系统名称 + _表意字串表意字串 例如： 帐务系统中的科目字典数据窗口(查询用)： dw_zw_KmzdWh_cx (增加删除修改用): dw_zw_KmzdWh_Update 13 （3） UserObject 前缀：前缀：uo_ + 系统名称系统名称 + _ 或者或者 u_ + 系统名称系统名称 + _ 例如：可经 PowerBuilder 直接调用的 Windows 函数集对象： u_pub_WinFunc （4） ） 系统名称代码见后系统名称代码见后 2、 PowerBuilder Controls PowerBuilder Controls 的前缀一般采用 PowerBuilder 提供的缺省前缀，不采用其提供 的。 （1） CheckBox 前缀： cbx_ （2） CommandButton 前缀： cb_ 对主要的 CommandButton 的名字定义： 按 钮 命 字 确 认 cb_ok 重 试 cb_Retry 取 消 cb_Cancel 退 出 cb_Exit 是 cb_Yes 否 cb_No 增 加 cb_Add 删 除 cb_Del 查 询 cb_Cx 打 印 cb_Print 排 序 cb_Sort 条件查询 cb_Tjcx 更新存盘 cb_Update 页 首 cb_PgFirst 页 尾 cb_PgLast 前 页 cb_PgPrior 后 页 cb_PgNext 前一行() cb _LNext 帮 助 cb_Help （3） DropDownListBox 前缀： ddlb_ （4） EditMask 前缀： em_ 14 （5） Graph 前经： gr_ （6） GroupBox 前缀： gb_ （7） HScrollBar 前缀： hsb_ （8） Line 前缀： l_ 说明： 对于不同型号的直线可用不同的前缀，如： (1) 粗的横向直线 chl + n (n=1,2,3.) (2) 粗的纵向直线 czl + n (3) 细的横向直线 xhl + n (4) 细的纵向直线 xzl + n （9） ListBox 前缀： lb_ （10） MultiLineEdit 前缀： mle_ （11） OLE 2.0 前缀： ole_ （12） Oval 前缀： o_ （13） Picture 前缀： p_ （14） PictureButton 前缀： pb_ （15） RadioButton 前缀： rb_ （16） Rectangle 前缀： rt_ （17） RoundRectangle 前缀： rrt_ （18） SingleLineEdit 前缀： sle_ （19） StaticText 前缀： st_ （20） VScrollBar 前缀： vsb_ 3、 Objects In DataWindow 如果没有必要，可以不对 DataWindow 中的对象进行命名。如果有必要，则需按下面 15 说明的规则命名。 DataWindow 中的 Objects 前缀命名方法是： 对象所在区域对象所在区域 + 对象代码对象代码 + _ 对象所在区域有四个，它们是：Header，Detail，Summary，Footer 下面分别给出前缀定义: （1） Text 前缀：t_ (1) Text in Header： ht_ (2) Text in Detail： dt_ (3) Text in Summary： st_ (4) Text in Footer： ft_ （2） Computed Field Definition 前缀：c_ 特殊的 Computer Field 前缀定义： A) Page Definition (1) Page in Header： hpg_ (2) Page in Detail： dpg_ (3) Page in Summary： spg_ (4) Page in Footer： fpg_ B) Date Definition (1) Date in Header： hda_ (2) Date in Detail： dda_ (3) Date in Summary： sda_ (4) Date in Footer： fda_ C) Sum Definition (1) sum in Header： hsum_ (2) sum in Detail： dsum_ (3) sum in Summary： ssum_ (4) sum in Footer： fsum_ （3） Graph 前缀：gr_ (1) Graph in Header： hgr_ (2) Graph in Detail： dgr_ (3) Graph in Summary： sgr_ (4) Graph in Footer： fgr_ （4） Report 16 前缀：rp_ (1) Report in Header： hrp_ (2) Report in Detail： drp_ (3) Report in Summary： srp_ (4) Report in Footer： frp_ （5） Extended Bitmap 前缀：bm_ (1) Bitmap in Header： hbm_ (2) Bitmap in Detail： dbm_ (3) Bitmap in Summary： sbm_ (4) Bitmap in Footer： fbm_ （6） Rectangle 前缀：rt_ (1) Rectangle in Header： hrt_ (2) Rectangle in Detail： drt_ (3) Rectangle in Summary： srt_ (4) Rectangle in Footer： frt_ （7） Line 前缀：l_ 说明： 对于不同型号的直线可用不同的前缀，如： (1) 粗的横向直线 h(d,s,f)chl + n (n=1,2,3.) (2) 粗的纵向直线 h(d,s,f)czl + n (3) 细的横向直线 h(d,s,f)xhl + n (4) 细的纵向直线 h(d,s,f)xzl + n （8） Oval 前缀：ov_ (1) Oval in Header： hov_ (2) Oval in Detail： dov_ (3) Oval in Summary： sov_ (4) Oval in Footer： fov_ （9） Round Rectangle 前缀：rr_ (1) Round Rectangle in Header： hrr_ (2) Round Rectangle in Detail： drr_ (3) Round Rectangle in Summary： srr_ (4) Round Rectangle in Footer： frr_ （10） Column Column 的名字与表的列名一样. 17 4、 Function（函数函数） 前缀前缀=可调用范围可调用范围 + 返回值变量返回值变量类型类型 可调用范围如下： 可调用范围 可调用范围 代码 代码 注 注 释释 全程（系统） g Window 内部 w UserObject 内部 u 返回值变量类型为数据类型或对象代码。 例如： gsGetWholeKmmc() 是取得科目全称的函数 ，适用整个 Appacation ，返回值 为字符串型（科目名称） 。 例如： wiRjzSl() 是窗口 w_zw_rjzycx 中形成数量日记帐的函数。 数据类型或对象类型代码见附录： 5、 Variable（变量）变量） 前缀前缀=变量作用域变量作用域 + 变量类型变量类型 例： 变量名 作用域 变量类型 名字含义或功能 isKmmc Instance String 科目名称 iiRealKmjs Instance Integer 某总帐科目的实际级数 vsSql Script String 动态 SQL 语句 vdJfjeHj Script Double 借方金额合计 vwMain Script Window 模块中用到的主窗口变量 gtSqlca Global Transaction 定义的另一个全程 SQLCA 对常用变量的规定：对常用变量的规定： (1) 循环计数变量循环计数变量 循环计数变量由于应较频繁，不按上面的规则命名，只定义五个（即一个循 环体至多能嵌套四次） ，使用时由前至后： i，j，k，m，n (2) 临时变量临时变量 有关临时变量的概念定义见PowerBuilder 程序设计风格一节。 18 定义： v + 变量类型 + Temp 或者是 v + 变量类型 + Oper(ate) （ate 可省略不写） 例： viTemp，vsTemp，vdTemp / Integer,String,Double viOper，vsOper，vdOperate (3) 其他变量其他变量 i) 一般 SQL 语句用变量 vsSql 表示。 (4) PowerBuilder 中浮点数应定义成中浮点数应定义成 Double, 不能定义成不能定义成 real, decimal 等类型。等类型。 5、 、 临时表临时表 临时表的命名规则不同于以上 PB 对象的命名规则，它特殊遵循以下原则： (1) 名字构成名字构成 #+系统名称系统名称+表的内容及表的内容及操作描述操作描述 ( + 用户标识号用户标识号 ) 1+ 2 + 6 + 4 = 13(位) (2) 临时表的表名皆用小写字母表示临时表的表名皆用小写字母表示 (3) 临时表的名字总长度不超过临时表的名字总长度不超过 13 位位 例： 总帐余额查询： #zw_zzye1234 日记帐页查询： #zw_rjzy1234 6、代码定义表代码定义表 （1）数据类型代码 数据类型 数据类型 代码 代码 注 注 释释 Blob bl Boolean b Char c character c Date da DateTime da Decimal de Dec de Double d Integer i Int i Long l Real r String s Time t 19 UnsignedInteger ui UnsignedInt ui UInt ui UnsignedLong ul ULong ul （2） 对象类型代码 对象名称 对象名称 代码 代码 注 注 释释 Application ap Structure st Menu m Window w DataWindow dw Function f UserObject uo Transaction t dynamicdescript dy area error er message ms environment en （3）变量作用域代码： 变量作用域类型 变量作用域类型 代码 代码 注 注 释释 Global Variable g Share Variable s Instance Variable i Variable In PowerScript v (简记为 Script) Parameter p （4）常用表意串缩写 意 义 中英文缩写 编号 bh 名称 mc 类型 type 性质 xz 属性 sx 级数 js 明细 mx SQL 语句 sql 材料 cl 产品 cp 科目 km 借方 jf 贷方 df 数量 sl 金额 je 单价 dj 外币 wb 汇率 hl 20 折旧率 zjl 主要 main 实际 real 第三节 第三节 程序风格程序风格 1、目 、目 的的 使程序员能够进行无私程序设计，即避免程序员与其所产生的代码之间的关系过于密 切。提高程序代码的规范化程度，使程序代码易读易懂，并能够达到程序员之间相互进行程 序维护。 3、定 、定 义义 Script 程序： 在 PowerBuilder 对象中，一个事件或一个函数的 Script 中所包含的全 部程序代码称为一个 Script 程序，在下面的引用中也简称程序。 程序块：程序块是整个 Script 程序中完成某一细分功能的具有相对独立性的一段程 序，其主要内容包括注释、变量定义及程序正文三部分。 程序正文：是指不包括程序头部注释和变量定义的纯 PowerScript 的语句部分。 子程序块：程序块中的某一细分功能的程序块称为子程序块。 临时变量：临时变量是每一次赋值的作用域范围较小，一般不应超过五行程序。临时变 量的名字本身只是说明了该变量只是一个临时的操作数， 不具任何意义， 但在某一作用域内 代表不同的具体含义。 4、程序设计要求、程序设计要求 一、依照所确定的标准进行程序设计。 二、模块的内聚度高，模块之间的耦合度低。在修改一个模块时，不要对其它模块造成 影响。 三、 每个程序模块的行数不做规定； 但对于程序模块中相对独性较高的程序块最好提炼 成为一个函数。 四、尽量为程序块加上明确的注释。对于较复杂的程序或算法需要有注释文件，并在程 序中注明注释文件名及在注释文件中注明程序名。 21 5、程序风格定义、程序风格定义 定义了 Window 及 Window 对象的编程风格。 51、Window 的风格的风格 由于 PowerBuilder 是以 Window 对象为基础，以事件（Event）处理为核心的面向 对象的开发工具。所有的程序执行皆是事件触发式的。因此对整个的 Window 的出入口参 数、完成的功能及主要对象的功能进行轮廓描术是必要的。 对于 Window 对象， 需在 Open 事件中对该 Window 所完成的功能进行描述， 包括主 要 Controls、事件和函数所完成的功能。 Window 的 Open 事件中程序头部具体格式如下： （这里描述的是文该窗口的总体性 质，与事件无关，因此在其它事件或函数中要参照程序的注释格式及要求） /* WinName: / 窗口名字 Parm: / 参数及注释 Return: / 返回值及其注释 Process: / 完成的功能及主要处理过程 / 以上是对整个 Window 的描述 Call: / 调用的其他窗口或函数（包括其祖先，可不写） Called: / 被哪个窗口的事件或函数调用（包括其祖先，可不写） Date: Write By / 编写日期，编写 Process: / 本 Open 事件所完成的功能及主要处理过程及适应情况 */ / 以上是对本 Open 事件的描述 52 PowerScript 的风格的风格（事件（事件、函数、函数） （1）程序结构）程序结构 Script 程序结构应是一个并列（或嵌套）的程序块结构。 这样的结构简洁明快，易于理解，就象文章分段一样。 程序结构如下： 程序头部注释； 22 作用于本程序的变量定义 （注释） ； 程序块； 程序块； 程序块 （子程序块.， 子程序块.， 子程序块.； ） 程序块 程序块的结构如下： 程序块注释； 变量定义 （注释） ； 语句 （注释） ， 语句 （注释） ， 语句 （注释） 。 （2）程）程序注释序注释 PowerScript 的程序注释分为头部注释、块注释、行注释三种，注释尽量使用中文，以 上注释的使用原则是：头部注释必须有；块注释尽量有；行注释可尽量少用，因为如果用的 太多，则影响程序部分的可读性。 程序头部注释风格如下（对于较简短易懂的程序可不必拘泥于此风格） ： /* Func: / 函数，过程，事件的功能简述（必写） Parm: / 参数及其注释（函数必写） Return: / 返回值及其注释（函数必写） Call: / 调用的其他对象（包括其祖先名字） Called: / 被哪个对象调用（包括其祖先名字） Inhert: / 继承的对象（包括其祖先名字） Date: Write By / 编写日期，程序员 Globle / 引用全局变量 23 Process / 主要处理内容（包括主要对象） */ 53 临时变量临时变量 程序书写时， 如果变量结果不需保留， 则尽量利用已定义的临时变量而不定义新的变量。 临时变量作用域不能超过一屏程序。 各种数据类型的临时变量的名字见命名规范 。 第四节 第四节 界面规范界面规范 一、一、 菜单菜单 主要规定菜单的分类及各类采单的主要内容。 菜单分类菜单分类 将系统的所涉及的所有的采单分为三类： 系统空菜单 系统空菜单 系统主菜单 系统主菜单 功能操作菜单功能操作菜单 系统空菜单系统空菜单 该类菜单在将帐套关闭的情形下出现，具体形式如下： 系统主菜单系统主菜单 该类菜单在某一个子系统登录进入后出现，具体内容如下： 文件 窗口 帮助 打开（帐套） 关闭（帐套） 打印机设置 退出 文件 功能 1 功能 n 系统 其它 窗口 帮助 TOOL BAR（将一些主要功能以 BAR 的形式列于此） 打开（帐套） 关闭（帐套） 重新登录 打印机设置 退出 功能 n1 功能 n2 功能 n3 功能 n4 . 功能 nn 关于国强财务 目录 索引 如何使用帮助 关于 帐务处理 报表处理 工资管理 固定资产 采购计划 采购核算 库存核算 销售核算 数据备份 数据恢复 更改口令 系统封锁 系统设置 24 第一级菜单都简写为两个汉字。 功能操作菜单功能操作菜单 当执行某一个具体功能时，出现此操作菜单，该菜单出现后将主菜单屏蔽，要想同时操 作该系统的其它功能，则只有通过第一行 TOOLBAR 完成，如果在 TOOLBAR 中没有要操 作的功能，只有通出本功能。具体格式及内容如下： 对于各项功能性操作，根据实际情况加入到“编辑”菜单中，对于与查询有关的操作， 根据情况加入到“视图”菜单中，对于输出方面的操作，根据情况加入到“文件”中。 以上菜单情况，对于查询类操作和输入/维护类操作不尽相同，需要根据情况对待，其 中“兰色”为必有内容。 主 TOOL BAR 为主菜单中的 TOOL BAR，操作 TOOL BAR 为“编辑”中的内容及其 它部分主要内容。 菜单热键规定菜单热键规定 各菜单项都要定义一热键， 对于业务功能菜单这里没有作出具体规定， 可根据功能内容 自行定，但不得在同一栏菜单中重复，对于已确知功能，这规定如下： 按 按 钮 钮 热 热 键 键 文件文件 Alt + F 系统管理系统管理 Alt + S 其它系统其它系统 Alt + O 查询查询 Alt + Q 编辑编辑 Alt + E 工具工具 Alt + T 文件 编辑 查询 工具 窗口 帮助 主 TOOL BAR 操作 TOOL BAR 存盘 打印设置 页面设置 打印预览 打印 导入 导出 退出 增加 删除 修改 . 查找 条件查询 排序 图形分析 全显/分级 横线 竖线 计算器 . 选项 并列 层叠 展开 图标 25 帮助帮助 Alt + H 窗口窗口 Alt + W 打开打开 Alt + O 关闭关闭 Alt + C 重新登录重新登录 Alt + G 打印机设置打印机设置 Alt + E 数据备份数据备份 Alt + B 数据恢复数据恢复 Alt + R 更改口令更改口令 Alt + U 系统封锁系统封锁 Alt + L 存盘存盘 Alt + S 打印设置打印设置 Alt + E 页面设置页面设置 Alt + U 打印预览打印预览 Alt + V 打印打印 Alt + P 退出退出 Alt + Q 查找查找 Alt + L 条件查询条件查询 Alt + C 排序排序 Alt + S 图形分析图形分析 Alt + G 全显全显/分级分级 Alt + A/T 横线横线 Alt + H 竖线竖线 Alt + V 计算器计算器 Alt + C 选项选项 Alt + O 增加增加 Alt + A 删除删除 Alt + D 修改修改 Alt + M 二、二、 窗口窗口 窗口分类窗口分类 所有的窗口分为以下几类： Mdi Main Response Popup Children 操作形式操作形式 将窗口归纳为以下几种操作形式： 立即响应式立即响应式：必须采用 Response 窗口，使用按钮，如： 26 向导式向导式：各步骤的内容分别集成在一个用户对象内，这样便于隐含；所有步骤都必须 在一个窗口内，一般采用 response 窗口，也可以根据实际情况调整。如： 树和卡片结合式树和卡片结合式：将树对象同卡片结合在