产品设计体会(3010)UC(用例)写作

UCuse case,用例)是需求人员写给开发人员看的一种最基本的文档,在和其他公司合作做项目的过程中,发现双方的文档规范差异很大,造成了沟通成本的提高,所以感觉在一个长期合作的团队中,文档与规范的统一真的是非常必要的(我强调的是“统一”,并没有强调要一定要用“某种格式”)。

查了一下资料,早期的需求人员是通过对应用场景(Scenario)的分析来细化需求,本世纪初,一些牛人们才将这种方法正式归纳为用例法。之后在网站制作中,业界又对其发展,扩展出了“任务分解”等需求细化方法。

从一个项目的PRD开始,首先会有些总体说明,如项目概述、功能范围、用户描述、词汇表等,然后主体就是UC文档,首先需要有个总的用例图来对系统给出高级可视化的表示,说明各个UC之间的关系,UML中有相关的内容。上个图感觉一下。

本篇简单说一下单个用例要描述哪些事情。


====== 看不清猛击图片看大图 ======

首先是UC概述(括号中举例说明每项内容):

用例的唯一标识UC_ordermeal);

用例名称(点菜);

业务描述(为什么要做这个UC?小明工作一周辛苦了,周末晚上去吃一顿好的补补。);

需求描述(这个UC要做什么?去餐馆,点一个菜,之后等烧好了吃掉)

行为者(小明);

前置条件(是周末,……);

后置条件(服务员接受订单,去厨房,……);

UC主体:

界面描述(小明的例子中好像没有,对于网页,我们对界面的描述经常占UC的很大篇幅,甚至链接上demo。当然还有一种做法是单独写界面文档,然后与UC文档互相引用);

业务规则(比如限制条件:小明不吃辣,小明口袋里只有100块);

流程描述,分主干、分支和异常三种,描述共前置条件到后置条件的过程中,系统与用户之间有何种交互步骤,这里多见的是时序图、活动图、流程图(小明自己选 or 让服务员推荐,if 服务员推荐,小明接受 or 不接受……确定点某个菜……);

其他内容,额外的一些针对项目特定的需求。

UC一般只能描述绝大部分的功能需求,无法描述诸如性能、培训需要、时间限制等非功能需求,所以再加上非功能的需求描述以及项目其他的概要信息,才构成教科书里的“需求说明书”。

------------------------------------------------------------如果你想第一时间看到最新内容, 就猛击此处订阅吧!

《产品设计体会(3010)UC(用例)写作》有19个想法

  1. sujie兄,我很认真的看了你的文章。
    工作中,以下几个文档应该是最重要的:
    1、功能列表
    2、单项需求卡片
    3、BRD
    4、MRD
    5、PRD 主体是 UC文档
    6、UML 图

    是这样的吗?sujie兄有没有补充啊?

    iamsujie Reply:

    @洪仔, 嗯,差不多就是我们经常写的了,我们经常把BRD+MRD的内容都表达在BRD里

  2. 我现在也难理解到如果是个复杂的信息化项目UC要如何去写?找不到下手的地方。主要是业务流程过于复杂,我认为用uml很难表达清楚。
    麻烦sujie给指条明路。

    本人拙见

    iamsujie Reply:

    @shanzhonglai, 找做过这事儿的人问吧。。。我没有答案

  3. 能否将图中的UML图放大显示,看不清楚。点击之后页面无法显示。谢谢~

    iamsujie Reply:

    @朝阳, 很老的东西了,要看需要picasa翻墙哦

  4. 苏杰能不能把引用过的图片放大图重新找个家,我每次来都想看大图,

    iamsujie Reply:

    @kovin, picasa里有大图的吧,呵呵

  5. 我是应届毕业生,因为之前在学校的时候有一点点从事互联网的经验,就被公司安排到最新开发的这个产品,而且被导师安排写需文档,有点兴奋,有些紧张。看了你的说明,还是有些无从下手

    iamsujie Reply:

    @taozipussy, 加油,先写个给需要看的人看看,能看懂就行

  6. 我是一个想入行的同学,第一遍看书整体的了解了一下,第二遍看此书重点看了文档这一块。不是说入行基本都是从文档开始么,我想在入行之前就先了解需求列表、BRD、PRD、UC文档,不知这个思路是否正确?

    iamsujie Reply:

    “不是说入行基本都是从文档开始么”,谁说的?

  7. @女伯爵
    是入行的前几个月,基本上都在写文档,而且写的痛不欲生。。。苏杰学长的原话是这样的。。。

  8. 用Ipad mini、360浏览器7.1,IE都无法浏览网页中的插图啊,这个网站所有图片都打不开,怎么回事呢

    iamsujie Reply:

    应该是因为图片存储的地方挂了。。。你看看文章的发布时间,估计都是5、6年前的

  9. 苏老师,你好!我现在算是一个产品新人吧,在一次面试里,面试官问我如果以后都是老板出策划案,然后你只需要负责做就行了,你能接受吗?我当时有点懵,我不知道他为什么这么问,但是我记得你书上说过的BCD,我就觉得这种现象是很正常的。但我又怕面试官会觉得做产品怎么能没有自己的想法呢?所以对于这种情况,我们应该如何处理和应对所谓的BCD?

    iamsujie Reply:

    短期接受,长期努力改变局面,帮老板分忧

发表评论

电子邮件地址不会被公开。 必填项已用*标注