軟件需求分析說明書審查規(guī)范

1、軟件需求分析說明書審查規(guī)范文件編號(hào)受控編號(hào)版本1.0編制日期生效日期密級(jí)編制審核批準(zhǔn)文件修改控制修改記錄編號(hào)修改狀態(tài)修改位置及內(nèi)容修改人審核人批準(zhǔn)人修改日期1.2.3.4.5.6.7.8.目錄16軟件需求分析說明書審查規(guī)范1目錄31.引言31.1.目的31.2.適用范圍31.3.使用說明42.參考資料43.術(shù)語定義44.質(zhì)量要求64.1.完整性64.1.1.整體內(nèi)容完整性64.1.2.需求項(xiàng)信息完整性84.2.正確性94.3.一致性104.4.可驗(yàn)證性104.5.劃分優(yōu)先級(jí)104.6.可用性115.附件115.1.一些編寫建議115.2.部分參考實(shí)例125.2.1.需求項(xiàng)表格125.2.2.表

2、格需求項(xiàng)實(shí)例135.2.3.優(yōu)先級(jí)劃分方法實(shí)例145.2.4.軟件需求分析說明書模板151. 引言1.1. 目的軟件需求分析說明書在軟件開發(fā)、測試、質(zhì)量保證、項(xiàng)目管理以及相關(guān)項(xiàng)目功能中起著重要作用。為了保證軟件說明書對質(zhì)量，本文檔具體描述了軟件需求分析說明書所要包含的內(nèi)容及其編制所要達(dá)到的質(zhì)量要求。1.2. 適用范圍作為軟件需求分析說明書是否可以進(jìn)入正式評(píng)審的審查標(biāo)準(zhǔn)，符合該規(guī)范的可以提交正式需求評(píng)審；作為測試人員編制軟件需求分析說明書審查列表的依據(jù)；作為開發(fā)人員編制軟件需求分析說明書的指導(dǎo)原則；1.3. 使用說明本文重點(diǎn)對需求分析說明書的內(nèi)容進(jìn)行要求，對表示方式、方法未明確提出要求對視為不作

3、要求；本文中的“應(yīng)”、“必須”含義等同；本文中的“現(xiàn)有的技術(shù)水平”指與該需求相關(guān)的行業(yè)中，可獲得的、已知的、可實(shí)際運(yùn)用于生產(chǎn)的、可信的、經(jīng)過驗(yàn)證的所有技術(shù)；本文中的需求可行性以通過審核發(fā)布的項(xiàng)目可行性研究報(bào)告為依據(jù)；2. 參考資料 GB 8566 計(jì)算機(jī)軟件開發(fā)規(guī)范 受控編號(hào)？GB 8567 計(jì)算機(jī)軟件產(chǎn)品開發(fā)文件編制指南 受控編號(hào)？GB/T 11457 軟件工程術(shù)語 受控編號(hào)？Systematic Software Testing Rick D.Craig, Stefan P.JaskielArtech House Publishers 2002-05-1 統(tǒng)一軟件開發(fā)過程RUP2000手冊

4、 IBM公司 2000年3. 術(shù)語定義GB/T 11457所列術(shù)語和下列定義適用于本文需求系統(tǒng)必須符合的條件或具備的功能軟件需求分析軟件需求分析的基本任務(wù)是準(zhǔn)確地定義未來系統(tǒng)的目標(biāo)，確定為了滿足用戶的需求，系統(tǒng)必須做什么。需求分析包括需求獲取和需求規(guī)約：需求獲取是系統(tǒng)分析員通過學(xué)習(xí)以及同用戶的交往，熟悉用戶領(lǐng)域的知識(shí)，并獲得對未來系統(tǒng)的需求；需求規(guī)約是系統(tǒng)分析員在獲得了用戶的初步需求后，必須進(jìn)行一致性分析和檢查，通過和用戶協(xié)商解決其中存在的二義性和不一致性，并以一種規(guī)范的形式準(zhǔn)確地表達(dá)用戶的需求，形成軟件需求分析說明書。軟件需求分析說明書（Software Requirements Speci

5、fications，簡稱SRS）：軟件需求分析說明書（也稱軟件需求規(guī)格說明書、軟件需求分析報(bào)告）是軟件需求分析階段得到的最終文檔，它以形式化的術(shù)語和表示對軟件的功能和性能進(jìn)行詳細(xì)而具體的描述。它是用戶和開發(fā)者之間的技術(shù)合同，是軟件設(shè)計(jì)、編碼階段的基礎(chǔ),也是軟件測試和驗(yàn)收的依據(jù)。IEEE軟件工程標(biāo)準(zhǔn)詞匯表(1997年)中定義為：(1) 用戶解決問題或達(dá)到目標(biāo)所需的條件或權(quán)能(Capability)。 (2) 系統(tǒng)或系統(tǒng)部件要滿足合同、標(biāo)準(zhǔn)、規(guī)范或其它正式規(guī)定文檔所需具有的條件或權(quán)能。 (3) 一種反映上面(1)或(2)所描述的條件或權(quán)能的文檔說明。軟件質(zhì)量IEEE 610.12-1990中定義：

6、一個(gè)系統(tǒng)、組件或過程滿足客戶或用戶的需求的程度，或滿足期望值的程度。（“The degree to which a system, component, or process meets customer or user needs or expectations.” ISO/IEC9126中定義：與軟件產(chǎn)品滿足規(guī)定的和隱含的需求的能力有關(guān)的特征或特性的全體。（The totality of features and characteristics of a software product that bear on its ability to satisfy stated or impli

7、ed needs.）軟件質(zhì)量保證軟件質(zhì)量保證，是為保證產(chǎn)品和服務(wù)充分滿足消費(fèi)者要求的質(zhì)量而進(jìn)行的有計(jì)劃、有組織的活動(dòng)。軟件質(zhì)量保證是面向消費(fèi)者的活動(dòng)，是為了使產(chǎn)品實(shí)現(xiàn)用戶要求的功能，站在用戶立場上來掌握產(chǎn)品質(zhì)量的。軟件的質(zhì)量保證就是向用戶及社會(huì)提供滿意的高質(zhì)量的軟件產(chǎn)品?？筛櫺灾溉绻恳粋€(gè)需求的來源、變更歷史是清晰的，在進(jìn)一步產(chǎn)生和改變文件編制時(shí)，可以方便地引證每一個(gè)需求，則該軟件需求分析說明書就是可追蹤的?？尚薷男灾溉绻粋€(gè)軟件需求分析說明書的結(jié)構(gòu)和風(fēng)格在需求有必要改變時(shí)是易于實(shí)現(xiàn)的、且改變后仍然完整、一致的，那么這個(gè)軟件需求分析說明書就是可修改的?？尚行灾冈谝?guī)定的時(shí)間限制和開銷下、在特定

8、的環(huán)境制約下、利用現(xiàn)有的技術(shù)、工具、資源和人力下，需求必須是可以實(shí)現(xiàn)的。具體包括：技術(shù)可行，現(xiàn)有的技術(shù)水平能夠?qū)崿F(xiàn)所有的需求；財(cái)政可行，有足夠的資金來實(shí)現(xiàn)所有的需求，且實(shí)現(xiàn)的成本在可接受的范圍內(nèi)；時(shí)間可行，在指定的時(shí)間范圍內(nèi)能夠?qū)崿F(xiàn)所有的需求；資源可行，有足夠的人力、物力來實(shí)現(xiàn)所有的需求；驗(yàn)證標(biāo)準(zhǔn)用以判斷需求被實(shí)現(xiàn)后，實(shí)現(xiàn)的結(jié)果是否正確的依據(jù)。如：對于性能需求，其驗(yàn)證標(biāo)準(zhǔn)是具體的性能指標(biāo)；對于功能需求，其驗(yàn)證標(biāo)準(zhǔn)是詳細(xì)的功能效果描述。軟件測試軟件測試是為了度量和提高被測軟件的質(zhì)量，對測試件進(jìn)行工程設(shè)計(jì)、實(shí)施和維護(hù)的整個(gè)生命周期過程。(Systematic Software Testing)統(tǒng)一

9、建模語言（UML）UML(Unified Modeling Language)是一種構(gòu)建軟件系統(tǒng)和文檔的通用可視化建模語言。UML 能與所有的開發(fā)方法一同使用，可用于軟件開發(fā)的整個(gè)生命周期。UML 能表達(dá)系統(tǒng)的靜態(tài)結(jié)構(gòu)和動(dòng)態(tài)信息，并能管理復(fù)雜的系統(tǒng)模型，便于軟件團(tuán)隊(duì)之間的合作開發(fā)。UML 不是編程語言，但支持UML 語言的工具可以提供從UML 到各種編程語言的代碼生成，也可以提供從現(xiàn)有程序逆向構(gòu)建UML 模型。統(tǒng)一軟件開發(fā)過程（RUP）RUP 是一個(gè)通用軟件過程框架，可以應(yīng)付種類廣泛的軟件系統(tǒng)、不同的應(yīng)用領(lǐng)域、不同的組織類型、不同的性能水平和不同的項(xiàng)目規(guī)模。“統(tǒng)一過程”是基于構(gòu)件的，這意味著利

10、用它開發(fā)的軟件系統(tǒng)是由構(gòu)件構(gòu)成的，構(gòu)件之間通過定義良好的接口相互聯(lián)系。在準(zhǔn)備軟件系統(tǒng)的所有藍(lán)圖的時(shí)候，“統(tǒng)一過程”使用的是“統(tǒng)一建模語言（Unified Modeling Language ）”。事實(shí)上，UML 是“統(tǒng)一過程”的有機(jī)組成部分它們是被同步開發(fā)的。然而，真正使“統(tǒng)一過程”與眾不同的方面可以用三個(gè)句話來表達(dá)：它是用例驅(qū)動(dòng)的、以基本架構(gòu)為中心的、迭代式和增量性的。4. 質(zhì)量要求合格的軟件需求分析說明書要滿足如下質(zhì)量要求：1. 完整性2. 正確性3. 一致性4. 可驗(yàn)證性5. 劃分優(yōu)先級(jí)6. 可用性下面我們分別對每個(gè)質(zhì)量要求進(jìn)行說明，同時(shí)給出如何滿足各質(zhì)量要求的指導(dǎo)原則。4.1. 完整性

11、 完整性是指軟件需求分析說明書包含了所有應(yīng)該具備的內(nèi)容，由于不同的產(chǎn)品、項(xiàng)目對軟件需求分析說明書所應(yīng)該具備的內(nèi)容的不完全相同，因此為了便于指導(dǎo)和規(guī)范文檔的實(shí)際編制本規(guī)范將完整性劃分為整體內(nèi)容完整性、需求項(xiàng)信息完整性，并針對不同的內(nèi)容提出不同的要求，包括：必須和可選，具體如下：4.1.1. 整體內(nèi)容完整性整體內(nèi)容完整性用以確定整個(gè)軟件需求分析說明書中具體應(yīng)該包含的內(nèi)容和不應(yīng)該包含的內(nèi)容，具體如下：一. 需求沒有遺漏：確定在需求分析說明書編制的過程中，沒有遺漏需求獲取階段所確定的需求。其依據(jù)為包括但不僅限于通過正式審核的下列文檔：1. 市場調(diào)研報(bào)告；2. 用戶需求調(diào)查報(bào)告；3. 需求分析討論會(huì)議記

12、錄；二. 需求沒有冗余：即同一需求不能在軟件需求分析說明書中出現(xiàn)多次；三. 不存在超出產(chǎn)品/項(xiàng)目范圍的需求；四. 除設(shè)計(jì)上的特殊限制之外，軟件需求分析說明書中不描述任何設(shè)計(jì)、驗(yàn)證或項(xiàng)目管理細(xì)節(jié)的內(nèi)容；五. 軟件需求分析說明書必須包含下列信息：1. 目的：說明編寫這份軟件需求說明書的目的，指出預(yù)期的讀者2. 概述：說明產(chǎn)品或項(xiàng)目的背景、總體描述、功能、用戶特點(diǎn)、一般的設(shè)計(jì)約束。只描述影響產(chǎn)品及其需求的一般因素，不說明具體的需求，概述的目的僅近使需求更易于理解3. 參考資料：列出軟件需求分析說明書中所有用得到的所有參考資料，詳細(xì)說明參考資料的來源。內(nèi)容包括但不僅限于：1) 本產(chǎn)品或項(xiàng)目的經(jīng)過核準(zhǔn)的

13、計(jì)劃任務(wù)書或合同、上級(jí)機(jī)關(guān)的批文；2) 本項(xiàng)目的其他已通過審核的正式文檔；3) 企業(yè)內(nèi)部制定發(fā)布的正式管理文件；4) 各處引用的資料，如出版物、網(wǎng)絡(luò)資訊；5) 所要用到的軟件開發(fā)標(biāo)準(zhǔn)。 且每條參考資料記錄中包含的內(nèi)容及格式應(yīng)滿足下列要求（按類型劃分）：1) 專著出版物：主要作者，其他作者，書名，版本，出版地：出版者，出版年；2) 連續(xù)期刊出版物：文獻(xiàn)作者，文獻(xiàn)其他作者，題名，刊物名，版本：在原文獻(xiàn)中的位置；3) 標(biāo)準(zhǔn)：標(biāo)準(zhǔn)編，號(hào)標(biāo)準(zhǔn)名，公司受控編號(hào)；4) 文件：文件編號(hào)，文件名，文件版本5) 網(wǎng)絡(luò)資訊：作者，題名，發(fā)布網(wǎng)址，發(fā)布時(shí)間4. 術(shù)語定義：提供軟件需求分析說明書中用到的專門術(shù)語、縮寫詞

14、、縮略語的定義，這部分信息可以在軟件需求分析說明書中用一個(gè)單獨(dú)章節(jié)提供或者在附錄中提供，也可以參考其他的文件；5. 具體需求：指產(chǎn)品或項(xiàng)目必須符合的條件或具備的功能，它包括軟件開發(fā)者在建立設(shè)計(jì)時(shí)需要的全部細(xì)節(jié)。由于不同的產(chǎn)品項(xiàng)目其需求都不同，同樣的需求可以使用不同的分類方法進(jìn)行劃分，因此這里只列舉一種比較常見的劃分方式，并分別加以說明：1) 功能需求：規(guī)定了在不考慮物理約束的情況下必須能夠執(zhí)行的動(dòng)作，也就是通常所說的系統(tǒng)能夠做什么；2) 性能需求：是指軟件功能在執(zhí)行過程中需要滿足的強(qiáng)加條件，如速度、效率、可使用性、響應(yīng)時(shí)間、各種軟件功能的恢復(fù)時(shí)間、吞吐能力、精度、頻率、資源用途等等3) 屬性需

15、求：可擴(kuò)展性、可移植性、穩(wěn)定性、可靠性、可維護(hù)性、 兼容性、 安全性、可配置性、 可服務(wù)性、 可安裝性，可國際化性、可用性、易用性等方面的考慮因素；4) 外部接口：用戶、硬件、其他軟件和其他硬件的相互關(guān)系，如用戶接口、軟件接口、硬件接口、通信接口等；5) 強(qiáng)加的設(shè)計(jì)限制或?qū)崿F(xiàn)約束：說明必須遵守的技術(shù)標(biāo)準(zhǔn)和軟硬件限制等設(shè)計(jì)約束，如對硬件配置的要求，對軟件開發(fā)環(huán)境限制、運(yùn)行環(huán)境限制和對軟件設(shè)計(jì)、實(shí)現(xiàn)方式的限制；六. 包含第五條中未列出但應(yīng)該在需求分析說明書中說明的其他信息；七. 對第五條第5項(xiàng)具體需求所列出的幾類需求的要求：除功能需求總是必須的，其他需求根據(jù)產(chǎn)品/項(xiàng)目的實(shí)際情況進(jìn)行增刪裁減。4.1

16、.2. 需求項(xiàng)信息完整性需求項(xiàng)信息完整性指每個(gè)具體需求的需求項(xiàng)需包含足夠的信息，來詳細(xì)明確定義需求要實(shí)現(xiàn)的目標(biāo)。一. 針對每個(gè)需求項(xiàng)，必須包含下列信息：1. 唯一標(biāo)識(shí)：跟蹤需求的標(biāo)簽，唯一且不變，建議采用“項(xiàng)目編號(hào)+內(nèi)部編號(hào)”方式，使需求編號(hào)在整個(gè)公司的范圍內(nèi)都是唯一點(diǎn)；2. 簡要描述：簡單描述該需求要實(shí)現(xiàn)的目標(biāo)；3. 類型：需求的類型，依所采用的需求分類方法而定；4. 目的：簡要描述提出該需求的目的，若很明顯則寫“略”；5. 來源：誰提出該需求，具體可以是人(客戶、用戶、員工)、公司、市場等；6. 詳細(xì)描述：對該需求的詳細(xì)說明；由于不同類型的需求其詳細(xì)描述需要包含的內(nèi)容不同，下面分類列出具體

17、應(yīng)該包含的詳細(xì)內(nèi)容：A. 功能性需求：應(yīng)包括但不僅限于下列內(nèi)容：1) 環(huán)境要求：完成該功能應(yīng)該滿足的具體條件，如什么狀態(tài)、情況、什么樣的軟硬件環(huán)境下可以進(jìn)行該功能；2) 觸發(fā)者：使該功能的執(zhí)行的人或事，可以是用戶或是其他系統(tǒng)、定時(shí)事件等；3) 輸入：描述該功能執(zhí)行前及在執(zhí)行過程中所有輸入的詳細(xì)定義。例如：數(shù)據(jù)類型輸入的數(shù)據(jù)類型、數(shù)量、度量單位、源、時(shí)間關(guān)系、要求（如精度）； 功能執(zhí)行過程中的用戶操作控制信息；事件類型輸入的事件時(shí)間設(shè)定；所引用的用以統(tǒng)一定義輸入的有關(guān)接口說明或接口控制文件。4) 處理：該功能所完成的任務(wù)，即從輸入到輸出的變換操作過程。具體應(yīng)包括但不僅限于下列內(nèi)容：對所有輸入的有

18、效性檢查；對所有輸入的處理順序、流程或方法，即系統(tǒng)如何把輸入變換成相應(yīng)輸出，可以使用自然語言、方程式、數(shù)學(xué)算法、邏輯操作、圖、表、狀態(tài)機(jī)等不同表達(dá)方式進(jìn)行描述；對所有輸出有效性的檢查；對所有異常情況的處理及響應(yīng)，例如，溢出、通信故障、要所有非合法輸入的響應(yīng)、錯(cuò)誤處理等；5) 輸出：描述該功能所有最終預(yù)期結(jié)果的詳細(xì)定義。如：數(shù)據(jù)類型輸出的數(shù)據(jù)類型、數(shù)量、目的地、度量單位、時(shí)間關(guān)系、要求（如精度）； 所引用的用以統(tǒng)一定義輸出的有關(guān)接口說明或接口控制文件。B. 非功能性需求：性能需求：達(dá)到該性能需求必須具備的條件或限制；該性能需求所要達(dá)到的具體性能指標(biāo)屬性需求：可移植性：具體列出要求可以移植的平臺(tái)；

19、可維護(hù)性：具體列出保證可維護(hù)性的具體的方法；安全性：具體列出要達(dá)到的安全級(jí)別或安全程度；兼容性：具體列出所要兼容的平臺(tái)或軟硬件環(huán)境；可測試性：具體列出保證該特性的具體功能和方法；可靠性：具體列出可靠性的要求，如無故障運(yùn)行時(shí)間；設(shè)計(jì)限制：列出所有的限制因素，如：需遵守的技術(shù)標(biāo)準(zhǔn): 列出所有必須遵守的技術(shù)標(biāo)準(zhǔn)、規(guī)范（包含標(biāo)準(zhǔn)名、標(biāo)準(zhǔn)編號(hào)、版本號(hào)（或發(fā)布日期）、公司受控編號(hào)信息）硬件限制：列出所有影響或約束產(chǎn)品/項(xiàng)目的硬件成分，如運(yùn)行環(huán)境最低配置；軟件限制：列出所有影響或約束產(chǎn)品/項(xiàng)目的軟件成分，如軟件開發(fā)環(huán)境限制、軟件運(yùn)行環(huán)境限制和軟件的設(shè)計(jì)限制；7. 驗(yàn)證標(biāo)準(zhǔn)：用于該需求被實(shí)現(xiàn)后，檢查實(shí)現(xiàn)結(jié)果是

20、否符合需求，給測試或用戶提供明確的驗(yàn)證依據(jù)。如：對于性能需求，列出具體的性能指標(biāo)；對于功能需求，給出詳細(xì)的實(shí)現(xiàn)效果；若驗(yàn)證標(biāo)準(zhǔn)已包含在詳細(xì)描述中，則指明位置即可；8. 優(yōu)先級(jí)：用以表明該需求在產(chǎn)品/項(xiàng)目中的重要程度及被實(shí)現(xiàn)代優(yōu)先順序，應(yīng)定義優(yōu)先級(jí)的劃分方式，不同的產(chǎn)品/項(xiàng)目可以采用不同的劃分方式； 9. 依賴性：對其他需求的存在、變化的依賴，如列出本需求所引用的需求，若無任何依賴，則寫“無”；二. 包含第一條中未列出但應(yīng)該在需求項(xiàng)中說明的其他信息；4.2. 正確性正確性指對需求的定義必須是對的，它涵蓋了軟件需求分析說明書中所定義的需求與用戶的實(shí)際需求是一致的、對需求內(nèi)容的描述是明確、準(zhǔn)確、精確

21、和無歧義的。具體應(yīng)滿足但不僅限于下列要求：1. 每個(gè)需求與用戶的實(shí)際需求是一致，即正確表達(dá)了用戶的真正需求，可以使用讓用戶確認(rèn)的方式來保證；2. 內(nèi)容的表達(dá)沒有錯(cuò)誤，應(yīng)滿足包括但不僅限于下列要求：1) 使用正確的語法，拼寫，標(biāo)點(diǎn)；2) 無錯(cuò)字和別字；3) 用詞貼確；3. 內(nèi)容的表達(dá)無歧義，如同一讀者對同一表達(dá)通過不同的斷句方式得出多種正確的理解；4. 無不一致的內(nèi)容，詳見質(zhì)量要求的“一致性”部分；5. 沒有因使用不明確的表述而存在可隨意發(fā)揮的內(nèi)容，如：描述中出現(xiàn)了對于軟件需求分析說明書作者自己很清楚但讀者并不清楚的主觀性詞語（除了已經(jīng)對這些詞語進(jìn)行了明確的定義或引用說明），具體如：“待定”、“

22、可能”、“即將”、“考慮”、“最好”、“最差”、“一般情況”、“特殊情況”、“可以”、“用戶友好性”，“容易”，“簡單”，“快速”，“有效”，“幾個(gè)”，“藝術(shù)級(jí)”，“改善的”，“最大”，“最小”、“較好”、“較差”、“等等”、“一期實(shí)現(xiàn)”、“根據(jù)需要”、“如果可能”、“高級(jí)”。4.3. 一致性 一致性指不存在內(nèi)容相互矛盾的地方。具體應(yīng)滿足但不僅限于下列要求：1. 同一內(nèi)容在整個(gè)軟件需求分析說明書中其內(nèi)涵和外延都是一致的；2. 不存在一個(gè)需求與軟件的其他需求或高級(jí)別的系統(tǒng)需求發(fā)生沖突的現(xiàn)象；3. 術(shù)語的定義與標(biāo)準(zhǔn)、規(guī)范、行業(yè)用戶的定義一致；4. 需求被引用時(shí)的含義與定義時(shí)的含義保持一致；5. 術(shù)

23、語被引用時(shí)的含義與定義時(shí)的含義保持一致，若某一術(shù)語在某一特殊的行文中使用時(shí)具有多種歧義，那么對該術(shù)語的每種含義作出解釋并指出其適用場合；4.4. 可驗(yàn)證性 可驗(yàn)證性指針對每項(xiàng)需求能夠找到某種方法，通過這種方法可以驗(yàn)證該需求被實(shí)現(xiàn)后其實(shí)現(xiàn)的結(jié)果是否正確。具體應(yīng)滿足但不僅限于下列要求：1. 每個(gè)需求必須是可行的，只有可行的才是可驗(yàn)證的；2. 每個(gè)需求項(xiàng)必須有明確的驗(yàn)證標(biāo)準(zhǔn)，且驗(yàn)證標(biāo)準(zhǔn)在現(xiàn)有的技術(shù)水平下是可測量的（能夠找到某種測試方法，通過這種方法可以明確判斷出是否已經(jīng)達(dá)到預(yù)期指定的要求），如對于該性能需求，必須給出已經(jīng)量化的所要達(dá)到的具體性能指標(biāo)，且這些指標(biāo)都能用某種方法或工具進(jìn)行測量；3. 需求

24、必須一致的，詳見質(zhì)量要求的“一致性”部分；4. 需求必須是明確的，詳見質(zhì)量要求的“正確性”部分的第5條；如任何需求如果說“產(chǎn)品/項(xiàng)目將要支持什么”是不可驗(yàn)證的，必須具體說明何時(shí)支持，如何支持。4.5. 劃分優(yōu)先級(jí)劃分優(yōu)先級(jí)指為每個(gè)需求指定實(shí)施的優(yōu)先級(jí)，以表明它在產(chǎn)品/項(xiàng)目中的重要程度及被實(shí)現(xiàn)代優(yōu)先順序。具體應(yīng)滿足下列要求：為整個(gè)軟件需求分析說明書制定統(tǒng)一的優(yōu)先級(jí)劃分標(biāo)準(zhǔn)；為每個(gè)需求指定一個(gè)定義好的優(yōu)先級(jí)；4.6. 可用性可用性指需求分析說明書易于閱讀、理解、修改、跟蹤、維護(hù)、管理。具體應(yīng)滿足但不僅限于下列要求：1. 每項(xiàng)需求都有唯一標(biāo)識(shí)，便于需求的引用、跟蹤、管理；2. 明確指出需求間的相互關(guān)

25、聯(lián)，便于在需求變更時(shí)確定變更所涉及和影響的范圍；3. 明確說明每項(xiàng)需求的來源和目的，便于需求的跟蹤、維護(hù)；4. 維護(hù)記錄需求的修改歷史，便于需求的跟蹤、管理；5. 對需求進(jìn)行良好的組織，如：對需求進(jìn)行類型劃分后將相關(guān)的需求分組，對需求進(jìn)行層次劃分使需求的結(jié)構(gòu)層次清晰，為需求建立目錄表、索引等。便于需求的閱讀、管理。6. 編寫、排版風(fēng)格保持統(tǒng)一，便于閱讀、理解，如對于同一類的內(nèi)容，使用相同的表達(dá)方式和方法；7. 最終產(chǎn)品的每一個(gè)特性用某一術(shù)語描述，便于修改、維護(hù)；8. 部分編寫格式符合一定的標(biāo)準(zhǔn)，如參考文檔記錄的格式；9. 需求的粗細(xì)粒度要保持一致；如軟件需求分析說明書中同時(shí)存在下列的需求描述，

26、其粒度是不一致的：“用戶信息對于紅色合法的顏色代碼應(yīng)是R”、“對于綠色合法的顏色代碼應(yīng)是G”、“產(chǎn)品應(yīng)能對來自語音編輯指示做出反應(yīng)”，最后一個(gè)需求應(yīng)作為一個(gè)子系統(tǒng)而不應(yīng)作為單個(gè)的功能性需求。10. 對多處出現(xiàn)的同一內(nèi)容進(jìn)行統(tǒng)一的定義再分別引用，便于修改、維護(hù)和保證一致性；11. 避免將多個(gè)需求合成單個(gè)需求12. 若選擇使用某軟件需求分析說明書的模板，應(yīng)：1) 如果模板中的個(gè)別章節(jié)或部分內(nèi)容不適用，則在軟件需求分析說明書中要保留章節(jié)號(hào)并寫明不適用，不應(yīng)刪除；2) 若模板中未列出，但需求中應(yīng)該包含的信息，應(yīng)在文檔中適當(dāng)?shù)奈恢锰砑樱?. 附件此章節(jié)內(nèi)容只作為開發(fā)人員編寫軟件需求分析說明書時(shí)的一個(gè)參考

27、，不作為審查的內(nèi)容。5.1. 一些編寫建議列出軟件需求分析說明書編寫過程中的一些建議，這些建議的描述相對比較定性、籠統(tǒng)。1. 使用書面語，不用口語；2. 使用短句和短的段落；3. 采用主動(dòng)語氣；4. 語句表達(dá)方式的風(fēng)格要保持一致；5. 編寫時(shí)盡量使用定量、客戶的詞匯，少用定性、主觀的詞匯；6. 編寫時(shí)以開發(fā)人員的角度來審視是否需要軟件需求分析說明書作者的額外解釋和幫助開發(fā)人員才能理解需求，才能進(jìn)行設(shè)計(jì)和實(shí)現(xiàn)？若是，則需進(jìn)一步細(xì)化需求；7. 避免一個(gè)段落中包含了多個(gè)的需求；8. 對軟件需求說明書進(jìn)行持續(xù)的改進(jìn)，軟件產(chǎn)品的開發(fā)過程中，在項(xiàng)目的開始階段可能無法詳細(xì)說明某些細(xì)節(jié)，在開發(fā)過程中可能發(fā)現(xiàn)缺

28、陷、缺點(diǎn)和錯(cuò)誤，一旦發(fā)現(xiàn)需立即按需求管理的流程改進(jìn)；9. 不要在一個(gè)需求中使用“和”/“或”，以避免將多個(gè)需求合成一個(gè)需求；10. 使用需求編制、管理工具，以便需求的變更并保證變更后需求仍是一致的、保證編寫和排版風(fēng)格的統(tǒng)一；11. 盡量使用形式化的語言，少用自然語言，如使用UML、圖、表格、規(guī)范化模型等方式。因?yàn)楸M管自然語言是豐富多彩的，但不易精確表述；12. 編寫時(shí)重點(diǎn)在其表達(dá)的內(nèi)容，不要拘泥于表達(dá)的形式，形式可以多種多樣，合適易用的即可；13. 建議選擇使用適用的需求分析說明書模板；5.2. 部分參考實(shí)例列出軟件需求分析說明書中部分重要內(nèi)容的常見表示方式的例子。5.2.1. 需求項(xiàng)表格 使

29、用表格的方式來組織需求項(xiàng)的內(nèi)容。唯一標(biāo)識(shí)【必須】(跟蹤需求的標(biāo)簽，唯一且不變，建議采用(項(xiàng)目編號(hào)+文檔的內(nèi)部編號(hào))方式，使需求編號(hào)在整個(gè)公司的范圍內(nèi)都是唯一點(diǎn))簡要描述【必須】(簡單描述該需求要實(shí)現(xiàn)的目標(biāo)) 類型【必須】(需求的類型，依需求的分類方法而定)目的【可選】(簡要描述提出該需求的目的，若很明顯則寫“略”)來源【必須】(指誰提出該需求，具體可以是人(客戶、用戶、員工)、公司、市場等)詳細(xì)描述【必須】對該需求的詳細(xì)說明；由于不同類型的需求其詳細(xì)描述需要包含的內(nèi)容不同，下面分類列出具體應(yīng)該包含的詳細(xì)內(nèi)容：A. 功能性需求：應(yīng)包括但不僅限于下列內(nèi)容：1. 環(huán)境要求：完成該功能應(yīng)該滿足的具體條

30、件，如什么狀態(tài)、情況、什么樣的軟硬件環(huán)境下可以進(jìn)行該功能；2. 觸發(fā)者：使該功能的執(zhí)行的人或事，可以是用戶或是其他系統(tǒng)、定時(shí)事件等；3. 輸入：描述該功能執(zhí)行前及在執(zhí)行過程中所有輸入的詳細(xì)定義。例如：數(shù)據(jù)類型輸入的數(shù)據(jù)類型、數(shù)量、度量單位、源、時(shí)間關(guān)系、要求（如精度）； 功能執(zhí)行過程中的用戶操作控制信息；事件類型輸入的事件時(shí)間設(shè)定；所引用的用以統(tǒng)一定義輸入的有關(guān)接口說明或接口控制文件。4. 處理：該功能所完成的任務(wù)，即從輸入到輸出的變換操作過程。具體應(yīng)包括但不僅限于下列內(nèi)容：對所有輸入的有效性檢查；對所有輸入的處理順序、流程或方法，即系統(tǒng)如何把輸入變換成相應(yīng)輸出，可以使用自然語言、方程式、數(shù)學(xué)

31、算法、邏輯操作、圖、表、狀態(tài)機(jī)等不同表達(dá)方式進(jìn)行描述；對所有輸出有效性的檢查；對所有異常情況的處理及響應(yīng)，例如，溢出、通信故障、要所有非合法輸入的響應(yīng)、錯(cuò)誤處理等；5. 輸出：描述該功能所有最終預(yù)期結(jié)果的詳細(xì)定義。如：數(shù)據(jù)類型輸出的數(shù)據(jù)類型、數(shù)量、目的地、度量單位、時(shí)間關(guān)系、要求（如精度）； 所引用的用以統(tǒng)一定義輸出的有關(guān)接口說明或接口控制文件。非功能性需求：性能需求：達(dá)到該性能需求必須具備的條件或限制；該性能需求所要達(dá)到的具體性能指標(biāo)屬性需求：可移植性：具體列出要求可以移植的平臺(tái)；可維護(hù)性：具體列出保證可維護(hù)性的具體的方法；安全性：具體列出要達(dá)到的安全級(jí)別或安全程度；兼容性：具體列出所要兼容的平臺(tái)或軟硬件環(huán)境；可測試性：具體列出保證該特性的具體功能和方法；設(shè)計(jì)限制：列出具體的限制因素；驗(yàn)證標(biāo)準(zhǔn)【必須】（用于后期檢查實(shí)現(xiàn)結(jié)果是否符合需求，給測試或用戶提供明確的驗(yàn)證依據(jù)。如：對于性能需求，列出具體的性能指標(biāo)；對于功能需求，給出詳細(xì)的實(shí)現(xiàn)效果；若驗(yàn)證標(biāo)準(zhǔn)已包含在詳細(xì)描述中，則指明位置即可。）優(yōu)先級(jí)【必須】(用以表明該需求在產(chǎn)品/項(xiàng)目中的重要程度及被實(shí)現(xiàn)代優(yōu)先順序，應(yīng)定義優(yōu)先級(jí)的劃分方式，不同的產(chǎn)品/項(xiàng)目可以采用不同的劃分方式)依賴性【必須】(對其他需求的存在、變化的依賴，如列出本需求所引用的需求，若無任何依賴，則寫“無”。)