需求規格說明書編寫規范
目 錄
1. 簡介
1.1?
目的
?? 說明編寫這份軟件需求說明書的目的,指出預期的讀者范圍。
1.2? 范圍
a.????? 待開發的軟件系統的名稱;
b.????? 說明軟件將干什么,如果需要的話,還要說明軟件產品不干什么;
c.????? 描述所說明的軟件的應用。應當:
1) 盡可能精確地描述所有相關的利益、目的、以及最終目標。
2)
如果有一個較高層次的說明存在,則應該使其和高層次說明中的類似的陳述相一致(例如,系統的需求規格說明)。
1.3?
定義、首字母縮寫詞和縮略語
列出本文件中用到的專門術語的定義和縮寫詞的原詞組。
1.4?
參考資料
1.5?
概述
2.
整體說明
2.1
?產品描述
敘述該項軟件開發的意圖、應用目標、作用范圍以及其他應向讀者說明的有關該軟件開發的背景材料。解釋被開發軟件與其他有關軟件之間的關系。如果本軟件產品是一項獨立的軟件,而且全部內容自含,則說明這一點。如果所定義的產品是一個更大的系統的一個組成部分,則應說明本產品與該系統中其他各組成部分之間的關系,為此可使用一張方框圖來說明該系統的組成和本產品同其他各部分的聯系和接口。
2.2 產品功能
本條是為將要完成的軟件功能提供一個摘要。例如,對于一個記帳程序來說,需求說明可以用這部分來描述:客房帳目維護、客房財務報表和發票制作,而不必把功能所要求的大量的細節描寫出來。
有時,如果存在較高層次的規格說明時,則功能摘要可從中取得,這個較高層次的規格說明為軟件產品分配了特殊的功能,為了清晰起見,請注意:
a. 編制功能的一種方法是制作功能表,以便客房或者第一次讀這個文件的人都可以理解;
b.??? 用方框圖來表達不同的功能和它們的關系也是有幫助的。但應牢記,這樣的圖不是產品設計時所需求的,而只是一種有效的解釋性的工具。
2.3 用戶特點
列出本軟件的最終用戶的特點,充分說明操作人員、維護人員的教育水平和技術專長,以及本軟件的預期使用頻度。這些是軟件設計工作的重要約束。
2.4 一般約束
本條對設計系統時限制開發者選擇的其他一些項作一般性描述。而這些項將限定開發者在設計系統時的任選項。這些包括:
a. 管理方針;
b.??? 硬件的限制;
c.??? 與其他應用間的接口;
d.??? 并行操作;
e. 審查功能;
f. 控制功能;
g.??? 所需的高級語言;
h.??? 通信協議;
i.? 應用的臨界點;
j.? 安全和保密方面的考慮。
2.5 假設和依據
本條列出影響需求說明中陳述的需求的每一個因素。這些因此不是軟件的設計約束,但是它們的改變可能影響到需求說明中的需求。例如:假定一個特定的操作系統是在被軟件產品指定的硬件上使用的,然而,事實上這個操作系統是不可能使用的,于是,需求說明就要進行相應的改變。
3. 具體需求
3.1? 功能
3.1.1
功能需求
1
對于每一類功能或者有時對于每一個功能,需要具體描述其輸入、加工和輸出的需求。由四個部分組成:
a. 引言
描述的是功能要達到的目標、所彩的方法和技術,還應清楚說明功能意圖的由來和背景。
b.??? 輸入
1)??? 詳細描述該功能的所有輸入數據,如:輸入源、數量、度量單位、時間設定、有效輸入范圍(包括精度和公差);
2)??? 操作員控制細節的需求。其中有名字、操作員活動的描述、控制臺或操作員的位置。例如:當打印檢查時,要求操作員進行格式調整;
3)??? 指明引用接口說明或接口控制文件的參考資料。
c.??? 加工
定義輸入數據、中間參數,以獲得預期輸出結果的全部操作。它包括如下的說明:
1)??? 輸入數據的有效性檢查;
2)??? 操作的順序,包括事件的時間設定;
3)??? 響應,例如,溢出、通信故障、錯誤處理等;
4)??? 受操作影響的參數;
5)??? 降級運行的要求;
6)??? 用于把系統輸入變換成相應輸出的任何方法(方程式、數學算法、邏輯操作等);
7)??? 輸出數據的?行?約觳欏?
d.??? 輸出
1)??? 詳細描述該功能所有輸出數據,例如:輸出目的地、數量、度量單位、時間關系、有效輸出的范圍(包括精度和公差)、非法值的處理、出錯信息;
2)??? 有關接口說明或接口控制文件的參考資料。
此外,對著重于輸入輸出行為的系統來說,需求說明應指定所有有意義的輸入、輸出對及其序列。當一個系統要求記憶它的狀態時,需要這個序列,使得它可以根據本次輸入和以前的狀態作出響應。也就是說,這種情況猶如有限狀態機。
3.1.2
功能需求
2
......
3.1.n 功能需求 n
可用性需求可包含如下子類別:
????? 人員因素(請參見:概念:以用戶為中心的設計)、
????? 美觀、
????? 用戶界面的一致性(請參見:指南:用戶界面)、?
????? 聯機幫助和環境相關幫助、
????? 向導和代理、
????? 用戶文檔和?
????? 培訓材料。
3.3? 可靠性
需要考慮的可靠性需求有:
????? 故障的頻率/嚴重性、
????? 可恢復性、
????? 可預見性、
????? 準確性和
????? 平均故障間隔時間(MTBF)。
3.4?
性能
????? 速度、
????? 效率、
????? 可用性、
????? 準確性、
????? 吞吐量、
????? 響應時間、
????? 恢復時間,或
????? 資源用途。
3.5?
可支持性
可支持性需求可包括:?
????? 可測試性、
????? 可擴展性、
????? 可適應性、
????? 可維護性、
????? 兼容性、
????? 可配置性、
????? 可服務性、
????? 可安裝性,或
????? 是否可本地化(國際化)。
3.6? 設計約束
3.7? 聯機用戶文檔和幫助系統需求
3.8? 購買的構件
3.9? 接口
屏幕格式:
(1)要求有菜單及工具欄以方便操作
(2)各數據庫信息可在屏幕上直接修改
(3)各數據統計結果可在屏幕上顯示
(4)進行系統分析后的結果在另一窗口中顯示
報表格式:
(1)XX報表
(2)YY報表
要指出軟件產品和系統硬部件之間每一個接口的邏輯特點。還可能包括如下事宜:支撐什么樣的設備,如何支撐這些設備,有何約定。
在此要指定需使用的其他軟件產品(例如,數據管理系統、操作系統或數學軟件包),以及同其他應用系統之間的接口。對每一個所需的軟件產品,要提供如下內容:
a. 名字;
b.??? 助記符;
c.??? 規格說明號;
d.??? 版本號;
e. 來源。
???
對于每一個接口,這部分應說明與軟件產品相關的接口軟件的目的,并根據信息的內容和格式定義接口,但不必詳細描述任何已有完整文件的接口,只要引用定義該接口的文件即可。
指定各種通信接口。例如,局部網絡的協議等等。
3.10????? 許可需求
3.11 法律、版權及其他聲明
3.12????? 適用的標準
4. 支持信息
posted on 2007-03-16 13:15 feilongone 閱讀(2763) 評論(0) 編輯 收藏