1. 程式人生 > >產品需求文件PRD的寫作(五) – 用例文件(UML用例圖、流程圖)

產品需求文件PRD的寫作(五) – 用例文件(UML用例圖、流程圖)

在產品和技術領域裡都有UML的技能知識,而對於產品人員的UML則更多的是指用例圖,也就是我所稱呼的使用者流程圖。在講PRD文件寫作的第二篇文章裡,我提到了使用者流程圖的製作,實際上使用者流程圖是我在產品規則的初期對用例圖的一種結構化的表達方式,由於以結構化的方式描述用例太抽象,缺少邏輯性表達,並且那篇文章更偏向於功能性使用者流程,還不是實際意義上的用例,因此今天我補文一篇,細講一下UML用例圖用例文件

用例文件是由多個用例組成的一份文件,主要用於技術開發與測試使用,他是PRD中的重要輔助文件,用於講解某個環節的功能邏輯,例如使用者註冊、活動報名等等功能都是需要用例輔助說明的。用例文件的寫作時間在原型設計之後,通常和PRD文件同步撰寫。

用例文件中有兩個關聯檔案,分別是用例圖流程圖用例圖是UML的一種類圖表現方式,是從使用者角度描述產品功能,並指出該使用者在產品各功能中的操作許可權。流程圖是通過線框圖形的方式描述產品功能的處理過程,主要是描述功能的執行順序、分支和迴圈的邏輯。

寫使用者文件的常用軟體是Word,其中用例圖和流程圖的製作軟體常用的是Visio,當然也有用Axure RP軟體製作的,例如下面的第三步流程圖就是用Axure RP製作的。

一份完整的用例文件分別是由以下三點內容組成,其中第3點的“用例”是描述功能邏輯的部分,根據功能的多少決定有多少個用例。

用例文件的大概組成部分如下:
1、修改記錄:每次修改的備註記錄,同PRD文件。
2、角色介紹:描述參與系統中的各個角色
3、用例:同下方步驟的第4步,其中第3步中的流程圖是直接插入到第4步的流程圖表格項中的。

用例文件的模板格式如同以上三點內容,通過Word文件繪製表格,在表格中撰寫用例描述,表格的格式和樣式參考以下示例圖。

1、撰寫用例文件的第一步是註明使用產品的各個角色(參與者)和角色說明(角色介紹)。(如下圖)

角色

2、第二步是以用例圖的方式註明角色在前後端的用例關係。(如下圖)

會員中心UML用例圖

3、第三步是以流程圖的方式註明角色在各個功能環節的活動過程。(如下圖:以活動報名為示例)

流程圖

4、第四步則是以用例文件的方式將以上三步整合到一起,並撰寫各個功能環節的用例描述。(如下圖)

流程圖

表格說明:
4.1、用例名:此功能環節的名稱
4.2、用例編號:在此產品中該用例的編號
4.3、行為角色:參與或操作(執行)該功能的角色
4.4、簡要說明:用最少的文字描述一下該用例的需求
4.5、前置條件:參與或操作(執行)此功能的前提條件
4.6、後置條件:執行完畢後的結果條件
4.7、流程圖:該功能的角色活動過程(處理過程)圖(第三步中的圖)

上面示範的用例描述相對簡單,也是最常用和基本的用例描述內容,當然也有稍微複雜一點的用例文件,文件中會詳細描述使用場景、事件流和資訊欄位,也有一些用例文件還會插入產品介面效果圖。

使用場景主要描述行為角色在不同情況下使用產品時,根據情況或問題給出相應的系統反饋。事件流類似流程圖,只不過是通過文字的方式描述角色的活動過程。資訊欄位主要是描述用例中所用到的資料欄位。

這些更多的描述內容取決於個人的習慣,最終目的都是為了描述清晰產品邏輯,因此我的原則就是用越少的文字描述清晰越多的需求說明。(畢竟這些文件是產品開發中的執行文件,文字不在多,表達清晰即可。)