1、目錄范圍錯誤!未定義書簽?？傮w要求 錯誤!未定義書簽。總體功能要求 錯誤!未定義書簽。軟件開發(fā)平臺要求錯誤!未定義書簽。軟件項目的開發(fā)實施過程管理要求 錯誤!未定義書簽。軟件項目實施過程總體要求錯誤!未定義書簽。軟件項目實施變更要求錯誤!未定義書簽。軟件項目實施里程碑控制 錯誤!未定義書簽。軟件開發(fā)錯誤!未定義書簽。軟件的需求分析錯誤!未定義書簽。需求分析 錯誤!未定義書簽。需求分析報告的編制者錯誤!未定義書簽。需求報告評審錯誤!未定義書簽。需求報告格式 錯誤!未定義書簽。軟件的概要設(shè)計錯誤!未定義書簽。概要設(shè)計 錯誤!未定義書簽。編寫概要設(shè)計的要求錯誤!未定義書簽。概要設(shè)計報告的編寫者錯誤!

2、未定義書簽。概要設(shè)計和需求分析、詳細(xì)設(shè)計之間的關(guān)系和區(qū)別錯誤!未定義書簽。概要設(shè)計的評審 錯誤!未定義書簽。概要設(shè)計格式 錯誤!未定義書簽。軟件的詳細(xì)設(shè)計 錯誤!未定義書簽。詳細(xì)設(shè)計 錯誤!未定義書簽。特例錯誤!未定義書簽。詳細(xì)設(shè)計的要求 錯誤!未定義書簽。數(shù)據(jù)庫設(shè)計錯誤!未定義書簽。詳細(xì)設(shè)計的評審 錯誤!未定義書簽。詳細(xì)設(shè)計格式 錯誤!未定義書簽。軟件的編碼錯誤!未定義書簽。軟件編碼 錯誤!未定義書簽。軟件編碼的要求 錯誤!未定義書簽。編碼的評審 錯誤!未定義書簽。編程規(guī)范及要求錯誤!未定義書簽。軟件的測試錯誤!未定義書簽。軟件測試 錯誤!未定義書簽。測試計劃 錯誤!未定義書簽。軟件的交付準(zhǔn)

3、備錯誤!未定義書簽。交付清單 錯誤!未定義書簽。軟件的鑒定驗收錯誤!未定義書簽。軟件的鑒定驗收錯誤!未定義書簽。驗收人員 錯誤!未定義書簽。驗收具體內(nèi)容 錯誤!未定義書簽。軟件驗收測試大綱錯誤!未定義書簽。培訓(xùn)錯誤!未定義書簽。系統(tǒng)應(yīng)用培訓(xùn) 錯誤!未定義書簽。系統(tǒng)管理的培訓(xùn)（可選）錯誤!未定義書簽。附錄A軟件需求分析報告文檔模板9附錄B軟件概要設(shè)計報告文檔模板21附錄C軟件詳細(xì)設(shè)計報告文檔模板33附錄D軟件數(shù)據(jù)庫設(shè)計報告文檔模板43附錄E軟件測試（驗收）大綱錯誤!未定義書簽。5范圍本指南用于指導(dǎo)軟件開發(fā)者為南京市交通局開發(fā)軟件項目的過程，通過規(guī)范軟件項目承擔(dān)單位的 開發(fā)過程達(dá)到提高軟件質(zhì)量，降

4、低維護(hù)成本的目的。開發(fā)者應(yīng)根據(jù)本指南進(jìn)行軟件開發(fā)和編制軟 件開發(fā)文檔。本指南是對軟件項目承擔(dān)單位的基本要求。在本指南的附錄A至E中提供了文檔 的編寫模板供開發(fā)者參考，在進(jìn)行具體軟件開發(fā)時，開發(fā)者可根據(jù)實際情況采編寫，但必須提供 雙方約定的文檔，文檔中約定的內(nèi)容必須描述清楚?？傮w要求總體功能要求網(wǎng)絡(luò)應(yīng)用環(huán)境以Internet/Intranet技術(shù)為核心。開發(fā)者應(yīng)在充分分析需求的基礎(chǔ)上，選擇采用B/S結(jié)構(gòu)或者C/S結(jié)構(gòu)。軟件系統(tǒng)的數(shù)據(jù)庫應(yīng)依照南京市交通局信息化數(shù)據(jù)庫建設(shè)規(guī)范進(jìn)行設(shè)計和建設(shè)。本指南中沒有規(guī)定開發(fā)者采用何種具體的軟件工程開發(fā)方法，開發(fā)者可根據(jù)項目具體特點、自身 擅長來選擇采用面向過程的

5、方法、面向?qū)ο蟮姆椒ɑ蛎嫦驍?shù)據(jù)的方法，但建議開發(fā)商使用面向?qū)ο筌浖こ痰姆椒?，如：采用目前被廣泛使用的RUP(Rational Unified Process)方法來進(jìn)行 分析、設(shè)計和開發(fā)。軟件開發(fā)平臺要求開發(fā)者開發(fā)的軟件必須能夠在南京市交通局規(guī)定的軟件平臺上正常運(yùn)行。目前軟件平臺為：數(shù)據(jù)庫管理系統(tǒng)：Oracle 9i以上版本中間件(應(yīng)用服務(wù)器)系統(tǒng)：舊M WebSphereOA系統(tǒng)：Lotus Domino/Notes網(wǎng)絡(luò)架構(gòu)：完全支持TCP/IP協(xié)議開發(fā)工具或技術(shù)體系：為保證軟件的上下兼容性，開發(fā)者應(yīng)選擇比較通用的開發(fā)工具的較新版本進(jìn)行開發(fā)，如MicrosoftVisual ， Borla

6、nd Delphi， C+ Builder,或 J2EE(Java2 P1atform Enterprise Edition)等。軟件項目的開發(fā)實施過程管理要求軟件項目實施過程總體要求開發(fā)者提交軟件開發(fā)工作大綱，交通局組織專家組對工作大綱進(jìn)行評審，并提出整改意見。 通過評審后，開發(fā)者根據(jù)整改意見完善工作大綱，經(jīng)過交通局認(rèn)可后組織項目組進(jìn)行軟件開發(fā)。 軟件開發(fā)工作按照需求分析、概要設(shè)計、詳細(xì)設(shè)計、編碼、測試等幾個階段進(jìn)行，在開發(fā)過程中， 開發(fā)者需分階段提交相關(guān)文檔。在軟件開發(fā)工作完成后，開發(fā)者應(yīng)向交通局提交完整的軟件文檔，交通局組織驗收組對軟件進(jìn)行 驗收審查。軟件項目實施變更要求在開發(fā)過程中，需

7、求或設(shè)計不可避免地需要發(fā)生變更，相關(guān)變更必須經(jīng)過交通局書面同意方可進(jìn)行。在需求或設(shè)計發(fā)生變更時，需要對原有文檔進(jìn)行修改，并提供完整的變更記錄，以使變更處于可控制的狀態(tài)。變更單如下表所示： 表2-1變更單需求變更申請申請變更的需求文檔輸入名稱，版本，日期等信息變更的內(nèi)客及其理由評估需求變更將對 項目造成的影響申請人簽字變更申請的審批意見項目經(jīng)理簽字審批意見：簽字 日期客戶簽字（合同項目）審批意見：簽字 日期更改需求文檔變更后的需求文檔輸入名稱，版本，完成日期等信息更改人簽字重新評申需求文檔需求評審小組簽字評審意見：簽字 日期變更結(jié)束項目經(jīng)理簽字簽字 日期軟件項目實施里程碑控制交通局將分四個階段進(jìn)

8、行把關(guān)，召開專家審查會。需求分析（結(jié)合原型進(jìn)行審查）確認(rèn)；概要設(shè)計+數(shù)據(jù)庫設(shè)計；預(yù)驗收（試運(yùn)行后）；正式驗收（推廣使用后）。軟件開發(fā)合同簽訂以后，項目承擔(dān)單位即可組織項目組進(jìn)行軟件開發(fā)工作。軟件開發(fā)必須嚴(yán)格按照軟件工 程的要求進(jìn)行。開發(fā)過程包括開發(fā)者的活動和任務(wù)。此過程由軟件需求分析、概要設(shè)計、詳細(xì)設(shè) 計、編碼、測試、驗收、鑒定等活動組成。軟件的需求分析需求分析首先，開發(fā)者和交通局應(yīng)共同對交通局的應(yīng)用需求作充分的調(diào)研，提交完整的需求分析 報告。 在需求分析報告中必須描述的基本問題是：功能、性能、強(qiáng)加于實現(xiàn)的設(shè)計限制、屬 性、外部 接口。應(yīng)當(dāng)避免把設(shè)計或項目需求寫入需求分析報告中。它必須說明由軟

9、件獲得的 結(jié)果，而 不是獲得這些結(jié)果的手段。軟件需求可以用若干種方法來表達(dá)，如通過輸入、輸出說明；使用代表性的例子；用規(guī)范化的模 型。開發(fā)者應(yīng)盡可能地使用模型的方式，因為這是表達(dá)復(fù)雜需求的精確和有效的方法。比如用統(tǒng) 一建模語言（UML）來描述需求。編寫需求分析報告的要求無歧義性對最終產(chǎn)品的每一個特性用某一術(shù)語描述；若某一術(shù)語在某一特殊的行文中使用時具有多種含 義，那么應(yīng)對該術(shù)語的每種含義做出解釋并指出其適用場合。完整性需求分析報告應(yīng)該包括全部有意義的需求，無論是關(guān)系到功能的、性能的、設(shè)計約束的、還是關(guān) 系到外部接口方面的需求；對所有可能出現(xiàn)的輸入數(shù)據(jù)的響應(yīng)予以定義，要對合法和非合法的輸 入值的

10、響應(yīng)做出規(guī)定；填寫全部插圖、表、圖示標(biāo)記等；定義全部術(shù)語和度量單位?？沈炞C性需求分析報告描述的每一個需求應(yīng)是可以驗證的。可以通過一個有限處理過程來檢查軟件產(chǎn)品是 否滿足需求。一致性在需求分析報告中的各個需求的描述不能互相矛盾。e .可修改性需求分析報告應(yīng)具有一個有條不紊、易于使用的內(nèi)容組織；沒有冗余，即同一需求不能在需求分 析報告中出現(xiàn)多次。可追蹤性每一個需求的源流必須清晰，在進(jìn)一步產(chǎn)生和改變文件編制時，可以方便地引證每一個需求。運(yùn)行和維護(hù)階段的可使用性需求分析報告必須滿足運(yùn)行和維護(hù)階段的需要。在需求分析報告要寫明功能的來源和目的。需求分析報告的編制者需求分析報告應(yīng)由交通局和開發(fā)者雙方共同完成

11、。其中：交通局負(fù)責(zé)根據(jù)實際需要提出希望軟件 實現(xiàn)的功能；軟件開發(fā)者根據(jù)交通局提出的性能需求，結(jié)合軟件開發(fā)編寫需求分析。需求報告評審在軟件需求分析工作完成后，軟件開發(fā)者應(yīng)向交通局提交軟件需求分析報告。交通局組織有 關(guān)人員對需求進(jìn)行評審，以決定軟件需求是否完善和恰當(dāng)。評審?fù)瓿珊?，就可以進(jìn)入軟件的設(shè)計 階段。需求報告格式軟件需求分析報告需按一定的格式進(jìn)行編寫，具體的軟件需求分析報告文檔編寫模板請 見附錄A。軟件的概要設(shè)計概要設(shè)計在交通局和開發(fā)者雙方認(rèn)可的需求分析報告基礎(chǔ)上，開發(fā)者進(jìn)行下一一步的工作。首先，開發(fā)者需要對軟件系統(tǒng)進(jìn)行概要設(shè)計，即系統(tǒng)設(shè)計。概要設(shè)計需要對軟件系統(tǒng)的設(shè)計 進(jìn) 行考慮，包括系統(tǒng)

12、的基本處理流程、系統(tǒng)的組織結(jié)構(gòu)、模塊劃分、功能分配、接口設(shè)計、 運(yùn) 行設(shè)計、數(shù)據(jù)結(jié)構(gòu)設(shè)計和出錯處理設(shè)計等，為軟件的詳細(xì)設(shè)計提供基礎(chǔ)。編寫概要設(shè)計的要求一致性概要設(shè)計的要求應(yīng)該與需求分析報告所描述的需求一致。同時，概要設(shè)計的各項要求之間也應(yīng)該 一致。合理性概要設(shè)計所提出的設(shè)計方法和標(biāo)準(zhǔn)應(yīng)該是合理的、恰當(dāng)?shù)??？勺粉櫺詫Ω乓O(shè)計所提出的各項要求應(yīng)該可以得到它的清晰的源流，即在需求分析報告客戶有明確的需 求描述?？尚行愿鶕?jù)概要設(shè)計進(jìn)行詳細(xì)設(shè)計、操作和維護(hù)應(yīng)該是可行的。概要設(shè)計報告的編寫者概要設(shè)計報告由開發(fā)者根據(jù)需求分析報告的要求進(jìn)行編寫。 概要設(shè)計和需求分析、詳細(xì)設(shè)計之間的關(guān)系和區(qū)別需求分析不涉及具體

13、的技術(shù)實現(xiàn)，而概要設(shè)計注重于從宏觀上和框架上來描述采用何種技術(shù)手 段、方法來實現(xiàn)這些需求。詳細(xì)設(shè)計相對概要設(shè)計更注重于微觀上和框架內(nèi)的設(shè)計，是編碼的依據(jù)。概要設(shè)計是指導(dǎo)詳細(xì)設(shè)計的依據(jù)。 概要設(shè)計的評審 在軟件概要設(shè)計工作完成后，軟件開發(fā)者應(yīng)向交通提交軟件系統(tǒng)概要設(shè)計報告。在交通局對 概要設(shè)計報告評審?fù)ㄟ^后，即可進(jìn)入詳細(xì)設(shè)計階段。概要設(shè)計格式軟件系統(tǒng)概要設(shè)計報告需按一定的格式進(jìn)行編寫，具體的軟件系統(tǒng)概要設(shè)計報告文檔編寫模板請見附錄B。 軟件的詳細(xì)設(shè)計 詳細(xì)設(shè)計 在概要設(shè)計的基礎(chǔ)上，開發(fā)者需要進(jìn)行軟件系統(tǒng)的詳細(xì)設(shè)計。在詳細(xì)設(shè)計中，描述實現(xiàn)具體模塊所涉及到的主要算法、數(shù)據(jù)結(jié)構(gòu)、類的層次結(jié)構(gòu)及調(diào)用關(guān)系

14、，需要說明軟件系統(tǒng)各個層次 中的每一個程序（每個模塊或子程序）的設(shè)計考慮，以便進(jìn)行編碼和測試。應(yīng)當(dāng)保證軟件的需求完全分配給整個軟件。詳細(xì)設(shè)計應(yīng)當(dāng)足夠詳細(xì)，能夠根據(jù)詳細(xì)設(shè)計報告進(jìn)行編碼。 特例 如果軟件系統(tǒng)比較簡單，層次較少，可以不必進(jìn)行專門的詳細(xì)設(shè)計，而和概要設(shè)計結(jié)合起來。 詳細(xì)設(shè)計的要求一致性詳細(xì)設(shè)計的要求應(yīng)該與需求分析報告所描述的需求、與概要設(shè)計一致。同時，詳細(xì)設(shè)計的各項要 求之間也應(yīng)該是一致的。合理性詳細(xì)設(shè)計所提出的設(shè)計方法和標(biāo)準(zhǔn)應(yīng)該是合理的、恰當(dāng)?shù)??？勺粉櫺詫υ敿?xì)設(shè)計所提出的各項要求應(yīng)該可以得到它的清晰的源流，即可在需求分析報告、概要設(shè)計報 告中有明確的需求描述。可行性根據(jù)詳細(xì)設(shè)計進(jìn)行

15、編碼、測試、操作和維護(hù)應(yīng)該是可行的。 數(shù)據(jù)庫設(shè)計 如果軟件產(chǎn)品需要使用到數(shù)據(jù)庫，軟件的詳細(xì)設(shè)計應(yīng)包括對數(shù)據(jù)庫的設(shè)計。數(shù)據(jù)庫設(shè)計應(yīng)在軟件 的需求分析、概要設(shè)計完成之后、詳細(xì)設(shè)計的其它工作之前進(jìn)行。在進(jìn)行數(shù)據(jù)庫設(shè)計時，應(yīng)當(dāng)按 照交通局制定的南京市交通局信息化數(shù)據(jù)庫建設(shè)規(guī)范要求進(jìn)行。 詳細(xì)設(shè)計的評審 在軟件詳細(xì)設(shè)計完成后，軟件開發(fā)者應(yīng)向交通局提交軟件系統(tǒng)數(shù)據(jù)庫設(shè)計報告和軟件系統(tǒng) 詳細(xì)設(shè)計報告。在交通局對軟件系統(tǒng)數(shù)據(jù)庫設(shè)計報告、軟件系統(tǒng)詳細(xì)設(shè)計報告評審?fù)?過后，即可進(jìn)入軟件編碼階段。 詳細(xì)設(shè)計格式軟件系統(tǒng)詳細(xì)設(shè)計報告、軟件系統(tǒng)數(shù)據(jù)庫設(shè)計報告需按一定的格式進(jìn)行編寫，具體的軟件系統(tǒng)詳細(xì)設(shè)計報告文檔編寫模板

16、和軟件系統(tǒng)數(shù)據(jù)庫設(shè)計報告文檔編寫模板請見附錄C、附錄D。 軟件的編碼軟件編碼在軟件編碼階段，開發(fā)者根據(jù)軟件系統(tǒng)詳細(xì)設(shè)計報告中對數(shù)據(jù)結(jié)構(gòu)、算法分析和模塊實現(xiàn)等 方面的設(shè)計要求，開始具體的編寫程序工作，分別實現(xiàn)各模塊的功能，從而實現(xiàn)對目標(biāo)系統(tǒng)的功 能、性能、接口、界面等方面的要求。軟件編碼的要求模塊化編碼代碼可讀性可維護(hù)性d 模塊接口標(biāo)準(zhǔn)化界面風(fēng)格統(tǒng)一注釋的應(yīng)用編碼的評審為了盡早發(fā)現(xiàn)軟件中的障礙，提高軟件產(chǎn)品的質(zhì)量，開發(fā)者在編碼的過程中應(yīng)該強(qiáng)調(diào)代碼評審工 作。將代碼評審報告作為文檔的一部分，提交給交通局。編程規(guī)范及要求為了提高編程實現(xiàn)的質(zhì)量，軟件的程序設(shè)計必須遵照國家頒布的相關(guān)編程規(guī)范。主要內(nèi)容包

17、括：規(guī)范化的程序內(nèi)部文檔、數(shù)據(jù)結(jié)構(gòu)的詳細(xì)說明、清晰的語句結(jié)構(gòu)、編碼規(guī)范。編 碼規(guī)范的內(nèi)容包括命名規(guī)范、界面規(guī)范、提示及幫助信息規(guī)范、熱鍵定義等。其中數(shù)據(jù)庫部分應(yīng)遵守南京市交通局信息化數(shù)據(jù)庫建設(shè)規(guī)范的要求。在軟件編碼的同時應(yīng)進(jìn)行單元測試。軟件的測試軟件測試為了盡早發(fā)現(xiàn)軟件產(chǎn)品中的錯誤，從而達(dá)到提高軟件質(zhì)量、降低軟件維護(hù)的費用，開發(fā)者應(yīng)在編 碼過程中對各個模塊的程序代碼進(jìn)行單元測試，系統(tǒng)集成時進(jìn)行集成測試，系統(tǒng)集成完成后對整 個軟件進(jìn)行系統(tǒng)測試。單元測試是在軟件開發(fā)過程中針對程序模塊進(jìn)行正確性檢驗。集成測試是 在單元測試的基礎(chǔ)上，將所有模塊按照設(shè)計要求組裝成系統(tǒng)或子系統(tǒng)，對模塊組裝過程和模塊接 口

18、進(jìn)行正確性檢驗。軟件系統(tǒng)測試不僅是檢測軟件的整體行為表 現(xiàn)，從另一個側(cè)面看，也 是對軟件開發(fā)設(shè)計的再確認(rèn)。進(jìn)行軟件系統(tǒng)測試工作時。測試主要包括界面測試、可用性測試、 功能測試、穩(wěn)定性（強(qiáng)度）測試、性能測試、強(qiáng)壯性（恢復(fù)）測試、邏輯性測試、破壞性測試、安全 性測試等。開發(fā)者針對單元測試，集成測試，系統(tǒng)測試分別制定測試計劃。集成測試需要根據(jù)需求分析 報告和概要設(shè)計制作測試用例，并須經(jīng)過評審。軟件測試按照測試計劃、需求分析報告 的要求進(jìn)行，最后形成軟件測試報告。測試計劃在軟件編碼開始之前，開發(fā)者應(yīng)向交通局提交測試計劃，在軟件交付時，開發(fā)者應(yīng)向交通局 提交軟件測試報告，以確保開發(fā)者的軟件得到了充分的測

19、試。開發(fā)的軟件必須經(jīng)過充分的測 試證明其符合設(shè)計要求、運(yùn)行穩(wěn)定、安全可用方可交付交通局。軟件的交付準(zhǔn)備交付清單在軟件測試證明軟件達(dá)到要求后，軟件開發(fā)者應(yīng)向交通局提交開發(fā)的目標(biāo)安裝程序、數(shù)據(jù)庫的數(shù) 據(jù)字典、用戶安裝手冊、用戶使用指南、需求報告、設(shè)計報告、測試報告等雙方合同約 定的產(chǎn)物。用戶安裝手冊應(yīng)詳細(xì)介紹安裝軟件對運(yùn)行環(huán)境的要求、安裝軟件的定義和內(nèi)容、在客戶端、 服務(wù)器端及中間件的具體安裝步驟、安裝后的系統(tǒng)配置。用戶使用指南應(yīng)包括軟件各項功能的使用流程、操作步驟、相應(yīng)業(yè)務(wù)介紹、特殊提示和注意 事項等方面的內(nèi)容，在需要時還應(yīng)舉例說明。軟件的鑒定驗收軟件的鑒定驗收在軟件開發(fā)完成后，為了確保軟件是按

20、照需求分析的要求進(jìn)行開發(fā)的，保證軟件產(chǎn)品的質(zhì)量，需 要對軟件產(chǎn)品進(jìn)行鑒定驗收。在開發(fā)者如期交付軟件后，由交通局負(fù)責(zé)確定具體的鑒定驗收日期。 驗收人員由交通局聘請具有一定的分析、設(shè)計、編程和軟件測試經(jīng)驗的驗收組長和其他專業(yè)人員組成。驗 收組設(shè)組長一名(可設(shè)有副組長)，負(fù)責(zé)整個驗收的計劃、組織工作。驗收具體內(nèi)容驗收內(nèi)容應(yīng)該包括：合法性檢查、文檔檢查、軟件一致性檢查、軟件系統(tǒng)測試與測試結(jié)果評審等 幾項工作。合法性檢查檢查軟件開發(fā)工具是否合法、使用的函數(shù)庫、控件、組件是否有合法的發(fā)布許可。文檔檢查檢查開發(fā)者提交的文檔必須齊全，質(zhì)量是否過關(guān)。需要開發(fā)者提供的文檔包括：項目實施計劃；詳細(xì)技術(shù)方案；軟件需求

21、規(guī)格說明書(STP)(含數(shù)據(jù)字典)；概要設(shè)計說明書(PDD)；詳細(xì)設(shè)計說明書(DDD)(含數(shù)據(jù)庫設(shè)計說明書)；軟件測試計劃(STP)(含測試用例)；軟件測試報告(STR)；用戶手冊(SUM)(含操作、使用、維護(hù)、應(yīng)急處理手冊)；源程序(SCL)(不可修改的電子文檔)；項目實施計劃(PIP)；項目開發(fā)總結(jié)(PDS)；軟件質(zhì)量保證計劃(SQAP)；此外，驗收組可以根據(jù)需要對其它文檔(如軟件配置計劃、項目進(jìn)展報表、階段評審報表等)進(jìn)行檢查。文檔的質(zhì)量根據(jù)完備性、正確性、簡明性、可追蹤性、自說明性、規(guī)范件等方面進(jìn)行蹤合評定。 驗收需要對軟件代碼進(jìn)行檢查，以確保其符合規(guī)范，并檢查其一致性。軟件驗收測試大

22、綱在軟件進(jìn)行鑒定驗收前，開發(fā)者需按照一定的格式編寫軟件驗收測試大綱，具體的格式請見 附錄E。培訓(xùn)系統(tǒng)應(yīng)用培訓(xùn)主要培訓(xùn)內(nèi)容包括：系統(tǒng)操作使用、業(yè)務(wù)管理流程。培訓(xùn)對象：應(yīng)用操作人員。系統(tǒng)管理的培訓(xùn)(可選)主要培訓(xùn)內(nèi)容包括：系統(tǒng)安裝、調(diào)試、維護(hù)；系統(tǒng)管理。培訓(xùn)對象：系統(tǒng)管理人員。開發(fā)者應(yīng)詳細(xì)列出培訓(xùn)計劃，包括培訓(xùn)內(nèi)容、教材、時間和人員等。附錄A軟件需求分析報告文檔模板引言錯誤!未定義書簽。編寫目的 錯誤!未定義書簽。項目風(fēng)險 錯誤!未定義書簽。文檔約定 錯誤!未定義書簽。預(yù)期讀者和閱讀建議錯誤!未定義書簽。產(chǎn)品范圍 錯誤!未定義書簽。參考文獻(xiàn) 錯誤!未定義書簽。綜合描述錯誤!未定義書簽。產(chǎn)品的狀況

23、錯誤!未定義書簽。產(chǎn)品的功能錯誤!未定義書簽。用戶類和特性 錯誤!未定義書簽。運(yùn)行環(huán)境 錯誤!未定義書簽。設(shè)計和實現(xiàn)上的限制錯誤!未定義書簽。假設(shè)和約束（依賴）錯誤!未定義書簽。3.外部接口需求 錯誤!未定義書簽。用戶界面 錯誤!未定義書簽。硬件接口 錯誤!未定義書簽。軟件接口 錯誤!未定義書簽。通訊接口 錯誤!未定義書簽。4.系統(tǒng)功能需求 說明和優(yōu)先級 激勵/響應(yīng)序列 輸入/輸出數(shù)據(jù)錯誤!未定義書簽。錯誤!未定義書簽。錯誤!未定義書簽。錯誤!未定義書簽。5.其它非功能需求錯誤!未定義書簽。性能需求 錯誤!未定義書簽。安全措施需求 錯誤!未定義書簽。安全性需求錯誤!未定義書簽。軟件質(zhì)量屬性 錯

24、誤!未定義書簽。業(yè)務(wù)規(guī)則 錯誤!未定義書簽。用戶文檔 錯誤!未定義書簽。詞匯表錯誤!未定義書簽。數(shù)據(jù)定義錯誤!未定義書簽。分析模型錯誤!未定義書簽。待定問題列表錯誤!未定義書簽。引言引言是對這份軟件產(chǎn)品需求分析報告的概覽，是為了幫助閱讀者了解這份文檔是如何編寫的，并 且應(yīng)該如何閱讀、理解和解釋這份文檔。編寫目的說明這份軟件產(chǎn)品需求分析報告是為哪個軟件產(chǎn)品編寫的，開發(fā)這個軟件產(chǎn)品意義、作用、以及 最終要達(dá)到的意圖。通過這份軟件產(chǎn)品需求分析報告詳盡說明了該軟件產(chǎn)品的需求規(guī)格，包括修 正和（或）發(fā)行版本號，從而對該軟件產(chǎn)品進(jìn)行準(zhǔn)確的定義。如果這份軟件產(chǎn)品需求分析報告只與整個系統(tǒng)的某一部分有關(guān)系，那么

25、只定義軟件產(chǎn)品需求分析 報告中說明的那個部分或子系統(tǒng)。項目風(fēng)險具體說明本軟件開發(fā)項目的全部風(fēng)險承擔(dān)者，以及各自在本階段所需要承擔(dān)的主要風(fēng)險，首要風(fēng) 險承擔(dān)者包括：任務(wù)提出者；軟件開發(fā)者；產(chǎn)品使用者。文檔約定描述編寫文檔時所采用的標(biāo)準(zhǔn)（如果有標(biāo)準(zhǔn)的話），或者各種排版約定。排版約定應(yīng)該包括：正文風(fēng)格；提示方式；重要符號；也應(yīng)該說明高層次需求是否可以被其所有細(xì)化的需求所繼承，或者每個需求陳述是否都有其自己 的優(yōu)先級。預(yù)期讀者和閱讀建議列舉本軟件產(chǎn)品需求分析報告所針對的各種不同的預(yù)期讀者，例如，可能包括：用戶；開發(fā)人員；項目經(jīng)理；營銷人員；測試人員；文檔編寫入員。并且描述了文檔中，其余部分的內(nèi)容及其組

26、織結(jié)構(gòu)，并且針對每一類讀者提出最適合的文檔閱讀建議。產(chǎn)品范圍說明該軟件產(chǎn)品及其開發(fā)目的的簡短描述，包括利益和目標(biāo)。把軟件產(chǎn)品開發(fā)與企業(yè)目標(biāo)，或者 業(yè)務(wù)策略相聯(lián)系。描述產(chǎn)品范圍時需注意，可以參考項目視圖和范圍文檔，但是不能將其內(nèi)容復(fù)制到這里。參考文獻(xiàn)列舉編寫軟件產(chǎn)品需求分析報告時所用到的參考文獻(xiàn)及資料，可能包括：本項目的合同書；上級機(jī)關(guān)有關(guān)本項目的批文；本項目已經(jīng)批準(zhǔn)的計劃任務(wù)書；用戶界面風(fēng)格指導(dǎo)；開發(fā)本項目時所要用到的標(biāo)淮；系統(tǒng)規(guī)格需求說明；使用實例文檔；屬于本項目的其它己發(fā)表文件；本軟件產(chǎn)品需求分析報告中所引用的文件、資料；相關(guān)軟件產(chǎn)品需求分析報告；為了方便讀者查閱，所有參考資料應(yīng)該按一定順

27、序排列。如果可能，每份資料都應(yīng)該給出：標(biāo)題名稱；作者或者合同簽約者；文件編號或者版本號；發(fā)表日期或者簽約日期；出版單位或者資料來源。綜合描述這一部分概述了正在定義的軟件產(chǎn)品的作用范圍以及該軟件產(chǎn)品所運(yùn)行的環(huán)境、使用該軟件產(chǎn)品 的用戶、對該軟件產(chǎn)品己知的限制、有關(guān)該軟件產(chǎn)品的假設(shè)和依賴。產(chǎn)品的狀況描述了在軟件產(chǎn)品需求分析報告中所定義的軟件產(chǎn)品的背景和起源。說明了該軟件產(chǎn)品是否屬于 下列情況：是否是產(chǎn)品系列中的下一成員；是否是成熟產(chǎn)品所改進(jìn)的下一代產(chǎn)品；是否是現(xiàn)有應(yīng)用軟件的替代品（升級產(chǎn)品）；是否是一個新型的、自主型的產(chǎn)品。如果該軟件產(chǎn)品需求分析報告定義的軟件系統(tǒng)是：大系統(tǒng)的一個組成部分；與其它系

28、統(tǒng)和其它機(jī)構(gòu)之間存在基本的相互關(guān)系。那么必須說明軟件產(chǎn)品需求分析報告定義的這部分軟件是怎樣與整個大系統(tǒng)相關(guān)聯(lián)的，或者（同 時）說明相互關(guān)系的存在形式，并且要定義出兩者之間的全部接口。產(chǎn)品的功能因為將在需求分析報告的第4部分中詳細(xì)描述軟件產(chǎn)品的功能，所以在此只需要概略地總結(jié)。僅 從業(yè)務(wù)層面陳述本軟件產(chǎn)品所應(yīng)具有的主要功能，在描述功能時應(yīng)該針對每一項需求準(zhǔn)確地描述 其各項規(guī)格說明。如果存在引起誤解的可能，在陳述本軟件產(chǎn)品主要功能的作用領(lǐng)域時，也需要 對應(yīng)陳述本軟件產(chǎn)品的非作用領(lǐng)域，以利讀者理解本軟件產(chǎn)品。為了很好地組織產(chǎn)品功能，使每個讀者都容易理解，可以采用列表的方法給出。也可以采用圖形 方式，將

29、主要的需求分組以及它們之間的聯(lián)系使用數(shù)據(jù)流程圖的頂層圖或類圖進(jìn)行表示，這種表 示方法是很有用的。參考用戶當(dāng)前管理組織構(gòu)架，了解各個機(jī)構(gòu)的主要職能，將有助于陳述軟件產(chǎn)品的主要功能。用戶類和特性確定有可能使用該軟件產(chǎn)品的不同用戶類，并且描述它們相關(guān)的特征。往往有一些軟件需求，只 與特定的用戶類有關(guān)。描述時，應(yīng)該將該軟件產(chǎn)品的重要用戶類與非重要用戶類區(qū)分開。用戶不一定是軟件產(chǎn)品的直接使用者，通過報表、應(yīng)用程序接口、系統(tǒng)硬件接口得到軟件產(chǎn)品的 數(shù)據(jù)和服務(wù)的人、或者機(jī)構(gòu)也有他們的需求。所以，應(yīng)該將這些外部需求視為通過報表、應(yīng)用程 序接口、系統(tǒng)硬件接口附加給軟件產(chǎn)品的附加用戶類。運(yùn)行環(huán)境描述了本軟件的運(yùn)行

30、環(huán)境，一般包括：硬件平臺；操作系統(tǒng)和版本；支撐環(huán)境（例如：數(shù)據(jù)庫等）和版本；其它與該軟件有關(guān)的軟件組件；與該軟件共存的應(yīng)用程序。設(shè)計和實現(xiàn)上的限制確定影響開發(fā)人員自由選擇的問題，并且說明這些問題為什么成為一種限制?？赡艿南拗瓢ㄏ?列內(nèi)容：必須使用的特定技術(shù)、工具、編程語言和數(shù)據(jù)庫；避免使用的特定技術(shù)、工具、編程語言和數(shù)據(jù)庫；要求遵循的開發(fā)規(guī)范和標(biāo)準(zhǔn)例如，如果由客戶的公司或者第三方公司負(fù)責(zé)軟件維護(hù)，就必須定義轉(zhuǎn)包者所使用的設(shè)計符號表 示和編碼標(biāo)準(zhǔn)；企業(yè)策略的限制；政府法規(guī)的限制；工業(yè)標(biāo)準(zhǔn)的限制；硬件的限制例如，定時需求或存儲器限制；數(shù)據(jù)轉(zhuǎn)換格式標(biāo)淮的限制。假設(shè)和約束（依賴）列舉出對軟件產(chǎn)品需求

31、分析報告中，影響需求陳述的假設(shè)因素（與己知因素相對立）。如果這些假 設(shè)因素不正確、不一致或者被修改，就會使軟件產(chǎn)品開發(fā)項目受到影響。這些假設(shè)的因素可能包 括：計劃使用的商業(yè)組件，或者其它軟件中的某個部件；假定產(chǎn)品中某個用戶界面將符合一個特殊的設(shè)計約定；有關(guān)本軟件用戶的若干假定（例如：假定用戶會熟練使用SQL語言。）；有關(guān)本軟件開發(fā)工作的若干假定（例如：用戶承諾的優(yōu)惠、方便、上級部門給予的特殊政策和支 持等。）；有關(guān)本軟件運(yùn)行環(huán)境的一些問題；此外，確定本軟件開發(fā)項目對外部約束因素所存在的依賴。有關(guān)的約束可能包括：工期約束；經(jīng)費約束；人員約束；設(shè)備約束；地理位置約束；其它有關(guān)項目約束；外部接口需求

32、通過本節(jié)描述可以確定，保證軟件產(chǎn)品能和外部組件正確連接的需求。關(guān)聯(lián)圖僅能表示高層抽象 的外部接口，必須對接口數(shù)據(jù)和外部組件進(jìn)行詳細(xì)描述，并且寫入數(shù)據(jù)定義中。如果產(chǎn)品的不同 部分有不同的外部接口，那么應(yīng)該把這些外部接口的全部詳細(xì)需求并入到這一部分實例中。注意：必須將附加用戶類的特征與外部接口需求加以區(qū)分，附加用戶類的特征描述的是通過接口 取得軟件產(chǎn)品的數(shù)據(jù)和服務(wù)的人的需求；而外部接口需求描述的是接口本身的需求。用戶界面陳述需要使用在用戶界面上的軟件組件，描述每一個用戶界面的邏輯特征。必須注意，這里需要 描述的是用戶界面的邏輯特征，而不是用戶界面。以下是可能包括的一些特征：將要采用的圖形用戶界面（

33、GUI）標(biāo)準(zhǔn)或者產(chǎn)品系列的風(fēng)格；有關(guān)屏幕布局或者解決方案的限制；將要使用在每一個屏幕（圖形用戶界面）上的軟件組件，可能包括：選單；標(biāo)準(zhǔn)按鈕；導(dǎo)航鏈接；各種功能組件；消息欄；快捷鍵；各種顯示格式的規(guī)定，可能包括：不同情況下文字的對齊方式；不同情況下數(shù)字的表現(xiàn)格式與對齊方式日期的表現(xiàn)方法與格式；計時方法與時間格式；等等。錯誤信息顯示標(biāo)準(zhǔn)；對于用戶界面的細(xì)節(jié)，例如：一個特定對話框的布局，應(yīng)該寫入具體的用戶界面設(shè)計說明中，而 不能寫入軟件需求規(guī)格說明中。如果采用現(xiàn)成的、合適的用戶界面設(shè)計規(guī)范（標(biāo)準(zhǔn)），或者另文描述，可以在這里直接說明，并且 將其加入?yún)⒖嘉墨I(xiàn)。硬件接口描述待開發(fā)的軟件產(chǎn)品與系統(tǒng)硬件接口的

34、特征，若有多個硬件接口，則必須全都描述。接口特征 的描述內(nèi)容可能包括：支持的硬件類型；軟、硬件之間交流的數(shù)據(jù)；控制信息的性質(zhì)；使用的通訊協(xié)議；軟件接口描述該軟件產(chǎn)品與其它外部組件的連接，這些外部組件必須明確它們的名稱和版本號以資識別， 可能的外部組件包括： 操作系統(tǒng)； 數(shù)據(jù)庫； 工具.；函數(shù)庫；集成的商業(yè)組件說明：這里所說的“集成的商業(yè)組件”，是指與系統(tǒng)集成的商業(yè)組件，而不是與軟件產(chǎn)品集成的 商業(yè)組件。例如：中間件、消息服務(wù)，等等。描述并且明確軟件產(chǎn)品與軟件組件之間交換數(shù)據(jù)或者消息的目的。描述所需要的服務(wù)，以及與內(nèi) 部組件通訊的性質(zhì)。確定軟件產(chǎn)品將與組件之間共享的數(shù)據(jù)。如果必須使用一種特殊的方

35、法來實 現(xiàn)數(shù)據(jù)共享機(jī)制，例如：在多用戶系統(tǒng)中的一個全局?jǐn)?shù)據(jù)區(qū)，那么就必須把它定義為一種實現(xiàn)上 的限制。通訊接口描述與軟件產(chǎn)品所使用的通訊功能相關(guān)的需求，包括：電子郵件；WEB瀏覽器；網(wǎng)絡(luò)通訊標(biāo)準(zhǔn)或者協(xié)議；數(shù)據(jù)交互用電子表格；必須定義相關(guān)的：消息格式；通訊安全或加密問題；數(shù)據(jù)傳輸速率；同步和異步通訊機(jī)制；系統(tǒng)功能需求需要進(jìn)行詳細(xì)的需求記錄，詳細(xì)列出與該系統(tǒng)功能相關(guān)的詳細(xì)功能需求，并且，唯一地標(biāo)識每一 項需求。這是必須提交給用戶的軟件功能，使得用戶可以使用所提供的功能執(zhí)行服務(wù)或者使用所 指定的使用實例執(zhí)行任務(wù)。描述軟件產(chǎn)品如何響應(yīng)己知的出錯條件、非法輸入、非法動作。如果每一項功能需求都能用一項，也

36、只需要用一項測試用例就能進(jìn)行驗證，那么就可以認(rèn)為功能 需求已經(jīng)適當(dāng)?shù)剡M(jìn)行描述了。如果某項功能需求找不到合適的測試用例，或者必須使用多項測試 用例才能驗證，那么該項功能需求的描述必然存在某些問題。功能需求是根據(jù)系統(tǒng)功能，即軟件產(chǎn)品所提供的主要服務(wù)來組織的?？梢酝ㄟ^使用實例、運(yùn)行模 式、用戶類、對象類或者功能等級來組織這部分內(nèi)容，也可以便用這些元素的組合?？偠灾?， 必須選擇一種是讀者容易理解預(yù)期產(chǎn)品的組織方案。用簡短的語句說明功能的名稱，例如：“系統(tǒng)參數(shù)管理”。按照服務(wù)組織的順序，逐條闡述系統(tǒng) 功能。無論說明的是何種功能，都應(yīng)該針對該系統(tǒng)功能重復(fù)敘述這三個部分?？梢酝ㄟ^各種方式來組織這一部分內(nèi)容

37、，例如采用：使用實例、運(yùn)行模式、用戶類、對象類、功 能等級等，也可以采用它們的組合。其最終目的是，讓讀者容易理解即將開發(fā)的軟件產(chǎn)品。一般 來說，每個使用實例都對應(yīng)一個系統(tǒng)功能，因而按照使用實例來組織內(nèi)容比較容易讓用戶理解。 對應(yīng)一些被共享的獨立使用實例，可以定義一些公用系統(tǒng)功能。必須特別注意的是，在節(jié)“產(chǎn)品的功能”中描述的全部需求，以及它們的規(guī)格說明；必須在某個 系統(tǒng)功能描述中有所反映，而且不應(yīng)重復(fù)。說明和優(yōu)先級對該系統(tǒng)功能進(jìn)行簡短的說明，并且指出該系統(tǒng)功能的優(yōu)先級是：高、中、還是低。需要的話， 還可以包括對特定優(yōu)先級部分的評價，例如：利益、損失、費用和風(fēng)險，其相對優(yōu)先等級可以從 1（低）到9

38、（高）。激勵/響應(yīng)序列列出輸入激勵（用戶動作、來自外部設(shè)備的信號或者其它觸發(fā)）并且定義針對這一一功能行為的系 統(tǒng)響應(yīng)序列，這些序列將與使用實例中相關(guān)的對話元素相對應(yīng)。描述激勵/響應(yīng)序列時，不僅需要描述基本過程，而且應(yīng)該描述可選（擴(kuò)充）過程，包括例外（引起 任務(wù)不能順序完成的情況稱為例外）。疏忽了可選過程，有可能影響軟件產(chǎn)品的功能；如果遺漏 例外過程，則有可能會引發(fā)系統(tǒng)崩潰。如果采用流程圖來描述激勵/響應(yīng)序列，比較容易讓用戶理解。輸入/輸出數(shù)據(jù)列出輸入數(shù)據(jù)（用戶輸入、來自外部接口的輸入或者其它輸入）并且定義針對這些輸入數(shù)據(jù)的處理 （計算）方法，以及相應(yīng)地輸出數(shù)據(jù)，描述對應(yīng)區(qū)別：輸入數(shù)據(jù)和輸出數(shù)據(jù)

39、。當(dāng)有大量數(shù)據(jù)需要描述時，也可以分類描述數(shù)據(jù)，并且注明各項數(shù)據(jù)的輸入、輸出屬性。對于每一項數(shù)據(jù)，均需要描述：數(shù)據(jù)名稱；實際含義；數(shù)據(jù)類型；數(shù)據(jù)格式；數(shù)據(jù)約束；對于復(fù)雜的處理方法，僅僅給出算法原理是不夠的，必須描述詳細(xì)的計算過程，并且列出每一步 具體使用的實際算式；如果計算過程中涉及查表、判斷、迭代等處理方法，應(yīng)該給出處理依據(jù)和 相關(guān)數(shù)據(jù)。如果計算方法很簡單，也可以將其從略，不加描述。其它非功能需求在這里列舉出所有非功能需求，主要包括可靠性、安全性、可維護(hù)性、可擴(kuò)展性、可測試性等。 性能需求闡述不同應(yīng)用領(lǐng)域?qū)浖a(chǎn)品性能的需求，并且說明提出需求的原理或者依據(jù)，以幫助開發(fā)人員 做出合理的設(shè)計選擇。

40、盡可能詳細(xì)地描述性能需求，如果需要，可以針對每個功能需求或者特征 分別陳述其性能需求。在這里確定：相互合作的用戶數(shù)量；系統(tǒng)支持的并發(fā)操作數(shù)量；響應(yīng)時間；與實時系統(tǒng)的時間關(guān)系：容量需求存儲器；磁盤空間；數(shù)據(jù)庫中表的最大行數(shù)。安全措施需求詳盡陳述與軟件產(chǎn)品使用過程中可能發(fā)生的損失、破壞、危害相關(guān)的需求。定義必須采取的安全 保護(hù)或動作，以及必須預(yù)防的潛在危險動作。明確軟件產(chǎn)品必須遵從的安全標(biāo)準(zhǔn)、策略、或規(guī)則。 安全性需求詳盡陳述與系統(tǒng)安全性、完整性問題相關(guān)的需求，或者與個人隱私問題相關(guān)的需求。這些問題將 會影響到軟件產(chǎn)品的使用，和軟件產(chǎn)品所創(chuàng)建或者使用的數(shù)據(jù)的保護(hù)。定義用戶身份認(rèn)證，或備 授權(quán)需求。

41、明確軟件產(chǎn)品必須滿足的安全性或者保密性策略。也可以通過稱為完整性的質(zhì)量屬性 來闡述這些需求。一個典型的軟件系統(tǒng)安全需求范例如下：“每個用戶在第一次登錄后，必須更 改他的系統(tǒng)預(yù)置登錄密碼，系統(tǒng)預(yù)置的登錄密碼不能重用。” 軟件質(zhì)量屬性詳盡陳述對客戶和開發(fā)人員至關(guān)重要的在軟件產(chǎn)品其它方面表現(xiàn)出來的質(zhì)量功能。這些功能必須 是確定的、定量的、在需要時是可以驗證的。至少也應(yīng)該指明不同屬性的相對側(cè)重點，例如：易 用性優(yōu)于易學(xué)性，或者可移植性優(yōu)于有效性。業(yè)務(wù)規(guī)則列舉出有關(guān)軟件產(chǎn)品的所有操作規(guī)則，例如：那些人在特定環(huán)境下可以進(jìn)行何種操作。這些本身 不是功能需求，但是他們可以暗示某些功能需求執(zhí)行這些規(guī)則。一個業(yè)務(wù)

42、規(guī)則的范例如下：“進(jìn) 行達(dá)到或者超過10，000，00元人民幣的儲蓄業(yè)務(wù)時，必須通過附加的管理員認(rèn)證?！?列舉業(yè)務(wù)規(guī)則時，可以根據(jù)規(guī)則的數(shù)量，選取合適的編目方式。用戶文檔列舉出將與軟件產(chǎn)品一同交付的用戶文檔，并且明確所有己知用戶文檔的交付格式或標(biāo)準(zhǔn)，例如： 安裝指南紙質(zhì)文檔，16開本；用戶手冊紙質(zhì)文檔，16開本；在線幫助電子文檔，與軟件產(chǎn)品一同分發(fā)、配置；使用教程電子文檔，與軟件產(chǎn)品一同分發(fā)、配置。詞匯表列出本文件中用到的專業(yè)術(shù)語的定義，以及有關(guān)縮寫的定義（如有可能，列出相關(guān)的外文原詞）。 為了便于非軟件專業(yè)或者非計算機(jī)專業(yè)人士閱讀軟件產(chǎn)品需求分析報告，要求使用非軟件專業(yè)或 者非計算機(jī)專業(yè)的術(shù)

43、語描述軟件需求。所以這里所指的專業(yè)術(shù)語，是指業(yè)務(wù)層面上的專業(yè)術(shù)語， 而不是軟件專業(yè)或者計算機(jī)專業(yè)的術(shù)語。但是，對于無法回避的軟件專業(yè)或者計算機(jī)專業(yè)術(shù)語， 也應(yīng)該列入詞匯表并且加以準(zhǔn)確定義。數(shù)據(jù)定義數(shù)據(jù)定義是一個定義了應(yīng)用程序中使用的所有數(shù)據(jù)元素和結(jié)構(gòu)的共享文檔，其中對每個數(shù)據(jù)元素 和結(jié)構(gòu)都準(zhǔn)確描述：含義、類型、數(shù)據(jù)大小、格式、計量單位、精度以及取值范圍。數(shù)據(jù)定義的 維護(hù)獨立于軟件需求規(guī)格說明，并且在軟件產(chǎn)品開發(fā)和維護(hù)的任何階段，均向風(fēng)險承擔(dān)者開放。 如果為軟件開發(fā)項目創(chuàng)建一個獨立的數(shù)據(jù)定義，而不是為每一項特性描述有關(guān)的數(shù)據(jù)項，有利于 避免冗余和不一致性。但是卻不利于多人協(xié)同編寫需求分析報告，容

44、易遺漏數(shù)據(jù)，也不方便閱讀。 因此還是建議為每個特性描述有關(guān)的數(shù)據(jù)項，匯總數(shù)據(jù)項創(chuàng)建數(shù)據(jù)定義，再根據(jù)數(shù)據(jù)定義復(fù)核全 部數(shù)據(jù)，使得它們的名稱和含義完全一致。必須注意的是，為了避免二義性，在匯總數(shù)據(jù)項時應(yīng) 該根據(jù)數(shù)據(jù)項所代表的實際意義匯總，而不是根據(jù)數(shù)據(jù)項的名稱匯總。在數(shù)據(jù)定義中，每個數(shù)據(jù)項除了有一個中文名稱外，還應(yīng)該為它取一個簡短的英文名稱，該英文 名稱應(yīng)該符合命名規(guī)范，因為在軟件開發(fā)時將沿用該英文名稱。可以使用等號表示數(shù)據(jù)項，名稱 寫在左邊，定義寫在右邊。常見數(shù)據(jù)項的描述方式如下：原數(shù)據(jù)元素一個原數(shù)據(jù)元素是不可分解的，可以將一個數(shù)量值賦給它。定義原數(shù)據(jù)元素必須確定其 含義、類型、數(shù)據(jù)大小、格式、

45、計量單位、精度以及取值范圍。采用以星號為界的一行 注釋文本，描述原數(shù)據(jù)元素的定義。選擇項選擇項是一種只可以取有限離散值的特殊原數(shù)據(jù)元素，描述時一一枚舉這些值，并用方括號括起來寫在原數(shù)據(jù)元素的定義前。在兩項離散值之間，使用管道符分隔。組合項組合項是一個數(shù)據(jù)結(jié)構(gòu)或者記錄，其中包含了多個數(shù)據(jù)項。這些數(shù)據(jù)項可以是原數(shù)據(jù)元 素，也可以是組合數(shù)據(jù)項，各數(shù)據(jù)項之間用加號連接。其中每個數(shù)據(jù)項都必須是數(shù)據(jù)定 義中定義過的，結(jié)構(gòu)中也可以包括其它結(jié)構(gòu)，但是絕對不允許遞歸。如果數(shù)據(jù)結(jié)構(gòu)中有 可選項，使用圓括號把該項括起來。重復(fù)項重復(fù)項是組合項的一種特例，其中有一項將有多個實例出現(xiàn)在數(shù)據(jù)結(jié)構(gòu)中，使用花括號 把該項括起來

46、。如果知道該項可能允許的范圍，就按“最小值：最大值”的形式寫在花 括號前。分析模型這是一個可選部分，包括或涉及到相關(guān)的分析模型，例如：數(shù)據(jù)流程圖；類圖；狀態(tài)轉(zhuǎn)換圖；實體-關(guān)系圖。待定問題列表編輯一張在軟件產(chǎn)品需求分析報告中待確定問題時的列表，把每一個表項都編上號，以便跟蹤調(diào) 查。附錄B軟件概要設(shè)計報告文檔模板引言錯誤!未定義書簽。編寫目的 錯誤!未定義書簽。項目風(fēng)險 錯誤!未定義書簽。預(yù)期讀者和閱讀建議錯誤!未定義書簽。參考資料 錯誤!未定義書簽。設(shè)計概述錯誤!未定義書簽。限制和約束錯誤!未定義書簽。設(shè)計原則和設(shè)計要求錯誤!未定義書簽。系統(tǒng)邏輯設(shè)計錯誤!未定義書簽。系統(tǒng)組織設(shè)計 錯誤!未定義書

47、簽。系統(tǒng)結(jié)構(gòu)設(shè)計 錯誤!未定義書簽。系統(tǒng)特性表錯誤!未定義書簽。系統(tǒng)特性結(jié)構(gòu)圖錯誤!未定義書簽。系統(tǒng)接口設(shè)計 錯誤!未定義書簽。系統(tǒng)接口表 錯誤!未定義書簽。系統(tǒng)接口傳輸協(xié)議說明錯誤!未定義書簽。系統(tǒng)完整性設(shè)計錯誤!未定義書簽。系統(tǒng)出錯處理設(shè)計錯誤!未定義書簽。系統(tǒng)出錯處理表 錯誤!未定義書簽。維護(hù)處理過程表錯誤!未定義書簽。技術(shù)設(shè)計錯誤!未定義書簽。系統(tǒng)開發(fā)技術(shù)說明表錯誤!未定義書簽。開發(fā)技術(shù)應(yīng)用說明錯誤!未定義書簽。數(shù)據(jù)庫設(shè)計錯誤!未定義書簽。詞匯表錯誤!未定義書簽。進(jìn)度計劃錯誤!未定義書簽。引言引言是對這份軟件系統(tǒng)概要設(shè)計報告的概覽，是為了幫助閱讀者了解這份文檔是如何編寫的，并 且應(yīng)該如

48、何閱讀、理解和解釋這份文檔。編寫目的說明這份軟件系統(tǒng)概要設(shè)計報告是基于哪份軟件產(chǎn)品需求規(guī)格說明書編寫的，開發(fā)這個軟件產(chǎn)品 意義、作用、以及最終要達(dá)到的意圖。通過這份軟件系統(tǒng)概要設(shè)計報告詳盡說明了該軟件產(chǎn)品的 軟件結(jié)構(gòu)，包括數(shù)據(jù)庫結(jié)構(gòu)和出錯處理，從而對該軟件產(chǎn)品的結(jié)構(gòu)的描述。如果這份軟件系統(tǒng)概要設(shè)計報告只與整個系統(tǒng)的某一部分有關(guān)系，那么只定義軟件系統(tǒng)概要設(shè)計 報告中說明的那個部分或子系統(tǒng)。項目風(fēng)險具體說明本軟件開發(fā)項目的全部風(fēng)險承擔(dān)者，以及各自在本階段所需要承擔(dān)的主要風(fēng)險，首要風(fēng) 險承擔(dān)者包括：任務(wù)提出者；軟件開發(fā)者；產(chǎn)品使用者。預(yù)期讀者和閱讀建議列舉本軟件系統(tǒng)概要設(shè)計報告所針對的各種不同的預(yù)期

49、讀者，例如，可能的讀者包括：用戶；開發(fā)人員；項目經(jīng)理；營銷人員；測試人員；文檔編寫人員；等等。描述文檔中，其余部分的內(nèi)容及其組織結(jié)構(gòu)，并且針對每一類讀者提出最適合的文檔閱讀建議。參考資料列舉編寫軟件產(chǎn)品概要設(shè)計報告時所用到的參考文獻(xiàn)及資料，可能包括：本項目的合同書；上級機(jī)關(guān)有關(guān)本項目的批文；本項目已經(jīng)批準(zhǔn)的計劃任務(wù)書；用戶界面風(fēng)格指導(dǎo)；開發(fā)本項目時所要用到的標(biāo)準(zhǔn)；系統(tǒng)規(guī)格需求說明；使用實例文檔；屬于本項目的其它已發(fā)表文件；本軟件系統(tǒng)概要設(shè)計報告中所引用的文件、資料：相關(guān)軟件系統(tǒng)概要設(shè)計報告：等等。為了方便讀者查閱，所有參考資料應(yīng)該按一定順排列。如果可能，每份資料都應(yīng)該給出：標(biāo)題名稱；作者或者合

50、同簽約者；文件編號或者版本號；發(fā)表日期或者簽約日期；出版單位或者資料來源。設(shè)計概述本節(jié)描述現(xiàn)有開發(fā)條件和需要實現(xiàn)的目標(biāo)，說明進(jìn)行概要設(shè)計時應(yīng)該遵循的設(shè)計原則和必須采用 的設(shè)計方法。限制和約束簡要描述起到限制和約束作用的各種可能存在的條件，例如：技術(shù)條件；資金狀況；開發(fā)環(huán)境（包括：工具和平臺）；時間限制；等等。并且說明在上述條件下，應(yīng)該實現(xiàn)的系統(tǒng)目標(biāo)，設(shè)計原則和設(shè)計要求描述對本軟件系統(tǒng)進(jìn)行概要設(shè)計的原則，通?？梢钥紤]以下幾方面的內(nèi)容：命名規(guī)則；模塊獨立性原則： 邊界設(shè)計原則； 數(shù)據(jù)庫設(shè)計規(guī)則； 必須的安全措施； 安全性和保密原則; 系統(tǒng)靈活性要求； 系統(tǒng)易操作性要求; 系統(tǒng)可維護(hù)性要求;系統(tǒng)邏輯

51、設(shè)計本節(jié)內(nèi)容主要根據(jù)軟件產(chǎn)品需求規(guī)格說明書和軟件產(chǎn)品數(shù)據(jù)字典建立系統(tǒng)的邏輯模型。此種模型 暫時與系統(tǒng)的物理因素（例如：計算機(jī)、數(shù)據(jù)庫管理系統(tǒng)）無關(guān)。它是系統(tǒng)需求與物理實現(xiàn)的中間 結(jié)構(gòu)，它的主要結(jié)果是建立：系統(tǒng)結(jié)構(gòu)圖、系統(tǒng)界面結(jié)構(gòu)圖、系統(tǒng)出錯處理、以及系統(tǒng)開發(fā)技術(shù) 說明。說明：如果進(jìn)行系統(tǒng)設(shè)計時尚未編寫軟件數(shù)據(jù)字典：應(yīng)首先參照附錄B說明，編寫軟件數(shù)據(jù)字 典。在完成軟件數(shù)據(jù)字典后，再進(jìn)行系統(tǒng)設(shè)計。系統(tǒng)組織設(shè)計系統(tǒng)組織設(shè)計通過系統(tǒng)組織表描述本系統(tǒng)由哪些子系統(tǒng)（模塊）組成，這些子系統(tǒng)與業(yè)務(wù)職能之間 的關(guān)系，以及各個子系統(tǒng)的安裝地點。系統(tǒng)組織表的格式如下：子系統(tǒng)編號英文名稱E名稱業(yè)務(wù)職能安裝地點備注其中

52、：子系統(tǒng)編號給出本系統(tǒng)中指定子系統(tǒng)的順序編號。如果本系統(tǒng)末劃分為多個子系統(tǒng)，僅由一 個運(yùn)行模塊組成；則本項內(nèi)容仍需要描述，但是本表內(nèi)容只有一行。說明：在一個系統(tǒng)中有可能安裝若干個相同的子系統(tǒng)，在這種情況下，應(yīng)該視為 一個子系統(tǒng)，并且對多個安裝地點分別進(jìn)行描述。如果相同的子系統(tǒng)通過系統(tǒng)設(shè) 置，實現(xiàn)的業(yè)務(wù)職能具有明顯差異時，應(yīng)該采用多行進(jìn)行分別描述，并且在備注 中說明其差異所在。子系統(tǒng)英文名稱給出本子系統(tǒng)的英文名稱，該名稱是在應(yīng)用軟件中實際使用的可執(zhí)行文件名稱， 必須能夠說明該子系統(tǒng)的特點。若本系統(tǒng)中只有一個子系統(tǒng)，則本項內(nèi)容仍需要描述，但是本表內(nèi)容只有一行。 子系統(tǒng)中文名稱 給出本子系統(tǒng)的中文名

53、稱，該名稱必須能夠說明該子系統(tǒng)的特點。若本系統(tǒng)中只有一個子系統(tǒng)，則本項內(nèi)容仍需要描述，但是本表內(nèi)容只有一行。 業(yè)務(wù)職能描述該子系統(tǒng)完成的核心業(yè)務(wù)。安裝地點描述該子系統(tǒng)實際安裝的部門、或者某個具體地點。備注針對該子系統(tǒng)，需要說明的其它有關(guān)問題。系統(tǒng)結(jié)構(gòu)設(shè)計本節(jié)將對系統(tǒng)特性作較為詳細(xì)的描述，并給出系統(tǒng)特性結(jié)構(gòu)圖。系統(tǒng)特性表系統(tǒng)特性是系統(tǒng)中完成某項具體操作的基本單元，它由入口參數(shù)，出口參數(shù)以及處理過程三部分 組成。系統(tǒng)特性可以具有操作界面，也可以沒有操作界面；可以被其它操作界面、或者系統(tǒng)特性調(diào)用， 也可以調(diào)用其它操作界面、非操作界面、或者系統(tǒng)特性；但是不允許遞歸調(diào)用（調(diào)用自己），包括 間接遞歸調(diào)用。

54、當(dāng)系統(tǒng)由多個子系統(tǒng)（模塊）組成時，每個子系統(tǒng)分別使用一張系統(tǒng)特性表進(jìn)行描述。系統(tǒng)特性表 的格式如下：子系統(tǒng)編號：子系統(tǒng)英文名稱：子系統(tǒng)中文名稱：特性編號系統(tǒng)特征英文名稱系統(tǒng)特征中文名稱操作功能調(diào)用對象被調(diào)用 對象備注說明：其中子系統(tǒng)編號含義同上。子系統(tǒng)英文名稱含義同上。子系統(tǒng)中文名稱含義同上。特性編號整個系統(tǒng)所有特性的統(tǒng)一編號。系統(tǒng)特性英文名稱系統(tǒng)特性的英文正式名稱，將來用于軟件開發(fā)中，必須符合命名規(guī)范。系統(tǒng)特性中文名稱系統(tǒng)特性的中文正式名稱，來源于需求規(guī)格說明書中，系統(tǒng)特性一節(jié)中的有關(guān)描述。操作功能是指該特性實際完成的操作說明。調(diào)用對象是指調(diào)用該系統(tǒng)特性的系統(tǒng)對象，這里的系統(tǒng)對象可以是系統(tǒng)特

55、性、也可以是操作界面。被調(diào)用對象是指被該系統(tǒng)特性調(diào)用的系統(tǒng)對象，這里的系統(tǒng)對象可以是系統(tǒng)特性、也可以是操作界面。說明：某些較低層的系統(tǒng)特性，可能不存在被調(diào)用對象。備注描述與該系統(tǒng)特性有關(guān)的其它注意事項。說明描述與該系統(tǒng)特性表有關(guān)的其它注意事項。系統(tǒng)特性結(jié)構(gòu)圖系統(tǒng)特性結(jié)構(gòu)圖給出系統(tǒng)特性在邏輯層面上相互之間的關(guān)系，其主要依據(jù)來源于需求規(guī)格說明書中，系統(tǒng)特性一節(jié)中的有關(guān)描述。如果系統(tǒng)劃分為多個子系統(tǒng)，應(yīng)分別給出系統(tǒng)與子系統(tǒng)、以及各個子系統(tǒng)與系統(tǒng)特性的結(jié)構(gòu)圖。 繪制系統(tǒng)與子系統(tǒng)結(jié)構(gòu)圖時，一般不需要描繪出系統(tǒng)特性，如果確有必要，盡可能只畫出第一層 系統(tǒng)特性。繪制子系統(tǒng)與系統(tǒng)特性結(jié)構(gòu)圖時，通常也不需要描繪

56、出第二層系統(tǒng)特性，如果確有必 要可以畫出，但是盡可能不要畫出第三層系統(tǒng)特性。系統(tǒng)接口設(shè)計系統(tǒng)接口是一種非可視的系統(tǒng)界面，在多數(shù)情況下，它對用戶是透明的。本節(jié)將對系統(tǒng)接口作較為詳細(xì)的描述，并給出接口說明清單。系統(tǒng)接口表接口作為系統(tǒng)的一種輸入/輸出形式，分為網(wǎng)絡(luò)接口、數(shù)據(jù)庫接口、RS232串行通訊接口、IEEE 485串行總線接口、并行I/O接口等等多種類型。對于一些為可視界面服務(wù)的接口，例如：打印機(jī)接口、顯示器接口等，因為這類接口對應(yīng)用軟件 是透明的，所以不在本節(jié)描述范圍內(nèi)。當(dāng)系統(tǒng)由多個子系統(tǒng)（模塊）組成時，每個子系統(tǒng)分別使用一張系統(tǒng)接口表進(jìn)行描述。系統(tǒng)接口表 的格式如下：子系統(tǒng)編號子系統(tǒng)英文名

57、稱子系統(tǒng)中文名稱接口編號接口名稱接口類型接口性質(zhì)接口速率接口協(xié)議備注說明：其中：子系統(tǒng)編號含義同上。子系統(tǒng)英文名稱含義同上。子系統(tǒng)中文名稱含義同上。接口編號整個系統(tǒng)所有接口的統(tǒng)一編號。接口名稱系統(tǒng)接口的正式名稱，必須符合通常習(xí)慣。接口類型指出該接口所傳輸?shù)臄?shù)據(jù)在該模塊中起到的作用。接口性質(zhì)指出該接口在通訊中起到的作用，這里的作用可以是：輸入；輸出；雙向。接口速率指出該接口的傳輸速率。如果該接口依賴于其它通訊方式，那么傳輸速率將不高于它所依賴的其 它通訊方式的速率。接口協(xié)議給出該接口實際使用的通訊協(xié)議。相關(guān)對象給出直接使用本接口的系統(tǒng)對象，這里的系統(tǒng)對象，可以是操作界面，也可以是系統(tǒng)特性。備注描

58、述與該系統(tǒng)接口有關(guān)的其它注意事項。說明描述與該系統(tǒng)接口表有關(guān)的其它注意事項。系統(tǒng)接口傳輸協(xié)議說明逐項詳細(xì)描述系統(tǒng)接口表中所列出各個系統(tǒng)接口使用的傳輸協(xié)議，以及其它相關(guān)內(nèi)容，例如：驅(qū)動程序、動態(tài)連接庫、等等。系統(tǒng)完整性設(shè)計描述系統(tǒng)對象（數(shù)據(jù)元、數(shù)據(jù)類），所受到的邏輯約束關(guān)系。當(dāng)系統(tǒng)由多個子系統(tǒng)（模塊）組成時，每個子系統(tǒng)應(yīng)分別使用一張系統(tǒng)完整性約束表進(jìn)行描述。系 統(tǒng)完整性約束表的格式如下：子系統(tǒng)編號子系統(tǒng)英文名稱子系統(tǒng)中文名稱約束編號完整性名稱相對對象名約束表達(dá)式備注說明：其中：子系統(tǒng)編號含義同上。子系統(tǒng)英文名稱含義同上。子系統(tǒng)中文名稱含義同上。約束編號整個系統(tǒng)所有約束的統(tǒng)一編號。完整性名稱系統(tǒng)完

59、整性約束的正式名稱，必須符合通常習(xí)慣。相對對象名完整性約束中的相關(guān)對象（數(shù)據(jù)元和數(shù)據(jù)類）。約束表達(dá)式用一階邏輯表達(dá)式表達(dá)的約束方程式。備注描述與該系統(tǒng)完整性約束有關(guān)的其它注意事項。說明描述與該系統(tǒng)完整性約束表有關(guān)的其它注意事項。系統(tǒng)出錯處理設(shè)計本節(jié)描述系統(tǒng)發(fā)生外界及內(nèi)在錯誤時，所提供的錯誤信息及處理方法，它包括系統(tǒng)出錯處理表及 維護(hù)處理過程表。系統(tǒng)出錯處理表本表給出有關(guān)出錯處理的產(chǎn)生原因、提示信息、以及建議處理方法。當(dāng)系統(tǒng)由多個子系統(tǒng)（模塊）組成時，每個子系統(tǒng)分別使用一張系統(tǒng)出錯處理表進(jìn)行描述。系統(tǒng)出 錯處理表的格式如下：子系統(tǒng)編號：子系統(tǒng)英文名稱：子系統(tǒng)中文名稱：錯誤編號錯誤名稱錯誤原因錯誤

60、信息處理方式備注說明：其中：子系統(tǒng)編號含義同上。子系統(tǒng)英文名稱含義同上。子系統(tǒng)中文名稱含義同上。錯誤編號整個系統(tǒng)所有錯誤的統(tǒng)一編號。錯誤名稱錯誤的正式名稱，該名稱應(yīng)該是常用的，并且為人們所普遍接受的。錯誤原因?qū)υ撳e誤產(chǎn)生原因的解釋與說明。錯誤信息產(chǎn)生該錯誤時，向用戶發(fā)出的提示信息。處理方式對該錯誤處理的一種建議，此項允許缺省。備注描述與該系統(tǒng)錯誤有關(guān)的其它注意事項。說明描述與該系統(tǒng)錯誤表有關(guān)的其它注意事項。維護(hù)處理過程表系統(tǒng)出錯時，將調(diào)用維護(hù)處理過程對錯誤進(jìn)行處理，有關(guān)維護(hù)處理過程的各項內(nèi)容由維護(hù)處理過 程表進(jìn)行描述。當(dāng)系統(tǒng)有多個子系統(tǒng)（模塊）組成時，每個子系統(tǒng)分別使用一張維護(hù)處理過程表進(jìn)行描