需求用例文檔編寫建議 --事件流程(基本流程和擴(kuò)展流程)部分

每個(gè)用例表示用戶為實(shí)現(xiàn)某個(gè)目標(biāo)與系統(tǒng)的一次交互抹缕,而事件流程則是對(duì)實(shí)現(xiàn)該目標(biāo)的描述构蹬,事件流程包括基本流程(又稱為主成功流程)和可選流程(又稱為擴(kuò)展流程);對(duì)這部分的編寫應(yīng)該清晰的描述不同的對(duì)象(用戶毛仪、系統(tǒng))完成目標(biāo)的活動(dòng)序列,例如带膀,像這種方式:球員甲將球傳給球員乙橙垢,球員乙運(yùn)球,球員乙將球傳給球員丙嗽元。

編寫一個(gè)良好的事件流程有以下準(zhǔn)則:

準(zhǔn)則一:使用簡(jiǎn)單語法

主語+謂語+賓語喂击,例如: “系統(tǒng)從帳戶余額扣除一定數(shù)量金額“,簡(jiǎn)單的語句與用戶溝通起來對(duì)需求的理解會(huì)更準(zhǔn)確佩谷。

準(zhǔn)則二:明確寫出“誰控制球”(比喻)

控球的執(zhí)行者會(huì)做下列事情:自己運(yùn)球或?qū)⑶騻鹘o別人监嗜,在步驟結(jié)束時(shí)要問問“把球給誰了”。

準(zhǔn)則三:從系統(tǒng)外部的角度來編寫用例

始終站在用戶的角度來編寫桐猬,而不是系統(tǒng)的角度刽肠,例如,不要出現(xiàn)這樣的描述“系統(tǒng)讀取卡號(hào)和密碼五垮,并從帳號(hào)余額中扣除一定的金額”放仗,而要從系統(tǒng)外部的角度來編寫,如:

1)用戶輸入ATM卡并輸入密碼

2)系統(tǒng)從帳號(hào)余額中扣除一定的金額

準(zhǔn)則四:描述過程向前推進(jìn)

每一個(gè)步驟都要離目標(biāo)更進(jìn)一步诞挨,步驟不要太細(xì),也不能太粗棍郎,一般對(duì)基本流程3-10步是合適的银室,過多則會(huì)使用例文檔顯得太長(zhǎng)励翼。

準(zhǔn)則五:描述執(zhí)行者的意圖而不是動(dòng)作

編寫用例常見的問題就是在操作界面來描述辜荠,這應(yīng)該需要避免,例如:

用例1

1) 系統(tǒng)要求用戶輸入名字造烁;

2) 用戶輸入名字午笛;

3) 系統(tǒng)要求用戶輸入地址;

4) 用戶輸入地址告组;

5) 用戶點(diǎn)擊“確認(rèn)”

6) 系統(tǒng)顯示用戶簡(jiǎn)介

修改后:

1) 用戶輸入名字和地址

2) 系統(tǒng)顯示用戶簡(jiǎn)介

雖然在操作界面進(jìn)行描述能很精確的定義需求癌佩,但過多關(guān)注細(xì)節(jié)會(huì)花費(fèi)大量的精力,同時(shí)文檔也會(huì)變得很長(zhǎng)鸿秆,難以維護(hù)卿叽。

準(zhǔn)則六:包含“合理”的活動(dòng)集

對(duì)場(chǎng)景的描述可以把每個(gè)部分作為一個(gè)單獨(dú)的執(zhí)行步驟贩虾,也可以以不同的方式合并其中的幾個(gè)部分沥阱,如何分隔要盡量按“是否合理”進(jìn)行。一個(gè)常用的步驟模板如下:

1) 用戶向系統(tǒng)發(fā)送請(qǐng)求數(shù)據(jù)

2) 系統(tǒng)驗(yàn)證請(qǐng)求

3) 系統(tǒng)更新內(nèi)部狀態(tài)

4) 系統(tǒng)顯示成功處理結(jié)果

任何用例流程的描述策精,都可以在上述基礎(chǔ)上進(jìn)行適當(dāng)?shù)臄U(kuò)展完成崇棠。

準(zhǔn)則七:“確認(rèn)”而不是“檢查與否”

描述中不要出現(xiàn)“如果”字句枕稀,例如

2) 系統(tǒng)檢查密碼是否正確

3) 如果密碼正確,系統(tǒng)顯示主頁面

要修改為:

2) 系統(tǒng)確認(rèn)密碼正確

3) 系統(tǒng)顯示主頁面

對(duì)于密碼錯(cuò)誤的流程沐兰,則放到可選流程中處理

準(zhǔn)則八:習(xí)慣描述“循環(huán)執(zhí)行步驟X到Y(jié)匕垫,直到條件滿足”

例如“用戶重復(fù)步驟3-4,直到完成選購”

準(zhǔn)則九:對(duì)于可選流程寞秃,格式如下:

如準(zhǔn)則七的中的例子

2a:無效密碼:

1)系統(tǒng)顯示登陸失敗頁面

2b:用戶沒有響應(yīng)(超時(shí))

1)系統(tǒng)自動(dòng)關(guān)閉該頁面

參考資料:

《編寫有效用例》

?著作權(quán)歸作者所有,轉(zhuǎn)載或內(nèi)容合作請(qǐng)聯(lián)系作者
  • 序言:七十年代末偶惠,一起剝皮案震驚了整個(gè)濱河市忽孽,隨后出現(xiàn)的幾起案子兄一,更是在濱河造成了極大的恐慌出革,老刑警劉巖骂束,帶你破解...
    沈念sama閱讀 218,546評(píng)論 6 507
  • 序言:濱河連續(xù)發(fā)生了三起死亡事件旨枯,死亡現(xiàn)場(chǎng)離奇詭異混驰,居然都是意外死亡账胧,警方通過查閱死者的電腦和手機(jī)治泥,發(fā)現(xiàn)死者居然都...
    沈念sama閱讀 93,224評(píng)論 3 395
  • 文/潘曉璐 我一進(jìn)店門败潦,熙熙樓的掌柜王于貴愁眉苦臉地迎上來劫扒,“玉大人沟饥,你說我怎么就攤上這事贤旷∮资唬” “怎么了?”我有些...
    開封第一講書人閱讀 164,911評(píng)論 0 354
  • 文/不壞的土叔 我叫張陵,是天一觀的道長(zhǎng)。 經(jīng)常有香客問我元旬,道長(zhǎng),這世上最難降的妖魔是什么坑资? 我笑而不...
    開封第一講書人閱讀 58,737評(píng)論 1 294
  • 正文 為了忘掉前任,我火速辦了婚禮攒巍,結(jié)果婚禮上柒莉,老公的妹妹穿的比我還像新娘兢孝。我一直安慰自己,他們只是感情好橘沥,可當(dāng)我...
    茶點(diǎn)故事閱讀 67,753評(píng)論 6 392
  • 文/花漫 我一把揭開白布。 她就那樣靜靜地躺著介陶,像睡著了一般斤蔓。 火紅的嫁衣襯著肌膚如雪弦牡。 梳的紋絲不亂的頭發(fā)上驾锰,一...
    開封第一講書人閱讀 51,598評(píng)論 1 305
  • 那天椭豫,我揣著相機(jī)與錄音赏酥,去河邊找鬼裸扶。 笑死呵晨,一個(gè)胖子當(dāng)著我的面吹牛摸屠,可吹牛的內(nèi)容都是我干的季二。 我是一名探鬼主播戒傻,決...
    沈念sama閱讀 40,338評(píng)論 3 418
  • 文/蒼蘭香墨 我猛地睜開眼芦倒,長(zhǎng)吁一口氣:“原來是場(chǎng)噩夢(mèng)啊……” “哼不翩!你這毒婦竟也來了口蝠?” 一聲冷哼從身側(cè)響起妙蔗,我...
    開封第一講書人閱讀 39,249評(píng)論 0 276
  • 序言:老撾萬榮一對(duì)情侶失蹤昙啄,失蹤者是張志新(化名)和其女友劉穎梳凛,沒想到半個(gè)月后韧拒,有當(dāng)?shù)厝嗽跇淞掷锇l(fā)現(xiàn)了一具尸體叛溢,經(jīng)...
    沈念sama閱讀 45,696評(píng)論 1 314
  • 正文 獨(dú)居荒郊野嶺守林人離奇死亡,尸身上長(zhǎng)有42處帶血的膿包…… 初始之章·張勛 以下內(nèi)容為張勛視角 年9月15日...
    茶點(diǎn)故事閱讀 37,888評(píng)論 3 336
  • 正文 我和宋清朗相戀三年,在試婚紗的時(shí)候發(fā)現(xiàn)自己被綠了郭怪。 大學(xué)時(shí)的朋友給我發(fā)了我未婚夫和他白月光在一起吃飯的照片鄙才。...
    茶點(diǎn)故事閱讀 40,013評(píng)論 1 348
  • 序言:一個(gè)原本活蹦亂跳的男人離奇死亡嘴纺,死狀恐怖栽渴,靈堂內(nèi)的尸體忽然破棺而出闲擦,到底是詐尸還是另有隱情墅冷,我是刑警寧澤,帶...
    沈念sama閱讀 35,731評(píng)論 5 346
  • 正文 年R本政府宣布,位于F島的核電站,受9級(jí)特大地震影響萍桌,放射性物質(zhì)發(fā)生泄漏上炎。R本人自食惡果不足惜藕施,卻給世界環(huán)境...
    茶點(diǎn)故事閱讀 41,348評(píng)論 3 330
  • 文/蒙蒙 一矛市、第九天 我趴在偏房一處隱蔽的房頂上張望浊吏。 院中可真熱鬧救氯,春花似錦找田、人聲如沸着憨。這莊子的主人今日做“春日...
    開封第一講書人閱讀 31,929評(píng)論 0 22
  • 文/蒼蘭香墨 我抬頭看了看天上的太陽心铃。三九已至挫剑,卻和暖如春,著一層夾襖步出監(jiān)牢的瞬間暮顺,已是汗流浹背。 一陣腳步聲響...
    開封第一講書人閱讀 33,048評(píng)論 1 270
  • 我被黑心中介騙來泰國打工羽氮, 沒想到剛下飛機(jī)就差點(diǎn)兒被人妖公主榨干…… 1. 我叫王不留惫恼,地道東北人档押。 一個(gè)月前我還...
    沈念sama閱讀 48,203評(píng)論 3 370
  • 正文 我出身青樓令宿,卻偏偏與公主長(zhǎng)得像,于是被迫代替她去往敵國和親。 傳聞我的和親對(duì)象是個(gè)殘疾皇子簇爆,可洞房花燭夜當(dāng)晚...
    茶點(diǎn)故事閱讀 44,960評(píng)論 2 355

推薦閱讀更多精彩內(nèi)容

  • 概要 用例(Use Case)是一種描述系統(tǒng)需求的方法入蛆。運(yùn)用用例這種方法來描述系統(tǒng)需求稱之為用例建模响蓉。用例也是UM...
    林海舟閱讀 43,856評(píng)論 0 34
  • 測(cè)試計(jì)劃和測(cè)試用例 1.測(cè)試計(jì)劃及缺陷管理 1.1.測(cè)試計(jì)劃 測(cè)試計(jì)劃是在測(cè)試設(shè)計(jì)階段枫甲,在需求規(guī)格說明書的基礎(chǔ)上制...
    方步閱讀 6,477評(píng)論 1 7
  • 一扼褪、Python簡(jiǎn)介和環(huán)境搭建以及pip的安裝 4課時(shí)實(shí)驗(yàn)課主要內(nèi)容 【Python簡(jiǎn)介】: Python 是一個(gè)...
    _小老虎_閱讀 5,746評(píng)論 0 10
  • 文/阿際 那一天,窗外下著不緊不慢的雨脏毯,我和朋友在一家茶館里聊天,不知怎的她聊起了她的祖母。她說她的祖母非常節(jié)儉。...
    阿際閱讀 341評(píng)論 0 9