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