1、詳細設(shè)計說明書編寫規(guī)范案卷號日期太陽能監(jiān)控系統(tǒng)詳細設(shè)計說明書 作 者： 高丹 完成日期： 簽 收 人： 簽收日期： 修改情況記錄：版本號修改批準人修改人安裝日期簽收人 目錄 1 引言11.1 編寫目的11.2 背景21.3 定義21.4 參考資料22 程序系統(tǒng)的結(jié)構(gòu)22.1 主程序的主要三層架構(gòu)關(guān)系32.2解決方案中關(guān)鍵項目說明32.3程序主序列監(jiān)聽部分SourceData43 WEB網(wǎng)頁詳細介紹43.1 程序描述43.2 功能53.3 性能53.4 角色權(quán)限劃分53.4 各個關(guān)鍵頁面說明：53.5 Plant頁面的調(diào)用順序74. WPF_Admin后臺信息配置114.1程序描述114.2 程

2、序性能114.3 主要窗體說明114.4 主要程序說明11詳細設(shè)計說明書1 引言1.1 編寫目的在前一階段已經(jīng)完成本項目的需求規(guī)格說明書，已經(jīng)完成了對用戶需求的定義，由于項目進度的需要，省略概要設(shè)計說明書，直接開始詳細設(shè)計說明書的編寫。在本階段中，包括如何把系統(tǒng)劃分成若干個模塊、決定各個模塊之間的接口、模塊之傳遞的信息，以及數(shù)據(jù)結(jié)構(gòu)、模塊結(jié)構(gòu)的設(shè)計。確定應(yīng)該如何具體地實現(xiàn)所要求的系統(tǒng)，從而在編碼階段可以把這個描述直接翻譯成用具體的 程序語言書寫的程序。主要的工作有：根據(jù)在需求分析說明書中所描述的數(shù)據(jù)、功能、運行、性能需求，并設(shè)計軟件系統(tǒng)的結(jié)構(gòu)設(shè)計、逐個模塊的程序描述（包括各模塊的功能、性能、輸

3、入、輸出、算法、程序邏輯、接口等等） 在以下的各個階段中，用戶操作手冊將與本階段的工作緊密結(jié)合，努力作到讓用戶易懂易學(xué)。測試報告和維護報告也將參考本說明書，檢驗本系統(tǒng)的各項性能指標，及時發(fā)現(xiàn)紕漏及時修補，一定要把功能強大、穩(wěn)定可靠、便于維護的機票預(yù)定系統(tǒng)交到用戶手中。1.2 背景說明：本項目（太陽能監(jiān)控系統(tǒng)）由陜西西科美芯科技集團有限公司承接開發(fā)。具體工作有西科美芯軟件開發(fā)部承接。a 項目名稱: 太陽能監(jiān)控系統(tǒng)；b 研發(fā)單位：陜西西科美芯科技集團有限公司c 研發(fā)人員：高丹 鹿堯 嚴單單 李輝 1.3 定義 SQL SERVER: 系統(tǒng)服務(wù)器所使用的數(shù)據(jù)庫管理系統(tǒng)（DBMS）。SQL: 一種用于

4、訪問查詢數(shù)據(jù)庫的語言Socket:。1.4 參考資料以下列出要用到的參考資料：1. 需求規(guī)格說明書；2 程序系統(tǒng)的結(jié)構(gòu)程序采用Windows窗體程序SourceData接收來集中器發(fā)送到網(wǎng)絡(luò)上的數(shù)據(jù)，處理后將數(shù)據(jù)存儲到數(shù)據(jù)庫當中去。采用報表程序ReportServer定期生成相關(guān)報表。UI層采用B/S模式，根據(jù)用戶需求獲取對應(yīng)信息。2.1 主程序的主要三層架構(gòu)關(guān)系依賴關(guān)系圖2.2解決方案中關(guān)鍵項目說明項目名稱說明SourceData用于接收和處理集中器發(fā)送上來的數(shù)據(jù)，解析存庫Web整個項目采用B/S架構(gòu) 所以web為本項目的UI呈現(xiàn)層，以及用于數(shù)據(jù)交互的webservice層BLL業(yè)務(wù)邏輯層I

5、DAL數(shù)據(jù)訪問抽象層SQLServerDAL數(shù)據(jù)訪問實現(xiàn)層，采用T-SQL實現(xiàn)對MSSqlserver的訪問DBUtility數(shù)據(jù)庫操作層，實現(xiàn)參數(shù)綁定，數(shù)據(jù)庫查詢、修改、刪除等具體代碼SA_Login用于實現(xiàn)登陸的Sliverlight界面SA_PlantWorkSpace用于呈現(xiàn)某個太陽能電站的Sliverlight界面SA_MovieReport用于呈現(xiàn)某個太陽能電站數(shù)據(jù)回放的Sliverlight界面ReportServer定期生成相關(guān)報表WPF_Admin后臺配置界面（WPF），配置電站、電池板、傳感器等關(guān)鍵信息Admin后臺配置界面(WindowsForm)，提供一些配界面供WPF

6、_Admin引用2.3程序主序列監(jiān)聽部分SourceData 3 WEB網(wǎng)頁詳細介紹3.1 程序描述采用ASP.NET+Sliverlight的模式呈現(xiàn)系統(tǒng)SourceData和ReportServer接收處理后的數(shù)據(jù)。交互的關(guān)系圖：3.2 功能實現(xiàn)系統(tǒng)登陸、電站列表查詢、電站詳細信息查詢、電站報表信息查詢3.3 性能具體性能應(yīng)按照部署的IIS服務(wù)器的硬件性能和網(wǎng)絡(luò)接入條件而定。3.4 角色權(quán)限劃分3.4 各個關(guān)鍵頁面說明：頁面名稱說明截圖(可放大)Default.aspxWeb項目的默認起始頁，頁面主要由登陸模塊構(gòu)成，用于阻擋非常用戶的訪問，以及給予不同角色的用戶的訪問權(quán)限map.aspx呈

7、現(xiàn)本系統(tǒng)中以及納入的電站的列表。plant.aspx呈現(xiàn)某個基站電站的詳細情況DianChiBan.aspx查詢某個電池板的報表信息help.aspx系統(tǒng)幫助頁面3.5 Plant頁面的調(diào)用順序3.5.1 關(guān)鍵代碼前臺JS： <script type="text/javascript"> function request(paras) var url = location.href; var paraString = url.substring(url.indexOf("?") + 1, url.length).split("&am

8、p;"); var paraObj = for (i = 0; j = paraStringi; i+) paraObjj.substring(0, j.indexOf("=").toLowerCase() = j.substring(j.indexOf("=") + 1, j.length); var returnValue = paraObjparas.toLowerCase(); if (typeof (returnValue) = "undefined") return "" else retur

9、n returnValue; /定義全局函數(shù)： function getArrayTest() return request('id'); function goo(o) o.href = "#DianChiDiv" o.click(); </script>3.5.2 關(guān)鍵代碼調(diào)用前臺JS： private void hh_Loaded(object sender, System.Windows.RoutedEventArgs e) try / TODO: Add event handler implementation here. HtmlWi

10、ndow win = HtmlPage.Window; /win.Alert("Silverlight 里面彈出的對話框。 "); /執(zhí)行頁面中的js函數(shù)： win.Eval("getArrayTest()"); string id = win.Invoke("getArrayTest", null).ToString(); WSCollector.WSCollectorSoapClient wc = new SA_PlantWorkSpace.WSCollector.WSCollectorSoapClient(); wc.getDa

11、taByPlantIdCompleted += new EventHandler<SA_PlantWorkSpace.WSCollector.getDataByPlantIdCompletedEventArgs>(wc_getDataByPlantIdCompleted); wc.getDataByPlantIdAsync(id); catch (Exception ex) label1.Content = ex.Message; 3.5.3 關(guān)鍵代碼定時刷新：refreshData = new DispatcherTimer(); refreshData.Interval = n

12、ew TimeSpan(0, 0, 0, 0, 5000); refreshData.Tick += new EventHandler(refreshData_Tick); refreshData.Start(); void refreshData_Tick(object sender, EventArgs e) if (!firstBuildSensors) for (int i = 0; i < DianChiBanList.Count; i+) DianChiBanListi.buildSensorIds(); firstBuildSensors = true; for (int

13、i = 0; i < DianChiBanList.Count; i+) /更新溫度 WSInstData.WSInstDataSoapClient wcInstDataC = new SA_PlantWorkSpace.WSInstData.WSInstDataSoapClient(); wcInstDataC.getInstDataCompleted += new EventHandler<SA_PlantWorkSpace.WSInstData.getInstDataCompletedEventArgs>(wcInstData_getInstDataCompletedC

14、); wcInstDataC.getInstDataAsync(Convert.ToInt32(DianChiBanListi.Csensor.id); /更新電壓 WSInstData.WSInstDataSoapClient wcInstDataV = new SA_PlantWorkSpace.WSInstData.WSInstDataSoapClient(); wcInstDataV.getInstDataCompleted += new EventHandler<SA_PlantWorkSpace.WSInstData.getInstDataCompletedEventArgs

15、>(wcInstData_getInstDataCompletedV); wcInstDataV.getInstDataAsync(Convert.ToInt32(DianChiBanListi.Vsensor.id); /更新電流 WSInstData.WSInstDataSoapClient wcInstDataA = new SA_PlantWorkSpace.WSInstData.WSInstDataSoapClient(); wcInstDataA.getInstDataCompleted += new EventHandler<SA_PlantWorkSpace.WSI

16、nstData.getInstDataCompletedEventArgs>(wcInstDataA_getInstDataCompleted); wcInstDataA.getInstDataAsync(Convert.ToInt32(DianChiBanListi.Asensor.id); for (int i = 0; i < DianChiBanList.Count; i+) foreach (var child in this.workSpace.Children) string s = child.GetType().Name; if (s = "dianch

17、iban") /MessageBox.Show(tempProvince); dianchiban el = child as dianchiban; if (el.Tag.ToString() = DianChiBanListi.CollectorId) string Str = Math.Round(Convert.ToSingle(DianChiBanListi.Vsensor.value) * Convert.ToSingle(DianChiBanListi.Asensor.value), 2).ToString(); el.updatePower(Str); 3.5.4 關(guān)

18、鍵代碼WEBService代碼namespace WEB.WS / <summary> / WSInstData 的摘要說明 / </summary> WebService(Namespace = "/") WebServiceBinding(ConformsTo = WsiProfiles.BasicProfile1_1) System.ComponentModel.ToolboxItem(false) / 若要允許使用 ASP.NET AJAX 從腳本中調(diào)用此 Web 服務(wù)，請取消對下行的注釋。 / System.Web.Script.Services.ScriptService public class WSInstData : System.Web.Services.WebService / <summary> / 得到實時數(shù)據(jù)表中最新的數(shù)據(jù) / </summary> / <param name="sensorId">傳感器ID</param> / &l