軟件用戶文檔第一頁，共三十四頁，2022年，8月28日2023/3/1017.1軟件用戶文檔用戶文檔是軟件開發(fā)人員為軟件用戶了解、使用、操作和維護等提供的詳細資料。用戶文檔包括用戶手冊、操作手冊和維護修改建議等。7.1編制用戶文檔的基本要求1.描述規(guī)范準確

用戶文檔的閱讀對象通常是非計算機專業(yè)的人員，因此對用戶有很強的實用和指導(dǎo)意義。要求在描述內(nèi)容、說明方法、提出見解時都應(yīng)準確無誤，恰如其分。文檔需要反映哪些內(nèi)容、如何描述、口氣、分寸等，都應(yīng)與編制目的、使用對象協(xié)調(diào)一致。用詞應(yīng)標準、統(tǒng)一、規(guī)范。2.敘述簡練生動

用戶文檔應(yīng)簡潔、精煉，少用用戶難懂的專業(yè)術(shù)語，并力求形象生動、圖文并茂，便于用戶學(xué)習(xí)、理解和掌握軟件的使用、操作。3.語言嚴密平實

用戶文檔的價值在于科學(xué)性。文字表達必須合乎邏輯，才能有助于用戶使用、操作軟件。4.內(nèi)容系統(tǒng)完整

用戶文檔作為軟件系統(tǒng)開發(fā)者和用戶之間的界面，應(yīng)能提供給用戶關(guān)于軟件整體結(jié)構(gòu)、功能、安裝、運行和操作的有關(guān)知識，并且用戶文檔的內(nèi)容組織應(yīng)該有系統(tǒng)性、層次性，使之成為軟件使用、操作的清晰的“交通圖”。2023/3/102第二頁，共三十四頁，2022年，8月28日7.2軟件常用表示形式軟件的表示方法為軟件系統(tǒng)建立一個基本構(gòu)架，對理解軟件，特別是對于軟件的維護，將是非常重要的。1.容器模型基于一個共享數(shù)據(jù)庫的系統(tǒng)模型一般稱為容器模型。如果系統(tǒng)的工作所使用的數(shù)據(jù)是圍繞共享數(shù)據(jù)庫進行的，這可以考慮采用容器模型來表達其系統(tǒng)結(jié)構(gòu)。下圖是一種集成CASE工具集的體系結(jié)構(gòu)。設(shè)計編輯器代碼生成器設(shè)計分析器報告生成器程序編輯器設(shè)計轉(zhuǎn)換器項目存儲在上面的例子中，容器是被動的，對它的控制是由其它子系統(tǒng)完成的。2023/3/103第三頁，共三十四頁，2022年，8月28日2.客戶機/服務(wù)器模型這個模型用于表示一個分布式系統(tǒng)，說明數(shù)據(jù)和加工過程在多個處理器之間的分配。其例子如下圖所示。用戶用戶用戶用戶接口客戶進程用戶接口客戶進程用戶接口客戶進程多媒體數(shù)據(jù)庫服務(wù)器及中間件圖像服務(wù)器視頻服務(wù)器聲音服務(wù)器文本服務(wù)器……圖像數(shù)據(jù)庫視頻數(shù)據(jù)庫聲音數(shù)據(jù)庫文本數(shù)據(jù)庫2023/3/104第四頁，共三十四頁，2022年，8月28日3.抽象機模型抽象機模型，也稱分層模型，常用來表示子下圖的接口模型。將下圖組織成一系列的層次，每一層次定義一組服務(wù)。一個著名的例子是網(wǎng)絡(luò)協(xié)議OSI參考模型。下圖是一個版本管理下圖的抽象機模型的結(jié)構(gòu)示例。4.接口描述大型系統(tǒng)總是分解成獨立開發(fā)的一些子系統(tǒng)。因此，在軟件描述中的一個必要成分就是定義子系統(tǒng)接口。接口的示意如下圖。子系統(tǒng)A子系統(tǒng)B2023/3/105第五頁，共三十四頁，2022年，8月28日接口是一種抽象的概念，在面向?qū)ο蟮某绦蛟O(shè)計中，可以是一個類的公開的數(shù)據(jù)成員或成員函數(shù)，也可以是若干個類抽象出的接口對象。接口抽象概念如圖所示。Class1-用于接口數(shù)據(jù)成員-其它數(shù)據(jù)成員Class2+用于接口的成員函數(shù)()+其它成員函數(shù)()Class3Class4《interface》接口對象Class5接口描述主要包括三方面信息：-類型名：即一組對象的名字-接口語法：定義接口操作的名字、參數(shù)個數(shù)、參數(shù)類型及操作結(jié)果類型-接口描述：對接口操作給出無二義的語法和語義解釋2023/3/106第六頁，共三十四頁，2022年，8月28日5.控制模型控制模型在體系結(jié)構(gòu)層次上描述子系統(tǒng)之間的控制流。有兩種表示形式：集中式控制和事件驅(qū)動控制。集中式控制模型中，由一個稱為系統(tǒng)控制器的子系統(tǒng)來負責(zé)管理其它子系統(tǒng)的執(zhí)行，模型工具子系統(tǒng)是順序執(zhí)行還是并發(fā)執(zhí)行，而分成調(diào)用-返回模型和管理者模型。下圖是一個調(diào)用-返回式集中控制模型的結(jié)構(gòu)示例：主程序程序1程序2程序3程序1.1程序1.2程序3.1程序3.22023/3/107第七頁，共三十四頁，2022年，8月28日下圖是一種實時系統(tǒng)的管理者集中控制模型的結(jié)構(gòu)示例：故障處理器傳感器進程傳動裝置進程計算進程系統(tǒng)控制用戶界面在基于事件驅(qū)動控制模型中，各個子系統(tǒng)都可以接受來自外部子系統(tǒng)的事件，并對此作出響應(yīng)。典型的有廣播型事件驅(qū)動控制模型和中斷型控制模型。2023/3/108第八頁，共三十四頁，2022年，8月28日廣播型事件驅(qū)動控制模型的結(jié)構(gòu)示例如圖：子系統(tǒng)1子系統(tǒng)2子系統(tǒng)3子系統(tǒng)n…時間和消息處理器中斷驅(qū)動型控制模型的結(jié)構(gòu)示例如圖：處理器1處理器2處理器3處理器4進程1進程2進程3進程4中斷向量2023/3/109第九頁，共三十四頁，2022年，8月28日6.數(shù)據(jù)流模型數(shù)據(jù)流模型是描述系統(tǒng)數(shù)據(jù)處理的一種很直觀的方式。下圖是一個訂單處理的數(shù)據(jù)流圖。完成訂單表完成訂單表完成訂單表驗證訂單記錄訂單訂單明細+空白訂單表訂單文件預(yù)算文件下圖是一個CASE工具集的數(shù)據(jù)流圖。設(shè)計編輯器設(shè)計交叉檢查器設(shè)計分析器報告生成器代碼框架生成器設(shè)計數(shù)據(jù)庫設(shè)計數(shù)據(jù)庫檢查過的設(shè)計引用的設(shè)計輸出代碼輸入設(shè)計有效設(shè)計設(shè)計分析用戶報告檢查過的設(shè)計2023/3/1010第十頁，共三十四頁，2022年，8月28日7.狀態(tài)機模型狀態(tài)機模型是一種描述系統(tǒng)對內(nèi)或外部事件響應(yīng)的行為模型，用來表示系統(tǒng)狀態(tài)和事件，以及事件引發(fā)系統(tǒng)在狀態(tài)之間的轉(zhuǎn)換。下圖是一個簡單微波爐的狀態(tài)機模型示例。全功率Do:setpower=600等待Do:displaytime半功率Do:setpower=300設(shè)置時間Do:getnumberExit:settime屏蔽Do:display‘Waiting’激活Do:display‘ready’等待Do:displaytime操作Do:operateopen全功率半功率全功率半功率計時器計時器門開門關(guān)門關(guān)開始取消系統(tǒng)出錯數(shù)字2023/3/1011第十一頁，共三十四頁，2022年，8月28日8.數(shù)據(jù)模型絕大多數(shù)的軟件系統(tǒng)都要使用數(shù)據(jù)庫，因此，系統(tǒng)建模的一項重要工作就是定義系統(tǒng)處理的邏輯結(jié)構(gòu)。數(shù)據(jù)模型就是要表達這樣的一個結(jié)構(gòu)。數(shù)據(jù)模型可以表示為一個有向圖，包含一系列不同類型的結(jié)點，結(jié)點之間的連線表示結(jié)點之間的關(guān)系，每個結(jié)點有結(jié)點標示和若干屬性描述。下圖是一個由一組結(jié)點和一組關(guān)聯(lián)構(gòu)成的ERA數(shù)據(jù)模型，表是對應(yīng)的數(shù)據(jù)字典。設(shè)計NamedescriptionC-dateM-date標簽Nametexticon鏈接Nametype鏈接Nametype有結(jié)點n1有標簽11isan有鏈接有標簽1nn1有鏈接12鏈接2023/3/1012第十二頁，共三十四頁，2022年，8月28日ERA圖所對應(yīng)的數(shù)據(jù)字典名字描述類型日期has-labels在結(jié)點或關(guān)聯(lián)實體和類型標簽實體間的1:n關(guān)系關(guān)系2005-12-30label存放結(jié)點或關(guān)聯(lián)的結(jié)構(gòu)化的或非結(jié)構(gòu)化的信息。標簽由一個圖標(可能是一個透明方塊)和相關(guān)的文本表示實體2005-12-30link表示設(shè)計實體的結(jié)點間的1:1關(guān)系，關(guān)聯(lián)具有類型和名字關(guān)系2005-12-30name(label)每個標簽具有一個說明類型的名字，該名字在設(shè)計中的標簽類型必須唯一屬性2005-12-30name(node)每個結(jié)點名字在整個設(shè)計中必須唯一，名字可以長達64個字符屬性2005-12-309.對象模型對象模型是一種映射真實世界中實體及對其操作的自然方法。對象模型既可以表達系統(tǒng)數(shù)據(jù)，又可以表達對數(shù)據(jù)的處理。因此，對象模型可以看作是數(shù)據(jù)流模型和數(shù)據(jù)模型的結(jié)合。下面的圖是用UML描述對象類的例子。圖中，每個矩形表示一個對象類，其中包括對象名字、對象類中的屬性、對象類的中操作。向上的空三角箭頭表示繼承。2023/3/1013第十三頁，共三十四頁，2022年，8月28日-CataloguenumberAcquisitionCostType-Status-Numberofcopies+Acquire()+Catalogue()+Dispose()+Issue()+Return()-Author-Edition-Publicationdate-ISBN-Title-Publisher-Title-Medium-Year-Issue-Version-Platform-Director-Dateofrelease-Distributor圖書館系統(tǒng)的部分類層次2023/3/1014第十四頁，共三十四頁，2022年，8月28日除了通過繼承來組織系統(tǒng)，對象類還可以由其它的對象組合而成，稱為對象成員。這種關(guān)系稱為對象的聚合，使用菱形表示聚合關(guān)系。如圖所示的是課程的聚合對象表示。課程CoursetitleNumberYearInstructor作業(yè)Credits幻燈片Slides課堂筆記Text錄像帶Tapeids練習(xí)ProblemsDescription解答TextDiagrams2023/3/1015第十五頁，共三十四頁，2022年，8月28日對象行為建模用序列圖來表示。如圖，描述一組對象上的一個序列圖，操作由帶標簽的箭頭指示，操作順序是自上而下。讀者目錄圖書館項目服務(wù)器查找顯示發(fā)行發(fā)行許可接受許可打包交付電子科目的發(fā)放——對象行為建模2023/3/1016第十六頁，共三十四頁，2022年，8月28日7.3用戶手冊

軟件的質(zhì)量是由多個方面構(gòu)成的，用戶手冊也是衡量軟件質(zhì)量的一個重要標準。特別是目前軟件需求快速增長，市場迅速擴張的時期，不少軟件開發(fā)者過于注重軟件的功能、性能，而忽略了軟件作為產(chǎn)品的其它方面的質(zhì)量，而用戶手冊的質(zhì)量問題尤為突出。一個優(yōu)秀的用戶手冊可以幫助用戶快速入門，是用戶正確、充分使用軟件的前提。對于開發(fā)者來說，質(zhì)量符合要求的用戶手冊，至少可以減少用戶培訓(xùn)和售后服務(wù)的投入。所以，對軟件開發(fā)者來說，應(yīng)該充分認識軟件產(chǎn)品用戶手冊的重要性，提高用戶手冊的質(zhì)量，以促進軟件產(chǎn)品質(zhì)量的整體提高。一個質(zhì)量存在問題的某產(chǎn)品用戶手冊的例子。2023/3/1017第十七頁，共三十四頁，2022年，8月28日1.用戶手冊的完整性

在實際使用中經(jīng)常發(fā)現(xiàn)，很多軟件由于開發(fā)過于倉促，在付諸使用時，用戶手冊中經(jīng)常缺少關(guān)于某些方面的說明，有時缺少的還是十分重要的內(nèi)容，讓用戶使用時，感到困難，甚至是無所適從。而質(zhì)量良好的用戶手冊，至少應(yīng)該是能夠包括軟件產(chǎn)品的所有相關(guān)內(nèi)容，能夠指導(dǎo)用戶順利的安裝、設(shè)置和使用軟件。因此，保證內(nèi)容的全面性和完整性是把握用戶手冊質(zhì)量的重要方面。2.用戶手冊的描述與軟件實際功能的一致性

用戶手冊的內(nèi)容不僅要保證其全面性和完整性，還要確保它與一起發(fā)行的軟件版本的實際功能相一致?，F(xiàn)實情況是，由于開發(fā)企業(yè)產(chǎn)品研發(fā)管理和產(chǎn)品版本管理方面存在的問題，產(chǎn)生用戶手冊描述內(nèi)容和軟件實際運行情況不一致，造成用戶使用中的困惑和誤解，進而影響軟件的正常使用。2023/3/1018第十八頁，共三十四頁，2022年，8月28日3.用戶手冊的易理解性

由于軟件產(chǎn)品的用戶往往對計算機方面的專業(yè)知識了解不多，對軟件運行缺少實際的腦際映像，因此，用戶手冊的可理解性，是其質(zhì)量的重要指標。對于軟件使用中那些關(guān)鍵的、重要的、文字難表述清楚的，或者使用圖表方法可以簡化描述，增加可理解性的內(nèi)容，應(yīng)該采用圖表或附有圖表的方式描述。優(yōu)秀的用戶手冊應(yīng)該是圖文并舉，易讀、易理解、易對照。4.用戶手冊應(yīng)提供學(xué)習(xí)操作的實例

一個沒有軟件運行和操作實例的用戶手冊，對于用戶來說，其實并沒有太大的幫助。例如，軟件中關(guān)于系統(tǒng)網(wǎng)絡(luò)參數(shù)配置的說明，如果沒有具體實例的輔助演示，相信絕大多數(shù)沒有多少網(wǎng)絡(luò)知識的用戶是很難勝任的。一個優(yōu)秀的用戶手冊，不僅要對軟件主要功能和關(guān)鍵操作提供應(yīng)用實例，而且實例的描述還應(yīng)做到詳細、充分，易于理解，實例最好由圖示的方法描述。2023/3/1019第十九頁，共三十四頁，2022年，8月28日5.用戶手冊的印刷與包裝質(zhì)量

用戶手冊作為商品化軟件產(chǎn)品的重要組成內(nèi)容，其紙張、印刷、裝訂、包裝等的質(zhì)量，包括版面、封面等的設(shè)計質(zhì)量，手冊和軟件應(yīng)用類型的吻合程度等，都將直接影響軟件的形象、市場可接受度和最終的銷售業(yè)績。另外，用戶手冊不同于用戶使用說明書，它除了向用戶提供基本的產(chǎn)品操作方法，還要提供很多與產(chǎn)品相關(guān)的其它信息。主要的有以下方面：-介紹：軟件的基本情況-用途：介紹軟件的適用范圍、功能、性能主要及其特點-運行環(huán)境：介紹軟件最基本的和推薦的運行配置、軟件安裝說明、參數(shù)設(shè)定等，以及可能引起的和系統(tǒng)的沖突，解決途徑等-使用過程：向用戶介紹軟件具體的使用方法-相關(guān)信息：必要的開發(fā)者信息，軟件注冊、升級途徑等2023/3/1020第二十頁，共三十四頁，2022年，8月28日7.4操作手冊

操作手冊是指導(dǎo)軟件具體操作的工具書。操作手冊涉及軟件設(shè)計完成后的以后所關(guān)心的有關(guān)操作的內(nèi)容。由于操作的項目不同，操作手冊的內(nèi)容和形式也有所不同。在形式上，有技術(shù)指導(dǎo)書，也有操作規(guī)程等類型。內(nèi)容上，伸縮的余地較大。但一般而言，操作手冊的內(nèi)容主要應(yīng)包括：1.引言。主要簡介軟件的外圍特性、軟件名稱、開發(fā)單位、專用名稱，概述軟件內(nèi)部的一些結(jié)構(gòu)，介紹手冊涉及的技術(shù)、設(shè)備或產(chǎn)品的特點、用途、使用對象、指導(dǎo)的內(nèi)容，以及手冊的編排格式等，一些規(guī)模較大的手冊，還要介紹手冊的使用方法和檢索示例，使讀者對手冊和軟件產(chǎn)品都有一個大概的了解。寫作上，要求簡明扼要，敘述全面、真實，讀者讀后能感受到對手冊和軟件產(chǎn)品的一個提綱式的了解。2023/3/1021第二十一頁，共三十四頁，2022年，8月28日2.操作原理。這部分內(nèi)容是對操作對象或過程的主要性質(zhì)或步驟的解釋，為操作者提供理論依據(jù)和操作基礎(chǔ)。這部分內(nèi)容要求適合操作者的專業(yè)水平，一般不宜過于專深，內(nèi)容描述可結(jié)合公式、框圖、圖表等，要求易于閱讀、理解。3.操作說明。介紹操作的具體步驟和要求，是操作手冊的核心部分。步驟的組織結(jié)構(gòu)一般按每一步驟分點說明。操作說明的輔助敘述方法主要有圖解、框圖、程序、表格等。這些輔助表述方法有時也會成為手冊內(nèi)容的主要表述形式。如操作過程的說明。操作說明要求簡練、準確、形象、清晰、易懂，表述內(nèi)容應(yīng)與系統(tǒng)實際操作過程對應(yīng)一致，語句多采用短句和主動語態(tài)，經(jīng)常是一個動作、一個步驟為一個編號單位。2023/3/1022第二十二頁，共三十四頁，2022年，8月28日4.注意事項。注意事項是指系統(tǒng)操作過程中應(yīng)該注意的內(nèi)容。注意事項和故障排除也經(jīng)常放在操作說明中。但更多的時候，為了強調(diào)，將其單獨列出，還有那些不屬于基本操作的內(nèi)容，也可放在這一部分。如軟件與運行環(huán)境的維護、保管、技術(shù)故障的判斷、排除、操作質(zhì)量的分析等。5.附錄。主要用于非操作說明內(nèi)容的補充敘述。如運行環(huán)境的配套設(shè)備、技術(shù)指標的誤差范圍、非常規(guī)過程部分和遠程操作部分等，以及在其它方面的應(yīng)用或其典型操作的示例等。附錄也經(jīng)常提供一些與軟件產(chǎn)品密切相關(guān)的理論、技術(shù)、方法、工具、資料、數(shù)據(jù)及其發(fā)明、創(chuàng)作或提供者的出處、來源、介紹等資料，包括技術(shù)文檔、資料的引用列表等。2023/3/1023第二十三頁，共三十四頁，2022年，8月28日7.5維護修改文檔

根據(jù)軟件生命周期的階段理論，軟件投入運行后，在相當(dāng)長的時間里，由于業(yè)務(wù)、政策、市場、法規(guī)、管理、技術(shù)等方面的發(fā)展和變化，都會使得軟件應(yīng)用機構(gòu)的業(yè)務(wù)經(jīng)歷著持續(xù)不斷的變化，這些變化或者產(chǎn)生了新的需求，或者需要修改原先的軟件需求。再好的軟件系統(tǒng)，都會隨著系統(tǒng)應(yīng)用領(lǐng)域業(yè)務(wù)的變化而變化。因此，軟件在其生命周期中是會不斷的進行著維護修改工作的。1.軟件運行系統(tǒng)的結(jié)構(gòu)

對運行中的軟件進行維護修改，將涉及技術(shù)和社會的雙重因素。這不僅是由客觀的工程準則決定，還會受到軟件運行環(huán)境和機構(gòu)策略的影響。如圖，軟件運行系統(tǒng)的不同邏輯部分，會產(chǎn)生各自不同的相互影響。2023/3/1024第二十四頁，共三十四頁，2022年，8月28日支持軟件應(yīng)用軟件業(yè)務(wù)策略和規(guī)則硬件系統(tǒng)應(yīng)用數(shù)據(jù)業(yè)務(wù)過程使用使用使用約束嵌入知識運行在運行在軟件運行系統(tǒng)的例子：圖中，各部分的含義如下：-硬件系統(tǒng)：當(dāng)時的硬件系統(tǒng)現(xiàn)在可能已過時，或者維護費用過高-支持軟件：系統(tǒng)運行所依賴的操作系統(tǒng)、數(shù)據(jù)庫系統(tǒng)、與硬件相關(guān)的實用程序、驅(qū)動程序、編譯系統(tǒng)等，現(xiàn)在可能已無法得到生產(chǎn)廠家的支持-應(yīng)用軟件：應(yīng)用系統(tǒng)是由多個程序組成的，并且這些程序是獨立的，在不同的時段開發(fā)的-應(yīng)用數(shù)據(jù)：在系統(tǒng)以往的運行歷史中，積累了大量的數(shù)據(jù)，不同文檔的數(shù)據(jù)可能不一致或有重復(fù)-業(yè)務(wù)過程：業(yè)務(wù)過程受到業(yè)務(wù)策略和規(guī)則的約束，對應(yīng)用軟件提出具體的需求-業(yè)務(wù)策略和規(guī)則：規(guī)定了業(yè)務(wù)執(zhí)行的規(guī)則和流程2023/3/1025第二十五頁，共三十四頁，2022年，8月28日上面軟件運行系統(tǒng)的示意圖可以進一步抽象為右圖所示的層次結(jié)構(gòu)。從圖中可以看到，每一層依賴于其下方的一層，層與層之間有接口。因此，對系統(tǒng)的一個層次進行維護或變更，勢必引起其它各層作出相應(yīng)的變更。業(yè)務(wù)過程應(yīng)用軟件應(yīng)用軟件支持軟件硬件一個應(yīng)用軟件通常包含有多個不同的程序，不同的程序針對不同的數(shù)據(jù)操作，有些數(shù)據(jù)還可能為多個程序共享。如圖，程序變更影響到數(shù)據(jù)，也影響到其它程序的變更。程序1程序2程序3程序4程序5程序6程序7文件1文件2文件3文件4文件5文件6本例說明，當(dāng)需要對軟件進行修改、變更時，應(yīng)評估其影響，并慎重地提出建議，以提交審批。2023/3/1026第二十六頁，共三十四頁，2022年，8月28日2.維護修改方案軟件的維護、修改需要資金的支持，需要對投資做精心安排，以期獲得好的回報。因此，對所維護修改的軟件系統(tǒng)作出客觀的分析和評估，制定合理、恰當(dāng)?shù)木S護修改方案，是維護取得成功的前提。根據(jù)實際軟件維護可能的類型，可以有下面幾種可選的維護方案：-徹底拋棄現(xiàn)有系統(tǒng)。當(dāng)系統(tǒng)不能對現(xiàn)有業(yè)務(wù)過程產(chǎn)生有效作用時選擇-繼續(xù)維護現(xiàn)有系統(tǒng)。當(dāng)系統(tǒng)運行平穩(wěn)，能夠繼續(xù)發(fā)揮作用，用戶也沒有大的變更要求時，可選擇此方案-轉(zhuǎn)換系統(tǒng)以改善其可維護性。當(dāng)系統(tǒng)質(zhì)量應(yīng)經(jīng)常變更，或系統(tǒng)的功能、性能增加及改善后，現(xiàn)運行環(huán)境已不敷適應(yīng)，并且系統(tǒng)維護修改的需求仍然是經(jīng)常性的時候，應(yīng)選擇此方案-以一新系統(tǒng)代替現(xiàn)系統(tǒng)。當(dāng)新的硬件環(huán)境無法使現(xiàn)軟件系統(tǒng)繼續(xù)正常運行；或雖現(xiàn)系統(tǒng)仍然能使用，但新開發(fā)系統(tǒng)的成本已很合理時，可考慮采用此方案-綜合方案。根據(jù)實際情況，選擇上面幾種方案進行綜合維護工作2023/3/1027第二十七頁，共三十四頁，2022年，8月28日3.維護過程與記載

在通常情況下，一個規(guī)范的維護過程，都應(yīng)有規(guī)范的結(jié)構(gòu)化維護文檔的生成機制。由于維護過程是由一系列變更請求所觸發(fā)的，這些變更請求可以來自于系統(tǒng)用戶、管理層或者是客戶。從抽象層面看，所有維護過程都有相同的基本活動，包括變更分析、版本規(guī)劃、系統(tǒng)實現(xiàn)和交付使用。下圖描述了系統(tǒng)維護過程的概況。變更請示影響分析版本規(guī)劃變更實現(xiàn)缺陷修補平臺適應(yīng)系統(tǒng)增強系統(tǒng)發(fā)布2023/3/1028第二十八頁，共三十四頁，2022年，8月28日在維護過程的變更實現(xiàn)階段，應(yīng)該修改系統(tǒng)描述、實際和實現(xiàn)，以反映對系統(tǒng)所做的變更。要對提出的反映系統(tǒng)變更的新需求進行詳細分析，明確變更的內(nèi)容。變更的過程由于變更涵義在變更分析的早期階段的不清晰性，而變得曲折反復(fù)，因此，對變更需求應(yīng)進行反復(fù)的修改和有效性驗證，然后再進入相應(yīng)的組件設(shè)計和實現(xiàn)階段，最后通過測試，完成系統(tǒng)變更維護。其過程如下圖所示。變更提議需求分析需求更新變更開發(fā)2023/3/1029第二十九頁，共三十四頁，2022年，8月28日軟件生命周期的所有階段的文檔，對軟件維護工作都是十分重要的。這些文檔將作為評估維護技術(shù)的有效性，確定軟件產(chǎn)品的“優(yōu)良”程度，以及確定維護的實際代價等的重要依據(jù)。因此，維護過程內(nèi)容的記載應(yīng)該要確定。下面是維護記載的基本內(nèi)容參考：-程序標識-源語句數(shù)-機器指令條數(shù)-使用的程序設(shè)計語言-程序安裝的日期-自從安裝以來程序運行的次數(shù)-自從安裝以來程序失效的次數(shù)-程序變動的層次標識-因程序變動而增加的源語句數(shù)-因程序變動而減少的源語句數(shù)-每個改動耗費的人時數(shù)-程序改動的日期-軟件工程師的名字-維護要求表的標識-維護類型-維護開始和完成的日期-累計用于維護的人時數(shù)-與完成的維護相聯(lián)系的純效益2023/3/1030第三十頁，共三十四頁，2022年，8月28