需求用例格式及说明

⽤例格式

⽤例内容说明

前置与后置条件表⽰⽤例开始和结束回发⽣什么。即在⽤例开始时系统必须处在什么状态（前置条件）或者在⽤例结束时系统必须处在什么状态（后置条件）。不管紧随⽤例之后是哪⼀个分⽀或选择，后置条件都必须为真。“优先级”指该本系统对本需求任务实现的重要程度。

“使⽤频率”是指实际⽤户环境中，本任务执⾏的频率。预先估计的使⽤频度为并⾏使⽤和性能需求提供了⼀个早期指⽰。“基本流程”：在描述基本流程时列出执⾏者和系统之间相互交互或对话的顺序。当这种对话结束时，执⾏者也达到了预期的⽬的。

“可选流程”：可选流程代表了任务的细节或⽤于完成任务的途径的变化部分。基本流程可以在⼀些决策点上分解成可选流程。然后再重新汇成⼀个基本流程。

“包含⽤例”，许多使⽤实例可能共享⼀些公共函数。为了避免重复，你可以定义⼀个独⽴的使⽤实例，这⼀实例包含这个公共函数，并指定其它使⽤实例必须包括这个公共使⽤实例。

“例外因素”引起任务不能顺序完成的情况称为例外（exception），在某些时候它可以视为可选流程。在定义使⽤实例时，描述例外路径是很重要的，因为它们描述了在特定条件下⽤户对系统如何⼯作的看法。“请求⼀种化学制品”使⽤实例中的⼀个例外

是不存在业务上可⽤的化学制品。如果你没有将例外记录在⽂档上，那么开发者可能在设计和构造阶段忽视这些可能性。此时，当系统遇到⼀个例外条件时，就会发⽣系统崩溃。需求⽤例⽂档编写建议 --事件流程（基本流程和扩展流程）

每个⽤例表⽰⽤户为实现某个⽬标与系统的⼀次交互，⽽事件流程则是对实现该⽬标的描述，事件流程包括基本流程（⼜称为主成功流程）和可选流程（⼜称为扩展流程）；对这部分的编写应该清晰的描述不同的对象（⽤户、系统）完成⽬标的活动序列，例如，像这种⽅式：球员甲将球传给球员⼄，球员⼄运球，球员⼄将球传给球员丙。编写⼀个良好的事件流程有以下准则：准则⼀：使⽤简单语法

主语＋谓语＋宾语，例如：“系统从账户余额扣除⼀定数量⾦额”，简单的语句与⽤户沟通起来对需求的理解会更准确。准则⼆：明确写出“谁控制球”（⽐喻）

控球的执⾏者会做下列事情：⾃⼰运球或将球传给别⼈，在步骤结束时要问问“把球给谁了”。准则三：从系统外部的⾓度来编写⽤例

始终站在⽤户的⾓度来编写，⽽不是系统的⾓度，例如，不要出现这样的描述“系统读取卡号和密码，并从账号余额中扣除⼀定的⾦额”，⽽要从系统外部的⾓度来编写，如：1）⽤户输⼊ATM卡并输⼊密码2）系统从账号余额中扣除⼀定的⾦额准则四：描述过程向前推进

每⼀个步骤都要离⽬标更进⼀步，步骤不要太细，也不能太粗，⼀般对基本流程3-10步是合适的，过多则会使⽤例⽂档显得太长。

准则五：描述执⾏者的意图⽽不是动作

编写⽤例常见的问题就是在操作界⾯来描述，这应该需要避免，例如：⽤例1

1）系统要求⽤户输⼊名字；2）⽤户输⼊名字；

3）系统要求⽤户输⼊地址；4）⽤户输⼊地址；5）⽤户点击“确认”6）系统显⽰⽤户简介修改后：

1）⽤户输⼊名字和地址2）系统显⽰⽤户简介

虽然在操作界⾯进⾏描述能很精确的定义需求，但过多关注细节会花费⼤量的精⼒，同时⽂档也会变得很长，难以维护。准则六：包含“合理”的活动集

对场景的描述可以把每个部分作为⼀个单独的执⾏步骤，也可以以不同的⽅式合并其中的⼏个部分，如何分隔要尽量按“是否合理”进⾏。⼀个常⽤的步骤模板如下：1）⽤户向系统发送请求数据2）系统验证请求3）系统更新内部状态4）系统显⽰成功处理结果

任何⽤例流程的描述，都可以在上述基础上进⾏适当的扩展完成。

准则七：“确认”⽽不是“检查与否”描述中不要出现“如果”字句，例如2）系统检查密码是否正确

3）如果密码正确，系统显⽰主页⾯要修改为：

2）系统确认密码正确3）系统显⽰主页⾯

对于密码错误的流程，则放到可选流程中处理

准则⼋：习惯描述“循环执⾏步骤X到Y，直到条件满⾜”例如“⽤户重复步骤3－4，直到完成选购”准则九：对于可选流程，格式如下：如准则七的中的例⼦2a：⽆效密码：

1）系统显⽰登陆失败页⾯2b：⽤户没有响应（超时）1）系统⾃动关闭该页⾯参考资料：《编写有效⽤例》《需求⽤例分析技术》

严歌苓说，⼈之间的关系不⼀定从陌⽣进展为熟识，从熟识⾛向陌⽣，同样是正常进展。

⼈与⼈之间的缘分，远没有想像中的那么牢固，也许前⼀秒钟还牵⼿⼀起经历风⾬，后⼀秒就说散就散，所以，你要懂得善待和珍惜。

⼈与⼈相处，讲究个真⼼，你对我好，我就对你好，你给予真情，我还你真意，⼈⼼是相互的。

两个⼈在⼀起，总会有⼈主动，但主动久了，就会累，会伤⼼，⼼伤了就暖不回来了，凡事多站在对⽅的⾓度想⼀想，多⼀份忍耐和谦就，就不会有那么多的怨⽓和误解，也少了⼀些擦肩⽽过。

做⼈不要太苛刻，太苛⽆友，⼈⽆完⼈，每个⼈都有这样或那样的缺点，重在包容。包容是⼀种⼤度，整天笑呵呵的⼈并不是他没有脾⽓和烦恼，⽽是⼼胸开阔，两个懂得相互包容的⼈，才能⾛得越久。

⼈与⼈相处，要多⼀份真诚，俗语说，你真我便真。常算计别⼈的⼈，总以为⾃⼰有多聪明，孰不知被欺骗过的⼈，就会选择不再相信，千万别拿⼈性来试⼈⼼，否则你会输得体⽆完肤。

⼈与⼈相处不要太较真，⽣活中我们常常因为⼀句话⽽争辩的⾯红⽿⾚，你声⾳⼤，我⽐你嗓门还⼤，古⼈说，有理不在声⾼，很多时候，让⼈⾂服的不是靠嘴，⽽是靠真诚，⽆论是朋友亲⼈爱⼈都不要太较真了，好好说话，也是⼀种修养。俗语说，良⾔⼀句三冬暖，你对我好，我⼜岂能不知，你谦让与我，我⼜怎能再得⼨进尺，你欣赏我，我就有可能越变越好，你尊重我，我也会⽤尊重来回报你，你付出爱，必会得到更多的爱。

与⼈相处，要多⼀份和善，切忌恶语相向，互相伤害就有可能永远失去彼此，每个⼈⼼中都有⼀座天平，每个⼈⼼中都藏⼀份柔软，表⾯再强势的⼈，内⼼也是渴求温暖的。

做⼈要学会谦虚，虚怀若⾕。⼈⼈都喜欢和谦虚的⼈交往，司马懿说：“⾂⼀路⾛来，没有敌⼈，看见的都是朋友和师长”.这就是胸怀。

有格局的⼈，⼼中藏有⼀⽚海，必能前路开阔，⼜何愁⽆友。

⼈与⼈相处，开始让⼈舒服的也许是你的⾔语和外表，但后来让⼈信服的⼀定是你的内在。就如那句，欣赏⼀个⼈，始于颜值，敬于才华，合于性格，久于善良，终于⼈品。

⼈这⼀⽣，遇见相同的⼈不容易，遇见正确的⼈更不容易，只有选择了合适的相处⽅式，带上真诚与⼈相处，才会⾛得更长，更远更久。

⼈与⼈相处，要多⼀份真诚，俗语说，你真我便真。常算计别⼈的⼈，总以为⾃⼰有多聪明，孰不知被欺骗过的⼈，就会选择不再相信，千万别拿⼈性来试⼈⼼，否则你会输得体⽆完肤。

⼈与⼈相处不要太较真，⽣活中我们常常因为⼀句话⽽争辩的⾯红⽿⾚，你声⾳⼤，我⽐你嗓门还⼤，古⼈说，有理不在声⾼，很多时候，让⼈⾂服的不是靠嘴，⽽是靠真诚，⽆论是朋友亲⼈爱⼈都不要太较真了，好好说话，也是⼀种修养。俗语说，良⾔⼀句三冬暖，你对我好，我⼜岂能不知，你谦让与我，我⼜怎能再得⼨进尺，你欣赏我，我就有可能越变越好，你尊重我，我也会⽤尊重来回报你，你付出爱，必会得到更多的爱。

与⼈相处，要多⼀份和善，切忌恶语相向，互相伤害就有可能永远失去彼此，每个⼈⼼中都有⼀座天平，每个⼈⼼中都藏⼀份柔软，表⾯再强势的⼈，内⼼也是渴求温暖的。

做⼈要学会谦虚，虚怀若⾕。⼈⼈都喜欢和谦虚的⼈交往，司马懿说：“⾂⼀路⾛来，没有敌⼈，看见的都是朋友和师长”.这就是胸怀。

有格局的⼈，⼼中藏有⼀⽚海，必能前路开阔，⼜何愁⽆友。

⼈与⼈相处，开始让⼈舒服的也许是你的⾔语和外表，但后来让⼈信服的⼀定是你的内在。就如那句，欣赏⼀个⼈，始于颜值，敬于才华，合于性格，久于善良，终于⼈品。