資源描述:
《需求用例編寫規(guī)范》由會員上傳分享,免費在線閱讀,更多相關(guān)內(nèi)容在行業(yè)資料-天天文庫。
1、EBS開發(fā)小組需求用例編寫規(guī)范-V1.0文檔編號:文檔名稱:需求用例編寫規(guī)范文檔類別:設計規(guī)范密級:機密版本信息:1.0建立日期:2005-08-26創(chuàng)建人:016審核者:批準人:批準日期:編輯軟件:MicrosoftOffice2003中文版EBS開發(fā)小組文檔修訂記錄版本編號*變化狀態(tài)簡要說明(變更內(nèi)容和變更范圍)日期變更人批準日期批準人更改請求號V1.0C參考《編寫有效用例》2005-08-26016*變化狀態(tài):C——創(chuàng)建,M——修改,D——刪除文檔審批信息序號審批人角色審批日期簽字備注EBS開
2、發(fā)小組目錄1簡介11.1文檔目的11.2有效范圍12梗概12.1用例定義12.2用例格式22.2.1非正式用例22.2.2正式用例33非正式用例33.1用例名33.2自然語言描述體43.3圖例說明44正式用例44.1范圍44.2級別44.3主執(zhí)行者44.4項目相關(guān)人員和利益44.5前置條件44.6最小保證54.7成功保證54.8觸發(fā)事件54.9主成功場景54.10擴展場景54.11相關(guān)信息64.11.1解釋說明64.11.2約束條件74.11.3改進建議75編號76批注77超鏈接88字體及顏色89如
3、何快速書寫需要用例89.1非正式用例8EBS開發(fā)小組9.2正式用例910范例10EBS開發(fā)小組1簡介1.1文檔目的本文檔中的內(nèi)容是為了更好的書寫與理解需求用例,閱讀本文后,達到讀者能夠書寫規(guī)范有效的需求用例。如果讀者需要立即書寫需求用例,則可以直接閱讀第9節(jié)“如何快速書寫需求用例”。本文參考AlistairCockburn編著,王雷、張莉翻譯由機械工業(yè)出版社出版的《編寫有效用例(WritingEffectiveUseCases)》一書,有興趣的讀者可以詳細閱讀此書。1.2有效范圍本文適用于各種軟件開
4、發(fā)項目的需求分析。2梗概2.1用例定義用例是代表系統(tǒng)中各個項目相關(guān)人員之間就系統(tǒng)的行為所達成的契約,用例描述了在不同條件下,系統(tǒng)對某一項目相關(guān)人員的請求所作出的響應。如果用用例來記錄一個組織的業(yè)務過程,那么被討論的系統(tǒng)是指組織本身,項目相關(guān)人員是指公司的股東、客戶、供應商和政府管理部門,這種用例稱為業(yè)務用例,業(yè)務用例可以作為軟件需求采集時使用;如果用用例來記錄一個軟件的行為需求,那么被討論的系統(tǒng)是指計算機程序,項目相關(guān)人員是指使用該程序的人、擁有該程序的公司、政府管理部門和其他一些計算機程序,這種用
5、例稱為系統(tǒng)用例,系統(tǒng)用例可以作為軟件需求分析時使用。用例不是所有的需求,用例不能詳細地描述外部接口、數(shù)據(jù)格式、業(yè)務規(guī)則和復雜公式,用例只是需要收集的所有需求中的一部分,雖然這一部分是非常重要的一部分,但畢竟僅僅是“一部分”,不能全部反映“需求”。UI需求業(yè)務規(guī)則數(shù)據(jù)格式I/O協(xié)議性能需求······用例UI設計第12頁共16頁EBS開發(fā)小組1.1用例格式需求用例分為正式用例與非正式用例,非正式用例是用自然語言及圖例進行用例描述,正式用例是具有規(guī)范格式的用例描述。讀者在此不必深究用例如何書寫,后續(xù)章節(jié)
6、中有詳細說明。1.1.1非正式用例用例名自然語言描述體圖例說明第12頁共16頁EBS開發(fā)小組用例名自然語言描述體圖例說明范圍:級別:主執(zhí)行者:項目相關(guān)人員和利益:前置條件:最小保證:成功保證:觸發(fā)事件:主成功場景:1.成功動作描述2.成功動作描述擴展:1.a.場景執(zhí)行過程中非順利情況1.a.1.處理動作描述1.b.場景執(zhí)行過程中非順利情況1.b.1.處理動作描述相關(guān)信息:2解釋說明2約束條件2改進建議1.1.1正式用例2非正式用例非正式用例包括三部分:用例名、自然語言描述體、圖例說明。2.1用例名用
7、例名就是用例的名稱,應是一個主動語態(tài)動詞短語來表示的用例目標。第12頁共16頁EBS開發(fā)小組1.1自然語言描述體用自然語言描述成功場景和可能會出現(xiàn)的失敗場景,及其相應的處理動作,還包括用例所需要的功能操作等。1.2圖例說明對于較復雜的需求用例,可以用圖表說明用例之間關(guān)系,使用例更加清晰明朗。2正式用例正式用列具有格式規(guī)范,包括:用例名、自然語言描述體、圖例說明、范圍、級別、主執(zhí)行者、項目相關(guān)人員和利益、前置條件、最小保證、成功保證、觸發(fā)事件、主成功場景、擴展場景和相關(guān)信息等項目,用例格式并不是硬性規(guī)
8、定必須包括這此內(nèi)容,只是為需求用例編寫者提供正式用例編寫格式參考,具體項目具體分析,以增減正式用例內(nèi)容,更好地為需求分析服務;用例名、自然語言描述體、圖例說明的編寫方法同非正式用例,只是自然語言描述體只闡述不能在主成功場景和擴展場景中描述的部分,不必將場景全部說明。2.1范圍范圍(scope)用來描述項目開發(fā)人員負責的設計工作的邊界,以便與應由其他人負責的設計工作或已經(jīng)完成的設計工作相區(qū)別;范圍應該是一個簡單明確的名詞,比如說需求人員正在對“固定資產(chǎn)”項目進行需求分析