肖俊飛

云南省曲靖市第一中學，云南曲靖 655000

用例詳細描述是軟件詳細設(shè)計過程中的重要環(huán)節(jié)。通過用例詳細描述完成用例詳細設(shè)計說明書。

1 用例詳細描述的用途

通過用例模型和業(yè)務(wù)對象模型，對目標系統(tǒng)的功能和數(shù)據(jù)有了概要的理解。這兩者將成為高層需求說明書的主要內(nèi)容。更進一步，需要以用例為單位，進行細節(jié)的描述，即編制系統(tǒng)需求說明書。由于信息技術(shù)的發(fā)展，當今研發(fā)的信息系統(tǒng)，均采用聯(lián)機方式。用戶在客戶機前，采用鼠標，鍵盤或其它工具，通過圖形用戶界面（GUI）與系統(tǒng)進行交互，引導(dǎo)系統(tǒng)完成規(guī)定的處理，達到預(yù)定的結(jié)果。用例詳細描述就是這一交互過程的細節(jié)描述。然而，高層需求說明書只是描述系統(tǒng)應(yīng)該做什么，至于系統(tǒng)內(nèi)部的處理過程，即系統(tǒng)如何做，則有待設(shè)計和實現(xiàn)階段去解決。

正如事件是業(yè)務(wù)流程流轉(zhuǎn)的線索一樣，事件也是用例實現(xiàn)的線索。詳細描述用例的基本思路是，以圖形用戶界面為媒介，系統(tǒng)事件為線索，描述每個事件的發(fā)生，從而引發(fā)系統(tǒng)做什么的交互過程，即系統(tǒng)行為過程的描述。如何來描述做什么呢？我們要敘述清楚，在特定的系統(tǒng)狀態(tài)下，要進行什么處理，在什么情況下應(yīng)創(chuàng)建、更新、閱讀、刪除哪些對象或其間的關(guān)聯(lián)。返回什么信息，即系統(tǒng)對于事件的響應(yīng)，即系統(tǒng)行為。系統(tǒng)行為的本質(zhì)是由業(yè)務(wù)邏輯決定的，所以相應(yīng)的內(nèi)容叫做業(yè)務(wù)規(guī)則。

用例模型是功能模型，記錄著本系統(tǒng)需要完成哪些事情，說明系統(tǒng)的行為特點。業(yè)務(wù)對象模型，記錄著本系統(tǒng)需要處理或持久保存數(shù)據(jù)，說明系統(tǒng)的結(jié)構(gòu)特點。但在用例模型中只是從使用者角度粗略地說明要做的事情是什么，并沒有說明這件事情具體怎么做，用例詳細描述就是用來說明用例內(nèi)部是如何工作的，即用例的實現(xiàn)，用例詳細描述相當于分析階段的動態(tài)模型。

2 用例詳細描述的要素

用例詳細描述，也叫用例規(guī)格說明，包含下列內(nèi)容：

用例名稱：用例的名稱。

用例簡述：用例的作用和目標，或是簡要的過程。

事件流程：采用參與者與系統(tǒng)之間對話的方式，描述是什么和做什么，不描述原因和方式。如明確指明輸入商品編號和數(shù)量，不能籠統(tǒng)地說輸入商品信息；也不描述輸入的方式，是鍵盤錄入，還是用條碼掃描，在規(guī)格說明時不必指明。留待設(shè)計階段再補充技術(shù)細節(jié)。

基本事件流：從用例啟動開始，直至結(jié)束的骨干流程。

替換流程：基本流程中發(fā)生了替換，如果只要幾行就能描述清楚，則寫在基本流程中；如果較為復(fù)雜，則另行設(shè)置替換流程段。

前置條件：用例執(zhí)行之前，系統(tǒng)必須處于的狀態(tài)。如按訂單收貨，訂單必須處于確認狀態(tài)。

后置條件：系統(tǒng)完成用例之后，可能處于的一組狀態(tài)。如按訂單收貨，可能訂單收貨全部完成，處于收貨完成狀態(tài)，也可能某些訂單行項尚末完成收貨，仍處于訂單確認狀態(tài)。

擴展點：擴展點描述使用、擴展關(guān)系的發(fā)生位置。以擴展點名指明在事件流程中的位置。

界面原型：描述圖形用戶界面的邏輯構(gòu)成、圖形元素及其布置。如果一個用例涉及幾個界面，則要描述引發(fā)界面轉(zhuǎn)換的事件。說明界面流轉(zhuǎn)情景的圖稱為屏幕流轉(zhuǎn)圖，或叫連環(huán)畫，形象地說明了用例的動態(tài)過程。因為它具有直觀生動的特點，常常成為與用戶交流業(yè)務(wù)需求的重要方式。界面原型表示方式可以是草圖，也可以是快速工具開發(fā)的界面，界面原型是后期界面設(shè)計的基礎(chǔ)。

特殊需求：常常是非功能性需求。

3 用例詳細描述舉例

用例ID UC001

參與者：系統(tǒng)管理員

用例名稱：用戶管理

用例描述：系統(tǒng)管理員新建、修改或刪除用戶

前置條件：系統(tǒng)管理員進入系統(tǒng)

后置條件：無

基本操作流程：

1）系統(tǒng)要求系統(tǒng)管理員選擇要執(zhí)行的操作（新建用戶、修改用戶或刪除用戶）；

2）一旦系統(tǒng)管理員選擇了要執(zhí)行的操作，以下子流程中的某一個將被執(zhí)行。

（1）如果選擇新建用戶，則‘新建用戶’子流程將被執(zhí)行；

（2） 如果選擇修改用戶，則‘修改用戶’子流程將被執(zhí)行；

（3）如果選擇刪除用戶，則‘刪除用戶’子流程將被執(zhí)行。

新建用戶：

① 系統(tǒng)管理員輸入用戶名、登錄名、口令信息；

②系統(tǒng)驗證所錄入的信息（用戶名、登錄名不能為空；登錄名不能重復(fù)）；

③通過驗證，系統(tǒng)保存用戶信息；沒有通過驗證，系統(tǒng)返回相應(yīng)提示信息給系統(tǒng)管理員，不保存用戶信息。

修改用戶：

① 系統(tǒng)檢索出所有用戶；

② 系統(tǒng)管理員選擇需要修改的用戶；

③系統(tǒng)管理員修改其用戶名、登錄名、口令等信息；

④ 系統(tǒng)驗證修改過后的用戶信息（用戶名、登錄名不能為空；登錄名不能重復(fù)）；

⑤通過驗證，系統(tǒng)保存用戶信息；沒有通過驗證，系統(tǒng)返回相應(yīng)提示信息給系統(tǒng)管理員，不保存用戶信息。

刪除用戶：

① 系統(tǒng)檢索出所有用戶；

②系統(tǒng)管理員選擇要刪除的用戶；

③判斷用戶是否已使用；

④ 如果未使用，執(zhí)行步驟e；如果已使用，不能刪除該用戶，直接結(jié)束；

⑤系統(tǒng)詢問系統(tǒng)管理員是否確認刪除所選擇的用戶；

⑥如果選擇是，系統(tǒng)刪除該用戶信息；選擇否，系統(tǒng)不刪除該用戶。

可選操作流程：

備注說明：用戶已使用：為用戶分配過角色或權(quán)限。

4 編寫用例詳細描述過程中的注意事項

1）用例詳細描述是用例實現(xiàn)的一種表達方式，主要對用例的內(nèi)部運作過程的一種描述；

2）用例詳細描述涉及的內(nèi)容較多：業(yè)務(wù)藍圖、用例清單、業(yè)務(wù)對象、界面原型、業(yè)務(wù)的系統(tǒng)流程等，所以需要理解上述內(nèi)容后才能正確建模；

3）替換流程與基本流程之間是擴展關(guān)系；

4）除了分析用例的實現(xiàn)過程，還要對實現(xiàn)過程中的質(zhì)量方面的要求加以說明。質(zhì)量方面的要求是非功能需要，用例詳細需求描述是將功能與非功能相結(jié)合。

5 結(jié)論

用例詳細描述記錄著系統(tǒng)某個用例的行為過程。用例詳細描述是用例在特定場景下的運行情況的詳細說明。

用例的實現(xiàn)有多種方式：有的用活動圖、有的通過建立分析模型再用用順序圖實現(xiàn)等，用例詳細需求描述這種方式是我們在企業(yè)工作中積累的行之有效的方法，也符合我國軟件企業(yè)的實際情況。用用例詳細描述來實現(xiàn)用例，使需求獲取、需求分析、需求定義、需求管理等幾個主要的需求開發(fā)環(huán)節(jié)形成一個有機的整體，為后期工作提供更實用的幫助。但用例詳細描述在后期也會有變化的，一個不斷完善的過程。

一個項目的所有用例詳細描述匯總在一起形成用例詳細需求說明書。這是一份非常重要的文檔，對后面設(shè)計及實現(xiàn)具體非常重要的指導(dǎo)意義。

[1]陳顯剛.軟件設(shè)計.電子工業(yè)出版社.

[2]廖白楷，王如龍，洪躍山，等.醫(yī)院管理信息系統(tǒng)的研究與實踐[J].計算機技術(shù)與自動化，1992，11（2）：15-18.

[3]夏鋒，孫優(yōu)賢.基于軟件工程的個性化網(wǎng)上教學系統(tǒng)開發(fā)研究[J].工業(yè)控制計算機，2003，16（1）：22-24.

[4]張海藩.軟件工程導(dǎo)論[M].北京：清華大學出版社，2003.