EMS V1.20能源管理系統(tǒng) KPI子系統(tǒng) 概要設計說明書 V1.00

PAGEEMSV1.2KPI子系統(tǒng)功能概要設計說明書V1.00文件編號生效日期受控編號保密級別一級版本號V1.00修改次數(shù)0總頁數(shù)正文附錄無編制吳曉彥審核批準(版權所有,翻版必究)評審記錄對《EMSV1.20平臺功能概要設計說明書V1.00》的評審意見：上述問題修改驗證后，由驗證后，本文件即可發(fā)布。評審人員簽字：問題修改驗證結果：驗證人簽字：時間：年月日變更日志編號版本修改內容修改人修改日期1V1.00定稿。吳曉彥目錄TOC\o"2-3"\h\z\t"標題1,1"1引言 11.1編寫目的 11.2背景 11.3定義 11.4參考資料 12總體設計 22.1需求規(guī)定 22.1.1功能邊界 22.1.2性能邊界 22.2運行環(huán)境 22.2.1硬件環(huán)境 22.2.2軟件環(huán)境 22.3概要設計決策 22.3.1設計原則 22.3.2設計決策 32.4開發(fā)環(huán)境 42.5界面設計 42.6功能模塊劃分 52.7系統(tǒng)結構 62.7.1系統(tǒng)框架圖 63模塊設計 73.1KPI子系統(tǒng) 73.1.1實現(xiàn)方案 73.1.2數(shù)據(jù)庫表結構 73.1.3計算方法 83.1.4執(zhí)行流程 93.1.5接口 9KPI子系統(tǒng)功能概要設計說明書V1.00PAGE11引言1.1編寫目的本文檔是對天溯EMSV1.20能源管理系統(tǒng)軟件V1.2（以下簡稱NTS-9000系統(tǒng)或本系統(tǒng)）進行詳細分析和討論后得出的分析說明書，旨在明確本軟件模塊的功能需求。通過本說明書，可以了解到本軟件的開發(fā)背景、建設要求、功能需求等。各個模塊的開發(fā)人員閱讀此文檔后，以各個模塊的功能為基礎，兼顧配合服務器模塊，完成各自模塊的功能。本文檔面向的讀者是：EMSV1.20項目組各成員。1.2背景原天溯NTS-9000強弱電一體化平臺系統(tǒng)軟件V1.20及EMSV1.15以前的版本，在業(yè)務、規(guī)模及相關功能上無法支撐快速發(fā)展的客戶需求，在此基礎上對客戶需求進行分析、篩選并結合目前系統(tǒng)的架構，對功能進行升級/完善、規(guī)模擴充，實現(xiàn)對醫(yī)院、商業(yè)載體等實現(xiàn)全面的監(jiān)測、分析，給運維人員提供便利，給管理者提供決策分析。1.3定義下表列出本報告中專門術語的定義、英文縮寫詞的原詞組和意義、項目組內達成一致意見的專用詞匯，同時繼承全部的先前過程中定義過的詞匯。詞匯名稱詞匯含義備注常規(guī)定額水、電、氣等能耗種類定額經營性定額單位床日、萬元收入、業(yè)務量定額1.4參考資料編號資料名稱說明1EMSV1.20系統(tǒng)需求包-140828-一階段需求.xlsx2總體設計2.1需求規(guī)定2.1.1功能邊界1）首頁KPI概覽。顯示總區(qū)域的KPI數(shù)據(jù)，如消耗百分比、消耗值，數(shù)據(jù)通過儀表盤顯示展示。模塊要求：能夠靈活配置KPI總覽顯示的項，經營性KPI和常規(guī)類型KPI可以靈活搭配。2）KPI定額管理。主要展示常規(guī)能源種類的定額值以及KPI數(shù)據(jù)信息（包括節(jié)能、正常等數(shù)據(jù)），其中KPI數(shù)據(jù)信息以二層樹模型展示。3）經營性KPI。主要展示經營性相關的kPI數(shù)據(jù)信息，如百分比、消耗值，以儀表盤的形式展示（不包括節(jié)能、正常等數(shù)據(jù)）。2.1.2性能邊界首頁KPI數(shù)據(jù)請求響應時間不超過3s。2.2運行環(huán)境2.2.1硬件環(huán)境硬件環(huán)境類別要求備注CPU2.0GHz以上CPU內存2.0GB或以上主機硬盤80GB或以上2.2.2軟件環(huán)境軟件環(huán)境類別要求備注操作系統(tǒng)Windows2000/2003或WindowsXPSP3或Win2008R232bit或Win732bit旗艦版數(shù)據(jù)庫SQL2000SP3及以上或MSSQL2005開發(fā)版（32bit）或MSSQLServer2008企業(yè)版（32bit）2.3概要設計決策2.3.1設計原則要有一個良好的設計框架。為了軟件能適應未來幾年的現(xiàn)場需要，通用數(shù)據(jù)配置模塊應該根據(jù)實際需要保持一定的可擴展性、可復用性，這就要求系統(tǒng)升級時對已基于該系統(tǒng)實施的系統(tǒng)兼容，軟件設計必須有良好的設計框架。其中包括：第一、采用復用技術。第二、底層業(yè)務模塊相對獨立，統(tǒng)一接口，做到高內聚、低耦合。第三、良好的人機交互界面。系統(tǒng)的使用要考慮現(xiàn)場人員的易用性本軟件的最終用戶為現(xiàn)場的運行維護人員，在設計軟件時要考慮人員的使用習慣和方便使用；簡單易用的系統(tǒng)可以提高現(xiàn)場工程實施人員的效率，降低出錯的幾率。系統(tǒng)需要具有足夠的靈活性KPI子系統(tǒng)中KPI首頁總覽應根據(jù)實際數(shù)據(jù)準備情況，可自由配置顯示的時間段、顯示的項（電能耗、經營性能耗等）。2.3.2設計決策本節(jié)記錄對概要設計具有重要影響的軟件需求和約束，描述相關的重要決策和決策的原因。這些決策一般對設計有很大影響,它們的改變很難通過設計技巧來屏蔽，例如所選用的開發(fā)語言,所選用的平臺、組件和框架，對關鍵業(yè)務，類和方法的處理等。2.3.2.1KPI數(shù)據(jù)查詢設計設計決策KPI數(shù)據(jù)查詢模塊標識號001問題描述首頁請求的KPI數(shù)據(jù)包含兩大類：經營性能耗KPI和常規(guī)能耗KPI數(shù)據(jù)KPI定額功能需要查詢常規(guī)能耗KPI數(shù)據(jù)以及定額數(shù)據(jù)經營性能耗功能需要查詢與經營業(yè)務相關的KPI數(shù)據(jù)假設條件可選方案1返回數(shù)據(jù)的接口類中包括兩大類：經營性能耗KPI和常規(guī)能耗KPI數(shù)據(jù)，定額數(shù)據(jù)信息優(yōu)點：不用重復設計接口類，一個功能類完成2項任務。缺點：當首頁請求后，后臺返回數(shù)據(jù)有冗余?？蛇x方案2為經營類數(shù)據(jù)、定額數(shù)據(jù)和常規(guī)類數(shù)據(jù)均建立一個接口類優(yōu)點：由于每個頁面請求的數(shù)據(jù)和每一個接口類均對應，邏輯更加清晰。缺點：由于兩大類KPI數(shù)據(jù)，本質上是相同的，因此存在不同類做相同任務的弊端。決策使用方案1影響當“KPI定額”功能請求數(shù)據(jù)時，此時返回結果包括：常規(guī)能耗KPI數(shù)據(jù)和定額數(shù)據(jù)；反之，當“經營性能耗KPI”功能請求數(shù)據(jù)時，此時僅返回與經營相關的KPI數(shù)據(jù)，定額數(shù)據(jù)為null。相關決策2.4開發(fā)環(huán)境開發(fā)用機器類別要求備注CPU2.40GHzCPU內存4G主機硬盤250G網卡100Mb/s操作系統(tǒng)Windows7旗艦版64bitwindowsxp開發(fā)環(huán)境MicrosoftVisualStudio2010旗艦版2.5界面設計界面1

界面2界面32.6功能模塊劃分 2.7系統(tǒng)結構2.7.1系統(tǒng)框架圖 3模塊設計3.1KPI子系統(tǒng)3.1.1實現(xiàn)方案 首頁KPI要能夠靈活搭配各類KPI組合顯示，同時滿足設置時間條件，如當月、上月、當年、上年四類，以保證首頁面可以有數(shù)據(jù)展示。因此，首頁需要在數(shù)據(jù)庫中添加一張表，用來存在配置信息。 KPI定額管理功能和1.1版本基本一致，通過選擇區(qū)域對象和時間粒度，將各類常規(guī)能耗的定額值，KPI數(shù)據(jù)讀出，以儀表盤的形式展示。 經營性KPI功能可以視為對常規(guī)KPI的擴展，將經營性數(shù)據(jù)納入其中制定KPI。因此，需要建立一張與業(yè)務相關的基本表，存放業(yè)務類型、業(yè)務項描述信息、業(yè)務計算單位。另外，還需要一張表來存放具體的業(yè)務數(shù)據(jù)，如單位床數(shù)、業(yè)務量、萬元收入信息。而定額信息的描述，為了和已有常規(guī)定額區(qū)分對1.1.定額表，添加一個標識字段，說明是否為經營類定額。3.1.2數(shù)據(jù)庫表結構經營業(yè)務表（TD_EMS_BusinessType）該表主要存放與客戶業(yè)務相關的，衡量能耗的參數(shù)。字段名描述類型說明PK_BusinessTypeVarchar(10)PKDescription對象描述varchar(32)關于此定額的輔助說明Unit單位Varchar(5)Notnull例子：<1，"按床位數(shù)"，"張">，<2，"按業(yè)務量"，"人次"><3,''按單位空調面積","KWh/m2",><4,"按萬元收入","T/元">經營數(shù)據(jù)表（TB_EMS_BusinessData）字段名描述類型說明BusinessDataIDint自動編號PKRecordTime時間Datetime時刻點當月經營數(shù)量notnullZValue屬性數(shù)值floatNullFK_BusinessData_BusinessTypeInt外鍵，與經營業(yè)務ID對應；notnullAreaIDInt關聯(lián)tb_area中的areaid；notnullRecordType年、月Int1：月2：年；notnull例子：<1，'2014-09-01',5000，1，35>：2014年9月，實際使用床位數(shù)5000張，該區(qū)域ID為35.<2，'2014-09-01',100000，2，1>：2014年9月，業(yè)務量10萬人次，該區(qū)域ID為1.<3，'2014-05-01',3000，3，1>：2014年5月，空調覆蓋面積3千平，該區(qū)域ID為1.<4，'2014-04-01',300000，4，1>：2014年4月，本月萬元收入30萬，該區(qū)域ID為1.經營定額表（TB_EMS_Quota）字段名描述類型說明PK_QuotaID自增idintPKQUOTAID定額idint定額id；notnullOBJECTTYPE對象類型smallint對象類型；notnullOBJECTID對象idint對象id；notnullOBJECTDESC對象描述varchar(32)對象描述QUOTATYPE定額類型smallint1:月定額2：年定額；notnullItemCode業(yè)務代碼varchar(5)分類分項代碼；包括：經營類和常規(guī)類兩種數(shù)據(jù)。QUOTATIME定額時間datetime定額時間；notnullQUOTAVALUE定額值float定額值IsBusiness標志是否為經營業(yè)務類型Smallint1：是經營業(yè)務2：常規(guī)類型能耗區(qū)域附加信息表（TB_EMS_AreaInfo） 在KPI評價中，如按面積評價，在1.1版本中區(qū)域附加信息表中已經包含了”面積“的配置。計算單位面積KPI可以從此表讀取數(shù)據(jù)。KPI配置表（TD_EMS_KPIConfig）字段名描述類型說明KPIConfigID自增idintPKType經營類型和常規(guī)類型int1：常規(guī)類型2：經營類型；notnullCode經營類或常規(guī)類編碼Varchar(10)notnullTimeDisplay配置首頁KPI顯示的時間范圍IntNotnull。1:上月2：上年3：本月4：本年舉例：<1,1,"01000",3>首頁需要顯示一個電的KPI，統(tǒng)計時間范圍為本月；<21,"1",1>首頁需要顯示一個單位床日的KPI，統(tǒng)計時間范圍為上月；<3,1,"4",2>首頁需要顯示一個萬元收入的KPI，統(tǒng)計時間范圍為上年；備注：1.2一階段中，數(shù)據(jù)條目即為4行。其它需要表TS_EMS_Datacenter_Area_HourTS_EMS_Datacenter_Area_DayTS_EMS_Datacenter_Area_Month3.1.3計算方法（1）單位床日能耗KPI=（總能耗數(shù)據(jù)）/床日數(shù)。當給定時間（本月、本年、上月、上年）類型時，總能耗數(shù)據(jù)為該時間段內的能耗消費值。（2）單位業(yè)務量KPI=（總能耗數(shù)據(jù)）/業(yè)務量?？偰芎臄?shù)據(jù)同上。業(yè)務量：由床日數(shù)、門診數(shù)按不同權重計算所得。（3）本月（年）床日數(shù)=本月（年）內每個住院病人的住院天數(shù)累加起來，每月（年）由維護人員手工錄入上月（年）的月（年）度床日數(shù)；業(yè)務量=門診人次、住院人次的加權合計數(shù)，業(yè)務量也是每月（年）由維護人員手工錄入上月（年）的業(yè)務量（業(yè)務量=業(yè)務量為床日數(shù)+門診數(shù)量/3）。（4）單位面積能耗KPI=月（年）總電能耗/建筑面積。（5）單位空調面積KPI=空調總電能耗/空調覆蓋區(qū)域面積。（6）萬元收入能耗KPI=月（年）總耗能/月（年）萬元收入。3.1.4執(zhí)行流程KPI總覽定額和經營KPI執(zhí)行3.1.5接口3.1.5.1首頁KPI配置類//KPI顯示配置類publicclassKPIConfigModel{publicintID{get;set;}//id值///<summary>///1：常規(guī)類型2經營類型///</summary>publicintType{get;set;}///<summary>///常規(guī)類或經營類編碼///</summary>publicstringCode{get;set;}///<summary>///1:上月2：上年3：本月4：本年///</summary>publicintTimeDisplay{get;set;}}3.1.5.2KPI查詢類//KPI查詢參數(shù)類publicclassQueryKPIModel{///<summary>///對象ＩＤ///</summary>[DataMember]publicintAreaID{get;set;}///<summary>///定額時間///</summary>[DataMember]publicDateTimeQuotaTime{get;set;}///<summary>///定額時間類型：0月1年///</summary>[DataMember]publicintQuotaType{get;set;}///<summary>///KPI類型：0常規(guī)類型1經營業(yè)務///</summary>[DataMember]publicintIsBusiness{get;set;}///<summary>///該值為：常規(guī)類型水、電等編碼或經營業(yè)務編碼///</summary>[DataMember]publicstringItemCode{get;set;}}3.1.5.3KPI結果返回類//返回前端字符串類publicclassResultKPIStatistics{publicExecuteProcessActionInfo{get;set;}publicList<EnergStatisticsModel>EnergyStatistics{get;set;}publicList<QuotaModel>QuotaItems{get;set;}}類3和4：//KPI數(shù)據(jù)封裝publicclassEnergStatisticsModel{publicstringQuotaName{get;set;}//定額名字publicdecimalConsumPercent{get;set;}//占用百分比publicdecimalConsumValue{get;set;}//消耗值publicdecimalQuotaValue{get;set;}//定額值publicdecimalUnit{get;set;}//單位publicdecimalEvaluation{get;set;}//評價系數(shù)節(jié)能正常超額}//定額對象封裝publicclassQuotaModel{publicstringQuotaName{get;set;}//名字publicdecimalQuotaValue{get;set;}//定額值publicdecimalUnit{get;set;}//單位publicstringItemCode{get;set;}//分類分項名字}3.1.5.4KPI接口函數(shù)（1）WCF方法定義：publicList<KPIConfigModel>GetKPIConfigs();取值流程：首先讀取數(shù)據(jù)庫中的KPI配置表，根據(jù)表中的數(shù)據(jù)獲取List<KPIConfigModel>類型的結果。（2）WCF方法定義：publicList<ResultKPIStatistics>GetKPIEnergy();功能：根據(jù)KPI配置表中的數(shù)據(jù)獲取List<KPIConfigModel>類型的結果，組裝為QueryKPIModel對象