EMS能源管理系統V1.1統計服務模塊概要設計說明書V1.00文件編號生效日期受控編號保密級別一級版本號V1.00修改狀態A總頁數29正文23附錄無編制陸電審核批準(版權所有,翻版必究)評審記錄對《EMS能源管理系統V1.1統計服務模塊概要設計說明書V1.00》的評審意見：上述問題修改驗證后，由驗證后，本文件即可發布。評審人員簽字：問題修改驗證結果：驗證人簽字：時間：變更日志編號版本修改內容修改人修改日期11.00初稿做成陸電2014.08.11目錄一引言 一引言1.1編寫目的本文檔是對能源管理系統統計服務模塊的要求進行詳細分析和討論后得出的概要設計說明書，旨在明確模塊的總體和接口設計，以及各模塊中較重要業務的流程和對象的設計。通過本概要設計說明書，可以了解到統計服務模塊的功能邊界、設計思路、模塊設計等。本文檔面向的讀者是：能源管理系統統計服務模塊項目組開發人員、測試人員、QA。1.2背景項目名稱：統計服務模塊V1.0立項單位：研發中心開發單位：EMS能源管理系統項目組背景概述：EMS能源管理系統V1.1統計模塊主要是實現各類型區域、設備各分類分項能耗數據的統計及入庫處理，包括時統計、天統計、月能耗統計。1.3假定和約束本設計文檔假定用能計費系統（EMCS）V1.10整體升級到用能計費系統（EMCS）V1.15，具備V1.10版本中所有已實現功能。本設計文檔只涉及產品部提供的需求說明書闡述部分的功能開發，不涉及用能計費系統（EMCS）V1.15開發過程中自行消化的功能需求。1.4定義下表列出本報告中專門術語的定義、英文縮寫詞的原詞組和意義、項目組內達成一致意見的專用詞匯，同時繼承全部的先前過程中定義過的詞匯。詞匯名稱詞匯含義備注1.5參考資料編號資料名稱說明1醫院高效用能監測管理系統需求說明書-140401.doc二總體設計2.1需求規定2.1.1功能主角能耗統計設備、區域各類型能耗時統計設備時能耗統計（包括分類：電、水氣；分項：照明、空調、動力、特殊及自定義類型，具體由現場確定）；區域時能耗統計（包括分類：電、水氣；分項：照明、空調、動力、特殊及自定義類型，具體由現場確定）；設備、區域各類型能耗天統計設備天能耗統計（包括分類：電、水氣；分項：照明、空調、動力、特殊及自定義類型，具體由現場確定）；區域天能耗統計（包括分類：電、水氣；分項：照明、空調、動力、特殊及自定義類型，具體由現場確定）；設備、區域各類型能耗月統計設備月能耗統計（包括分類：電、水氣；分項：照明、空調、動力、特殊及自定義類型，具體由現場確定）；區域月能耗統計（包括分類：電、水氣；分項：照明、空調、動力、特殊及自定義類型，具體由現場確定）；費用統計分時計費支持區域、設備尖峰平谷費用統計；平價計費支持區域、設備電平價費用統計；支持區域、設備水平價費用統計；支持區域、設備氣平價費用統計；階梯計費支持區域、設備電階梯費用統計；支持區域、設備水階梯費用統計；支持區域、設備氣階梯費用統計；2.1.2系統邊界系統設備與9000平臺正常通訊，數據能準確入庫，為此系統模塊外部環境；數據的處理及入庫為系統內部條件。2.1.3非功能性要求支持10000個設備統計數據入庫。2.2系統結構2.2.1系統網絡架構圖2.2.1系統網絡架構圖系統采用C/S+B/S架構，其中數據統計處理采樣C/S架構，展示及EMS基礎應用配置采用B/S架構。系統模型主要分三層結構進行設計，即設備層、網絡層、監控層。設備層設備層儀表負責采集系統需要的數據，并對原始數據進行預處理，通過與通訊管理機建立通訊，將相應數據上送至數據采集器；常見的儀表主要有：水表、氣表、電表等。網絡層由通訊總線、數據采集器、交換機、路由器等組成，其中數據采集器與監控系統相獨立，采用基于嵌入式的平臺，能與現場各種智能儀表通訊；同時也提供遠傳功能，能夠向兩個及以上的數據中心收發數據。通訊總線對智能儀表采用總線RS-485，以總線方式組成分布式結構，便于擴充和維護；與監控系統的通訊采用以太網方式。已內置當前常用的協議，通過簡單的設置即可應用；同時，軟件已為協議擴充搭好了框架，適應不同廠家的特殊協議。監控層監控層由9000平臺（V1.2版本）、EMS能源管理系統V1.1構成，主要實現能耗數據采集、數據分類與匯總、數據統計、數據分析；數據展示、實時監測、數據遠傳。其中9000平臺主要是基礎數據配置及采集；EMS能源管理系統主要是實現數據展示分析。通常是又通訊服務器、數據庫服務器、WEB服務器構成。2.2.2統計服務模塊內外關系關系圖說明如下：EMS能源管理系統C/S部分由統計服務模塊、斷點及告警服務模塊、TSWEBSERVICE模塊構成；B/S部分由展示分析部分和系統配置部分組成。其中統計服務模塊、斷點及告警服務模塊、TSWEBSERVICE模塊彼此之間沒有直接關系；統計服務模塊、斷點及告警服務模塊通過平臺接口與數據庫交互；TSWEBSERVICE模塊通過9000平臺接口生成文件，提供給設備監測頁面展示。2.3運行環境2.3.1軟件要求服務器操作系統：WindowsServer2008企業版服務器數據庫：SQLServer2005企業版服務器必選組件：IIS7.0服務器必選組件：.NETFramework4.0服務器輔助軟件：MicrosoftOffice2003客戶機瀏覽器：Chrome、Firefox、≥IE82.3.2硬件要求服務器CPU：≥雙核2.0服務器內存：≥4G服務器硬盤：≥1T2.3.3、網絡要求物理網絡：100M/1000M以太網絡2.4開發規范2.4.1代碼編寫規范 VC代碼編寫要求符合《VC編程規范-00.doc》2.4.2、源碼管理規范 服務模塊的源碼及相關設計文檔上傳到SVN。 三接口設計3.1、Interface接口定義/************************************************************************@函數 :GetValueBySampleNO*@訪問 :public*@限定 :*@參數 :intsampletype采樣類型（１代表時，２代表天，３代表月）*@參數 :intsampleno采樣號*@參數:CStringsaapletime采樣時間*@返回 :返回指定時間采樣值*@作者 :lud*@日期 :2014/8/12*@說明 :獲取采樣值***********************************************************************/doubleGetValueBySampleNO(intsampletype,intsampleno,CStringsaapletime)；/************************************************************************@函數 :GetItemCodeByNO*@訪問 :public*@限定 :*@參數 :intitemnumber傳入分類分項索引*@返回 :cstring分類分項代碼*@作者 :lud*@日期 :2014/8/12*@說明 :獲取分類分項代碼***********************************************************************/CStringGetItemCodeByNO(intitemnumber);/************************************************************************@函數 :GetObjectvValue*@訪問 :public*@限定 :*@參數 :intObjectno傳入對象ＩＤ*@參數 :intobjecttype傳入對象類型*@參數 :CStringitemcode傳入分類分項*@參數 :CStringstrbegintime傳入開始時間*@參數 :CStringstrendtime傳入結束時間*@返回 :float*@作者 :lud*@日期 :2014/8/12*@說明 :獲取對象總值***********************************************************************/floatGetObjectvValue(intObjectno,intobjecttype,CStringitemcode,CStringstrbegintime,CStringstrendtime);/************************************************************************@函數 :GetTimeByType*@訪問 :public*@限定 :*@參數 :intpaymenttype傳入費率類型*@參數 :CStringitemcode傳入分類分項*@參數 :CString&strbegintime獲取開始時間*@參數 :CString&strendtime獲取結束時間*@返回 :BOOL*@作者 :lud*@日期 :2014/8/12*@說明 :獲取某種費率開始及結束時間***********************************************************************/BOOLGetTimeByType(intpaymenttype,CStringitemcode,CString&strbegintime,CString&strendtime);/************************************************************************@函數 :ns__downFileInMac*@訪問 :public*@限定 :*@參數 :intdevno傳入設備號*@返回 :int設備索引*@作者 :lud*@日期 :2014/8/12*@說明 :獲取設備索引***********************************************************************/intGetDevIndexByNO(intdevno);/************************************************************************@函數 :GetStepIndex*@訪問 :public*@限定 :*@參數 :intigear傳入索引*@返回 :int檔位檔次*@作者 :lud*@日期 :2014/8/12*@說明 :獲取檔位檔次***********************************************************************/intGetStepIndex(intigear)；/************************************************************************@函數 :GetPeriodPrice*@訪問 :public*@限定 :*@參數 :CStringitemcode傳入分類分項*@返回 :float返回分時價格*@作者 :lud*@日期 :2014/8/12*@說明 :獲取分時價格***********************************************************************/floatGetPeriodPrice(CStringitemcode);四數據庫設計4.1數據表設計4.1.1TB_AREA(區域表)字段名描述類型允許空說明ID序號自增字段×AREAID區域編號int×CNAME區域類型Varchar(64)√PROJECTID工程smallint√STATIONID廠站smallint√DESCRIPTION區域描述Varchar(256)√FLAG標志tinyint√BUILDINGID建筑編號smallint√PARENTID父節點int×PIC區域圖片varchar(150)√ISBIAOGAN是否標桿int√AREATYPE建筑性質int√XMLFILEimage√4.1.2TB_AREA_Info(區域附加信息表)字段名描述類型允許空說明ID序號自增字段×AREAID區域編號int×CLASSID類型int×INFOVALUE數值float√REMARK1描述1（關閉算式）varchar(128)√ITEMCODE分類分項IDsmallint√DEEPTH層級深度int√AREANUM面積float√PERSONNUM人數int√LOCATION位置varchar(50)√4.1.3TB_DEVICE_PROPERTY（設備附加信息表）字段名描述類型允許空說明ID序號int×自增字段DEVICEID設備編號int×DEVICE_ITEMCODE分類分項IDint×DEVICE_HEAD_NUMsmallint√DEVICE_CONTAIN_DEVvarchar(1024)√DEVICE_RATINGint√DEVICE_LOCATION位置varchar(128)√DEVICE_ORGANIZATIONvarchar(128)√DEVICENUMBERvarchar(15)√AREAID1所屬區域1int√AREAID2所屬區域2int√AREAID3所屬區域3int√PAY_TYPE計費類型smallint√4.1.4TB_BECM_COUNTTYPE（分類分項配置表）字段名描述類型允許空說明ID序號smallintint×自增字段CNAME名稱varchar(64)×PARENTID所屬大類IDsmallint×DESCRIPTION能源類型索引varchar(128)×ITEMUNIT能源單位varchar(50)√ITEMCOAL轉化煤系數float√ITEMCO2轉化二氧化碳系數float√ITEMMONEY金額（未啟用）float√4.1.5TB_BECM_COUNT_CONFIG(統計配置表)字段名描述類型允許空說明ID索引int×自增CNAME統計類型名varchar(64)×DATASOURCE數據源binary(13)×COUNTTYPE分類分項IDsmallint×OBJECTDESC設備或區域IDvarchar(50)×OBJECTTYPE對象類型int×1為設備，0為區域LASTVALUE統計值float√4.1.6TS_COUNT_AREA_HOUR_201402（區域小時統計表）字段名描述類型允許空說明ID序號int×自增字段COUNTID統計類型IDint×CNAME名稱varchar(64)×ITEMCODE分類分項varchar(6)×STARTTIME開始時間datetime×ENDTIME結束時間datetime×COUNTVALUE統計值float√RESERVED保留varchar(10)√TS_COUNT_AREA_HOUR_XXXXXX表示某年某月，每個月創建一張TS_COUNT_AREA_HOUR表，每小時插入一次數據。4.1.7TS_COUNT_AREA_DAY_2014（區域天統計表）字段名描述類型允許空說明ID序號int×自增字段COUNTID統計類型IDint×CNAME名稱varchar(64)×ITEMCODE分類分項varchar(6)×STARTTIME開始時間datetime×ENDTIME結束時間datetime×COUNTVALUE統計值float×RESERVED保留varchar(10)√TS_COUNT_AREA_DAY_XXXX，表示某年，每年創建一次TS_COUNT_AREA_DAY表，每天插入一次數據。4.1.8TS_COUNT_AREA_MONTH_2014（區域月統計表）字段名描述類型允許空說明ID序號int×自增字段COUNTID統計類型IDint×CNAME名稱varchar(64)×ITEMCODE分類分項varchar(6)×STARTTIME開始時間datetime×ENDTIME結束時間datetime×COUNTVALUE統計值float×RESERVED保留varchar(10)√TS_COUNT_AREA_MONTH_XXXX，表示某年，每年創建一次TS_COUNT_AREA_MONTH表，每天更新一次數據，每月插入一次數據。4.1.9TS_COUNT_DEVICE_HOUR_201402（設備小時統計表）字段名描述類型允許空說明ID序號int×自增字段COUNTID統計類型IDint×CNAME名稱varchar(64)×ITEMCODE分類分項varchar(6)×STARTTIME開始時間datetime×ENDTIME結束時間datetime×COUNTVALUE統計值float×RESERVED保留varchar(10)√TS_COUNT_DEVICE_HOUR_XXXXXX表示某年某月，每個月創建一張TS_COUNT_DEVICE_HOUR表，每小時插入一次數據。4.1.10TS_COUNT_DEVICE_DAY_2014（設備天統計表）字段名描述類型允許空說明ID序號int×自增字段COUNTID統計類型IDint×CNAME名稱varchar(64)×ITEMCODE分類分項varchar(6)×STARTTIME開始時間datetime×ENDTIME結束時間datetime×COUNTVALUE統計值float×RESERVED保留varchar(10)√TS_COUNT_DEVICE_DAY_XXXX，表示某年，每年創建一次TS_COUNT_DVICE_DAY表，每天插入一次數據。4.1.11TS_COUNT_DEVICE_MONTH_2014（設備月統計表）字段名描述類型允許空說明ID序號int×自增字段COUNTID統計類型IDint×CNAME名稱varchar(64)×ITEMCODE分類分項varchar(6)×STARTTIME開始時間datetime×ENDTIME結束時間datetime×COUNTVALUE統計值float×RESERVED保留varchar(10)√TS_COUNT_DEVICE_MONTH_XXXX，表示某年，每年創建一次TS_COUNT_DVICE_MONTH表，每天更新一次數據，每月插入一次數據。4.1.12TB_MULTI_STEP（階梯電價配置表）配置階梯計費的每個檔位的單價字段名描述類型允許空說明ID索引int×自增GEARSID檔位TINYINT×從1開始依次遞增，不可重復或跳躍GEARNAME檔位名稱VARCHAR(32)√TYPEID能源類型索引VARCHAR(5)×START_GEARS_VALUE開始入檔電度int×END_GEARS_VALUE結束入檔電度int×PRICE檔位價格float×DATE結算日smallint×1至31（代表結算是哪天）樣例：11第一級0100001000.45254.1.13TB_TIME_PERIOD_SET（峰平谷時段配置表）字段名描述類型允許空說明ID序號int×自增TYPEID能源類型索引VARCHAR(5)×CNAME名稱VARCHAR(32)√STARTHOUR開始時TINYINT×STARTMINUTE開始分TINYINT×ENDHOUR結束時TINYINT×ENDMINUTE結束分TINYINT×TYPE時段類型,1:尖2:峰3:平4:谷TINYINT×PRICE價格FLOAT×DATE結算日smallint×DESC描述，預留VARCHAR(32)×4.1.14TB__PAR_VALUE_SET（平價配置表）字段名描述類型允許空說明ID序號int×自增TYPEID能源類型索引VARCHAR(5)×CNAME名稱VARCHAR(32)√PRICE價格FLOAT×DATE結算日smallint×DESC描述VARCHAR(32)√樣例：101000電平價0.7264.1.15TS_FEE_DAY(費用歷史表)字段名描述類型允許空說明ID序號BIGINT×自增，增量為1TIMEID時間DATETIME√TOTAL總用電量FLOAT√HIGH峰用電量/第一級用電量FLOAT√MID平用電量/第二級用電量FLOAT√LOW谷用電量/第三級用電量FLOAT√SHARP尖時用量/第四級用電量FLOAT√TOTAL_COST總費用FLOAT√HIGH_COST峰時費用/第一級費用FLOAT√MID_COST平時費用/第二級費用FLOAT√LOW_COST谷時費用/第三級費用FLOAT√SHARP_COST尖時費用//第四級費用FLOAT√NAME名稱VARCHAR√OBJECTTYPE對象類型SMALLINT√OBJECTID對象IDSMALLINT√PAYMENT_TYPE費率類型SMALLINT√ITEMCODE分類分項VARCHAR√樣例：12014-4-510003005001001008503004007575分時3233OBJECTTYPE31是設備，32是區域；TS_FEE_DAY_XXXX,xxxx表示某年，按年生成一張表，通過PAYMENT_TYPE字段表明采用哪種費率計費、1是分時、2是平價、3是階梯。當PAYMENT_TYPE是1時，HIGH、MID、LOW、SHARP、HIGH_COST、MID_COST、LOW_COST、SHARP_COST字段代表分時計費；當是2時，HIGH、MID、LOW、SHARP、HIGH_COST、MID_COST、LOW_COST、SHARP_COST不填，只填TOTAL、TOTAL_COST；當是3時，HIGH、MID、LOW、SHARP，HIGH_COST、MID_COST、LOW_COST、SHARP_COST分別代表階梯計費的第幾級電量及電費。4.1.16TS_FEE_MOUTH（費用歷史月表）域英文名域中文名域類型允許空說明ID序號BIGINT×自增，增量為1TIMEID時間DATETIME√TOTAL總用電量FLOAT√HIGH峰用電量/第一級用電量FLOAT√MID平用電量/第二級用電量FLOAT√LOW谷用電量/第三級用電量FLOAT√SHARP尖時用量FLOAT√TOTAL_COST總費用FLOAT√HIGH_COST峰時費用/第一級費用FLOAT√MID_COST平時費用/第二級費用FLOAT√LOW_COST谷時費用/第三級費用FLOAT√SHARP_COST尖時費用FLOAT√NAME名稱VARCHAR√OBJECTTYPE對象類型SMALLINT√OBJECTID對象IDSMALLINT√PAYMENT_TYPE費率類型SMALLINT√ITEMCODE分類分項VARCHAR√TS_FEE_MOUTH_XXXX,xxxx表示某年，按年生成一張表五各模塊概要設計統計服務模塊由兩個線程構成：能耗統計線程、費用統計線程。5.1能耗統計5.1.1功能描述能耗統計包括區域、設備的能耗統計，具體如下：區域（業態功能區、位置區域）各分類分項時統計；設備各分類分項時統計；區域（業態功能區、位置區域）各分類分項天統計；設備各分類分項天統計；區域（業態功能區、位置區域）各分類分項月統計；設備各分類分項月統計；5.1.2業務處理流程程序啟動后，初始化統計對象（包括設備，位置區域、業態區域），建立能耗線程。在時、天、月統計的觸發條件成立時，進行能耗數據統計入庫。時統計時統計是天統計、月統計的基礎。線程輪詢檢測時間，當每個小時整點到時，９０００平臺時采樣入庫。統計服務則調用平臺接口從采樣表中獲取對應設備該小時的數據存入設備能耗歷史時表。區域處理是在設備時統計完后進行，處理方式和設備相同，通過平臺接口獲取對應區域該小時的數據并存入區域歷史能耗時表。天統計統計線程輪詢檢測時間，當到第二天零點時，９０００平臺時采樣入庫。統計服務則調用平臺接口累加對應設備昨日24小時的數據存入設備能耗歷史天表。區域處理是在設備天統計完后進行，處理方式和設備相同，通過平臺接口獲取對應區域昨日的數據并存入區域歷史能耗天表。月統計統計線程輪詢檢測時間，當到第二天零點而且時統計、天統計已完成后開始進行月統計。統計服務則調用平臺接口累加對應設備截止目前的能耗數據存入設備能耗歷史月表。區域處理是在設備月統計完后進行，處理方式和設備相同，通過平臺接口獲取對應區域截止目前的數據并存入區域歷史能耗月表。5.1.3相關信息表說明分類分項信息分類分項是從TB_BECM_COUNTTYPE獲取，關聯與設備分類分項統計、區域分類分項統計設備信息設備信息從TB_DEVICE獲取；設備索引是TB_DEVICE中的ID;設備所屬父設備通過TB_DEVICE中的PARENTDEV字段獲取，0是最高級父節點；設備附加信息從TB_DEVICE_PROPERTY獲取；區域信息區域信息從TB_AREA表獲取；TB_AREA中ID是區域索引字段；PARENTID是區域所屬父區域，0是最高級父區域；設備及區域能耗存貯表信息TS_COUNT_DEVICE_DAY_2013（設備天表）、TS_COUNT_DEVICE_HOUR_201311（設備時表）、TS_COUNT_DEVICE_MONTH_2013（設備月表）TS_COUNT_AREA_DAY_2013（區域天表）TS_COUNT_AREA_HOUR_201311（區域時表）TS_COUNT_AREA_MONTH_2013（區域月表）注意：小時表是每月生成一張，日表、月表是一年一張5.2費用統計5.2.1功能描述費用計量包括三種算法：分時計費、平價計費、階梯計費。（1）分時計費分時計費包括尖/峰/平/谷4種時段，每種時段都有各自的費率，所有時段加起來是24小時。當日分時計費總費用=峰電價*峰電量（峰時時段電量一天內的累加和）+平電價*平電量（平時時段一天內電量的累加和+谷電價*谷電量（谷時時段一天內電量的累加和）+尖電價*尖電量（尖時時段一天內電量的累加和）；當月總費用：當日分時總費用累加。（2）平價計費只有一種費率，當日計費總費用=平價費用*當日總能耗；當月總費用：當月日累加；（3）階梯計費階梯一般有三級,目前支持以按月來結算。第一階梯為基數電量，此階梯內電量較少，電價也較低，電價乘電量即電費。第二階梯電量較高，電價也較高一些，在第一級電價基礎上加點價；第三階梯電量更多，電價更高，在原電價基礎上加更多。舉例：假設第一檔是0~100，費率0.5；第二檔是101~300,費率0.55；第三檔是301~1000，費率是0.7；某用戶4月耗電600度。第一檔費用100*0.5=50；第二檔是200*0.55=110；第三檔是剩余電耗600-300=300，費用為300*0.7=210；該月總費用為：50+110+210=370；5.2.2業務處理流程 程序啟動后，初始化設備鏈表和區域鏈表，建立計費線程進行費用統計。費用統計包括維度包括：設備和區域。設備費用統計從設備鏈表中取出對象，通過該對象所屬的計費類型（從TB_DEVICE_PROPERTY中的DEVICE_ITEMCODE分類分項、PAYTYPE費率類型），獲取費率配置信息。當計費類型是分時計