【導(dǎo)讀】一項計算機(jī)軟件的籌劃、研制及實現(xiàn)，構(gòu)成一個軟件開發(fā)項目。項目的進(jìn)行，一般需要在人力和自動化資源等方面作重大的投資。每一階段，都需要編制二定的文件。這些文件連同計算機(jī)程序及數(shù)據(jù)一起，構(gòu)。文件是計算機(jī)軟件中不可缺少的組成部分，它的作用是：。a．作為開發(fā)人員在一定階段內(nèi)的工作成果和結(jié)束標(biāo)志；“不可見的”事物轉(zhuǎn)換成“可見的”文字資料。以便管理人員在各個階段檢查開發(fā)計。C．記錄開發(fā)過程中的技術(shù)信息，便于協(xié)調(diào)以后的軟件開發(fā)、使用和修改；操作人員和用戶之間相互了解彼此的工作；之為工作表格；另一類則是應(yīng)編制的技術(shù)資料或技術(shù)管理資料，可稱之為文件。本指南規(guī)定軟件文件的編制形式，并提供對這些規(guī)定的解釋。使得所編制的軟件文件確實能夠起到軟件文件應(yīng)該發(fā)揮的作用?？尚行匝芯繄蟾?；軟件需求說明書；概要設(shè)計說明書；詳細(xì)設(shè)計說明書；在一般情況下，應(yīng)完成的文件包括：概要設(shè)計說明書、詳細(xì)設(shè)計說明書和測

　　

【正文】 質(zhì)量保證計劃、配置管理計劃、用戶培訓(xùn)計劃、系統(tǒng)安裝計劃等）的要點(diǎn)。 附錄 C 軟件需求說明書的編寫提示 C． 1 引言 C． 1． 1 編寫目的 說明編寫這份軟件需求說明書的目的，指出預(yù)期的讀者。 C． 1． 2 背景 說明： a．待開發(fā)的軟件系統(tǒng)的名稱； b．本項目的任務(wù)提出者、開發(fā)者、用戶及實現(xiàn)該軟件的計算中心或計算機(jī)網(wǎng)絡(luò)； C．該軟件系統(tǒng)同其他系統(tǒng)或 其他機(jī)構(gòu)的基本的相互來往關(guān)系。 C． 1． 3 定義 列出本文件中用到的專門術(shù)語的定義和外文首字母組詞的原詞組。 C． 1． 4 參考資料 列出用得著的參考資料，如： a．本項目的經(jīng)核準(zhǔn)的計劃任務(wù)書或合同、上級機(jī)關(guān)的批文； b．屬于本項目的其他已發(fā)表的文件； c．本文件中各處引用的文件、資料、包括所要用到的軟件開發(fā)標(biāo)準(zhǔn)。 列出這些文件資料的標(biāo)題、文件編號、發(fā)表日期和出版單位，說明能夠得到這些文件資料的來源。 C． 2 任務(wù)概述 C． 2． 1 目標(biāo) 敘述該項軟件開發(fā)的 意圖、應(yīng)用目標(biāo)、作用范圍以及其他應(yīng)向讀者說明的有關(guān)該軟件開發(fā)的背景材料。解釋被開發(fā)軟件與其他有關(guān)軟件之間的關(guān)系。如果本軟件產(chǎn)品是一項獨(dú)立的軟件，而且全部內(nèi)容自含，則說明這一點(diǎn)。如果所定義的產(chǎn)品是一個更大的系統(tǒng)的一個組成部分，則應(yīng)說明本產(chǎn)品與該系統(tǒng)中其他各組成部分之間的關(guān)系，為此可使用一張方框圖來說明該系統(tǒng)的組成和本產(chǎn)品同其他各部分的聯(lián)系和接口。 | C． 2． 2 用戶的特點(diǎn) 列出本軟件的最終用戶的特點(diǎn)，充分說明操作人員、維護(hù)人員的教育水平和技術(shù)專長，以及本軟件的預(yù)期使甩頻度。這些是軟件設(shè)計工作的重要約束 C． 2． 3 假定和約束 列出進(jìn)行本軟件開發(fā)工作的假定和約束，例如經(jīng)費(fèi)限制、開發(fā)期限等。 C． 3 需求規(guī)定 C． 3． 1 對功能的規(guī)定 用列表的方式（例如 IPO 表即輸入、處理、輸出表的形式），逐項定量和定性地敘述對軟件所提出的功能要求，說明輸入什么量、經(jīng)怎樣的處理、得到什么輸出，說明軟件應(yīng)支持的終端數(shù)和應(yīng)支持的并行操作的用戶數(shù)。 C． 3． 2 對性能的規(guī)定 C． 3． 2． 1 精度 說明對該軟件的輸入、輸出數(shù)據(jù)精度的要求，可能包括傳輸過程中的精度。 C． 3． 2． 2 時間特性要求 說明對于該軟件的時間特性要求，如對： a．響應(yīng)時間； b．更新處理時間； c．?dāng)?shù)據(jù)的轉(zhuǎn)換和傳送時間； d．解題時間； 等的要求。 C． 3． 2． 3 靈活性 說明對該軟件的靈活性的要求，即當(dāng)需求發(fā)生某些變化時，該軟件對這些變化的適應(yīng)能力，如： a．操作方式上的變化； b．運(yùn)行環(huán)境的變化； c．同其他軟件的接口的變化； d．精度和有效時限的變化； e．計劃的變化或改進(jìn)。 對于為了提供這些靈活性而進(jìn)行的專門設(shè)計的部分應(yīng)該加以標(biāo)明。 C． 3． 3 輸人輸出要求 解釋各輸入輸出數(shù)據(jù)類型，并逐項說明其媒體、格式、數(shù)值范圍、精度等。對軟件的數(shù)據(jù)輸出及必須標(biāo)明的控制輸出量進(jìn)行解釋并舉例，包括對硬拷貝報告（正常結(jié)果輸出、狀態(tài)輸出及異常輸出）以及圖形或顯示報告的描述。 C． 3． 4 數(shù)據(jù)管理能力要求 說明需要管理的文卷和記錄的個數(shù)、表和文卷的大小規(guī)模，要按可預(yù)見的增長對數(shù)據(jù)及其分量的存儲要求作出估算。 C． 3． 5 故障處理要求 列出可能的軟件、硬件故障以及對各項性能而言所產(chǎn)生的后果和對故障處理的要求。 C． 3． 6 其他專門要求 如用戶單位對安全保密的要求，對使用方便的要求，對可維護(hù)性、可補(bǔ)充性、易讀性、可靠性、運(yùn)行環(huán)境可轉(zhuǎn)換性的特殊要求等。 C． 4 運(yùn)行環(huán)境規(guī)定 C． 4． 1 設(shè)備 列出運(yùn)行該軟件所需要的硬設(shè)備。說明其中的新型設(shè)備及其專門功能，包括： a．處理器型號及內(nèi)存容量； b．外存容量、聯(lián)機(jī)或脫機(jī)、媒體及其存儲格式，設(shè)備的型號及數(shù)量； c．輸入及輸出設(shè)備的型號和數(shù)量，聯(lián)機(jī)或脫機(jī)； d．?dāng)?shù)據(jù)通信設(shè)備的型號和數(shù)量； e．功能鍵及其他專用硬件 C． 4． 2 支持軟件 列出支持軟件 ,包括要用到的 操作系統(tǒng)、編譯（或匯編）程序、測試支持軟件等。 C． 4． 3 接口 說明該軟件同其他軟件之間的接口、數(shù)據(jù)通信協(xié)議等。 C． 4． 4 控制 說明控制該軟件的運(yùn)行的方法和控制信號，并說明這些控制信號的來源。 附錄 D 數(shù)據(jù)要求說明書的編寫提示 D． 1 引言 D． 1． 1 編寫目的 說明編寫這份數(shù)據(jù)要求說明書的目的，指出預(yù)期的讀者。 D． 1． 2 背景 說明： a．待開發(fā)軟件系統(tǒng)的名稱； b．列出本項目的任務(wù)提出者、開發(fā)者、用戶以及將運(yùn)行該項軟件的計算站（中心）或計算機(jī) 網(wǎng)絡(luò)系統(tǒng)。 D． 1． 3 定義 列出本文件中用到的專門術(shù)語的定義和外文首字母組詞的原詞組。 D． 1． 4 參考資料 列出有關(guān)的參考資料，如： a．本項目的經(jīng)核準(zhǔn)的計劃任務(wù)書或合同，上級機(jī)關(guān)的批文； b．屬于本項目的其他已發(fā)表文件； c．本文件中各處引用的文件、資料，包括所要用到的軟件開發(fā)標(biāo)準(zhǔn)。列出這些文件的標(biāo)題、文件編號、發(fā)表日期和出版單位。說明能夠得到這些文件資料的來源。 D． 2 數(shù)據(jù)的邏輯描述 對數(shù)據(jù)進(jìn)行邏輯描述時可把數(shù)據(jù)分為動態(tài)數(shù)據(jù)和靜態(tài)數(shù)據(jù)。所謂靜態(tài)數(shù)據(jù)，指在 運(yùn)行過程中主要作 為參考的數(shù)據(jù)，它們在很長的一段時間內(nèi)不會變化，一般不隨運(yùn)行而改變。所謂動態(tài)數(shù)據(jù)．包括所有在運(yùn) 行中要發(fā)生變化的數(shù)據(jù)以及在運(yùn)行中要輸入、輸出的數(shù)據(jù)。進(jìn)行描述時應(yīng)把各數(shù)據(jù)元素邏輯地分成若干 組，列如函數(shù)、源數(shù)據(jù)或?qū)τ谄鋺?yīng)用更為恰當(dāng)?shù)倪壿嫹纸M。給出每一數(shù)據(jù)元的名稱（包括縮寫和代碼）、定 義（或物理意義）度量單位、值域、格式和類型等有關(guān)信息。 D． 2． 1 靜態(tài)數(shù)據(jù) 列出所有作為控制或參考用的靜態(tài)數(shù)據(jù)元素。 D． 2． 2 動態(tài)輸人數(shù)據(jù) 列出動態(tài)輸入數(shù)據(jù)元素（包括在常規(guī)運(yùn)行中或聯(lián)機(jī)操作中要改 變的數(shù)據(jù)）。 D． 2． 3 動態(tài)輸出數(shù)據(jù) 列出動態(tài)輸出數(shù)據(jù)元素（包括在常規(guī)運(yùn)行中或聯(lián)機(jī)操作中要改變的數(shù)據(jù)）。 D． 2． 4 內(nèi)部生成數(shù)據(jù) 列出向用戶或開發(fā)單位中的維護(hù)調(diào)試人員提供的內(nèi)部生成數(shù)據(jù)。 D． 2． 5 數(shù)據(jù)約定 說明對數(shù)據(jù)要求的制約。逐條列出對進(jìn)一步擴(kuò)充或使用方面的考慮而提出的對數(shù)據(jù)要求的限制（容 量、文卷、記錄和數(shù)據(jù)元的個數(shù)的最大值）。對于在設(shè)計和開發(fā)中確定是臨界性的限制更要明確指出。 D． 3．?dāng)?shù)據(jù)的采集 D． 3． 1 要求和范圍 按數(shù)據(jù)元的邏輯分組來說明數(shù)據(jù)采集的要求和 范圍，指明數(shù)據(jù)的采集方法，說明數(shù)據(jù)采集工作的承擔(dān)者是用戶還是開發(fā)者。具體的內(nèi)容包括： a．輸入數(shù)據(jù)的來源，例如是單個操作員、數(shù)據(jù)輸入站，專業(yè)的數(shù)據(jù)輸入公司或它們的一個分組； b．?dāng)?shù)據(jù)輸入（指把數(shù)據(jù)輸入處理系統(tǒng)內(nèi)部）所用的媒體和硬設(shè)備。如果只有指定的輸入點(diǎn)的輸入才是合法的，則必須對此加以說明； c．接受者說明輸出數(shù)據(jù)的接受者； d．輸出數(shù)據(jù)的形式和設(shè)備列出輸出數(shù)據(jù)的形式和硬設(shè)備。無論接受者將接收到的數(shù)據(jù)是打印輸出，還是 CRT 上的一組字符、一幀圖形，或一聲警鈴，或向開關(guān)線圈提供的一個電 脈沖，或常用介質(zhì)如磁盤、磁帶、穿孔卡片等，均應(yīng)具體說明； e．?dāng)?shù)據(jù)值的范圍給出每一個數(shù)據(jù)元的合法值的范圍； f．量綱給出數(shù)字的度量單位、增量的步長、零點(diǎn)的定標(biāo)等。在數(shù)據(jù)是非數(shù)字量的情況下，要給出每一種合法值的形式和含意； g．更新和處理的頻度給出預(yù)定的對輸入數(shù)據(jù)的更新和處理的頻度。如果數(shù)據(jù)的輸入是隨機(jī)的，應(yīng)給出更新處理的頻度的平均值，或變化情況的某種其他度量。 D． 3． 2 輸人的承擔(dān)者 說明預(yù)定的對數(shù)據(jù)輸入工作的承擔(dān)者。如果輸入數(shù)據(jù)同某一接口軟件有關(guān)，還應(yīng)說明該接口軟件的來源。 D． 3． 3 預(yù)處理 對數(shù)據(jù)的采集和預(yù)處理過程提出專門的規(guī)定，包括適合應(yīng)用的數(shù)據(jù)格式、預(yù)定的數(shù)據(jù)通信媒體和對輸入的時間要求等。對于需經(jīng)模擬轉(zhuǎn)換或數(shù)字轉(zhuǎn)換處理的數(shù)據(jù)量，要給出轉(zhuǎn)換方法和轉(zhuǎn)換因子等有關(guān)信息，以便軟件系統(tǒng)使用這些數(shù)據(jù)。 D． 3． 4 影響 說明這些數(shù)據(jù)要求對于設(shè)備、軟件、用戶、開發(fā)單位所可能產(chǎn)生的影響，例如要求用戶單位增設(shè)某個機(jī)構(gòu)等。 附錄 E 概要設(shè)計說明書的編寫提示 E． 1 引言 E． 1． 1 編寫目的 說明編寫這份概要設(shè)計說明書的目的，指出預(yù)期的讀者。 E． 1． 2 背 景 說明： a．待開發(fā)軟件系統(tǒng)的名稱； b．列出此項目的任務(wù)提出者、開發(fā)者、用戶以及將運(yùn)行該軟件的計算站（中心）。 E． 1． 3 定義 列出本文件中用到的專門術(shù)語的定義和外文首字母組詞的原詞組。 E． 1． 4 參考資料 列出有關(guān)的參考文件，如： a．本項目的經(jīng)核準(zhǔn)的計劃任務(wù)書或合同，上級機(jī)關(guān)的批文； b．屬于本項目的其他已發(fā)表文件； c．本文件中各處引用的文件、資料，包括所要用到的軟件開發(fā)標(biāo)準(zhǔn)。 列出這些文件的標(biāo)題、文件編號、發(fā)表日期和出版單位，說明能夠得到這 些文件資料的來源。 E． 2 總體設(shè)計 E． 2． 1 需求規(guī)定 說明對本系統(tǒng)的主要的輸入輸出項目、處理的功能性能要求，詳細(xì)的說明可參見附錄 C。 E． 2． 2 運(yùn)行環(huán)境 簡要地說明對本系統(tǒng)的運(yùn)行環(huán)境（包括硬件環(huán)境和支持環(huán)境）的規(guī)定，詳細(xì)說明參見附錄 C。 E． 2． 3 基本設(shè)計概念和處理流程 說明本系統(tǒng)的基本設(shè)計概念和處理流程，盡量使用圖表的形式。 E． 2． 4 結(jié)構(gòu) 用一覽表及框圖的形式說明本系統(tǒng)的系統(tǒng)元素（各層模塊、子程序、公用程序等）的劃分，扼要說明每個系統(tǒng)元素的標(biāo)識符和功能，分層 次地給出各元素之間的控制與被控制關(guān)系． E． 2． 5 功能器求與程序的關(guān)系 本條用一張如下的矩陣圖說明各項功能需求的實現(xiàn)同各塊程序的分配關(guān)系： E． 2． 6 人工處理過程 說明在本軟件系統(tǒng)的工作過程中不得不包含的人工處理過程（如果有的話）。 E． 2． 7 尚未問決的問題 說明在概要設(shè)計過程中尚未解決而設(shè)計者認(rèn)為在系統(tǒng)完成之前必須解決的各個問題 。 E． 3 接口設(shè)計 E． 3． 1 用戶接口 說明將向用戶提供的命令和它們的語法結(jié)構(gòu)，以及軟件的回答信息。 E． 3． 2 外部接口 說明本系統(tǒng)同外界的所有接口的安排包括軟件與硬件之間的接口、本系統(tǒng)與各支持軟件之間的接 口關(guān)系。 E． 3． 3 內(nèi)部接口 說明本系統(tǒng)之內(nèi)的各個系統(tǒng)元素之間的接口的安排。 E． 4 運(yùn)行設(shè)計 E． 4． 1 運(yùn)行模塊組合 說明對系統(tǒng)施加不同的外界運(yùn)行控制時所引起的各種不同的運(yùn)行模塊組合，說明每種運(yùn)行所歷經(jīng)的內(nèi)部模塊和支持軟件。 E． 4． 2 運(yùn)行控制 說明每一種外界 的運(yùn)行控制的方式方法和操作步驟。 E． 4． 3 運(yùn)行時間 說明每種運(yùn)行模塊組合將占用各種資源的時間。 E． 5 系統(tǒng)數(shù)據(jù)結(jié)構(gòu)設(shè)計 E． 5． 1 邏輯結(jié)構(gòu)設(shè)計要點(diǎn) 給出本系統(tǒng)內(nèi)所使用的每個數(shù)據(jù)結(jié)構(gòu)的名稱、標(biāo)識符以及它們之中每個數(shù)據(jù)項、記錄、文卷和系的標(biāo)識、定義、長度及它們之間的層次的或表格的相互關(guān)系。 E． 5． 2 物理結(jié)構(gòu)設(shè)計要點(diǎn) 給出本系統(tǒng)內(nèi)所使用的每個數(shù)據(jù)結(jié)構(gòu)中的每個數(shù)據(jù)項的存儲要求，訪問方法、存取單位、存取的物理關(guān)系（索引、設(shè)備、存儲區(qū)域）、設(shè)計考慮和保密條件。 E． 5． 3 數(shù)據(jù)結(jié)構(gòu)與程序的 關(guān)系 說明各個數(shù)據(jù)結(jié)構(gòu)與訪問這些數(shù)據(jù)結(jié)構(gòu)的形式 : E． 6 系統(tǒng)出錯處理設(shè)計 E． 6． 1 出錯信息 用一覽表的方式說朗每種可能的出錯或故障情況出現(xiàn)時，系統(tǒng)輸出信息的形式、含意及處理方法。 E． 6． 2 補(bǔ)救措施 說明故障出現(xiàn)后可能采取的變通措施，包括： a．后備技術(shù)說明準(zhǔn)備采用的后備技術(shù)，當(dāng)原始系統(tǒng)數(shù)據(jù)萬一丟失時啟用的副本的建立和啟動的技術(shù)， 例如周期性地把磁盤信息記錄到磁帶上去就是對于磁盤媒體的一種后備技術(shù)； b．降效技術(shù)說明準(zhǔn)備采用的后備技術(shù)，使用另一個效率稍低的系統(tǒng)或方法來求得所需結(jié)果的某些部分，例如一個自動系統(tǒng)的降效技術(shù)可以是手工操作和數(shù)據(jù)的人工記錄； c．恢復(fù)及再啟動技術(shù)說明將使用的恢復(fù)再啟動技術(shù)，使軟件從故障點(diǎn)恢復(fù)執(zhí)行或使軟件從頭開始重新運(yùn)行的方法。 E． 6． 3 系統(tǒng)維護(hù)設(shè)計