在作業:尋找參與者與使用案例時,您可能就已經提出事件的使用案例流程概要。請使用此概要作為開始點,並逐漸加入更多詳細資料。
分鏡腳本可協助您瞭解及詳述使用案例流程。如果已經有開發使用者介面原型的話,這也是另一個可以考慮的輸入。
依據專案決定採用的標準,來說明使用案例。在說明使用案例之前,請先決定下列事項,以便所有使用案例都能維持一致:
-
使用案例如何開始?使用案例的開始必須明確說明啟動使用案例的信號。例如,寫下「當發生 ... 時,就會開始使用案例」。
-
使用案例如何終止?您應該清楚指出在流程中發生什麼狀況時,就會終止使用案例。例如,寫下「當發生 ... 時,就會終止使用案例」。
-
使用案例如何與參與者互動?為了盡可能避免任何誤解,請確切指出什麼會存在系統中,以及什麼會存在系統外。將說明的結構排列為一系列的段落,每個段落都依此格式表示一個動作:「當參與者做 ... 時,系統就會
...」。您也可以藉由寫出使用案例會從參與者傳送及接收信號,來強調出互動關係,例如:「當使用案例從操作員收到『開始』信號時,使用案例就會開始」。
-
使用案例如何與參與者交換資料?您也可以視需要和偏好,參照信號的引數,不過,寫出如「當使用者提供其名稱和密碼以登入系統時,使用案例就會開始」會更好。
-
使用案例如何重複某些行為?您應該嘗試以自然語言來表示這一點。不過,在某些特殊的情況下,如果相對應的自然語言詞彙極難表示時,則可以使用類似程式碼的架構,例如 "WHILE-END WHILE"、"IF-THEN-ELSE" 以及
"LOOP-END LOOP" 等。不過,一般而言,您應該盡可能在使用案例說明中避免使用類似程式碼的架構,因為類似程式碼的架構很難讀和維護。
-
事件的使用案例流程中是否有任何選用的狀況?有時參與者會被提供數個選項。這種狀況也應該以相同的方式寫出。例如:
「參與者選擇下列其中一項一或多次:
a) . . .
b) . . .
c) . . ." 等等。
-
使用案例應該如何說明,才能讓客戶和使用者容易瞭解?使用諸如使用案例、參與者及信號等
方法學特有的專有名詞時,可能會使得文字極難理解。為了使文字容易閱讀理解,可以列舉出動作,或是採用別的策略。但是不論使用什麼策略,都應該在一般的使用案例模型準則中指出,以便您在說明使用案例的整個作業期間,都能記住這一點。
請將焦點集中在使用案例會做什麼,而不要集中在應該如何解決系統內部的特定問題。那些詳細資料會在生命週期的稍後考慮,因此請不要在這個時候過度詳細說明那些部分。只要說明您認為哪些在稍後會較穩定即可。
如果事件的使用案例流程變成非常龐大或複雜,或其中有些部分看似與其他部分互相分離時,可以將其分割為兩個或兩個以上的使用案例。
在撰寫說明文字時,請參閱工作成果:名詞解釋。若新的概念又蹦現出新的詞彙時,請將新詞彙加入名詞解釋中。不可在沒有通知適當的專案成員之前,就逕自更改詞彙的定義。如需詳細資訊,請參閱作業:擷取共用詞彙。
事件流程內容說明
事件流程說明會探討:
範例:
「當使用者啟動『管理訂單』時,使用案例就會開始」。
範例:
「若要建立新訂單,使用者要啟動『新增』功能,並指定下列有關訂單的必要資料:名稱、網路元素(至少一個)以及測量功能類型。也可以指定和訂單有關的選用資料:註解(一段簡短的文字說明)。使用者接著啟動「確定」功能,如此就會在系統中建立一張新訂單」。
注意:您必須明確指出參與者和使用案例之間交換的資料;否則客戶和使用者可能無法理解使用案例說明。
-
使用案例如何使用系統中儲存的資料以及使用時機,或是將資料儲存在系統中。
範例:
「使用者啟動『修改』功能以修改現有的訂單,並指定訂單號碼(小的整數)。系統隨即起始設定訂單表格,其中包含訂單名稱、其網路元素以及測量功能類型。這項資料是從次要儲存裝置擷取」。
範例:
「當訂單人員啟動「結束」功能時,使用案例就會結束」。
您也應該說明事件較不尋常或異常的流程。異常的流程是使用案例的一個子流程,它不屬於使用案例的正常或基本行為。不過,這個流程在使用案例行為的任何完整說明中,卻可能是必要的流程。典型的異常流程範例是如以下提供的第一個範例。如果使用案例收到一些非預期的資料(參與者不是該特定環境定義的預期參與者),使用案例就會終止。具有錯誤的參與者並提前終止並不是事件的典型流程。
在說明使用案例時應該考量的其他應做和不應做的項目包括:
-
說明事件流程,而不只是說明使用案例的功能或用途。
-
只說明屬於使用案例的事件,不要說明和此使用案例平行運作的其他使用案例發生了什麼。
-
不要提不會和要說明的使用案例互動的參與者。
-
說明使用案例和任何參與者之間的互動時,不要提供過多明細。
-
如果不需要固定針對使用案例說明的子流程次序時,不要將其說明成如同需要固定一樣。
-
使用一般名詞解釋中的詞彙,並在撰寫文字時,考量下列事項:
-
使用直接明確的詞彙。有簡單的詞彙可以用時,就不要使用複雜的詞彙。
-
撰寫的句子要簡短、具體。
-
避免使用諸如非常、較、而非等的副詞。
-
使用正確的標點。
-
避免複合句。
如需詳細資訊,請參閱準則:使用案例中,有關事件流程的內容與樣式討論。
|