软件需求第14课软件需求规格说明书ppt课件.ppt

1,软 件 需 求,Checking SettingsEntry/OpenShutter( 0.5 );MeasureLight();DetermineExposureTime(,Checking,Checking,Checking,Checking,CheCkinChecking g,Checking SettingsEntry/OpenShutter( 0.5 );MeasureLight();DetermineExposureTime(,Checking,Checking,Checking,Checking,CheCkinChecking g,哈尔滨工程大学计算机科学与技术学院海量数据挖掘及网络数据集成研究组 王念滨 教授 博导,2,第 14 章 需求规格说明书,3,本课主要讨论问题,2 需求规格说明文档,3 模板选择与裁剪,4 需求规格说明书文档的写作,1 需求规格说明书概述,5 优秀的需求规格说明书文档的特性,6 应用示例,4,本课主要讨论问题,2 需求规格说明文档,3 模板选择与裁剪,4 需求规格说明书文档的写作,1 需求规格说明书概述,5 优秀的需求规格说明书文档的特性,6 应用示例,5,1 需求规格说明书概述,需求获取收集了需求信息，需求分析活动深入理解了需求信息并建立了能够满足用户需求的软件解决方案。需求规格说明（需求描述）是将需求获取、需求分析的结果进行文档化的过程。在软件开发过程中，将分析的结果文档化是不可或缺的任务，也称为编写规约活动。,6,1 需求规格说明书概述,需求规格说明书编写的重要性？ 在经过需求获取活动和需求分析活动的处理之后，软件系统的涉众和需求工程师应该能够就软件的需求和解决方案达成共识。为了保证软件开发的成功，这种共识还需要完整地传递给开发人员。需求规格说明书的编写就是将需求及其软件解决方案进行定义和文档化，并传递给开发人员的需求工程活动。 需求规格说明书的完成（撰写完成、验证完成）标志着软件需求阶段告一段落。并将作为下一个阶段设计开发阶段的输入和重要依据。,编写SRS,需求（验证）评审会,需求文档发布（里程碑）,讲解SRS,7,需求规格说明书的作用？（1）需求规格说明书文档可以成为各方人员之间有关软件系统的协议基准。开发者和用户可以使用它作为合同协议的重要部分，涉众也可以利用它在相互间达成一致。（2）需求规格说明书文档可以成为项目开发活动的一个重要依据。它可以成为软件估算和项目进度安排的基础，也可以成为开发人员判断设计、测试等工作的进行是否正确的依据。（3）在需求规格说明书文档的编写过程中，可以尽早发现和减少可能存在的需求错误，从而减少项目返工，降低项目的工作量。（4）需求规格说明书文档可以成为有效的智力资产。该智利资产可以帮助新加入的团队成员快速融入项目，可以帮助更好地将软件产品移交给新客户，也可以帮助开发者更好地进行其他类似项目或者后续增强项目的开发。,1 需求规格说明书概述,8,1 需求规格说明书概述,需求规格说明书撰写的素材（面向对象）,9,1 需求规格说明书概述,撰写需求规格说明书-重要基础,需求获取目标是得到用户需求收集需求信息需求分析目标是更深刻的理解用户需求界定能够让用户满意的解决方案准则需求规格说明目标是定义用户需求准确描述需求及其解决方案,10,撰写需求规格说明书-主要活动,1 需求规格说明书概述,图 需求规格说明活动流图,11,本课主要讨论问题,2 需求规格说明文档,3 模板选择与裁剪,4 需求规格说明书文档的写作,1 需求规格说明书概述,5 优秀的需求规格说明书文档的特性,6 应用示例,12,2 需求规格说明文档,需求规格说明文档常见的写作风格,非形式化自然语言限制性文本半形式化结构化文本伪码/结构化英语模型语言图、表形式化形式化语言数学语言：BNF，,自然语言图形化模型形式化规格描述,13,2 需求规格说明文档,需求规格说明文档常见的写作风格,自然语言：就是使用结构合理的自然语言来描述需求，该显示不管对于写的人还是看的人都是一个非常容易接受的方法。以前的项目很多都是采用此方法。优点：易于编写、易于阅读，不需要掌握特定的技巧；缺点：不够严谨，歧义性强，表达能力弱（特别是对于复杂问题的描述）建议：一般以自然语言为主，辅以图形化模型，需要的地方少量使用形式化规格描述。这样的组合方式是目前多数软件系统采用的风格。,14,图形化模型：图形化模型在表述时能够给读者提供更强的视觉效果，同时能够使问题更加聚焦。在日常交流中，我们经常会绘制一些非标准的示意图，以便更好地进行沟通。优点：可视化、聚焦性，易于理解。缺点：编写和阅读的人都需要能够正确地理解模型，所以一般SRS不可能完全采用复杂模型。建议：图形化模型为主，辅以自然语言，需要的地方少量使用形式化规格描述。RUP(Rational Unified Process)统一开发过程推荐该方法，需求管理会更加方便。对双方的技术性要求比较强。,2 需求规格说明文档,需求规格说明文档常见的写作风格,15,形式化描述：如果说图形化模型比自然语言表达的精确度更高的话，则形式化描述比图形化模型更高一些。对于逻辑性很强，精度要求很高的场合，形式化规格描述是一种不错的选择。优点：严谨、精确。缺点：编写和阅读的人都会感到很困难。建议：形式化规格语言为主，辅以图形化模型和自然语言。一般很少采用，即时采用也是在局部。,需求规格说明文档常见的写作风格,2 需求规格说明文档,16,需求规格说明文档常见的模板,2 需求规格说明文档,示例-简单的范例,XX地税征管信息系统-需求规格说明书-户籍管理,17,需求规格说明文档常见的模板,2 需求规格说明文档,示例-封面,ABC软件有限公司密级：限项目内使用,ABC-LOGO,xx地税税收征管信息系统需求规格说明书,XX地税信息中心ABC软件公司税务事业部,18,1.概述2.开业登记管理2.1.业务规范2.2.操作岗位2.3.业务处理流程图2.4.业务处理流程描述 2.4.1.前置条件 2.4.2.基本流程 2.4.3.分支流程 2.4.4.后置条件2.5.特殊需求说明2.6.相关业务环节2.7.业务表单,3.登记变更管理 3.1.业务规范 3.2.操作岗位 3.3.业务处理流程图 3.4.业务处理流程描述3.4.1.前置条件3.4.2.基本流程3.4.3.分支流程3.4.4.后置条件3.4.5.特殊需求说明3.4.6.相关业务环节3.4.7.业务表单,需求规格说明文档常见的模板,2 需求规格说明文档,示例-目录,19,需求规格说明文档常见的模板,2 需求规格说明文档,示例-概述,1 概述 税收管理员户籍管理包括开业登记管理、停业登记管理、登记变更管理、非正常户管理、非正常解除管理、纳税人跨区迁移管理、外来报验管理、巡查管理、验、换证管理九部分内容。户籍管理部分以税收管理员为核心，论述了其在户籍管理中执行的全部职责。,20,需求规格说明文档常见的模板,2 需求规格说明文档,示例-内容,2 开业登记管理2.1 业务规范 各类企业及企业在外地设立的分支机构和从事生产、经营的场所，个体工商户和从事生产、经营的事业单位（从事生产经营的纳税人）自领取营业执照之日起30日内持有关证件向生产、经营地或纳税义务发生地税务登记机关申请办理税务登记。其它纳税人自依照税收法律、行政法规规定成为纳税义务人之日起30日内向所在地税务登记机关申请办理税务登记。 税务机关核准纳税人开业之后，由税收管理员根据纳税人的实际经营情况对纳税人填报的税务登记信息、社保登记信息、财产税税源登记信息、税种鉴定信息以及征收方式做实地核查。如果发现纳税人填报的信息与纳税人实际经营情况不一致，税收管理员有责任告知纳税人，令其到税务机关进行登记信息变更。,2.2 操作岗位 税收管理员岗,21,2.3 业务处理流程图税务登记核查财产税登记核查,需求规格说明文档常见的模板,2 需求规格说明文档,示例-内容,22,需求规格说明文档常见的模板,2 需求规格说明文档,示例-内容,税种鉴定核查、征收方式核查,23,需求规格说明文档常见的模板,2 需求规格说明文档,示例-内容,2.4 业务处理流程描述2.4.1 前置条件纳税人已申请办理税务登记、财产税税源登记、税种鉴定、征收方式鉴定。 (2) 税务机关已受理纳税人税务登记。 (3) 登记录入岗已录入完成纳税人的财产税税源登记、税种鉴定、征收方式鉴定。 (4) 税务机关已批准纳税人开业并为纳税人分配了税收管理员。,24,需求规格说明文档常见的模板,2 需求规格说明文档,示例-内容,2.4.2 基本流程,税务登记核查、财产税登记核查（1）税务机关批准纳税人开业并为纳税人分配税收管理员之后，系统自动发送税务登记核查任务、财产税税源登记核查任务给税收管理员。（2）税收管理员根据系统发送的核查任务与纳税人的实际经营情况进行实地核查。（3）如果税收管理员实地核查结果与纳税人填报的信息完全一致，则税收管理员直接结束任务。（4）如果税收管理员实地核查结果与纳税人填报的信息不一致，并且通过税收管理员调查，不一致的原因是由于纳税人填报错误造成的，并且变更内容涉及变更登记内容的，需要税收管理员向纳税人发放税务事项通知书、文书送达回证告知纳税人到税务机关进行更正。,25,需求规格说明文档常见的模板,2 需求规格说明文档,示例-内容,2.4.2 基本流程,税务登记核查、财产税登记核查（5）如果税收管理员实地核查结果与纳税人填报的信息不一致，并且通过税收管理员调查，不一致的原因是由于纳税人填报错误造成的，并且变更内容不涉及变更登记内容，税务机关有权直接修改的，税收管理员将不一致信息反馈给录入岗。 （6）如果税收管理员实地核查结果与纳税人填报的信息不一致，并且通过税收管理员调查，不一致的原因是由于税务机关内部原因造成的，并且变更内容不涉及到税务登记证件修改的，税收管理员将不一致信息反馈给录入岗。（7）如果税收管理员实地核查结果与纳税人填报的信息不一致，并且通过税收管理员调查，不一致原因是由于税务机关内部原因造成的，并且变更内容涉及到税务登记证件修改的，税收管理员将不一致信息反馈给录入岗由录入岗修改，修改之后将信息反馈给税收管理员。由税收管理员打印税务事项通知书通知纳税人到税务机关重新打印税务登记证。 （8）税收管理员将文书送达纳税人之后将文书销号。,26,税种鉴定核查管理、征收方式核查管理（1）纳税人开业登记之后，系统自动发送税种鉴定核查任务、征收方式核查任务给税收管理员。（2）税收管理员对纳税人进行实地核查。（3）如果核查结果没有问题，则直接将核查结果录入系统。（4）如果核查结果有问题，则需要将信息反馈给综合科，由综合科进行修改。,需求规格说明文档常见的模板,2 需求规格说明文档,示例-内容,2.4.2 基本流程,27,需求规格说明文档常见的模板,2 需求规格说明文档,示例-内容,2.4.3 分支流程,（1）税收管理员向纳税人发放税务事项通知书告知纳税人之后，纳税人需要持税务登记变更表到税务机关做事项变更。（2）如果由于税务机关内部原因造成的录入信息不一致，税收管理员将不一致信息反馈给录入岗之后，由录入岗对不一致信息做修改更正，更正完成之后任务结束。（3）由纳税人原因造成错误的，需要涉及变更登记内容的，进入变更登记环节由纳税人进行变更；不需要变更登记的错误信息，在纳税人确认后，由税收管理员将修改信息提供到录入岗进行更正。,2.4.4 后置条件,28,需求规格说明文档常见的模板,2 需求规格说明文档,示例-内容,2.5 特殊需求说明,（1）税收管理员可以对纳税人所有登记事项进行实地核查。（2）税收管理员在核查时应在纳税人税务登记表上手工填写主管科、所和其它有关事项。,2.6 业务相关环节,（1）如果税收管理员通过实地核查发现纳税人登记信息填报不实，税收管理员告知纳税人更正登记的同时，管理员有权提请对纳税人行政处罚，即做一个违法违章案源登记。,2.7 业务相关表单,税务事项通知书见表单文档文书送达回证见表单文档,29,需求规格说明文档常见的模板,2 需求规格说明文档,示例-简单的范例,XX地税征管信息系统-需求规格说明书（更早时间的版本）SRS.DOC,30,需求规格说明文档常见的模板,2 需求规格说明文档,选择合适的需求规格说明书模板是需求团队必须确定的一件事情。一般来说，不同的公司由于对需求获取、需求分析采用的方法和策略不同，需求规格说明书选用的模板也不尽相同。一般大的公司各行业部都有自己相应的需求规格说明书模板。中小型公司有全公司的需求规格说明书模板。 从目前能够收集到的模板来看，主要包含以下几类： （1）国际/ISO标准：由于制定的时间比较早（国际版本是1988年制定的，参考了ISO70年代制定的标准），总体显得有些陈旧。 （2）RUP版本：采用以模型为主的思路，由此文字部分的模板显得过于简单 ，难以涵盖所有的需求内容； （3）咨询公司（大型软件公司）版本：比较最求通用性，比较庞大。,31,(1)需求规格说明文档常见的模板-国际版,2 需求规格说明文档,1.引言1.1编写的目的1.2背景1.3定义本文件中用到的专门术语的定义和外文首字母组词的原词组。1.4参考资料列出用得着的参考资料。,32,(1)需求规格说明文档常见的模板-国际版-解释,2 需求规格说明文档,1.引言1.1编写的目的1.2背景1.3定义本文件中用到的专门术语的定义和外文首字母组词的原词组。1.4参考资料列出用得着的参考资料。,指出本文档所针对的读者对象，以及每类读者对象应该重点关注的内容。,指出本文档所涉及的系统的构建的原因、环境。,术语表，用于解释在文档中多次出现的、易混淆的、重要的术语。作用相当于术语（定义）索引。,本文档及所涉及的系统用到的业务和技术参考文献，包括政策、指示、文件、报告、规范等。,33,(1)需求规格说明文档常见的模板-国际版,2 需求规格说明文档,2.任务概述2.1目标叙述该系统开发的意图、应用目标、作用范围以及其他应想读者说明的有关该系统开发的背景材料。解释被开发系统与其他有关系统之间的关系。,34,2.2用户的特点列出本系统的最终用户的特点，充分说明操作人员、维护人员的教育水平和技术专长，以及本系统的预期使用频度。2.3假定和约束列出进行本系统开发工作的假定和约束。3.需求规定3.1对功能的规定用列表的方式，逐项定量和定性地叙述对系统所提出的功能要求，说明输入什么量、经怎么样的处理、得到什么输出，说明系统的容量，包括系统应支持的终端数和应支持的并行操作的用户数等指标。3.2对性能的规定3.2.1精度,(1)需求规格说明文档常见的模板-国际版,2 需求规格说明文档,35,(1)需求规格说明文档常见的模板-国际版,2 需求规格说明文档,3.2.2时间特性要求3.2.3灵活性3.3输入/输出要求3.4数据管理能力要求（针对软件系统）3.5故障处理要求3.6其他专门要求4.运行环境规定4.1设备列出运行该软件所需要的硬设备。说明新型设备及其专门功能。4.2支持软件列出支持软件，包括要用到的操作系统、编译程序、测试支持软件等。,36,(1)需求规格说明文档常见的模板-国际版,2 需求规格说明文档,4.3接口说明该系统同其他系统之间的接口、数据通信协议等。4.4控制说明控制该系统的运行方法和控制信号，并说明这些控制信号的来源。,37,(1)需求规格说明文档常见的模板-国际版2006版,2 需求规格说明文档,1.范围1.1标识本文档适用的系统和软件的完整标识1.2系统概述适用的系统和软件的用途；开发、运行、维护历史1.3文档概述文档的用途和内容2.引用文件3.需求3.1所需的状态和方式软件项是否在多种状态和方式下运行3.2需求概述3.2.1目标表述系统的目标和范围3.2.2运行环境,38,3.2.3用户特点3.2.4关键点关键功能、关键算法、关键技术3.2.5约束条件3.3需求规格3.3.1软件系统总体功能/对象结构对软件系统总体功能/对象结构进行描述，包括结构图、流程图或对象图3.3.2软件子系统功能/对象结构对每个主要子系统中的基本功能模块/对象结构进行描述，包括结构图、流程图或对象图3.3.3描述约定3.4软件配置项能力要求可用功能、性能、目标或类似词代替“能力”3.4.x包括能力的说明、输入、处理、输出,(1)需求规格说明文档常见的模板-国际版2006版,2 需求规格说明文档,39,3.5外部接口需求3.5.1接口标识和接口图3.5.x具体接口说明接口优先级、接口类型、数据元素特性、数据元素集合、接口通信方法、必须使用的接口协议等3.6内部接口需求3.7内部数据需求3.8适应性需求提供的依赖于安装的数据有关的需求3.9保密性需求诸如防止意外动作和无效动作所必须提供的安全措施3.10保密性和私密性需求3.11环境需求,(1)需求规格说明文档常见的模板-国际版2006版,2 需求规格说明文档,40,3.12计算机资源需求3.12.1计算机硬件需求3.12.2计算机硬件资源利用需求3.12.3计算机软件需求3.12.4计算机通信需求3.13软件质量因素3.14设计和实现的约束3.15数据3.16操作3.17故障处理,(1)需求规格说明文档常见的模板-国际版2006版,2 需求规格说明文档,41,3.18算法说明3.19有关人员需求3.20有关培训需求3.21有关后勤需求3.22其他需求3.23包装需求3.24需求的优先次序和关键程度4.合格性规定可以独立，也可以直接在前面注明方法，包括演示、测试、分析、审查、其他特殊方法5.需求可追踪性6.尚未解决问题7.注释,(1)需求规格说明文档常见的模板-国际版2006版,2 需求规格说明文档,42,2 需求规格说明文档,对国际版需求24项的简要说明,43,对国际版需求24项的简要说明,2 需求规格说明文档,44,1.文档概述1.1目的1.2背景1.3定义、首字母缩写词和缩略语1.4参考资料1.5概述2.整体说明让读者对整个软件系统的需求有一个框架性的认识。主要包括产品总体效果、产品功能、用户特征、约束、假设与依赖关系、需求子集等方面的内容。2.1用例模型2.2假设与依赖关系,(2)需求规格说明文档常见的模板-RUP版,2 需求规格说明文档,45,3.具体要求3.1用例描述3.2补充需求易用性、可靠性、性能、其他4.支持信息,(2)需求规格说明文档常见的模板-RUP版,2 需求规格说明文档,46,(3)需求规格说明文档常见的模板-某公司版本,2 需求规格说明文档,Part ：项目驱动1.项目的目标1.1该项目工作的用户业务或背景1.2项目的目标2.客户、顾客和其他风险承担者2.1客户2.2顾客2.3其他风险承担者,47,(3)需求规格说明文档常见的模板-某公司版本,2 需求规格说明文档,3.产品的用户3.1产品的直接操作用户 3.2对用户设定的优先级3.3用户参与程度3.4维护用户和服务技术人员Part ：产品限制条件4.强制的限制条件4.1解决方案的限制条件4.2当前系统的现实环境4.3伙伴应用或协作应用4.4立即可用的软件4.5预期的工作地点环境 4.6进度计划限制条件4.7该产品的财务预算,48,5.命名惯例和定义5.1定义在项目中使用的所有术语，包括同义词5.2所有包含模型的数据字典6.相关事实和假定6.1事实6.2假定,(3)需求规格说明文档常见的模板-某公司版本,2 需求规格说明文档,49,Part ：功能性需求7.工作的范围 7.1当前的状态7.2工作的上下文范围7.3工作切分8.产品的范围8.1产品边界8.2产品用例清单8.3单个产品用例9.功能性需求与数据需求9.1功能性需求9.2数据需求,(3)需求规格说明文档常见的模板-某公司版本,2 需求规格说明文档,50,Part ：非功能需求10.观感需求10.1外观需求10.2风格需求11.易用性和人性化需求11.1易于使用的需求11.2人性化和国际化需求11.3学习的容易程度11.4可理解性和礼貌需求11.5可用性需求,(3)需求规格说明文档常见的模板-某公司版本,2 需求规格说明文档,51,12.执行需求12.1速度和延迟需求12.2安全性至关重要的需求12.3精度需求12.4可靠性和可访问性需求12.5健壮性或容错需求12.6容量需求12.7可伸缩性和可扩展需求12.8寿命需求,(3)需求规格说明文档常见的模板-某公司版本,2 需求规格说明文档,52,13.操作需求13.1预期的物理环境13.2与相邻系统接口的需求13.3产品化需求13.4发布需求14.可维护性和支持需求14.1可维护性需求14.2支持需求14.3适应能力需求,(3)需求规格说明文档常见的模板-某公司版本,2 需求规格说明文档,53,15.安全需求15.1访问控制需求15.2完整性需求15.3隐私需求15.4审计需求15.5免疫力需求16.文化和政策需求16.1文化需求16.2政策需求17.法律需求17.1合法需求17.2标准需求,(3)需求规格说明文档常见的模板-某公司版本,2 需求规格说明文档,54,Part ：项目问题18.开放式问题19.立即可用的解决方案19.1已经做好的产品19.2可复用的组件19.3可以复制的产品20.新问题20.1对当前环境的影响20.2对已实施系统的影响20.3潜在的用户问题20.4预期的实现环境会存在什么限制新产品的因素20.5后续问题,(3)需求规格说明文档常见的模板-某公司版本,2 需求规格说明文档,55,21.任务21.1项目计划21.2开发阶段计划22.迁移到新产品22.1迁移到新产品的需求22.2为了新系统，哪些数据必须修改或转换23.风险24.费用,(3)需求规格说明文档常见的模板-某公司版本,2 需求规格说明文档,56,25.用户文档和培训25.1用户文档需求25.2培训需求26.后续版本需求27.关于解决方案的设想,(3)需求规格说明文档常见的模板-某公司版本,2 需求规格说明文档,57,2 需求规格说明文档,从用户需求到软件需求演化过程,用户需求团队,软件规格需求团队,全局,主线,主线细化,细节填充,划分主题域,确定主题域,总述范围与关系,确定业务事件,确定管理控制点,确定范围上下文图,验证业务事件,确定报表类型列表,业务流程图,业务实体列表,相关业务实体,相关字段,确定业务流程图,确定用例图,确定领域类图,细化报表,原始需求列表,生成用例描述,填充类细节,生成活动图,58,本课主要讨论问题,2 需求规格说明文档,3 模板选择与裁剪,4 需求规格说明书文档的写作,1 需求规格说明书概述,5 优秀的需求规格说明书文档的特性,6 应用示例,59,3 模板选择与裁剪,优秀的文档结构组织复用：模版选择与裁剪文字写作字词、句法写作技巧,选择与裁剪的动机,60,3 模板选择与裁剪,实践：一般来说，对于模板的选择要根据项目情况确定，大中型软件公司一般都有自己的模板。 但公司的模板都具有通用性，或者说制定模板的人都在追求通用性，因为这样易于公司管理人员管理，这也应该理解。但结果就是造成公司的标准模板通常不能照搬不变。一般的情况是，以公司的标准模板为依托，然后加进必要的新内容。当然应该与公司制定并管理标准的负责人讨论，以用户需要的理由获得他们的认可。,图 模板的选择和使用,61,本课主要讨论问题,2 需求规格说明文档,3 模板选择与裁剪,4 需求规格说明书文档的写作,1 需求规格说明书概述,5 优秀的需求规格说明书文档的特性,6 应用示例,62,4 需求规格说明书文档的写作,一般需求规格说明书是在项目需求获取、需求分析完成后。由项目经理负责组织需求规格说明的写作。SRS的写作没有放之四海而皆准的标准。但一般可以考虑如下开展。 1）制定模板 按照项目的具体应用环境、用户情况、系统特点、公司通用模板构建一个新模板。请用户代表、需求分析人员、（设计人员）参加。不要指望在此会议上由大家一起构建，那永远也做不完工作。而是先制定一个模板，让大家来修改完善。 2）写作指南 必须的。因为需求规格说明由多个人员共同完成。每个人写作的方式、文笔、对问题的理解都存在差异。因此，如果你是项目经理，就一定要制定写作指南，否则在合稿时将始终处于崩溃； 如果你是参与人员就一定要按照写作指南写作，否则你每天都会处于半休克状态。以后项目经理不会找你参与类似工作。,63,4 需求规格说明书文档的写作,关于写作指南,写作指南至少包含两方面内容：（1）对模板内容的细化：例如，培训需求从以下几个方面着手，一培训目的、意义和目标；二培训主要内容（内容要有表格明细）；三培训教师情况（按照用户要求，培训教师要细化到人）；四培训日程安排；五培训结果验证方法等（按照用户要求，培训结果不能用考试成绩考核，请提出其他方案）。（15-20页，XXX负责在YY日前完成）（2）对文字、图表、标题等格式的要求：例如，标题格式如下（一级标题，二级标题,三级标题。不允许使用四级标题。如果需要按如下方式）图表规定：.。正文内容使用宋体，小四号字体，1.5倍行距，首行缩进2字符当然最好是将这些内容在Word中先制定好。不许使用的词汇或术语与及替代词：我们本项目，本系统、本公司； 其它-其他。 这个，那个.,涉及文档的组织方式；常见情景的处理；常用的写作技巧；容易出错的地方等。,64,关于写作指南,4 需求规格说明书文档的写作,定义术语表或数据字典术语不一致“方言”问题错误术语和冗余术语避免干扰文本“这一段的意思是”“上一句话是指”避免歧义词汇,65,66,本课主要讨论问题,2 需求规格说明文档,3 模板选择与裁剪,4 需求规格说明书文档的写作,1 需求规格说明书概述,5 优秀的需求规格说明书文档的特性,6 应用示例,67,5 优秀的需求规格说明书文档的特性,（1）正确性是指文档内的所有需求都具有正确性。（2）无歧义是指文档内的所有需求都是无歧义的。（3）可验证是指文档内的所有需求都是可验证的。,68,5 优秀的需求规格说明书文档的特性,（4）完备性标准描述了用户的所有有意义的需求，包括功能、性能、约束、质量属性和对外接口。定义了软件对所有情况的所有实际输入（无论有效输入还是无效输入）的响应。为文档中的所有图、表和术语、度量单位的定义提供了完整的引用和标记。待解决问题(To Be Determined:TBD) ，在所有TBD问题为解决前，文档是不完备的。,69,（5）一致性标准细节的需求不能同高层次的需求相冲突，例如系统需求不能和业务需求、用户需求互相矛盾同一层次的不同需求之间也不能互相冲突评审自动化检查,5 优秀的需求规格说明书文档的特性,70,5 优秀的需求规格说明书文档的特性,（6）根据重要性和稳定性分级建立需求的优先级。（7）可修改标准它的结构和风格使得人们可以对其中任一需求进行容易地、完整地、一致地修改，同时还不会影响文档现有的结构和风格。文档的可修改性要求：有着条理分明并且易于使用的组织方式，包括目录、索引和显式的交叉引用。没有重复冗余。独立表达每个需求，而不是和其他需求混在一起。,71,5 优秀的需求规格说明书文档的特性,（8）可跟踪后向跟踪（Backward traceability）前向跟踪（Forward traceability）,72,本课主要讨论问题,2 需求规格说明文档,3 模板选择与裁剪,4 需求规格说明书文档的写作,1 需求规格说明书概述,5 优秀的需求规格说明书文档的特性,6 应用示例,