軟件需求規(guī)格說(shuō)明書新

1、軟件需求規(guī)格說(shuō)明書模版文件變化記錄單版本編號(hào)*變化狀態(tài)簡(jiǎn)要說(shuō)明變更人變更日期批準(zhǔn)人批準(zhǔn)日期*變化狀態(tài)：A增加,M修改,D刪除文件批準(zhǔn)單職務(wù)簽字日期1.引言提出對(duì)軟件需求規(guī)格說(shuō)明書的縱覽,幫助讀者理解文檔如何編寫并且如何閱讀 和解釋.1.1 編寫目的對(duì)產(chǎn)品也可能是工程,但是我們統(tǒng)稱為產(chǎn)品進(jìn)行定義,在該文檔中詳盡說(shuō) 明這個(gè)產(chǎn)品的軟件需求,包括修正或發(fā)行版本號(hào).如果這個(gè)軟件需求規(guī)格說(shuō)明書只 與整個(gè)系統(tǒng)的一局部有關(guān),那么只定義文檔中說(shuō)明的局部或子系統(tǒng).1.2 文檔約定描述編寫文檔時(shí)所采用的標(biāo)準(zhǔn)或排版約定,包括正文風(fēng)格、提示區(qū)或重要符號(hào), 例如,說(shuō)明高層需求的優(yōu)先級(jí)是否可以被其所有細(xì)化的需求所繼承,或者

2、每個(gè)需求 陳述是否都有優(yōu)先級(jí).1.3 預(yù)期的讀者和閱讀建議列舉軟件需求規(guī)格說(shuō)明書所針對(duì)的不同讀者,例如開(kāi)發(fā)人員、工程經(jīng)理、營(yíng)銷 人員、用戶、測(cè)試人員等.描述文檔中剩余局部的內(nèi)容及其組織結(jié)構(gòu).提出最適合 每一類型讀者閱讀文檔的建議.1.4 產(chǎn)品的范圍提供對(duì)指定的軟件及其目的的簡(jiǎn)短描述,包括利益和目標(biāo).把軟件與企業(yè)目標(biāo) 或業(yè)務(wù)策略相聯(lián)系.可以參考工程范圍文檔,而不是將其內(nèi)容復(fù)制到這里.1.5 參考資料列舉編寫軟件需求規(guī)格說(shuō)明書時(shí)所參考的資料或其它來(lái)源.可能包括用戶界面 風(fēng)格指導(dǎo)、合同、標(biāo)準(zhǔn)、系統(tǒng)需求規(guī)格說(shuō)明書、用戶需求、相關(guān)產(chǎn)品的軟件需求規(guī) 格說(shuō)明書.這里應(yīng)該給出詳細(xì)的信息,包括標(biāo)題名稱、作者、版

3、本號(hào)、日期、出版 單位或資料來(lái)源,以方便讀者查閱這些文獻(xiàn).2 .綜合描述這一局部概述了正在定義的產(chǎn)品以及它所運(yùn)行的環(huán)境、使用產(chǎn)品的用戶和 的限制、假設(shè)和依賴.2.1 產(chǎn)品的前景描述軟件需求規(guī)格說(shuō)明書中所定義的產(chǎn)品的背景和起源.說(shuō)明該產(chǎn)品是否是產(chǎn) 品系列中的下一個(gè)成員,是否是成熟產(chǎn)品所改良的下一代產(chǎn)品、是否是現(xiàn)有應(yīng)用程 序的替代品,或者是否是一個(gè)全新的產(chǎn)品.如果軟件需求規(guī)格說(shuō)明書定義了大系統(tǒng)的一個(gè)組成局部,那么就要說(shuō)明這局部 軟件是怎樣與整個(gè)系統(tǒng)相關(guān)聯(lián)的,并且要定義出兩者之間的接口.建議使用系統(tǒng)結(jié) 構(gòu)圖或者實(shí)體關(guān)系圖表示.2.2 產(chǎn)品的功能概述產(chǎn)品所具有的主要功能,詳細(xì)內(nèi)容在第 4節(jié)描述,所以這

4、里只需要概括總 結(jié),例如用列表的方法給出.很好地組織產(chǎn)品的功能,使每個(gè)讀者都易于理解.用 圖形表示主要的需求分組以及它們之間的聯(lián)系.建議使用數(shù)據(jù)流程圖DFD的頂層圖或功能層次圖來(lái)實(shí)現(xiàn)圖形化.2.3 用戶類和特征確定可能使用該產(chǎn)品的不同用戶類并描述它們相關(guān)的特征.有一些需求可能只 與特定的用戶類相關(guān).將該產(chǎn)品的重要用戶類與那些不太重要的用戶類區(qū)分開(kāi).2.4 運(yùn)行環(huán)境描述軟件的運(yùn)行環(huán)境,包括硬件平臺(tái)、操作系統(tǒng)和版本,還有其它的軟件組件 或者與其共存的應(yīng)用程序.2.5 設(shè)計(jì)和實(shí)現(xiàn)上的限制確定影響開(kāi)發(fā)人員自由選擇的問(wèn)題,并說(shuō)明這些問(wèn)題為什么成為一種限制.可 能的限制包括：必須使用或者防止的特定技術(shù)、工

5、具、編程語(yǔ)言、數(shù)據(jù)庫(kù)；經(jīng)費(fèi)、進(jìn)度、資源等方面的限制；所要求的開(kāi)發(fā)標(biāo)準(zhǔn)或標(biāo)準(zhǔn)；企業(yè)策略、政府法規(guī)或工業(yè)標(biāo)準(zhǔn)；硬件限制,例如定時(shí)需求或存儲(chǔ)器限制；數(shù)據(jù)轉(zhuǎn)換格式標(biāo)準(zhǔn).其它.2.6 假設(shè)和依賴列舉出在對(duì)軟件需求規(guī)格說(shuō)明書影響需求陳述的假設(shè)因素.可能包括打算要用 的商業(yè)組件或有關(guān)開(kāi)發(fā)或運(yùn)行環(huán)境的問(wèn)題.你可能認(rèn)為產(chǎn)品將符合一個(gè)特殊的用戶 界面設(shè)計(jì)約定,但是另外一個(gè)分析員卻不這么認(rèn)為.如果這些假設(shè)不正確、不一致 或者被更改,都會(huì)使工程受到影響.止匕外,確定工程對(duì)外部因素存在的依賴.例如,如果你打算把其它工程開(kāi)發(fā)的 組件集成到系統(tǒng)中,那么你就要依賴哪個(gè)工程能否按時(shí)提供正確的組件.如果這些 依賴已經(jīng)記錄到其它文

6、檔如工程方案中了,那么在此就可以參考其它文檔.2.7 關(guān)鍵點(diǎn)說(shuō)明本軟件需求規(guī)格說(shuō)明書中的關(guān)鍵點(diǎn)例如：關(guān)鍵功能、關(guān)鍵算法和所涉及 的關(guān)鍵技術(shù)等.3 .外部接口需求確定可以保證新產(chǎn)品與外部組件正確連接的需求.關(guān)聯(lián)圖表示了高層抽象的外 部接口.需要把對(duì)接口數(shù)據(jù)和限制組件的詳細(xì)描述寫入數(shù)據(jù)字典中.如果產(chǎn)品的不 同局部有不同的外部接口,那么應(yīng)該把這些外部接口的詳細(xì)要求并入到這一局部的 實(shí)例中.3.1 用戶界面陳述所需要的用戶界面的軟件組件.描述每個(gè)用戶界面的邏輯特征.以下是可 能要包括的一些特征：將要采用的圖形用戶界面標(biāo)準(zhǔn)或產(chǎn)品系列的風(fēng)格；屏幕布局或解決方案的限制；將出現(xiàn)在每個(gè)屏幕的標(biāo)準(zhǔn)按鈕、功能或?qū)Ш?/p>

7、鏈接；快捷鍵；錯(cuò)誤信息顯示標(biāo)準(zhǔn).對(duì)于用戶界面的細(xì)節(jié),例如特定對(duì)話框的布局,建議寫入一個(gè)獨(dú)立的用戶界面 規(guī)格說(shuō)明中,不要寫入軟件需求規(guī)格說(shuō)明書中.3.2 硬件接口描述系統(tǒng)中軟件和硬件每個(gè)接口的特征.可能包括支持的硬件類型、軟硬件之 間交流的數(shù)據(jù)和限制信息的性質(zhì)以及所使用的通信協(xié)議.3.3 軟件接口描述產(chǎn)品與其它外部組件由名字和版本識(shí)別的連接,包括數(shù)據(jù)庫(kù)、操作系 統(tǒng)、工具、庫(kù)和集成的商業(yè)組件.明確并描述在軟件組件之間交換數(shù)據(jù)或信息的目 的,描述所需要的效勞以及內(nèi)部組件通信的性質(zhì),確定將在組件之間共享的數(shù)據(jù). 如果必須用一種特殊的方法來(lái)實(shí)現(xiàn)數(shù)據(jù)共享機(jī)制,那么就必須把它定義為一種實(shí)現(xiàn) 上的限制.3.4

8、 通信接口描述與產(chǎn)品所使用的通信功能相關(guān)的需求,包括電子郵件、WEEU覽器、網(wǎng)絡(luò)通 信標(biāo)準(zhǔn)或協(xié)議及電子表格等,定義相關(guān)的信息格式、規(guī)定通信平安或加密問(wèn)題、數(shù) 據(jù)傳輸速率和同步通信機(jī)制.4 .功能需求4.1 功能分類將功能性需求先粗分再細(xì)分,下表中的Feature A, Function A.1等符號(hào)應(yīng)當(dāng)被替換成有含義的名稱.也可以用功能結(jié)構(gòu)圖表示功能類別功能Feature AFunction A.1Function A.2Feature BFunction B.1Function B.24.2 系統(tǒng)特性Feature A4.2.1 說(shuō)明和優(yōu)先級(jí)提出對(duì)該系統(tǒng)特性的簡(jiǎn)短說(shuō)明并指出該特性的優(yōu)先級(jí)是高

9、、中還是低.4.2.2 功能需求詳細(xì)列出與該特性相關(guān)的功能需求.這些是必須提交給用戶的軟件功能,使用 戶可以使用所提供的特性執(zhí)行效勞或者使用所指定的用例執(zhí)行任務(wù).描述產(chǎn)品如何 響應(yīng)可預(yù)知的出錯(cuò)條件或非法輸入或動(dòng)作.4.2.2.1功能 function A.1(1)說(shuō)明本功能的簡(jiǎn)要說(shuō)明(2)角色本功能的執(zhí)行人員(3)前置條件該功能啟動(dòng)的前提條件(4)輸入描述本功能的輸入信息(包括需要訪問(wèn)的存儲(chǔ)信息).(5)過(guò)程對(duì)本功能將做什么進(jìn)行詳細(xì)的描述.(6)輸出描述本功能的輸出信息(包括需要訪問(wèn)的存儲(chǔ)信息).(7)后置條件該功能結(jié)束的退出條件(8)業(yè)務(wù)規(guī)那么列舉出與該功能相關(guān)的操作規(guī)那么.例如什么人在特定

10、環(huán)境下可以進(jìn)行何種操作.4.2.2.2 function A.1 圖書借閱(1)說(shuō)明借閱人通過(guò)此功能向系統(tǒng)查詢并提交借書請(qǐng)求(2)角色借閱人(3)前置條件借閱人借閱證件在有效期內(nèi)借閱人沒(méi)有逾期未歸還的圖書(4)輸入借閱證(5)過(guò)程主過(guò)程描述1用戶用借閱證提供的帳號(hào)登錄系統(tǒng),系統(tǒng)顯示我的圖書館 界面2 .用戶選擇查詢圖書,系統(tǒng)顯示查詢界面3 .用戶按書名、作者、出版社查詢,系統(tǒng)顯示查詢結(jié)果4 .用戶可單項(xiàng)選擇或多項(xiàng)選擇書本,并確認(rèn)借閱.系統(tǒng)顯示確認(rèn)借閱 圖書清單.5 .用戶選擇確認(rèn)借閱,系統(tǒng)顯示借閱定單及費(fèi)用6用戶選擇提交定單,系統(tǒng)顯示提交結(jié)果和定單號(hào)7.系統(tǒng)執(zhí)行后置條件分支過(guò)程描系統(tǒng)執(zhí)行4;述

11、系統(tǒng)顯示借書籃現(xiàn)有內(nèi)容系統(tǒng)執(zhí)行2;系統(tǒng)執(zhí)行44.2.1用戶選擇放棄,系統(tǒng)執(zhí)行2;系統(tǒng)保存并執(zhí)行1;系統(tǒng)執(zhí)行1;異常過(guò)程描“歸還圖書功能述系統(tǒng)顯示余額和所需金額“交納借閱費(fèi)功能系統(tǒng)執(zhí)行1(6)輸出費(fèi)用記錄借閱定單(7)后置條件創(chuàng)立借書定單更新借閱人借閱記錄(8)業(yè)務(wù)規(guī)那么每次每人至少選擇一本,至多項(xiàng)選擇擇三本4.3 系統(tǒng)特性Feature B5 .非功能需求5.1 性能需求闡述不同的應(yīng)用領(lǐng)域?qū)Ξa(chǎn)品性能的需求,并解釋它們的原理以幫助開(kāi)發(fā)人員做 出合理的設(shè)計(jì)選擇.確定相互合作的用戶數(shù)或者所支持的操作、響應(yīng)時(shí)間以及與實(shí) 時(shí)系統(tǒng)的時(shí)間關(guān)系；還要定義容量需求,例如存儲(chǔ)器和磁盤空間的需求或者存儲(chǔ)在 數(shù)據(jù)庫(kù)中

12、表的最大行數(shù).也可能需要針對(duì)每個(gè)功能需求或特性分別陳述其性能需 求,而不是把它們集中在一起陳述.例如：“在運(yùn)行WINDOWS 1的3.5GHZ雙核芯 片的計(jì)算機(jī)上,當(dāng)系統(tǒng)至少有50%勺空閑資源時(shí),95%勺目錄數(shù)據(jù)庫(kù)查詢必須在兩秒 內(nèi)完成.5.2 平安性需求陳述與系統(tǒng)平安性、完整性或私人問(wèn)題相關(guān)的需求,這些問(wèn)題將會(huì)影響到產(chǎn)品的使用和產(chǎn)品所創(chuàng)立或使用的數(shù)據(jù)的保護(hù).明確產(chǎn)品必須滿足的平安性或保密性策 略.一個(gè)軟件系統(tǒng)的平安需求的范例如下：“每個(gè)用戶在第一次登錄之后,必須更改他的最初登錄密碼.最初的登錄密碼不能重用.5.3 軟件質(zhì)量屬性詳盡陳述與客戶或開(kāi)發(fā)人員至關(guān)重要的質(zhì)量特性.這些特性必須是確定、定

13、量 的并可驗(yàn)證的.至少應(yīng)指明不同屬性的相對(duì)側(cè)重點(diǎn),例如易用程度優(yōu)于易學(xué)程度, 或者可移植性優(yōu)于有效性.5.4 其它需求定義至今未出現(xiàn)的需求.例如國(guó)際化需求、法律上的需求、有關(guān)操作、治理、 維護(hù)、安裝、配置、啟動(dòng)、關(guān)閉、修復(fù)、容錯(cuò)、登錄、監(jiān)控等等方面的需求.說(shuō)明 本產(chǎn)品在可使用性、可維護(hù)性、可移植性、可靠性和平安性等方面的要求.6 .數(shù)據(jù)字典6.1 實(shí)體關(guān)系圖6.2 實(shí)體定義指出數(shù)據(jù)項(xiàng)名、定義、項(xiàng)結(jié)構(gòu)組成、項(xiàng)范圍、項(xiàng)類型.實(shí)體名稱Be_圖書實(shí)體描述每本圖書都經(jīng)有上架,預(yù)定,借出,返回待查和下架幾個(gè)狀態(tài),詳細(xì)請(qǐng)參看圖書狀態(tài)圖屬性名稱精度說(shuō)明屬性的業(yè)務(wù)含義及業(yè)務(wù)規(guī)那么圖書編號(hào)字符12圖書類別編號(hào)3位

14、+圖書購(gòu)入年份4位+流水號(hào)5位圖書分類字符3圖書的分類名稱字符100書本的封面名稱作者字符20書籍的作者出版社字符100書籍標(biāo)明的出版社出版日期日期書籍標(biāo)明的出版日期版本信息字符100書籍標(biāo)明的出版社簡(jiǎn)介字符1000書籍的內(nèi)容簡(jiǎn)介,上架時(shí)錄入狀態(tài)字符1書籍的狀態(tài),請(qǐng)參看圖書狀態(tài)圖7,業(yè)務(wù)規(guī)那么與業(yè)務(wù)算法7.1 業(yè)務(wù)規(guī)那么列舉出有關(guān)產(chǎn)品的所有操作規(guī)那么.例如什么人在特定環(huán)境下可以進(jìn)行何種操作.這些規(guī)那么不是功能需求,但它們可以暗示某些功能需求執(zhí)行這些規(guī)那么.業(yè)務(wù)規(guī)那么的 范例如下：“只有持有治理員密碼的用戶才能執(zhí)行100元以上的退款操作.借出規(guī)那么說(shuō)明：讀者已借書數(shù)未超過(guò)最大借書數(shù)、該書有庫(kù)存,

15、而且該讀者擁有借閱該書的權(quán)限,那么執(zhí)行該操作.罰款規(guī)那么說(shuō)明：1 .超期罰款：超期天數(shù)*超期罰款率.2 .喪失罰款：圖書價(jià)格*喪失賠率7.2 算法說(shuō)明用于實(shí)施系統(tǒng)計(jì)算功能的公式和算法的描述,類似于業(yè)務(wù)規(guī)那么.如某神州行套 餐的計(jì)費(fèi)標(biāo)準(zhǔn)說(shuō)明.a.每個(gè)主要算法的概況；b.用于每個(gè)主要算法的詳細(xì)公式.附錄A:分析模型也可以納入 4功能需求章節(jié)中描述包括或涉及到相關(guān)的分析模型的位置,例如數(shù)據(jù)流圖、類圖、狀態(tài)轉(zhuǎn)換圖等.頂層數(shù)據(jù)流圖：第1層數(shù)據(jù)流圖：第2層數(shù)據(jù)流圖：附錄B:待確定問(wèn)題的列表編輯一張?jiān)谲浖枨笠?guī)格說(shuō)明書中待確定問(wèn)題的列表,其中每一表項(xiàng)都是編上 號(hào)的,以便跟蹤調(diào)查.附錄C:編寫文檔的原那么編寫

16、文檔時(shí),要求具有本標(biāo)準(zhǔn)規(guī)定的所有條目如果某條目無(wú)內(nèi)容,那么填寫“無(wú),并在可能的情況下說(shuō)明理由.必要時(shí),可增加適當(dāng)?shù)臈l目.編寫優(yōu)秀的需求文檔沒(méi)有現(xiàn)成固定的方法,最好是根據(jù)經(jīng)驗(yàn)進(jìn)行.許多需求文 檔可以通過(guò)使用有效的技術(shù)編寫風(fēng)格和使用用戶術(shù)語(yǔ)而不是技術(shù)術(shù)語(yǔ)的方式得以 改良.你在編寫需求文檔時(shí),應(yīng)牢記以下幾點(diǎn)建議：?保持語(yǔ)句和段落的簡(jiǎn)短；?采用主動(dòng)語(yǔ)態(tài)的表達(dá)方式；? 語(yǔ)法正確,句子完整；?使用的術(shù)語(yǔ)與詞匯表中所定義的術(shù)語(yǔ)一致；?防止模糊的、主觀的術(shù)語(yǔ)如用戶友好、容易、簡(jiǎn)單、迅速、有效、許多、最新技術(shù)、優(yōu)越的、可接受的、健壯的等等；?防止使用比擬性的詞匯如提升、最大化、最小化、最正確化等.定量說(shuō)明所需 要提升的程度或者說(shuō)清一些參數(shù)可以接受的最大值和最小值.模糊的語(yǔ)句表 達(dá)將引起需求的不可驗(yàn)證.?由于需求的編寫是層次化的,因此,可以把頂層不明確的需求向低層詳細(xì)分 解,直到消除不明確性為止.編寫詳細(xì)的需求文檔,所帶來(lái)的益處是如果需 求得到滿足,那么客戶的目的也就到達(dá)了,但是不要讓過(guò)于詳細(xì)的需求影響 了設(shè)計(jì).如果你能用不同的方法來(lái)滿足需求,并且這種方法是可接受的,那 么需求的詳細(xì)程度也就足夠了.然而,如果評(píng)審需求規(guī)格說(shuō)明書的設(shè)計(jì)人員 對(duì)客戶的意圖還不甚了解,那么就需要增