【文章內(nèi)容簡(jiǎn)介】 學(xué)習(xí)的容易程序 [學(xué)習(xí)使用該產(chǎn)品應(yīng)該多容易的說(shuō)明。通常是有學(xué)習(xí)時(shí)間來(lái)衡量。] 速度需求 [明確完成特定任務(wù)需要的時(shí)間，這常常指響應(yīng)時(shí)間。] 安全性的需求 [對(duì)可能造成人身傷害、財(cái)產(chǎn)損失和環(huán)境破壞所考慮到的風(fēng)險(xiǎn)進(jìn)行量化描述。] 精度需求 [對(duì)產(chǎn)品產(chǎn)生的結(jié)果期望的精度進(jìn)行量化描述。] 可靠性和可用性需求[本節(jié)量化產(chǎn)品所需的可靠性。這常常表述為允許的兩次失敗之間無(wú)故障運(yùn)行時(shí)間，或允許的總失敗率。] 容量需求 [本節(jié)明確處理的吞吐量和產(chǎn)品存儲(chǔ)數(shù)據(jù)的容量。] 預(yù)期的物理環(huán)境 [本節(jié)明確產(chǎn)品將操作的物理環(huán)境，以及這種環(huán)境引起的任何特殊需求。] 預(yù)期的技術(shù)環(huán)境 [硬件和其它組成新產(chǎn)品操作環(huán)境的設(shè)備的規(guī)范。] 伙伴應(yīng)用程序 [對(duì)產(chǎn)品必須與之交互的其它應(yīng)用程序的描述。] 維護(hù)該產(chǎn)品需要多容易 [對(duì)產(chǎn)品作特定修改所需時(shí)間的量化描述。] 是否存在一些特殊情況適用于該產(chǎn)品的維護(hù) [關(guān)于預(yù)期的產(chǎn)品發(fā)布周期和發(fā)布將采取的形式的規(guī)定。] 可移植性需求 [對(duì)產(chǎn)品必須支持的其他平臺(tái)或環(huán)境的描述。] 該產(chǎn)品是保密的嗎？ [關(guān)于該被授權(quán)使用該產(chǎn)品，以及在什么樣的情況下授權(quán)等方面的描述。] 文件完整性需求 [關(guān)于需要的數(shù)據(jù)庫(kù)和其他文件完整性方面的說(shuō)明。] 審計(jì)需求 [關(guān)于需要的審計(jì)檢查方面的說(shuō)明。][本節(jié)包括針對(duì)社會(huì)和政策的因素的規(guī)格說(shuō)明，這些因素會(huì)影響產(chǎn)品的可接受性。如果你開(kāi)發(fā)的產(chǎn)品是針對(duì)外國(guó)市場(chǎng)的，可能要特別注意這些需求。][問(wèn)一下是否產(chǎn)品的目標(biāo)是你所不熟悉的文化環(huán)境，是否其它國(guó)家的人或其他類型的組織的人會(huì)使用該產(chǎn)品。人們是否有與你的文化不同的習(xí)慣、節(jié)日、迷信、文化上的社會(huì)行為規(guī)范。] 該產(chǎn)品是否受到某些法律的管制 [明確該產(chǎn)品的法律需求的描述。] 是否有一些必須符合的標(biāo)準(zhǔn) [明確適用的標(biāo)準(zhǔn)和參考的詳細(xì)標(biāo)準(zhǔn)的描述。][對(duì)未確定但可能對(duì)產(chǎn)品產(chǎn)生重要影響的因素的問(wèn)題描述。按照需求分析的術(shù)語(yǔ)還說(shuō)，就是TBD（To Be Define）的問(wèn)題。] 是否有一些制造好的產(chǎn)品可以購(gòu)買 [應(yīng)該調(diào)查現(xiàn)存產(chǎn)品清單，這些產(chǎn)品可以作為潛在的解決方案。] 該產(chǎn)品是否可使用制造好的組件 [描述可能用于該產(chǎn)品的候選組件，包括采購(gòu)的和公司自己的產(chǎn)品。列出來(lái)源。] 是否有一些我們可以復(fù)制的東西 [其他相似產(chǎn)品的清單。] 新產(chǎn)品會(huì)在當(dāng)前環(huán)境中帶來(lái)什么問(wèn)題 [關(guān)于新產(chǎn)品將怎樣影響當(dāng)前的實(shí)現(xiàn)環(huán)境的描述。] 新的開(kāi)發(fā)是否將影響某些已實(shí)施的系統(tǒng) [關(guān)于新產(chǎn)品將怎樣與現(xiàn)存系統(tǒng)協(xié)同工作的描述。] 是否我們現(xiàn)有的用戶會(huì)受到新開(kāi)發(fā)的敵對(duì)性影響 [關(guān)于現(xiàn)有用戶可能產(chǎn)生的敵對(duì)性反應(yīng)的細(xì)節(jié)。] 預(yù)期的實(shí)現(xiàn)環(huán)境會(huì)存在什么限制新產(chǎn)品的因素 [關(guān)于新的自動(dòng)化技術(shù)、新的組織結(jié)構(gòu)方式的任何潛在問(wèn)題的描述。] 是否新產(chǎn)品會(huì)帶來(lái)其他問(wèn)題 [確定我們可能不能處理的情況。] 為提交該產(chǎn)品已經(jīng)做了哪些事[用來(lái)開(kāi)發(fā)產(chǎn)品的生命周期和方法的細(xì)節(jié)。畫(huà)一個(gè)高層的過(guò)程圖展示各項(xiàng)任務(wù)和它們之間的接口，這可能是溝通這方面信息的最好辦法。] 開(kāi)發(fā)階段 [關(guān)于每個(gè)開(kāi)發(fā)階段和操作環(huán)境中的組件的規(guī)格說(shuō)明。] 我們要讓已有數(shù)據(jù)和過(guò)程配合新產(chǎn)品，有什么特殊要求 [一個(gè)移交活動(dòng)的列表，一個(gè)實(shí)現(xiàn)的時(shí)間表。] 為了新產(chǎn)品，哪些數(shù)據(jù)必須修改/轉(zhuǎn)換 [數(shù)據(jù)轉(zhuǎn)換任務(wù)清單，同時(shí)確定新產(chǎn)品需要轉(zhuǎn)換的數(shù)據(jù)。]23. 風(fēng)險(xiǎn) 當(dāng)你開(kāi)發(fā)該產(chǎn)品時(shí)，要面對(duì)什么風(fēng)險(xiǎn) 你制定了怎樣的偶然緊急情況計(jì)劃 [需求的其他費(fèi)用是你必須投入到產(chǎn)品構(gòu)建中去的錢(qián)或工作量。當(dāng)需求規(guī)格說(shuō)明書(shū)完成時(shí)，你可以使用一種估算方法來(lái)評(píng)估費(fèi)用，然后以構(gòu)建所需的資金或時(shí)間的形式表述出來(lái)。][用戶文檔的清單，這些文檔將作為產(chǎn)品的一部分交付。][這里記錄下一些希望今后版本中實(shí)現(xiàn)的需求。]Volere需求記錄卡編者說(shuō)明：正如前面所述，Atlantic System Guild還提供了一個(gè)配套的Volere需求記錄卡，這個(gè)記錄卡十分實(shí)用。建議大家在需求調(diào)查、分析過(guò)程中，將需求記錄在一系列的Volere需求記錄卡上，這個(gè)卡讓你能夠很好的理清需求之間的關(guān)系，需求提出的背景，用戶對(duì)需求的期望，有了這些素材，整理SRS時(shí)將變得更加簡(jiǎn)單。需求： 需求類型： 事件/用例：描述：理由：來(lái)源：驗(yàn)收標(biāo)準(zhǔn)：顧客滿意度： 顧客不滿意度：依賴關(guān)系： 沖突：支持材料： 歷史：Copyright @ Atiantic system GuildVolere注：顧客滿意度是指完成該項(xiàng)功能顧客滿意的程度，而顧客不滿意度則是指未實(shí)現(xiàn)該功能顧客不滿意的程度。軟件需求規(guī)格說(shuō)明書(shū)頁(yè)：16 注，以RUP《軟件需求規(guī)約》進(jìn)行修改。編者說(shuō)明： 如果在需求分析時(shí)采用了用例（Use case）技術(shù)，那么該需求規(guī)格說(shuō)明書(shū)將更加符合你的需要。當(dāng)然，你也可以結(jié)合Volere需求規(guī)格說(shuō)明書(shū)對(duì)該模板進(jìn)行必要的修改。1. 文檔概述[該部分主要是對(duì)軟件需求規(guī)格說(shuō)明書(shū)文檔進(jìn)行基本的描述，包括該文檔的目的、范圍、術(shù)語(yǔ)定義、參考資料以及概要。][軟件需求規(guī)格說(shuō)明書(shū)用來(lái)系統(tǒng)、完整地記錄系統(tǒng)的軟件需求。該軟件需求說(shuō)明書(shū)的基礎(chǔ)是用例分析技術(shù)。因此該文檔中應(yīng)包括用例模型、補(bǔ)充規(guī)約等內(nèi)容。][在此小節(jié)中，主要對(duì)軟件需求規(guī)格說(shuō)明書(shū)的目的做一概要性說(shuō)明，通常軟件需求規(guī)格說(shuō)明書(shū)應(yīng)詳細(xì)地說(shuō)明應(yīng)用程序、子系統(tǒng)的外部行為，還要說(shuō)明非功能性需求、設(shè)計(jì)約束，以及其它的相關(guān)因素。][系統(tǒng)是有范圍的，而不是無(wú)限擴(kuò)展的，對(duì)于無(wú)限擴(kuò)展的需求是無(wú)法進(jìn)行描述的。因此，在本小節(jié)應(yīng)該對(duì)該說(shuō)明書(shū)所涉及的項(xiàng)目范圍進(jìn)行清晰的界定。指定該規(guī)格說(shuō)明書(shū)適用的軟件應(yīng)用程序、特性或者其它子系統(tǒng)分組、其相關(guān)的用例模型。當(dāng)然在此也需要列出會(huì)受到該文檔影響的其它文檔。] 定義、首字母縮寫(xiě)詞和縮略語(yǔ)[與其它文檔一樣，該文檔也需要將本文檔中所涉及的所有術(shù)語(yǔ)、縮略語(yǔ)進(jìn)行詳細(xì)的定義。還有一種可簡(jiǎn)明的做法，就是維護(hù)在一個(gè)項(xiàng)目詞匯表中，這樣就可以避免在每個(gè)文檔中都重復(fù)很多內(nèi)容。][在這一小節(jié)中，應(yīng)完整地列出該文檔引用的所有文檔。對(duì)于每個(gè)引用的文檔都應(yīng)該給出標(biāo)題、標(biāo)識(shí)號(hào)、日期以及來(lái)源，為閱讀者查找這些文檔提供足夠詳細(xì)的信息。] 概述[在本小節(jié)中，主要是說(shuō)明軟件需求規(guī)格說(shuō)明書(shū)各個(gè)部分所包含的主要內(nèi)容，就像一個(gè)文章摘要一樣。同時(shí)也應(yīng)該對(duì)文檔的組織方式進(jìn)行解釋。]2. 整體說(shuō)明[在本節(jié)中，將對(duì)整個(gè)軟件需求進(jìn)行總體性的描述，以期讓讀者對(duì)整個(gè)軟件系統(tǒng)的需求有一個(gè)框架性的認(rèn)識(shí)。也就是說(shuō)，該節(jié)中主要包括影響產(chǎn)品及其需求的一般因素，而不列舉 具體的需求。主要包括產(chǎn)品總體效果、產(chǎn)品功能、用戶特征、約束、假設(shè)與依賴關(guān)系、需求子集等方面的內(nèi)容。][在本小節(jié)中，將列出該軟件需求的用例模型，該模型處于系統(tǒng)級(jí)，對(duì)系統(tǒng)的特性進(jìn)行宏觀的描述。在此應(yīng)該列出所有的用例和Actor的名稱列表，并且對(duì)其做出簡(jiǎn)要的說(shuō)明，以及在圖中的各種關(guān)系。] 假設(shè)與依賴關(guān)系[在軟件系統(tǒng)的開(kāi)發(fā)過(guò)程中，存在許多假設(shè)和依賴關(guān)系。在本小節(jié)中應(yīng)列舉出所有的重要的技術(shù)可行性假設(shè)、子系統(tǒng)或構(gòu)件可用性假設(shè)，以及一些可行性的假設(shè)。]3. 具體需求[如果說(shuō)第二章節(jié)是框架，那么本節(jié)就是血肉。在本節(jié)中，應(yīng)該詳細(xì)列出所有的軟件需求，其詳細(xì)程序應(yīng)使設(shè)計(jì)人員能夠充分理解并且進(jìn)行設(shè)計(jì)的要求，同時(shí)也應(yīng)該給予測(cè)試人員足夠的信息，以幫助他們來(lái)驗(yàn)證系統(tǒng)是否滿足了這些需求。整個(gè)需求的組織可以采用用例描述進(jìn)行。][如果你使用用例建模技術(shù)，那么你已經(jīng)通過(guò)用例定義了系統(tǒng)的大部分功能性需求和一些非功能性需求。因此，在軟件需求規(guī)格說(shuō)明書(shū)只需將這些具體的用例描述，整理在一起，全部放在該小節(jié)之中。當(dāng)然也可以將用例描述做為附件，在此列出引用，只是這樣做并不利于閱讀。建議在組織形式上采用以“軟件需求”為線索，在每個(gè)需求中，填入對(duì)應(yīng)的1個(gè)或幾個(gè)用例描述。][由于用例畢竟主要針對(duì)功能性需求，因此還會(huì)有一些其它的補(bǔ)充需求遺漏，因此在本小節(jié)中就是將這些東西補(bǔ)充出來(lái)。這些補(bǔ)充需求大部分集中在非功能需求之上，包括以下幾個(gè)方面的內(nèi)容：]1） 易用性：例如指出普通用戶和高級(jí)用戶要高效地執(zhí)行某個(gè)特定操作所需的培訓(xùn)時(shí)間；指出典型任務(wù)的可評(píng)測(cè)任務(wù)次數(shù)；或者指出需要滿足的可用性標(biāo)準(zhǔn)（如IBM的CUA標(biāo)準(zhǔn)、Microsoft的GUI標(biāo)準(zhǔn)。2） 可靠性：包括系統(tǒng)可用性（可用時(shí)間百分比、使用小時(shí)數(shù)、維護(hù)訪問(wèn)權(quán)、降紙模式操作等）；平均故障間隔時(shí)間（MTBF，通常表示為小時(shí)數(shù)，但也可表示為天數(shù)、月數(shù)或年數(shù)）；平均修復(fù)時(shí)間（MTTR，系統(tǒng)在發(fā)生故障后可以暫停運(yùn)行的時(shí)間）；精確度（指出系統(tǒng)輸出要求具備的精密度、分辨率和精確度）；最高錯(cuò)誤或缺陷率（通常表示為bugs/KLOC，即每千行代碼的錯(cuò)誤數(shù)目或 bugs/functionpoint，即每個(gè)功能點(diǎn)的錯(cuò)誤數(shù)目）；錯(cuò)誤或缺陷率（按照小錯(cuò)誤、大錯(cuò)誤和嚴(yán)重錯(cuò)誤來(lái)分類：需求中必須對(duì)“嚴(yán)重”錯(cuò)誤進(jìn)行界定，例如：數(shù)據(jù)完全丟失或完全不能使用系統(tǒng)的某部分功能）。3） 性能：包括對(duì)事務(wù)的響應(yīng)時(shí)間（平均、最長(zhǎng)）；吞吐量（例如每秒處理的事務(wù)數(shù)）；容量（例如系統(tǒng)可以容納的客戶或事務(wù)數(shù)）；降級(jí)模式（當(dāng)系統(tǒng)以某種形式降級(jí)時(shí)可接受的運(yùn)行模式）；資源利用情況：內(nèi)存、磁盤(pán)、通信等。4） 其它：包括用戶界面要求、聯(lián)機(jī)幫助系統(tǒng)要求、法律許可、外購(gòu)構(gòu)件，以及操作系統(tǒng)、開(kāi)發(fā)工具、數(shù)據(jù)庫(kù)系統(tǒng)等設(shè)計(jì)約束。[支持信息用于使軟件需求規(guī)格說(shuō)明書(shū)更易于使用。它包括：目錄、索引、附錄等。]計(jì)算機(jī)軟件需求說(shuō)明編制指南編者說(shuō)明： 軟件需求規(guī)格說(shuō)明是十分重要的文檔，因此為開(kāi)發(fā)團(tuán)隊(duì)提供一份詳細(xì)的編制指南是十分有意義和必要的。本文檔就是一個(gè)編制指南的例子，你可以根據(jù)該指南，結(jié)合自己的實(shí)際情況進(jìn)行修改。1．引言 目的和作用 本指南為軟件需求實(shí)踐提供了一個(gè)規(guī)范化的方法。本指南不提倡把軟件需求說(shuō)明（Software Requirements Specifications，以下簡(jiǎn)稱SRS）劃分成等級(jí)，避免把它定義成更小的需求子集。 本指南適用對(duì)象： 1）軟件客戶（Customers），以便精確地描述他們想獲得什么樣的產(chǎn)品。 2）軟件開(kāi)發(fā)者（Suppliers），以便準(zhǔn)確地理解客戶需要什么樣的產(chǎn)品。 對(duì)于任一要實(shí)現(xiàn)下列目標(biāo)的單位和（或）個(gè)人： 1）要提出開(kāi)發(fā)規(guī)范化的SRS提綱； 2）定義自己需要的具體的格式和內(nèi)容； 3）產(chǎn)生附加的局部使用條款，如SRS質(zhì)量檢查清單或者SRS作者手冊(cè)等。 SRS將完成下列目標(biāo)： 1） 在軟件產(chǎn)品完成目標(biāo)方面為客戶和開(kāi)發(fā)者之間建立共同協(xié)議創(chuàng)立一個(gè)基礎(chǔ)。對(duì)要實(shí)現(xiàn)的軟件功能做全面描述，幫助客戶判斷所規(guī)定的軟件是否符合他們的要求，或者怎樣修改這種軟件才能適合他們的要求； 2） 提高開(kāi)發(fā)效率。編制SRS的過(guò)程將使客戶在設(shè)計(jì)開(kāi)始之前周密地思考全部需求，從而減少事后重新設(shè)計(jì)、重新編碼和重新測(cè)試的返工活動(dòng)。在SRS中對(duì)各種需求仔細(xì)地進(jìn)行復(fù)查，還可以在開(kāi)發(fā)早期發(fā)現(xiàn)若干遺漏、錯(cuò)誤的理解和不一致性，以便及時(shí)加以糾正； 3） 為成本計(jì)價(jià)和編制計(jì)劃進(jìn)度提供基礎(chǔ)。SRS提供的對(duì)被開(kāi)發(fā)軟件產(chǎn)品的描述，是計(jì)算機(jī)軟件產(chǎn)品成本核算的基礎(chǔ)，并且可以為各方的要價(jià)和付費(fèi)提供依據(jù)。SRS對(duì)軟件的清晰描述，有助于估計(jì)所必須的資源，并用作編制進(jìn)度的依據(jù)； 4） 為確認(rèn)和驗(yàn)證提供一個(gè)基準(zhǔn)。任何組織將更有效地編制他們的確認(rèn)和驗(yàn)證計(jì)劃。作為開(kāi)發(fā)合同的一部分，SRS還可以提供一個(gè)可以度量和遵循的基準(zhǔn)（然而，反之則不成立，即任一有關(guān)軟件的合同都不能作為SRS。因?yàn)檫@種文件幾乎不包括詳盡的需求說(shuō)明，并且通常不完全的）； 5） 便于移植。有了SRS就便于移值軟件產(chǎn)品，以適應(yīng)新的用戶或新的機(jī)種?？蛻粢惨子谝浦财滠浖狡渌块T(mén)，而開(kāi)發(fā)者同樣也易于把軟件移植到新的客戶； 6） 作為不斷提高的基礎(chǔ)。由于SRS所討論的是軟件產(chǎn)品，而不是開(kāi)發(fā)這個(gè)產(chǎn)品的設(shè)計(jì)。因此SRS是軟件產(chǎn)品繼續(xù)提高的基礎(chǔ)。雖然SRS也可能要改變，但是原來(lái)的SRS還是軟件產(chǎn)品改進(jìn)的可靠基礎(chǔ)。 范圍 本指南適用于編寫(xiě)軟件需求規(guī)格說(shuō)明，它描述了一個(gè)SRS所必須的內(nèi)容和質(zhì)量，并且在第6章中提供了SRS大綱。 2．引用標(biāo)準(zhǔn) GB 8566 計(jì)算機(jī)軟件開(kāi)發(fā)規(guī)范 GB 8567 計(jì)算機(jī)軟件產(chǎn)品開(kāi)發(fā)文件編制指南 GB/T 11457 軟件工程術(shù)語(yǔ) 3．定義 GB/T 11457所列術(shù)語(yǔ)和下列定義適用于本指南。 合同（contract）：是由客戶和開(kāi)發(fā)者共同簽署的具有法律約束力的文件。其中包括產(chǎn)品的技術(shù)、組織、成本和進(jìn)度計(jì)劃要求等內(nèi)容。 客戶（customer）：指?jìng)€(gè)人或單位，他們?yōu)楫a(chǎn)品開(kāi)發(fā)提供資金，通常（但有時(shí)也不必）還提出各種需求。文件中的客戶和開(kāi)發(fā)者也可能是同一個(gè)組織的成員。 語(yǔ)言（language）：是具有語(yǔ)法和語(yǔ)義的通信工具，包括一組表達(dá)式、慣例和傳遞信息的有關(guān)規(guī)則。 分割（partitioning）：把一個(gè)整體分成若干部分。 開(kāi)發(fā)者（supplier）：指為客戶生產(chǎn)某種軟件產(chǎn)品的個(gè)人或集團(tuán)。在本指南中，客戶和開(kāi)發(fā)者可能是同一個(gè)組織的成員。 用戶（user）：指運(yùn)行系統(tǒng)或者直接與系統(tǒng)發(fā)生交互作用的個(gè)人或集團(tuán)。用戶和客戶通常不是同一些人。 4．編寫(xiě)SRS的背景信息 SRS的基本要求 SRS是對(duì)要完成一定功能、性能的軟件產(chǎn)品、程序或一組程序的說(shuō)明。對(duì)SRS的描述有兩項(xiàng)基本要求： 1）必須描述一定的功能、性能； 2）必須用確定的方法敘述這些功能、性能。 SRS的環(huán)境 必須認(rèn)識(shí)到SRS在整個(gè)軟件開(kāi)