1 [計算機軟件產(chǎn)品開發(fā)文件資料編制指南設(shè)計]gb8567-88

1、<p>　　計算機軟件產(chǎn)品開發(fā)文件編制指南GB 8567-88  Guidelines for computer software product development documentation </p><p>　　中華人民共和國國家標(biāo)準(zhǔn) UDC681．3</p><p><b>　　引言 <

2、;/b></p><p>　　1 目的   一項計算機軟件的籌劃、研制及實現(xiàn)，構(gòu)成一個軟件開發(fā)項目。一個軟件開發(fā)項目的進行，一般需要 在人力和自動化資源等方面作重大的投資。為了保證項目開發(fā)的成功，最經(jīng)濟地花費這些投資，并且便 于運行和維護，在開發(fā)工作的每一階段，都需要編制二定的文件。這些文件連同計算機程序及數(shù)據(jù)一起， 構(gòu)成為計算機軟件。文件是計算機軟件中不可缺少的組成部分，它的作用是：

3、0;   a．作為開發(fā)人員在一定階段內(nèi)的工作成果和結(jié)束標(biāo)志；    b．向管理人員提供軟件開發(fā)過程中的進展和情況，把軟件開發(fā)過程中的一些“不可見的”事物轉(zhuǎn) 換成“可見的”文字資料。以便管理人員在各個階段檢查開發(fā)計劃的實施進展，使之能夠判斷原定目標(biāo)是 否已達到，還將繼續(xù)耗用資源的種類和數(shù)量；    C．記錄開發(fā)過程中的技術(shù)信息，便于協(xié)調(diào)以后的軟件開發(fā)、使用

4、和修改；    d．提供對軟件的有關(guān)運行、維護和培訓(xùn)的信息，便于管理人員、開發(fā)人員、操作人員和用戶之間相 互了解彼此的工作；    e．向潛在用戶報導(dǎo)軟件的功能和性能，使他們能判定該軟件能否服務(wù)于自己的需要。    換言之，本指南認為：文件的編制必須適應(yīng)計算機軟件整個生存周</p><p>　　2 范圍 

5、本指南是一份指導(dǎo)性文件。本指甫建議，在一項計算機軟件的開發(fā)過程中，一般地說，應(yīng)該產(chǎn)生十四 種文件。這十四種文件是：   可行性研究報告；   項目開發(fā)計劃；   軟件需求說明書；   數(shù)據(jù)要求說明書；   概要設(shè)計說明書；   詳細設(shè)計說明書；   數(shù)據(jù)庫設(shè)計說明書； &#

6、160; 用戶手冊；   操作手冊；   模塊開發(fā)卷宗；   測試計劃；   測試分析報告；   開發(fā)進度月報；    項目開發(fā)總結(jié)報告。   本指南將給出開發(fā)過程中建議產(chǎn)生的這十四種文件的編制指導(dǎo)，同時，本指南也是這十四種文件的 編寫質(zhì)量的檢驗準(zhǔn)則。但是，本指南并未涉及軟件開發(fā)過程中

7、如何填寫工作表格的問題。   一般地說，一個軟件總是一個計算機系統(tǒng)（包括硬件、固件和軟件）的組成部分。鑒于計算機系統(tǒng)的 多樣性，本指南一般不涉及整個系統(tǒng)開發(fā)中的文件編制問題，本指南僅僅是軟件開發(fā)過程中的文件編制指南。 </p><p>　　3 文件的使用者     對于使用文件的人員而言，他們所關(guān)心的文件的種類，隨他們所承擔(dān)的工作而異。  

8、;  管理人員：可行性研究報告，              項目開發(fā)計劃，              模塊開發(fā)卷宗，    

9、          開發(fā)進度月報，              項目開發(fā)總結(jié)報告；     開發(fā)人員：可行性研究報告，     

10、0;        項目開發(fā)計劃，              軟件需求說明書，             

11、數(shù)據(jù)要求說明書，               概要設(shè)計說明書，              詳細設(shè)計說明書，     

12、0;        數(shù)據(jù)庫設(shè)計說明書，              測試計劃，              測

13、試分析報告；    維護人員：設(shè)計說明書，              測試分析報告，              模塊開發(fā)卷宗； &#

14、160;  用戶：用戶手冊，           操作手冊。    盡管本指南提出了在軟件開發(fā)中文件編制的要求，但并不意味著這些文件都必須交給用戶。一項軟件的用戶</p><p><b>　　文件的編制指導(dǎo) </b></p><p>　

15、　4 軟件生存周期與各種文件的編制   一項計算機軟件，從出現(xiàn)一個構(gòu)思之日起，經(jīng)過這項軟件開發(fā)成功投入使用，直到最后決定停止使 用，并被另一一項軟件代替之時止，被認為是該軟件的一個生存周期。一般地說這個軟件生存周期可以分成以下六個階段：可行性與計劃研究階段          需求分析階段   

16、       設(shè)計階段           實現(xiàn)階段           測試階段          運

17、行與維護階段    在可行性研究與計劃階段內(nèi)，要確定該軟件的開發(fā)目標(biāo)和總的要求，要進行可行性分析、投資一收益分析、制訂開發(fā)計劃，并完成應(yīng)編制的文件。   在需求分析階段內(nèi)，由系統(tǒng)分析人員對被設(shè)計的系統(tǒng)進行系統(tǒng)分析，確定對該軟件的各項功能、性能需求和設(shè)計約束，確定對文件編制的要求，作為本階段工作的結(jié)果，一般地說，軟件需求說明書、數(shù)據(jù)要求說明書和初步的用戶手冊應(yīng)該編寫出來。  

18、; 在設(shè)計階段內(nèi)，系統(tǒng)設(shè)計人員和程序設(shè)計人員應(yīng)該在反復(fù)理解軟件需求的基礎(chǔ)上，提出多個設(shè)計，分析每個設(shè)計能履行的功能并進行相互比較，最后確定一個設(shè)計，包括該軟件的結(jié)構(gòu)、模塊的劃分、功能的分配以及處理流程。在被設(shè)計系</p><p>　　5 文件編制中的考慮因素    文件編制是一個不斷努力的工作過程。是一個從形成最初輪廓，經(jīng)反復(fù)檢查和修改，直到程序和文件正式交付使用的完整過程。其中每一步都要求

19、工作人員做出很大努力。要保證文件編制的質(zhì)量，要體現(xiàn)每個開發(fā)項目的特點，也要注意不要花太多的人力。為此，編制中要考慮如下各項因素。 </p><p>　　5．1 文件的讀者    每一種文件都具有特定的讀者。這些讀者包括個人或小組、軟件開發(fā)單位的成員或社會上的公眾、從事軟件工作的技術(shù)人員、管理人員或領(lǐng)導(dǎo)干部。他們期待著使用這些文件的內(nèi)容來進行工作，例如設(shè)計、編寫程序、測試、使用、維護

20、或進行計劃管理。因此，這些文件的作者必須了解自己的讀者，這些文件的編寫必須注意適應(yīng)自己的特定讀者的水平、特點和要求。 </p><p>　　5．2 重復(fù)性    本指南第二篇中將列出的這十四種文件的內(nèi)容要求中，顯然存在某些重復(fù)。較明顯的重復(fù)有兩類。引言是每一種文件都要包含的內(nèi)容，以向讀者提供總的梗概。第二類明顯的重復(fù)是各種文件中的說明部分，如對功能性能的說明、對輸入和輸出的描述、系

21、統(tǒng)中包含的設(shè)備等。這是為了方便每種文件各自的讀者，每種產(chǎn)品文件應(yīng)該自成體系，盡量避免讀一種文件時又不得不去參考另一種文件。當(dāng)然，在每一種文件里，有關(guān)引言、說明等同其他文件相重復(fù)的部分，在行文上、在所用的術(shù)語上、在詳細的程度上，還是應(yīng)該有一些差別，以適應(yīng)各種文件的不同讀者的需要。</p><p>　　5．3 靈活性    鑒于軟件開發(fā)是具有創(chuàng)造性的腦力勞動，也鑒于不同軟件在規(guī)模上和復(fù)

22、雜程度上差別極大，本指南認為在文件編制工作中應(yīng)允許一定的靈活性。這種靈活性表現(xiàn)在如下各款。</p><p>　　5．3．1 應(yīng)編制的文件種類    盡管本指南認為在一般情況下，一項軟件的開發(fā)過程中，應(yīng)產(chǎn)生的文件有十四種，然而針對一項具體的軟件開發(fā)項目，有時不必編制這么多的文件，可以把幾種文件合并成一種。一般地說，當(dāng)項目的規(guī)模、復(fù)雜性和成敗風(fēng)險增大時，文件編制的范圍、管理手續(xù)和詳細程度將隨之

23、增加。反之，則可適當(dāng)減少。為了恰當(dāng)?shù)卣莆者@種靈活性，本指南要求貫徹分工負責(zé)的原則，這意味著：   a: 一個軟件開發(fā)單位的領(lǐng)導(dǎo)機構(gòu)應(yīng)該根據(jù)本單位經(jīng)營承包的應(yīng)用軟件的專業(yè)領(lǐng)域和本單位的管理能力，制定一個對文件編制要求的實施規(guī)定，主要是：在不同的條件下，應(yīng)該形成哪些文件？這些文件的詳細程度？該開發(fā)單位的每一個項目負責(zé)人，必須認真執(zhí)行這個實施規(guī)定。這種規(guī)定的兩個例子可嘆 本指南的附錄o（參考件）；  

24、; b．對于一個具體的應(yīng)用軟件項目，項目負責(zé)人應(yīng)根據(jù)上述實施規(guī)定，確定一個文件編制計劃，主 中包括:  (1)應(yīng)該編制哪幾種文件，詳細程度如何？ （2）各個文件的編制負責(zé)人和進度要求； （3）審查、批準(zhǔn)的負責(zé)人和時間進度安排；  （4）在開發(fā)時期內(nèi)，各文件的維護、修改和管理的負責(zé)人，以及批準(zhǔn)手續(xù)。   每項</p><p>　　5．3．2 文件的詳細程度

25、   從同一份提綱起草的文件的篇幅大小往往不同，可以少到幾頁，也可以長達幾百頁。對于這種差別本指南是允許的。此詳細程度取決于任務(wù)的規(guī)模、復(fù)雜性和項目負責(zé)人對該軟件的開發(fā)過程及運行環(huán)與所需要的詳細程度的判斷。</p><p>　　5．3．3 文件的擴展    當(dāng)被開發(fā)系統(tǒng)的規(guī)模非常大（例如源碼超過一百萬行）時，一種文件可以分成幾卷編寫，可以按其。 每一個系統(tǒng)分別編制，也可

26、以按內(nèi)容劃分成多卷，例如：   項目開發(fā)計劃可能包括：質(zhì)量保證計劃，                         配置管理計劃，    &#

27、160;                     用戶培訓(xùn)計劃，               &#

28、160;          安裝實施計劃；   系統(tǒng)設(shè)計說明書可分寫成：系統(tǒng)設(shè)計說明書，                    

29、;       子系統(tǒng)設(shè)計說明書；    程序設(shè)計說明書可分寫成：程序設(shè)計說明書，                       

30、;    接口設(shè)計說明書，                           版本說明；   操作手冊可分寫成：操作手冊，

31、                     安裝實施過程； ．測試計劃可分寫成：測試計劃，           

32、60;         測試設(shè)計說明，                      測試規(guī)程，     &#

33、160;        </p><p>　　5．3．4 節(jié)的擴張與縮并   在有些文件中，可以使用本指南所提供的章、條標(biāo)題，但在條內(nèi)又存在一系列需要分別討論的因素 本指南認為，所有的條都可以擴展，可以進一步細分，以適應(yīng)實際需要。反之，如果章條中的有些細節(jié)； 非必需，也可以根據(jù)實際情況縮并。此時章條的編號應(yīng)相應(yīng)地

34、改變。</p><p>　　5．3．5 程序設(shè)計的表現(xiàn)形式    本指南對于程序的設(shè)計表現(xiàn)形式并未作出規(guī)定或限制，可以使用流程圖的形式、判定表的形式，1 可以使用其他表現(xiàn)形式，如程序設(shè)計語言（PDL）、問題分析圖（PAD）等。 </p><p>　　5．3．6 文件的表現(xiàn)形式    本指南對于文件的表現(xiàn)形式亦未作出規(guī)定或限制，可以使用自然語言，也

35、可以使用形式化語言。</p><p>　　5．3．7 文件的其他種類    當(dāng)本指南中規(guī)定的文件種類尚不能滿足某些應(yīng)用部門的特殊需要時，他們可以建立一些特殊的文件種類要求，例如軟件質(zhì)量保證計劃、軟件配置管理計劃等，這些要求可以包含在本單位的文件編制實施規(guī)定中。</p><p>　　6 文件編制的管理工作    文件編制工作必須有管理工作

36、的配合，才能使所編制的文件真正發(fā)揮它的作用。文件的編制工作實際上貫穿于一項軟件的整個開發(fā)過程，因此，對文件的管理必須貫穿于整個開發(fā)過程。在開發(fā)過程中必須進行的管理工作是以下四條。</p><p>　　6．1文件的形成     開發(fā)集體中的每個成員，尤其是項目負責(zé)人，應(yīng)該認識到：文件是軟件產(chǎn)品的必不可少的組成部分；在軟件開發(fā)過程的各個階段中，必須按照規(guī)定及時地完成各種產(chǎn)品文件的編寫工

37、作；必須把在一個開發(fā)步驟中作出的決定和取得的結(jié)果及時地寫入文件；開發(fā)集體必須及時地對這些文件進行嚴格的評審；這些文件的形成是各個階段開發(fā)工作正式完成的標(biāo)志。這些文件上必須有編寫者、評審者和批準(zhǔn)者的簽字，必須有編寫、評審?fù)瓿傻娜掌诤团鷾?zhǔn)的日期。</p><p>　　6．2文件的分類與標(biāo)識     在軟件開發(fā)的過程中，產(chǎn)生的文件是很多的，為了便于保存、查找、使用和修改，應(yīng)該對文件按層次

38、地加以分類組織。一個軟件開發(fā)單位應(yīng)該建立一個對本單位文件的標(biāo)識方法，使文件的每一頁都具有明確的標(biāo)識。例如可以按如下四個層次對文件加以分類和標(biāo)識。     a．文件所屬的項目的標(biāo)識；     b．文件種類的標(biāo)識；     C．同一種文件的不同版本號；    d．頁號。    此外，

39、對每種文件還應(yīng)根據(jù)項目的性質(zhì)，劃定它們各自的保密級別，確定他們各自的發(fā)行范圍。</p><p>　　6．3文件的控制    在一項軟件的開發(fā)過程中，隨著程序的逐步形成和逐步修改，各種文件亦在不斷地產(chǎn)生、不斷地修改或補充。因此，必須加以周密的控制，以保持文件與程序產(chǎn)品的一致性，保持各種文件之間的一致性和文件的安全性。這種控制表現(xiàn)為：    a．就從事一項軟件開發(fā)

40、工作的開發(fā)集體而言，應(yīng)設(shè)置一位專職的文件管理人員（接口管理工程師或文件管理員）；在開發(fā)集體中，應(yīng)該集中保管本項目現(xiàn)有全部文件的主文本兩套，由該文件管理人員負責(zé)保管；    b．每一份提交給文件管理人員的文件都必須具有編寫人、審核人和批準(zhǔn)人的簽字；    C．這兩套主文本的內(nèi)容必須完全一致；其中有一套是可供出借的，另一套是絕對不能出借的，以免發(fā)生萬一；可出借的主文本在出借時必

41、須辦理出借手續(xù)，歸還時辦理注銷出借手續(xù)；     d．開發(fā)集體中的工作人員可以根據(jù)工作的需要，在本項目的開發(fā)過程中持有一些文件，即所謂個人文件，包括為使他完成他承擔(dān)的任務(wù)所需要的文件，以及他在完成任務(wù)過程中所編制的文件；但這種個人文件必須是主文本的復(fù)制品，必須同主文本完全一致，若要修改，必須首先修改主文本；    e．不同開發(fā)人員所擁有的個人文件通</p>&

42、lt;p>　　6．4文件的修改管理    在一個項目的開發(fā)過程中的任何時刻，開發(fā)集體內(nèi)的所有成員都可能對開發(fā)工作的已有成果—— 文件，提出進行修改的要求。提出修改要求的理由可能是各種各樣的，進行修改而引起的影響可能很小， 也可能會牽涉到本項目的很多方面。因此，修改活動的進行必須謹慎，必須對修改活動的進行加以管理， 必須執(zhí)行修改活動的規(guī)程，使整個修改活動有控制地進行。  

43、0; 修改活動可分如下五個步驟進行：    a．提議開發(fā)集體中的任何一個成員都可以向項目負責(zé)人提出修改建議，為此應(yīng)該填寫一份修 改建議表，說明修改的內(nèi)容、所修改的文件和部位、以及修改理由；    b．評議由項目負責(zé)人或項目負責(zé)人指定的人員對該修改建議進行評議，包括審查該項修改的 必要性、確定這一修改的影響范圍、研究進行修改的方法、步驟和實施計劃；  &

44、#160; c．審核一般由項目負責(zé)人進行審核，包括核實修改的自的和要求、核實修改活動將帶來的影 響、審核修改活動計劃是否可行；    d．批準(zhǔn)在一般情況下，批準(zhǔn)權(quán)屬于該開發(fā)單位的部門負責(zé)人；在批準(zhǔn)時，主要是決斷修改工作 中各項活動的先后順序及各自的完成日期，以保證整個開發(fā)工作按原定計劃日</p><p>　　第二篇 各種文件的內(nèi)容要求     本篇將

45、對引言中提到的十四種文件提供內(nèi)容要求，作為文件編制的技術(shù)標(biāo)準(zhǔn)。</p><p>　　7 可行性研究報告     可行性研究報告的編寫目的是：說明該軟件開發(fā)項目的實現(xiàn)在技術(shù)、經(jīng)濟和社會條件方面的可行 性；評述為了合理地達到開發(fā)目標(biāo)而可能選擇的各種方案；說明并論證所選定的方案。    可行性研究報告的編寫內(nèi)容要求如下： 7．1引言 

46、;7．1C1編寫目的  7．1．2背景  7．1．3定義  7．1．4參考資料 7 7．2可行性研究的前提 7．2．1要求 7．2．2目標(biāo)  7．2．3條件、假定和限制 7．2．4進行可行性研究的方法 7．2．5評價尺度  7．3對現(xiàn)有系統(tǒng)的分析  7．3．1數(shù)據(jù)流程和處理流程 7．3．2工作負

47、荷  7．3．3費用開支 7．3．4人員  7．3．5設(shè)備  7．3．6局限性  7．4所建議的系統(tǒng)  7．4．1對所建議系統(tǒng)的說明  7．4．2數(shù)據(jù)流程和處理流程  7．4．3改進之處  7．4．4影響  7．4．4．1對設(shè)備的影響  7．4．4．2對軟件的影響  7．4．4．3對用戶單位機構(gòu)

48、的影響 7．4．4．4對系統(tǒng)運行的影響 7．4．4．5對開發(fā)的影響 7．4，4．6對地點和設(shè)施的影響 </p><p>　　8 項目開發(fā)計劃   編制項目開發(fā)計劃的目的是用文件的形式，把對于在開發(fā)過程中各項工作的負責(zé)人員、開發(fā)進度、 所需經(jīng)費預(yù)算、所需軟、硬件條件等問題作出的安排記載下來，以便根據(jù)本計劃開展和檢查本項目的開 發(fā)工作。編制內(nèi)容要求如下： 

49、8．1引言  8．1．1編寫目的  8．1．2背景  8．1．3定義  8．1．4參考資料   8．2項目概述  8．2．1作內(nèi)容  8．2．2主要參加人員  8．2．3產(chǎn)品及成果   8．2．3．1程序   8．2．3．2文件  8．2．3．3服務(wù)   8．2．3．4非移交產(chǎn)品 

50、8．2．4驗收標(biāo)準(zhǔn)   8．．2．5完成項目的最遲期限   8．2．6本計劃的審查者與批準(zhǔn)者   8．3實施總計劃  8．3．1工作任務(wù)的分解   8．3．2接口人員  8．3．3進度  8．3．4預(yù)算  8．3．5關(guān)鍵問題  8．4支持條件   8．4．1計算機系統(tǒng)支持  8．4．2需要用戶承擔(dān)的工作&

51、#160; 8．4．3需由外單位提供的條件  8．5專題計劃要點 </p><p>　　9 軟件需求說明書   軟件需求說明書的編制是為了使用戶和軟件開發(fā)者雙方對該軟件的初始規(guī)定有一個共同的理解， 使之成為整個開發(fā)工作的基礎(chǔ)。編制軟件需求說明書的內(nèi)容要求如下：  9．1引言  9．1．1編寫目的   9．1．2背景   9．1．3定

52、義   9．1．4參考資料   9．2任務(wù)概述  9．2．1目標(biāo)  9．2．2用戶的特點   9．2．3假定與約束   9．3需求規(guī)定  9．3．1對功能的規(guī)定  9．3．2對性能的規(guī)定   9．3．2．1精度   9．3．2．2時間特性耍求  9．3．2．3靈活性   9．3．3輸入輸出要求

53、  9．3．4數(shù)據(jù)管理能力要求  9．3．5故障處理要求  9．3．6其他專門要求  9．4運行環(huán)境規(guī)定   9．4．1設(shè)備   9．4．2支持軟件   9．4．3接口   9．4．4控制 </p><p>　　10 數(shù)據(jù)要求說明書    數(shù)據(jù) 要求說明書的編制目的是為了向整個開發(fā)時期提供關(guān)于被處理

54、數(shù)據(jù)的描述和數(shù)據(jù)采集要求的 技術(shù)信息。編制數(shù)據(jù)要求說明書的內(nèi)容要求如下：   10．1引言    10．1．1編寫目的   10．1．2背景    10．1．3定義    10．1．4參考資料    10．2數(shù)據(jù)的邏輯描述   10．2．1靜態(tài)數(shù)據(jù)    10．2

55、．2動態(tài)輸入數(shù)據(jù)    10．2．3動態(tài)輸出數(shù)據(jù)    10．2．4內(nèi)部生成數(shù)據(jù)   10．2．5數(shù)據(jù)約定   10．3數(shù)據(jù)的采集    10．3．1要求和范圍    10．3．2輸入的承擔(dān)者    10．3．3處理    10．3．4影響。</p>

56、<p>　　11 概要設(shè)計說明書    概要設(shè)計說明書又可稱系統(tǒng)設(shè)計說明書，這里所說的系統(tǒng)是指程序系統(tǒng)。編制的目的是說明對程序 系統(tǒng)的設(shè)計考慮，包括程序系統(tǒng)的基本處。流程、程序系統(tǒng)的組織結(jié)構(gòu)、模塊劃分、功能分配、接口設(shè)計。 運行設(shè)計、數(shù)據(jù)結(jié)構(gòu)設(shè)計和出錯處理設(shè)計等，為程序的詳細設(shè)計提供基礎(chǔ)。編制概要設(shè)計說明書的內(nèi)容 要求如下：   11．1引言    11．1．

57、1編寫目的    11．1．2背景   11．1．3定義    11．1．4參考資料    11．2總體設(shè)計    11．2．1需求規(guī)定   11．2．2運行環(huán)境    11．2．3基本設(shè)計概念和處理流程   11．2．4結(jié)構(gòu)    11．2

58、．5功能需求與程序的關(guān)系    11．2．6人工處理過程    11．2．7尚未解決的問題    11．3接口設(shè)計    11．3．1用戶接口    11．3．2外部接口    11．3．3內(nèi)部接口   11．4運行設(shè)計   11．4．1運行模塊組合  

59、;  11．4．2運行控制   11．4．3運行時間   11．5系統(tǒng)論據(jù)結(jié)構(gòu)設(shè)計   11．5．1邏輯結(jié)構(gòu)</p><p>　　12詳細設(shè)計說明書    詳細設(shè)計說明書又可稱程序設(shè)計說明書。編制目的是說明一個軟件系統(tǒng)各個層次中的每一個程序 （每個模塊或子程序）的設(shè)計考慮，如果一個軟件系統(tǒng)比較簡單，層次很少，本文件可

60、以不單獨編寫，有關(guān) 內(nèi)容合并入概要設(shè)計說明書。對詳細設(shè)計說明書的內(nèi)容要求如下：   12．1引言   12．1．1編寫目的   12．1．2背景    12．1．3定義    12．1．4參考資料    12．2程序系統(tǒng)的組織結(jié)構(gòu)   12． 3程序1（標(biāo)識符）設(shè)計說明  

61、  12．3．1程序描述   12．3．2功能   12．3．3性能    12．3．4輸入項    12．3．5輸出項    12．3．6算法   12．3．7流程邏輯   12．3．8接口    12．3．．9存儲分配   12

62、．3．10注釋設(shè)計   12．3．11限制條件   12．3．12測試計劃．   12．3．13尚未解決的問題   12．4程序2（標(biāo)識符）設(shè)計說明     ．．．．．． 13 數(shù)據(jù)庫設(shè)計說明書    數(shù)據(jù)庫設(shè)計說明書的編制目的是對于設(shè)計中的數(shù)據(jù)庫的所有</

63、p><p>　　15 操作手冊   操作手冊的編制是為了向操作人員提供該軟件每一個運行的具體過程和有關(guān)知識，包括操作方法的細節(jié)。具體的內(nèi)容要求如下：  15．1引言   15．1．1編寫目的  15．1．2背景   15．1．3定義   15．1．4參考資料  15． 2軟件概述  15．2．1軟件的結(jié)構(gòu) &#

64、160; 15．2．2程序表  15．2．3文卷表   15．3安裝與初始化   15．4運行說明   15．4．1運行表  15．4．2運行步驟   15．4．3運行1（標(biāo)識符）說明  15．4．3．1運行控制   15．4．3．2操作信息   15．4．3．3輸入一輸出文卷  15．4．3．4輸出文段 

65、 15．4．3．5輸出文段的復(fù)制  15．4．3．6啟動恢復(fù)過程  15．4．4運行2（標(biāo)識符）說明      ．．．．．．   15．5非?，F(xiàn)過程   15．6遠程操作 </p><p>　　16 模塊開發(fā)卷宗    模塊開發(fā)卷宗是在模塊開發(fā)過程中逐步編寫出來的，每完成一個模塊或一組密切相關(guān)的模塊的

66、復(fù)審時編寫一份，應(yīng)該把所有的模塊開發(fā)卷宗匯集在一起。編寫的目的是記錄和匯總低層次開發(fā)的進度和結(jié)果，以便于對整個模塊開發(fā)工作的管理和復(fù)審，并為將來的維護提供非常有用的技術(shù)信息。具體的內(nèi)容要求如下：   16． 1標(biāo)題   16．2模塊開發(fā)情況表（見下表）            

67、;            模塊開發(fā)情況表          </p><p>　　16．3功能說明 16．4設(shè)計說明 16．5源代碼清單  16．6測試說明 16．7復(fù)審的結(jié)論

68、17測試計劃  這里所說的測試，主要是指整個程序系統(tǒng)的組裝測試和確認測試。本文件的編制是為了提供一個對該軟件的測試計劃，包括對每項測試活動的內(nèi)容、進度安排、設(shè)計考慮、測試數(shù)據(jù)的整理方法及評價準(zhǔn)則。具體的內(nèi)容要求如下：   17．1引言   17．1．1編寫目的   17．1．2背景    17．1．3定義   

69、 17．1．4參考資料   17． 2計劃    17．2．1軟件說明    17．2．2測試內(nèi)容   17．2．3測試1（標(biāo)識符）   17．2．3．1進度安排    17．2．3．2條件    17．2．3．3測試資料   17．2．3．4測試培訓(xùn) 

70、0;  17．2．4測試2（標(biāo)識符）      ．．．．．．   17．3測試設(shè)計說明    17．3．1測試l（標(biāo)識符）    17．3．1．1控制    17．3．1．2輸入    17．3．1．3輸出    17．3．1．4過程 

71、0;  17．3．2測試2（標(biāo)識符）     </p><p>　　18 測試分析報告 測試分析報告的編寫是為了把組裝測試和確認測試的結(jié)果、發(fā)現(xiàn)及分析寫成文件加以記載，具體的內(nèi)容要求如下：    18．1引言     18．1．1編寫目的    

72、 18．1．2背景     18．1．3定義     18．1．4參考資料    18．2測試概要    18．3測試結(jié)果及發(fā)現(xiàn)     18．3．1測試1（標(biāo)識符）     18．3．2測試2（標(biāo)識符）   

73、60;    ．．．．．．    18．4對軟件功能的結(jié)論    18．4．1功能1（標(biāo)識符）    18．4．1．1能力     18．4．1．2限制     18．4．2功能2（標(biāo)識符）    18．5分析摘要

74、    18．5．1能力     18．5．2缺陷和限制    18．5．3建議    18．5．4評價     18．6測試資源消耗</p><p>　　19 開發(fā)進度月報     開發(fā)進度月報的編制目的是及時向有關(guān)管理部門

75、匯報項目開發(fā)的進展和情況，以便及時發(fā)現(xiàn)和處 理開發(fā)過程中出現(xiàn)的問題。一般地，開發(fā)進度月報是以項目組為單位每月編寫的。如果被開發(fā)的軟件系 統(tǒng)規(guī)模比較大，整個工程項目被劃分給若干個分項目組承擔(dān)，開發(fā)進度月報將以分項目組為單位按月編 寫。具體的內(nèi)容要求如下：     19．1標(biāo)題    19．2工程進度與狀態(tài)     19．2．1進度 

76、   19．2．2狀態(tài)    19．3資源耗用與狀態(tài)     19．3．1資源耗用     19．3．1．1工時    19．3．1．2機時    19．3．2狀態(tài)    19．4經(jīng)費支出與狀態(tài)  

77、0; 19．4．1經(jīng)費支出    19．4．1．1支持性費用    19．4．1．2設(shè)備購置費     19．4．2狀態(tài)    19．5下個月的工作計劃     19．6建議</p><p>　　20 項目開發(fā)總結(jié)報告   

78、 項目開發(fā)總結(jié)報告的編制是為了總結(jié)本項目開發(fā)工作的經(jīng)驗，說明實際取得的開發(fā)結(jié)果以及對整個開發(fā)工作的各個方面的評價。具體的內(nèi)容要求如下：   20．1引言    20．1．1編寫目的    20．1．2背景    20．1．3定義    20．1．4參考資料   20．2．1產(chǎn)品   

79、20．2實際開發(fā)結(jié)果   20．2．2主要功能和性能   20．2．3基本流程    20．2．4進度    20．2．5費用    20．3開發(fā)工作評價    20．3．1對生產(chǎn)效率的評價   20．3．2對產(chǎn)品質(zhì)量的評價    20．3．3對技術(shù)方法的評價

80、   20．3．4出錯原因的分析   20．4經(jīng)驗與教訓(xùn) </p><p><b>　　附錄A </b></p><p>　　可行性研究報告的編寫提示（參考件） A．1引言   A．1．1編寫目的 說明編寫本可行性研究報告的目的，指出預(yù)期的讀者。  A．1．2背景   

81、60;  說明：     a．所建議開發(fā)的軟件系統(tǒng)的名稱；     b．本項目的任務(wù)提出者、開發(fā)者、用戶及實現(xiàn)該軟件的計算中心或計算機網(wǎng)絡(luò)；     C．該軟件系統(tǒng)同其他系統(tǒng)或其他機構(gòu)的基本的相互來往關(guān)系。 A．1．3定義      列出本文件中用到

82、的專門術(shù)語的定義和外文首字母組詞的原詞組。 A．1．4參考資料     列出用得著的參考資料，如：    a．本項目的經(jīng)核準(zhǔn)的計劃任務(wù)書或合同、上級機關(guān)的批文；    b．屬于本項目的其他已發(fā)表的文件；    C．本文件中各處引用的文件、資料，包括所需用到的軟件開發(fā)標(biāo)準(zhǔn)。|  

83、  列出這些文件資料的標(biāo)題、文件編號、發(fā)表日期和出版單位，說明能夠得到這些文件資料的來源。</p><p>　　A．2可行性研究的前提    說明對所建議的開發(fā)項目進行可行性研究的前提，如要求、目標(biāo)、假定、限制等。  A．2．1要求    說明對所建議開發(fā)的軟件的基本要求，如：    a．功能；

84、    b．性能；    C．輸出如報告、文件或數(shù)據(jù)，對每項輸出要說明其特征，如用途、產(chǎn)生頻度、接口以及分發(fā)對象；          d．輸入說明系統(tǒng)的輸入，包括數(shù)據(jù)的來源、類型、數(shù)量、數(shù)據(jù)的組織以及提供的頻度；    e．處理流程和數(shù)據(jù)流程用圖表的方式表示出最基

85、本的數(shù)據(jù)流程和處理流程，并輔之以敘述；    f．在安全與保密方面的要求；    g．同本系統(tǒng)相連接的其他系統(tǒng)；    h．完成期限。  A．2．2目標(biāo)     說明所建議系統(tǒng)的主要開發(fā)目標(biāo)，如：    a．人力與設(shè)備費用的減少；   

86、 b．處理速度的提高；    C．控制精度或生產(chǎn)能力的提高；    d．管理信息服務(wù)的改進；    e．自動決策系統(tǒng)的改進；    f．人員利用率的改進。   A．2．3條件、假定和限制    說明對這項開發(fā)中給出的條件、假定和所受到的限制，如： 

87、0;  a．所建議系統(tǒng)的運</p><p>　　A．3 對現(xiàn)有系統(tǒng)的分析    這里的現(xiàn)有系統(tǒng)是指當(dāng)前實際使用的系統(tǒng)，這個系統(tǒng)可能是計算機系統(tǒng)，也可能是一個機械系統(tǒng)甚 至是一個人工系統(tǒng)。    分析現(xiàn)有系統(tǒng)的目的是為了進一步闡明建議中的開發(fā)新系統(tǒng)或修改現(xiàn)有系統(tǒng)的必要性。  A．3．1處理流程和數(shù)據(jù)流程  &

88、#160; 說明現(xiàn)有系統(tǒng)的基本的處理流程和數(shù)據(jù)流程。此流程可用圖表即流程圖的形式表示，并加以敘述。 A．3．2工作負荷     列出現(xiàn)有系統(tǒng)所承擔(dān)的工作及工作量。 A．3．3費用開支    列出由于運行現(xiàn)有系統(tǒng)所引起的費用開支，如人力、設(shè)備、空間、支持性服務(wù)、材料等項開支以及開 支總額。 A．3．4人員   

89、0; 列出為了現(xiàn)有系統(tǒng)的運行和維護所需要的人員的專業(yè)技術(shù)類別和數(shù)量。 A．3．5設(shè)備     列出現(xiàn)有系統(tǒng)所使用的各種設(shè)備。 A．3．6局限性    列出本系統(tǒng)的主要的局限性，例如處理時間趕不上需要，響應(yīng)不及時，數(shù)據(jù)存儲能力不足，處理功能 不夠等。并且要說明，為什么對現(xiàn)有系統(tǒng)的改進性維護已經(jīng)不能解決問題。</p><p>　

90、　A．4 所建議的系統(tǒng)    本章將用來說明所建議系統(tǒng)的目標(biāo)和要求將如何被滿足。 A．4．1對所建議系統(tǒng)的說明    概括地說明所建議系統(tǒng)，并說明在第A．2章中列出的那些要求將如何得到滿足，說明所使用的基本 方法及理論根據(jù)。  A．4．2處理流程和數(shù)據(jù)流程    給出所建議系統(tǒng)的處理流程和數(shù)據(jù)流程。 A．4

91、．3改進之處     按A．2．2條中列出的目標(biāo)，逐項說明所建議系統(tǒng)相對于現(xiàn)存系統(tǒng)具有的改進。 A．4．4影響    說明在建立所建議系統(tǒng)時，預(yù)期將帶來的影響，包括： A．4．4．1對設(shè)備的影響     說明新提出的設(shè)備要求及對現(xiàn)存系統(tǒng)中尚可使用的設(shè)備須作出的修改。 A．4．4．2對軟件的影響  

92、;   說明為了使現(xiàn)存的應(yīng)用軟件和支持軟件能夠同所建議系統(tǒng)相適應(yīng)。而需要對這些軟件所進行的修 改和補充。 A．4．4．3對用戶單位機構(gòu)的影響     說明為了建立和運行所建議系統(tǒng)，對用戶單位機構(gòu)、人員的數(shù)量和技術(shù)水平等方面的全部要求。 A． 4． 4． 4對系統(tǒng)運行過程的影響     說明所建議系統(tǒng)對運行過程的影響，如：

93、60;   a．用戶的操作規(guī)程；    </p><p>　　A．5可選擇的其他系統(tǒng)方案    扼要說明曾考慮過的每一種可選擇的系統(tǒng)方案，包括需開發(fā)的和可從國內(nèi)國外直接購買的，如果沒 有供選擇的系統(tǒng)方案可考慮，則說明這一點。  A．5．1可選擇的系統(tǒng)方案1    參照第A．4章的提綱，說明可選擇的系統(tǒng)方案1

94、，并說明它未被選中的理由。 A．5．2可選擇的系統(tǒng)方案2    按類似A． 5． 1條的方式說明第2個乃至第。個可選擇的系統(tǒng)方案。    ．．．．．．</p><p>　　A．6投資及效益分析  A．6．1支出   對于所選擇的方案，說明所需的費用。如果已有一個現(xiàn)存系統(tǒng)，則包括該系統(tǒng)繼續(xù)運行期間所需的費用。 &

95、#160;A．6．1．1基本建設(shè)投資   包括采購、開發(fā)和安裝下列各項所需的費用，如：    a．房屋和設(shè)施；   b． A DP設(shè)備；    C．?dāng)?shù)據(jù)通訊設(shè)備；   d．環(huán)境保護設(shè)備；   e．安全與保密設(shè)備；   f．ADP操作系統(tǒng)的和應(yīng)用的軟件；    g．

96、數(shù)據(jù)庫管理軟件。 A．6．1．2其他一次性支出   包括下列各項所需的費用，如：   a．研究（需求的研究和設(shè)計的研究）；   b．開發(fā)計劃與測量基準(zhǔn)的研究；   C．?dāng)?shù)據(jù)庫的建立；   d．ADP軟件的轉(zhuǎn)換；   e．檢查費用和技術(shù)管理性費用；   f．培訓(xùn)費、旅差費以及

97、開發(fā)安裝人員所需要的一次性支出；    g．人員的退休及調(diào)動費用等。 A．6．1．3非一次性支出   列出在該系統(tǒng)生命期內(nèi)按月或按季或按年支出的用于運行和維護的費用，包括：    a．設(shè)備的租金和維護費用；    b軟件的租金和維護費用；   C．?dāng)?shù)據(jù)通訊方面的租金和維護費用； </p>&

98、lt;p>　　A．7 社會因素方面的可行性    本章用來說明對社會因素方面的可行性分析的結(jié)果，包括： A．7．1法律方面的可行性    法律方面的可行性問題很多，如合同責(zé)任、侵犯專利權(quán)、侵犯版權(quán)等方面的陷井，軟件人員通常是不熟悉的，有可能陷入，務(wù)必要注意研究。 A．7．2使用方面的可行性    例如從用戶單位的行政管理、工作制度等方面來看，

99、是否能夠使用該軟件系統(tǒng)；從用戶單位的工作人員的素質(zhì)來看，是否能滿足使用該軟件系統(tǒng)的要求等等，都是要考慮的。</p><p>　　A．8 結(jié)論   在進行可行性研究報告的編制時，必須有一個研究的結(jié)論。結(jié)論可以是：   a．可以立即開始進行；   b．需要推遲到某些條件（例如資金、人力、設(shè)備等）落實之后才能開始進行；   c．需

100、要對開發(fā)目標(biāo)進行某些修改之后才能開始進行；   d．不能進行或不必進行（例如因技術(shù)不成熟、經(jīng)濟上不合算等）。</p><p>　　附錄B項目開發(fā)計劃的編寫提示  </p><p>　　B．1引言 B．1．1編寫目的    說明編寫這份項目開發(fā)計劃的目的，并指出預(yù)期的讀者。 B．1．2背景 

101、0; 說明：   a．待開發(fā)的軟件系統(tǒng)的名稱；   b．本項目的任務(wù)提出者、開發(fā)者、用戶及實現(xiàn)該軟件的計算中心或計算機網(wǎng)絡(luò)；   C．該軟件系統(tǒng)同其他系統(tǒng)或其他機構(gòu)的基本的相互來往關(guān)系。 B．1．3定義    列出本文件中用到的專門術(shù)語的定義和外文首字母組詞的原詞組。 B．1．4參考資料   列出用得著的

102、參考資料，如：   a．本項目的經(jīng)核準(zhǔn)的計劃任務(wù)書或合同、上級機關(guān)的批文；   b．屬于本項目的其他已發(fā)表的文件；   C．本文件中各處引用的文件、資料，包括所要用到的軟件開發(fā)標(biāo)準(zhǔn)。 列出這些文件資料的標(biāo)題、文件編號、發(fā)表日期和出版單位，說明能夠得到這些文件資料的來源。</p><p>　　B．2項目概述   B．2．1 工作內(nèi)容&

103、#160;  簡要地說明在本項目的開發(fā)中須進行的各項主要工作。  B．2．2主要參加人員   扼要說明參加本項目開發(fā)工作的主要人員的情況，包括他們的技術(shù)水平。  B．2．3產(chǎn)品  B．2．31程序   列出需移交給用戶的程序的名稱、所用的編程語言及存儲程序的媒體形式，并通過引用有關(guān)文件， 逐項說明其功能和能力。   B．2．3．2文件

104、   列出需移交給用戶的每種文件的名稱及內(nèi)容要點。   B．2．3．3服務(wù)   列出需向用戶提供的各項服務(wù)，如培訓(xùn)安裝、維護和運行支持等，應(yīng)逐項規(guī)定開始日期、所提供支持 的級別和服務(wù)的期限。  B．2．3．4非移交的產(chǎn)品    說明開發(fā)集體應(yīng)向本單位交出但不必向用戶移交的產(chǎn)品（文件甚至某些程序）。  B．2．4驗收標(biāo)準(zhǔn)  &#

105、160; 對于上述這些應(yīng)交出的產(chǎn)品和服務(wù)，逐項說明或引用資料說明驗收標(biāo)準(zhǔn)。  B．2．5完成項目的員遲用限   B．2．6本計劃的批準(zhǔn)者和批準(zhǔn)日期 </p><p>　　B．3實施計劃   B．3．1工作任務(wù)的分門與人員分工    對于項目開發(fā)中需完成的各項工作，從需求分析、設(shè)計、實現(xiàn)、測試直到維護，包括文件的編制、審批、打印、分發(fā)工作，用戶培訓(xùn)工作，軟

106、件安裝工作等，按層次進行分解，指明每項任務(wù)的負責(zé)人和參加人員。  B．3．2 接口人員    說明負責(zé)接口工作的人員及他們的職責(zé)，包括：    a ．負責(zé)本項目同用戶的接口人員；    b．負責(zé)本項目同本單位各管理機構(gòu)，如合同計劃管理部門、財務(wù)部門、質(zhì)量管理部門等的接口人員；     &#

107、160; c．負責(zé)本項目同各分合同負責(zé)單位的接口人員等。   B．3．3進度     對于需求分析、設(shè)計、編碼實現(xiàn)、測試、移交、培訓(xùn)和安裝等工作，給出每項工作任務(wù)的預(yù)。定開始日期、完成日期及所需資源，規(guī)定各項工作任務(wù)完成的先后順序以及表征每項工作任務(wù)完成的標(biāo)志性事件（即所謂“里程碑”）。   B．3．4預(yù)算     逐項列出本開發(fā)項目所需要的勞務(wù)（包

108、括人員的數(shù)量和時間）以及經(jīng)費的預(yù)算（包括辦公費、差旅費、機時費、資料費、通訊設(shè)備和專用設(shè)備的租金等）和來源。  B．3．5關(guān)鍵問題     逐項列出能夠影響</p><p>　　B．4支持條件  說明為支持本項目的開發(fā)所需要的各種條件和設(shè)施。  B．4．1計算機系統(tǒng)支持     逐項列出開發(fā)中和

109、運行時所需的計算機系統(tǒng)支持，包括計算機、外圍設(shè)備、通訊設(shè)備、模擬器、編譯 （或 匯編）程序、操作系統(tǒng)、數(shù)據(jù)管理程序包、數(shù)據(jù)存儲能力和測試支持能力等，逐項給出有關(guān)到貨日期、 使用時間的要求。  B．4．2需由用戶承擔(dān)的工作     逐項列出需要用戶承擔(dān)的工作和完成期限。包括需由用戶提供的條件及提供時間。  B．4．3由外單位提供的條件    

110、  逐項列出需要外單位分合同承包者承擔(dān)的工作和完成的時間，包括需要由外單位提供的條件和提 供的時間。 </p><p>　　B．5專題計劃要點  說明本項目開發(fā)中需制訂的各個專題計劃（如分合同計劃、開發(fā)人員培訓(xùn)計劃、測試計劃、安全保密 計劃、質(zhì)量保證計劃、配置管理計劃、用戶培訓(xùn)計劃、系統(tǒng)安裝計劃等）的要點。</p><p>　　附錄C 軟件需求說明書的編寫提示

111、 </p><p>　　C．1引言 C．1．1編寫目的   說明編寫這份軟件需求說明書的目的，指出預(yù)期的讀者。 C．1．2背景     說明：     a．待開發(fā)的軟件系統(tǒng)的名稱；    b．本項目的任務(wù)提出者、開發(fā)者、用戶及實現(xiàn)該軟件的計算中心或計算機網(wǎng)絡(luò)； 

112、;   C．該軟件系統(tǒng)同其他系統(tǒng)或其他機構(gòu)的基本的相互來往關(guān)系。  C．1．3定義    列出本文件中用到的專門術(shù)語的定義和外文首字母組詞的原詞組。 C．1．4參考資料     列出用得著的參考資料，如：    a．本項目的經(jīng)核準(zhǔn)的計劃任務(wù)書或合同、上級機關(guān)的批文；  

113、0; b．屬于本項目的其他已發(fā)表的文件；    c．本文件中各處引用的文件、資料、包括所要用到的軟件開發(fā)標(biāo)準(zhǔn)。 列出這些文件資料的標(biāo)題、文件編號、發(fā)表日期和出版單位，說明能夠得到這些文件資料的來源。</p><p>　　C．2任務(wù)概述  C．2．1目標(biāo)    敘述該項軟件開發(fā)的意圖、應(yīng)用目標(biāo)、作用范圍以及其他應(yīng)向讀者說明的有關(guān)該軟件開發(fā)的背景材料

114、。解釋被開發(fā)軟件與其他有關(guān)軟件之間的關(guān)系。如果本軟件產(chǎn)品是一項獨立的軟件，而且全部內(nèi)容自含，則說明這一點。如果所定義的產(chǎn)品是一個更大的系統(tǒng)的一個組成部分，則應(yīng)說明本產(chǎn)品與該系統(tǒng)中其他各組成部分之間的關(guān)系，為此可使用一張方框圖來說明該系統(tǒng)的組成和本產(chǎn)品同其他各部分的聯(lián)系和接口。| C．2．2用戶的特點    列出本軟件的最終用戶的特點，充分說明操作人員、維護人員的教育水平和技術(shù)專長，以及本軟件的預(yù)期使甩頻

115、度。這些是軟件設(shè)計工作的重要約束 C．2．3假定和約束   列出進行本軟件開發(fā)工作的假定和約束，例如經(jīng)費限制、開發(fā)期限等。</p><p>　　C．3需求規(guī)定   C．3．1對功能的規(guī)定    用列表的方式（例如IPO表即輸入、處理、輸出表的形式），逐項定量和定性地敘述對軟件所提出的功能要求，說明輸入什么量、經(jīng)怎樣的處理、得到什么輸出

116、，說明軟件應(yīng)支持的終端數(shù)和應(yīng)支持的并行操作的用戶數(shù)。  C．3．2對性能的規(guī)定  C．3．2．1精度     說明對該軟件的輸入、輸出數(shù)據(jù)精度的要求，可能包括傳輸過程中的精度。  C．3．2．2時間特性要求    說明對于該軟件的時間特性要求，如對：   a．響應(yīng)時間；   b．更新處理時間； 

117、;  c．?dāng)?shù)據(jù)的轉(zhuǎn)換和傳送時間；   d．解題時間； 等的要求。  C．3．2．3靈活性    說明對該軟件的靈活性的要求，即當(dāng)需求發(fā)生某些變化時，該軟件對這些變化的適應(yīng)能力，如：   a．操作方式上的變化；   b．運行環(huán)境的變化；    c．同其他軟件的接口的變化；   d．精度和

118、有效時限的變化；   e．計劃的變化或改進。    對于為了提供這些靈活性而進行的專門設(shè)計的部分應(yīng)該加以標(biāo)明。 C．3．3輸人輸出要求   解釋各輸入輸出數(shù)據(jù)類型，并逐項說明其媒體、格式</p><p>　　C．4運行環(huán)境規(guī)定  C．4．1設(shè)備   列出運行該軟件所需要的硬設(shè)備。說明其中的新型設(shè)備及其專門功能，包

119、括：  a．處理器型號及內(nèi)存容量；  b．外存容量、聯(lián)機或脫機、媒體及其存儲格式，設(shè)備的型號及數(shù)量；  c．輸入及輸出設(shè)備的型號和數(shù)量，聯(lián)機或脫機；   d．?dāng)?shù)據(jù)通信設(shè)備的型號和數(shù)量；  e．功能鍵及其他專用硬件 C．4．2支持軟件   列出支持軟件,包括要用到的操作系統(tǒng)、編譯（或匯編）程序、測試支持軟件等。 C．4．3 接口 

120、說明該軟件同其他軟件之間的接口、數(shù)據(jù)通信協(xié)議等。 C．4．4控制   說明控制該軟件的運行的方法和控制信號，并說明這些控制信號的來源。 </p><p>　　附錄D 數(shù)據(jù)要求說明書的編寫提示 D．1引言  D．1．1編寫目的   說明編寫這份數(shù)據(jù)要求說明書的目的，指出預(yù)期的讀者。  D．1．2背景   說明： &

121、#160;  a．待開發(fā)軟件系統(tǒng)的名稱；    b．列出本項目的任務(wù)提出者、開發(fā)者、用戶以及將運行該項軟件的計算站（中心）或計算機網(wǎng)絡(luò)系統(tǒng)。   D．1．3定義    列出本文件中用到的專門術(shù)語的定義和外文首字母組詞的原詞組。 D．1．4參考資料   列出有關(guān)的參考資料，如：   a．本項目的經(jīng)核準(zhǔn)的計劃任

122、務(wù)書或合同，上級機關(guān)的批文；    b．屬于本項目的其他已發(fā)表文件；   c．本文件中各處引用的文件、資料，包括所要用到的軟件開發(fā)標(biāo)準(zhǔn)。列出這些文件的標(biāo)題、文件編號、發(fā)表日期和出版單位。說明能夠得到這些文件資料的來源。</p><p>　　D．2數(shù)據(jù)的邏輯描述   對數(shù)據(jù)進行邏輯描述時可把數(shù)據(jù)分為動態(tài)數(shù)據(jù)和靜態(tài)數(shù)據(jù)。所謂靜態(tài)數(shù)據(jù)，指在運行過程中主要作 為參

123、考的數(shù)據(jù)，它們在很長的一段時間內(nèi)不會變化，一般不隨運行而改變。所謂動態(tài)數(shù)據(jù)．包括所有在運 行中要發(fā)生變化的數(shù)據(jù)以及在運行中要輸入、輸出的數(shù)據(jù)。進行描述時應(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ù)元素。

124、60;D．2．2動態(tài)輸人數(shù)據(jù)   列出動態(tài)輸入數(shù)據(jù)元素（包括在常規(guī)運行中或聯(lián)機操作中要改變的數(shù)據(jù)）。 D．2．3動態(tài)輸出數(shù)據(jù)    列出動態(tài)輸出數(shù)據(jù)元素（包括在常規(guī)運行中或聯(lián)機操作中要改變的數(shù)據(jù)）。 D．2．4內(nèi)部生成數(shù)據(jù)   列出向用戶或開發(fā)單位中的維護調(diào)試人員提供的內(nèi)部生成數(shù)據(jù)。  D．2．5數(shù)據(jù)約定   說明

125、對數(shù)據(jù)要求的制約。逐條列出對進一步擴充或使用方面的考慮而提出的對數(shù)據(jù)要求的限制（容 量、文卷、記錄和數(shù)據(jù)元的個數(shù)的最大值）。對于在設(shè)計和開發(fā)中確定是臨</p><p>　　D．3．?dāng)?shù)據(jù)的采集  D．3．1要求和范圍    按數(shù)據(jù)元的邏輯分組來說明數(shù)據(jù)采集的要求和范圍，指明數(shù)據(jù)的采集方法，說明數(shù)據(jù)采集工作的承擔(dān)者是用戶還是開發(fā)者。具體的內(nèi)容包括：   a．輸入

126、數(shù)據(jù)的來源，例如是單個操作員、數(shù)據(jù)輸入站，專業(yè)的數(shù)據(jù)輸入公司或它們的一個分組；   b．?dāng)?shù)據(jù)輸入（指把數(shù)據(jù)輸入處理系統(tǒng)內(nèi)部）所用的媒體和硬設(shè)備。如果只有指定的輸入點的輸入才是合法的，則必須對此加以說明；   c．接受者說明輸出數(shù)據(jù)的接受者；    d．輸出數(shù)據(jù)的形式和設(shè)備列出輸出數(shù)據(jù)的形式和硬設(shè)備。無論接受者將接收到的數(shù)據(jù)是打印輸出，還是CRT上的一組字符、一幀圖形，或一

127、聲警鈴，或向開關(guān)線圈提供的一個電脈沖，或常用介質(zhì)如磁盤、磁帶、穿孔卡片等，均應(yīng)具體說明；   e．?dāng)?shù)據(jù)值的范圍給出每一個數(shù)據(jù)元的合法值的范圍；   f．量綱給出數(shù)字的度量單位、增量的步長、零點的定標(biāo)等。在數(shù)據(jù)是非數(shù)字量的情況下，要給出每一種合法值的形式和含意；   g．更新和處理的頻度給出預(yù)定的對輸入數(shù)據(jù)的更新和處理的頻度。如果數(shù)據(jù)的輸入是隨機的，應(yīng)給出更新處理的頻度的平

128、均值，或變化情況的某種其他度量。 D．3．2</p><p>　　附錄E概要設(shè)計說明書的編寫提示 </p><p>　　E．1引言  E．1．1編寫目的    說明編寫這份概要設(shè)計說明書的目的，指出預(yù)期的讀者。 E．1．2背景   說明：   a．待開發(fā)軟件系統(tǒng)的名稱； &

129、#160; b．列出此項目的任務(wù)提出者、開發(fā)者、用戶以及將運行該軟件的計算站（中心）。 E．1．3定義    列出本文件中用到的專門術(shù)語的定義和外文首字母組詞的原詞組。 E．1．4參考資料    列出有關(guān)的參考文件，如：   a．本項目的經(jīng)核準(zhǔn)的計劃任務(wù)書或合同，上級機關(guān)的批文；   b．屬于本項目的其他已發(fā)表文件；

130、0;  c．本文件中各處引用的文件、資料，包括所要用到的軟件開發(fā)標(biāo)準(zhǔn)。 列出這些文件的標(biāo)題、文件編號、發(fā)表日期和出版單位，說明能夠得到這些文件資料的來源。</p><p>　　E．2總體設(shè)計  E．2．1需求規(guī)定    說明對本系統(tǒng)的主要的輸入輸出項目、處理的功能性能要求，詳細的說明可參見附錄C。 E．2．2運行環(huán)境    簡要地說明

131、對本系統(tǒng)的運行環(huán)境（包括硬件環(huán)境和支持環(huán)境）的規(guī)定，詳細說明參見附錄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

132、．5功能器求與程序的關(guān)系   本條用一張如下的矩陣圖說明各項功能需求的實現(xiàn)同各塊程序的分配關(guān)系：</p><p>　　E．2．6人工處理過程   說明在本軟件系統(tǒng)的工作過程中不得不包含的人工處理過程（如果有的話）。 E．2．7尚未問決的問題   說明在概要設(shè)計過程中尚未解決而設(shè)計者認為在系統(tǒng)完成之前必須解決的各個問題。</p&g

133、t;<p>　　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)元素之間的接口的安排。</p><p>　

134、　E．4運行設(shè)計  E．4．1運行模塊組合  說明對系統(tǒng)施加不同的外界運行控制時所引起的各種不同的運行模塊組合，說明每種運行所歷經(jīng)的內(nèi)部模塊和支持軟件。 E．4．2運行控制   說明每一種外界的運行控制的方式方法和操作步驟。 E．4．3運行時間  說明每種運行模塊組合將占用各種資源的時間。</p><p>　　E．5系統(tǒng)數(shù)據(jù)結(jié)構(gòu)設(shè)計 &#

135、160;E．5．1邏輯結(jié)構(gòu)設(shè)計要點   給出本系統(tǒng)內(nèi)所使用的每個數(shù)據(jù)結(jié)構(gòu)的名稱、標(biāo)識符以及它們之中每個數(shù)據(jù)項、記錄、文卷和系的標(biāo)識、定義、長度及它們之間的層次的或表格的相互關(guān)系。  E．5．2物理結(jié)構(gòu)設(shè)計要點  給出本系統(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)系

136、60; 說明各個數(shù)據(jù)結(jié)構(gòu)與訪問這些數(shù)據(jù)結(jié)構(gòu)的形式:</p><p>　　E．6系統(tǒng)出錯處理設(shè)計 E．6．1出錯信息   用一覽表的方式說朗每種可能的出錯或故障情況出現(xiàn)時，系統(tǒng)輸出信息的形式、含意及處理方法。 E．6．2補救措施  說明故障出現(xiàn)后可能采取的變通措施，包括：  a．后備技術(shù)說明準(zhǔn)備采用的后備技術(shù)，當(dāng)原始系統(tǒng)數(shù)據(jù)萬一丟失時啟用的副本的建立和

137、啟動的技術(shù)，例如周期性地把磁盤信息記錄到磁帶上去就是對于磁盤媒體的一種后備技術(shù)；  b．降效技術(shù)說明準(zhǔn)備采用的后備技術(shù)，使用另一個效率稍低的系統(tǒng)或方法來求得所需結(jié)果的某些部分，例如一個自動系統(tǒng)的降效技術(shù)可以是手工操作和數(shù)據(jù)的人工記錄；  c．恢復(fù)及再啟動技術(shù)說明將使用的恢復(fù)再啟動技術(shù)，使軟件從故障點恢復(fù)執(zhí)行或使軟件從頭開始重新運行的方法。 E．6．3系統(tǒng)維護設(shè)計   說明為了系統(tǒng)維護的方便而在程序內(nèi)