1、1-3 文件的製作,在資訊系統的開發過程，有幾個重要的文件會產出，包括系統規劃階段的系統規劃書、系統需求分析階段的系統需求書、系統設計階段的系統規格書，系統開發階段的成果是程式碼，還包括了模組、結合、系統、整合測試規格書、使用者手冊等，通稱為文件(Document),文件的功能:,溝通的工具 控制的工具 記錄的工具,溝通的工具,由於系統的開發是由很多人所組成的，除了開發團隊需要各式各樣的專業人員之外，也有系統的所有者、使用者和維護者，這麼多的人員如果沒有將系統開發的計劃、需求、設計、程式碼等，用正式的文件記錄下來，那麼沒有一定的標準，每個人的認知也許會產生很多誤會，說的和想的沒有辦法像寫的一樣
2、清楚，有了彼此認同的文間資料，就有了開發系統的根據。,控制的工具,文件是系統開發的進度記錄，也是功能範圍的依據，當確認了使用者的需求之後，文件上的記錄可以確保系統的開發不會偏離了方向，確保開發者的工作範圍，確認開發的版本，也是開發系統團隊和系統使用者雙方的控制工具。,記錄的工具,資訊系統的開發是智慧型人力密集的工作成果，如果沒有將系統的開發細節記錄下來，將來系統的維護會非常困難，當然由於系統的複雜性，文件的會變得十分龐大，所以必須依據系統開發的生命週期，加以分割撰寫，每個階段都有相對的文件會產生，用以記錄該階段的工作內容。,文件的撰寫，應該要注意的事項:,專業的文件 客觀的描述 盡量用條列式的
3、方法 文件的使用,專業的文件,專業的文件最需要的是清楚的格式，全份文件應該使用統一的格式標準，由於系統開發的複雜，文件的基本階層式架構必須釐定清楚，所用的項目要一致，文件的封面和目錄，都要有一定的樣子，文字的格式也要一致，包括字體、大小、行距、空格等，每頁一定都要有頁碼，白紙黑字，不需要有彩色的紙、字、或是花邊，不要表現的天真可愛，太孩子氣的味道，都是不必要的，資訊系統的開發是成本很高的，系統開發人員需要以嚴肅的態度來對待，要給人很認真、專業、正式的感覺，不可諱言的，包裝很重要，和專業人士的穿著一樣，專業的文件是由正式的、一定規格的細節所組成，基本的樣子要符合，接著再看文件的內容。,客觀的描述
4、,文件需要客觀的描述，在這裡是指以報導是的方法來撰寫，文件內不應該出現我、我們、你、你們、他、他們當主詞的句子，應該要用描述事實的方法來寫，也就是執筆的人不能以開發者或使用者的立場來描述，可以以開發團隊、本專案、研發小組等來代替我和我們，用企業或使用者來代替你和你們。另外，應該避免太過於主觀的形容方式，比如，五彩繽紛、雀躍不已等太過於情緒性的描述，或是最強的、超級快之類的形容，每個人的標準不同，超級快是有多快？大家的感覺不同，應該要以某種標準來衡量，比如：0.5秒鐘，0.1秒鐘等，顏色也有工業上使用的標準，或是電腦上的三原色比例的標準，應該要找到大家可以接受的標準來，以量化來衡量,盡量用條列式
5、的方法,文件必須有條理的來架構，除了在摘要的部份之外，盡量用列點的方式呈現，文件是用來查閱的，有條列式的一點一點的敘述，會讓使用文件的人比較方便閱讀和查詢，馬上可以抓得住重點，但是條列的點又不要太多，如果描述某件事情用了十幾二十點，那麼反而不知道重點在哪裡，最適當的大約是3到5點，不要大於7點，每個特定的主題或項目，內容要描寫仔細，不要怕太細節，資訊系統開發本來就是很多瑣碎的工作，需要做溝通、澄清，並且將他寫下來。,文件的使用,文件是記錄資訊系統的開發，以提供相關使用者查詢用的，所以在撰寫文件時，每個部分必須能容易查詢，比如，每份文件都有編號和名稱，以及是誰所撰寫的，在哪一天完成，是哪一個版本
6、，在下一個版本出來之前，又有誰修改過，修改過哪裡，另外，文件的數量和使用都應該事先擬定好方法來管理，文件總共有幾份，各放在哪裡，一定要做好備份，才不會辛辛苦苦做的報告或文件，到要用的前一天，突然不見了或是毀壞了而欲哭無淚。,什麼是規格(Specification)?,什麼是規格?當我們要訂做東西時，會和製作的廠商說明我們所需要的尺寸、顏色、材質、做法等，否則廠商怎麼會知道顧客要的是什麼樣子，將顧客所需的樣子一一用專業的尺寸和標準的衡量制度寫下來，就是規格，比如說訂做一件衣服，裁縫師會問顧客衣服是什麼場合要用的，是宴客、工作服、居家服，還是有其他的特殊用途，接著幫顧客量身材，肩膀的寬度、腰圍、臀
7、圍、手臂長度、腳的長度等，用通用的標準，像是英吋來丈量，並且問顧客所要的樣式，像領口的式樣是荷花領還是V型領，並且和顧客溝通，適時做專業的建議，把顧客的需求給寫下來，畫出來，裁縫師可以根據的內容來製作，就是製作規格書，接著用選定的布，開始裁製衣服，當衣服做到一定的程度，裁縫師會請顧客來試穿，看看合不合身，有沒有地方是需要修改的，當顧客滿意之後，再完成所有的工作。,這個例子中，有很多地方和開發軟體相似，開發軟體就像是為顧客量身定做衣服一樣，首先必須知道顧客要什麼，和顧客溝通，並且將他們所需要的功能給寫下來，加上開發者專業的知識，給顧客做建議，開發時必須和使用者做溝通，讓他們試用，看看有哪些需要修
8、改的地方，最後完成工作，開發軟體在早期也向訂做衣服一樣，是手工業。,繼續以製衣來做比喻，手工業是一個人縫製衣服，效率比較差，當然製衣工業希望能夠發展成專業的分工，如此可以引進機器來幫忙剪裁和縫合等工作，可以降低開發的成本，加快生產的速度，大量生產，這時，成衣的規格就很重要，工廠的每一個作業，都是由不同的專業人員來負責，需要採用專業的規格，如尺寸、顏色、布料的標準，這樣大家才能看得懂要怎麼做，標準的規格可以通行於不同的企業間，這樣子，貿易商才能下訂單，成衣廠才能接訂單，按照規格來生產每一張訂單。專業的規格，除了需要用一定的衡量標準之外，也會加上圖形，來表示成衣的花樣，也會有一些特定的式樣名稱和縫
9、製的方法名稱，來形容如何製作，像是比基尼、襯衫、圓領T恤，羅紋、考克等,軟體的開發也是一樣，對於顧客的需求，必須以開發團隊都看得懂的格式和符號來表示，也就是開出專業的規格，這樣子，才能讓系統開發團隊能夠溝通，為了能讓團隊中的每個人可以負責不同的工作，又可以彼此了解工作的內容，必須要發展規格和一些標準來使用，比如開發團隊中有人負責做對顧客的訪談，有人負責做功能的設計，有人撰寫程式，有人測試，有人建置資料庫等，當然最後都要整合起來，同時要控制進度，統合團隊的合作等，這些軟體團隊開發的依據就是系統規格書。,規格是系統的開發設計圖，需要用大家都認可的標準來製作，所以有很多的工具讓我們來使用，通常會使用
10、圖形化的工具，常見的有結構化的資料流程圖、實體關係圖、程式流程圖等，物件導向的使用個案、活動圖、狀態圖、類別圖等等，開發團隊可以根據專案的需求，或是不同的角度來決定要用哪一個圖形化工具，比如說從功能的角度來看，顧客需要的功能可以用資料流程圖來架構，說明功能的內容，和使用者之間的資料輸入輸出，功能作業的細部解析，每一細部解析之間的資料傳遞，資料的項目內容，以及所需的資料儲存等等，文字的說明當然也很重要，系統規格書的內容和選用的工具是由開發團隊選定的，並沒有一定的規定，只要團隊的成員可以使用和溝通，可以完整的表達出所要開發的軟體內容即可，系統分析與設計或是軟體工程的專書，都會有一些建議的內容。,比
11、如由資料、功能、使用者、物件、物件狀態或網路的角度，定義出所需要的內容和需求，比如說軟體中有哪些物件需要被開發，每個物件的屬性、方法和行為是什麼，物件和物件之間的交互作用的描述，每個物件的不同情境和狀態的描述等等，系統分析與設計這門學科，主要的目的就是要講如何製作系統的規格和設計，有哪些常用的圖形化工具，以及如何使用這些工具，當學習完這些常用的工具之後，能有專業的能力來閱讀、使用、並製作軟體系統規格書，就像專業的裁縫師一樣，可以製作出專業的衣服製作規格書，來製作不同顧客在不同場合所需的衣飾。,文件的大綱,這裡提供一些文件應該有的項目，以供製作文件時參考，其中頁數的建議是以4-5個人為一組的開發
12、團隊來開發4-6個月的專案為預估，大約是一組學生工作一學期的份量。,系統規劃,摘要(why和what，為什麼需要這個規劃中的資訊系統，這個將要開發的系統到底是做什麼的，不要列點敘述，1-2頁) 系統概述(敘述一下系統的目的、功能、和別的系統的關係，定義出系統的範圍，並且敘述所能帶來的好處或優勢，盡量列點敘述，或是圖形描述，2-4頁) 資源需求(列出所需要的時間、人力、組織、開發模式及工作項 目、軟硬體設備和總預估費用，評估可行性，盡量列點敘述，或是圖形描述，3-6頁) 附錄(包含會議記錄和同意書，有使用者的簽名以同意本階段結束，進入下一個階段，附錄中也可以包含參考資料),系統需求,摘要(說明本
13、分文件的內容，包含哪些重要的項目，不要列點，1頁) 產業現況(說明產業狀況，主要是說企業所在的產業特性，以及企業競爭者的資訊系統實施狀況，有哪些套裝軟體可以使用，盡量列點敘述，或是圖形描述，3-10頁) 企業背景(說明企業的現況，企業的組織架構、人員、產品、電腦設備、既有的資訊系統等，可以運用企業診斷模型做分析和建議，盡量列點敘述，或是圖形描述，3-10頁) 現行作業描述(描述企業現行的作業流程，可以使用各種圖形來幫忙表示，如流程圖、IDEF0、Use Case等情境描述的工具，主要的問題控制在大約是3-5點，描寫的時候要注意語氣，千萬不能留於批評，儘量以量化來表達作業所需的時間和資源，找出作
14、業的瓶頸或是問題，5-10頁) 系統功能(確認系同所要開發的功能，可以使用各種圖形來幫忙表示，如流程圖、IDEF0、Use Case等情境描述的工具，標示出新的作業方法所改善的地方，主要的功能大約是5-7個，每個功能作業都應該以圖形化畫出來，並且要加以說明，5-10頁) 系統取得評估(主要是在決定本系統該如何取得，自行開發或是向外購買，有沒有既有的套裝軟體是比較適合企業使用的，大約的價錢如何) 附錄(包含會議記錄和同意書，有使用者的簽名以同意本階段結束，進入下一個階段，附錄中也可以包含參考資料),系統設計,摘要(說明本分文件的內容，包含哪些重要的項目，不要列點，1頁) 功能設計(主要是設計系統
15、該有哪些功能，可以以適合的圖形工具來設計，通常以資料流程圖來架構，包含環境圖、第1層、第2層到最後一層，另外會以資料字典來定義資料流以及其他的相關內容，20-30頁) 資料庫設計(主要是架構資料庫，通常都是以實體關係圖來架構資料庫，說明該件哪些基本表，有哪一些欄位和資料型態等，5-10頁) 物件導向設計(以物件導向的角度來看系統，以各種圖形化工具，定義出物件、物件的狀態、行為和方法，以及以物件之間的動態關係，包含的圖形化工具為類別圖、順序圖、狀態圖等，20-30頁) 介面設計(主要是在做使用者的介面，包含了介面的架構圖和細部的設計圖，10-20頁) 系統架構(主要是在做硬體設備的建置設計，包括
16、主機、PC、網路架構等，5-10頁) 系統安全及授權(主要是在未資訊系統的運作構想出安全的措施，包含系統及資料的運作管理、備份、授權、災難回復計劃等，10-20頁) 附錄(包含會議記錄和同意書，有使用者的簽名以同意本階段結束，進入下一個階段，附錄中也可以包含參考資料),系統內容,摘要(說明本分文件的內容，包含哪些重要的項目，不要列點，1頁) 系統軟體架構(說明系統軟體的架構，包含作業系統、資料庫軟體、應用程式等的版本以及之間的關係) 應用程式(說明本系統自行開發的部分，有哪幾支程式，是對應哪一個模組、物件或是介面，說明程式的版本、內容、撰寫程式的人、完成的日期、以及程式碼等) 系統測試(說明系統的測試設計、資料、測試方法、日期、以及結果，比較系統需求和測試結果) 系統硬體架構(說明硬體的設備狀況，包含主機、PC、周邊設備、網路的架構等，將硬體的規格也作整體的說明，所購買的廠商以及保固的狀況，都應加以描述) 使用者手冊(以往的系統比較重視使用者手冊，但現在的大都簡單的描述，是給終端使用者用的，說明系統的主要功能和操作方法) 附錄(包含會議記錄和同意書，有使用者的簽名以同意本階段結束，進入下一個階段，附錄中也可以包含參考資料),
