【書摘】使用案例的 12 步寫作訣竅

摘錄自 「Writing Effective Use Cases」,中文譯名:「使用案例寫作實務」,譯者:趙光正

尤其是第一個步驟,是個人在規劃使用案例圖時,覺得最為重要的關鍵所在(從架構觀點的角度視之),但也是許多單位 SA 所經常忽略與不重視的。

  1. 找出系統邊界(情境圖、專案範圍內/外清單。
    Find the boundaries of the system(context diagram, in/out list).

  2. 用腦力激盪法列出主要參與者(參與者簡述表)。
    Brainstorm and list the primary actors(actor profile table).

  3. 用腦力激盪法窮舉系統中主要參與者的使用者目標(參與者—目標清單)。
    Brainstorm and list the primary actors’ goals against the system(actor-goal list).

  4. 找出最外層目標摘要等級的使用案例,裡面會涵蓋上述的所有東西。
    Write the outermost summary-level use cases covering all of the above.

  5. 重新討論並修正目標摘要等級的使用案例。新增、刪除或合併一些目標。
    Reconsider and revise the strategic use cases. Add, subtract, and merge goals.

  6. 選出一個使用案例,展開它或寫出其敘事情節,以熟悉使用案例的寫作材料。
    Pick a use case to expand or write a narrive to get acquainted with the material.

  7. 補上使用案例的關係人與其利益、事先條件與事後保證,並重複檢查它們。
    Fill in the stakeholders, interests, preconditions, and guarantees. Double-check them.

  8. 寫出主要成功情節;重新檢查關係人的利益與事後保證。
    Write the main success scenario; check it against the interests and the guarantees.

  9. 用腦力激盪法窮舉可能的失敗條件與替代路徑成功條件。
    Brainstorm and list possible failure conditions and alternate success conditions.

  10. 寫出每個擴充情節中參與者跟系統如何動作。
    Write how he actors and system should behave in each extension.

  11. 把需要自己獨力出來的東西分開變成子使用案例。
    Break out any sub use case that needs its own space.

  12. 從最高層的使用案例開始重新調整整組使用案例。有必要時新增、粹取或合併使用案例。請重新檢查使用案例的完整性、可讀性與失敗條件。
    Start from the top and readjust the use cases. Add, subtract, and merge as appropriate. Double-check for completeness, readability, and failure conditions.

文章導覽

   

共有 2 則迴響

發佈留言

發佈留言必須填寫的電子郵件地址不會公開。 必填欄位標示為 *