NTS-BECM建筑能耗监测系统V2.00 概要设计说明书 V1.00

PAGENTS-BECM建筑能耗监测系统V2.00概要设计说明书文件编号TS1118-006生效日期受控编号保密级别一级版本号V1.00修改次数2总页数82正文76附录无编制陆电、夏存兴审核批准(版权所有,翻版必究)

评审记录对《NTS-BECM建筑能耗监测系统V2.00概要设计说明书V1.00》的评审意见：1

主页界面增加建筑、区域电能耗分布，显示当前建筑有无告警；2

能耗查询界面增加图像切换、页面收缩、自定义查询、能耗单位用量的切换；3

设备对比界面增加标杆设备对比、同期对比；4

建筑、建筑区域对比界面，增加标杆建筑、标杆区域对比；增加单位面积能耗对比；5

在能耗排名界面增加按单位用量排名；6

选择分类界面增加显示各分类分项能耗信息，并做成伸缩式；7

在能耗区域分布界面中增加电类主要分项分布图；8所有界面整体色调稍变深。上述问题修改验证后，由验证后，本文件即可发布。评审人员签字：问题修改验证结果：验证人签字：时间：年月日

变更日志编号版本修改内容修改人修改日期

目录1 引言 11.1编写目的 11.2背景 11.3定义 11.4参考资料 22 总体设计 32.1需求规定 32.1.1主角 32.1.2系统边界 32.2运行环境 32.2.1硬件环境 32.2.2软件环境 32.3概要设计决策 42.3.1设计原则 42.3.2设计决策 42.4开发环境 42.5网络结构 52.6总体设计思路和处理流程 53 采集器模块设计 73.1接口模块定义 73.1.1功能说明 73.1.2数据与接口的定义 73.1.3接口设计 93.1.4设计思路： 12通讯状态的显示及远传 12数据转发 12转发规约 13通讯接口驱动 134 服务器模块设计 154.1功能说明 154.2功能点描述 154.3.数据与接口的定义 154.4接口设计 164.5处理模式 185 Web系统接口设计 205.1功能说明 205.2外部接口 205.2.1显示城市温度基本信息模块 20模块说明 20接口设计 205.3内部接口 215.3.1系统验证模块 21模块说明 21接口设计 215.3.2系统权限模块 24模块说明 24接口设计 245.3.3系统日志模块 25模块说明 25接口设计 255.4系统重点业务模块 265.4.1用户配置模块 26.部门信息单位模块 26.系统角色模块 27.系统菜单模块 28.系统权限模块 29.用户模块 31.数据中心模块 32.建筑群模块 33.建筑模块 34.建筑区域模块 350.建筑附加信息模块 361.采集器信息模块 362.设备信息模块 375.4.2数据分析 38主页 38.建筑能耗展示分析 39.建筑能耗对比 41.能耗排名和数据导出 44.设备实时数据 45.设备通讯状态模块 465.4.3.人工导入模块 465.4.4节能告警 475.4.5专家诊断 495.4.6节能改造及系统公告信息 505.4运行设计 515.4.1运行系统单元组合 515.4.2运行控制 515.5系统出错处理设计 525.5.1出错信息 525.5.2补救措施 525.5.3系统维护设计 526 系统数据结构设计 53NTS-BECM建筑能耗监测系统V2.00概要设计说明书PAGE76引言1.1编写目的本文档是对NTS-BECM建筑能耗监测系统V2.00的需求规格进行详细分析和讨论后得出的概要设计说明书，旨在明确NTS-BECM建筑能耗监测系统V2.00的设计目标。通过本概要设计说明书，可以了解到NTS-BECM建筑能耗监测系统V2.00开发的技术路线、功能边界、模块设计等。本文档面向的读者是：NTS-BECM建筑能耗监测系统V2.00的开发人员及测试人员，概要设计说明书的评审人员。1.2背景软件名称：NTS-BECM建筑能耗监测系统V2.00。公司目前的建筑能耗监测系统V1.00，采用B/S架构，虽已实现常规能耗监测功能，但有一些特性使其不能更好的为客户服务：采集器配置转发不够灵活，需能够支持设备转、按数据点转发。采集器配置工具及能耗监测软件配置应更灵活，减少工程人员工作量。采集器性能及服务器性能仍需强化。WEB界面应更美观，贴近于客户。能耗统计功能不够强大；实时数据存贮及更新需优化。基于以上几点，需要对现有软件进行优化，以开发出一套系统相对安全、更加稳定可靠、安装配置更加灵活的软件以满足不断提高的工程应用需求。本软件主要是对能耗数据进行分析处理及展示，并将超出国家标准用量的能耗数据所对应的能耗种类采取相应措施，为用户节能降耗处理提供第一手数据。本项目的开发由公司研发中心提出，由研发中心软件部负责开发，软件最终由工程技术部现场实施，由监控系统值班人员最终使用。1.3定义下表列出本报告中专门术语的定义、英文缩写词的原词组和意义、项目组内达成一致意见的专用词汇，同时继承全部的先前过程中定义过的词汇。词汇名称词汇含义备注1.4参考资料编号资料名称说明1《NTS-BECM建筑能耗监测系统V2.00项目立项书》2《NTS-BECM建筑能耗监测系统V2.00项目计划书》3《NTS-BECM建筑能耗监测系统V2.00需求规格说明书》总体设计2.1需求规定2.1.1主角采集器采集器作为数据中转的中枢，本次V2.00要完成灵活配置转发、性能优化、远传、通讯状态显示、配置工具界面优化等。服务器服务器接收采集器上送的能耗数据，经分类处理后存数据库。本次主要完成对性能的优化，包括通讯接口、数据接收处理、分类分项处理等。WEB展示WEB服务器通过从数据库读取数据，图形化展示能耗统计信息，并对超出指定范围的能耗予以告警提示。本次优化主要完成对界面的优化、多样化统计方式、能耗告警及排名等。2.1.2系统边界系统边界定义了本模块对其它模块提供的外部接口、各模块间的接口应包括：数据结构与回调接口的定义；服务器与WEB接口；采集器与服务器间接口；2.2运行环境2.2.1硬件环境硬件环境类别要求备注CPU2.0MHz及以上内存1GB及以上硬盘10GB及以上以太网口1个或更多2.2.2软件环境软件环境类别要求备注操作系统WINDOWS/LINUX2.3概要设计决策2.3.1设计原则软件需要有一个良好的设计框架。为了软件能适应未来几年的现场需要，软件应该根据实际需要保持一定的可扩展，这就要求系统升级时对已基于该系统实施的系统兼容，软件设计必须有良好的设计框架。其中包括：第一、多采用复用技术。第二、底层业务模块相对独立，低耦合度。第三、保持业务模型稳定，表现出来就是Interface稳定。软件需要具有持续开发，功能完善能力，具有良好的向前兼容性。考虑到目前该软件模块使用对象的实际操作水平以及需求，软件开发不可能一步到位，但是必须考虑到未来的需求，目前系统必须为以后的功能完善，扩展留有充分的接口，系统具有良好的向前兼容性。2.3.2设计决策本节记录对概要设计具有重要影响的软件需求和约束，描述相关的重要决策和决策的原因。这些决策一般对设计有很大影响,它们的改变很难通过设计技巧来屏蔽，例如所选用的开发语言,所选用的平台、组件和框架，对关键业务，类和方法的处理等。决策1：配置文件生成及存储方式设计决策配置文件标识号01问题描述文件生成及存储方式。假设条件可选方案1、流文件2、XML文件3、Windows格式配置文件决策1、XML文件理由XML文件结构化比较好，方便工程人员阅读修改；方便开发人员定位检查；3、由于能耗监测传输的数据都是以XML数据文件格式传输的，统一标准。2.4开发环境开发用机器类别要求备注CPU2.0GHz或以上内存最少1GB主机硬盘最少80GB网卡10/100Mb/sUSB口至少1个软件环境类别要求备注操作系统WindowsXP、Linux开发软件MicrosoftVisualC++6.0、NETExtjs2.5网络结构这是建筑能耗监测系统解决方案总体框图，分为设备层、网络层、监控层。设备层主要是有具有通讯功能的智能仪表构成，包括水表、气表、电表等；网络层主要要数据采集器、和交换机组成，完成对能耗数据的采集；监控层主要由监控主机、打印机、web工作站等组成，完成对能耗数据的分类分项处理及展示，并上送上级数据中心。图2.1建筑能耗监测系统网络结构图2.6总体设计思路和处理流程建筑能耗监测系统分为server服务器和web展示两个部分，其中在server服务器包括初始化模块、内核模块、通信接口模块、规约模块这四个功能模块。Web展示包括信息配置模块、数据展示模块。工程调试人员通过web界面的信息配置及其对server服务器进行工程配置。配置好后，通过初始化模块启动server主程序，包括内核模块和规约模块。程序启动时采用动态加载规约方式启动规约，建筑能耗监测系统通过接收协议与数据采集器进行通信，解析数据采集器上送的能耗数据，并存至内核模块实时库。内核模块先将原始能耗数据存至数据库，再对能耗数据进行分类分项统计后将能耗统计值存入数据库；建筑能耗监测系统通过远传协议与上级数据中心进行通信，向上级数据中心上送能耗统计值，同时接收上级数据中心的命令并相应处理。各模块之间关系如图2.2所示：图2.2建筑能耗监测系统各模块关系图采集器模块设计数据采集器模块主要完成对水、电、气表等数据的采集，并远传至数据中心。在V1.00中已完成数据采集功能及远传，但有的功能还不完善。本次采集器V2.00版本主要完成以下功能：（1）对通讯接口模块底层驱动做增加。支持设备侧采用TCP、UDP等网络通讯方式；系统侧增加对UDP、串口通讯（RS485/232）通讯驱动支持，方便兼容其他系统。（2）通讯状态的显示及远传。为方便工程人员调试，增加设备通讯状态、及采集器与服务器通讯状态的实时显示，并远传数据中心。（3）支持对江苏省远传规约；（4）支持数据按点转发；工程人员可灵活选择转发数据点。（5）配置工具界面优化。3.1接口模块定义3.1.1功能说明（1）由于采集器件的配置工具模块与采集器之间的通讯，两者之间需要定义公共的数据结构和接口，用于统一二者之间的通讯方式和通讯规格。（2）采集器模块与服务器模块之间的通讯，是使用基于TCP/IP协议传输数据帧的，因此，需要在采集器模块与服务器之间建立TCP/IP通讯。（3）为扩展采集器与其他系统的兼容性，提供UDP驱动及串口驱动（包括232、485两种通讯方式）。3.1.2数据与接口的定义（1）数据定义： #defineSERVER_DEVICE_NO 10000 //服务器设备号 #defineFILE_TYPE_DEVSTATE00011//设备状态桢（2）数据结构定义： typedefstruct_DeviceState { intdeviceno; //设备号 boolstate;//状态 }DevState; typedefstruct_tagDFTANA{ intnNo; //序号 intnTransmitNo; //所属数据中心通道号 intnDeviceNo; //源设备号 intnPointNo; //源点号 DWORDdwParam; //参数 DWORDdwFlag; //属性 union { BYTEbtReserved[4]; DWORDdwReserved; };}DFTANA;typedefstructtagUDP_INFO{ charszName[20]; //端口对象 structsockaddr_insocket_addr; //本地通讯端口设置 structsockaddr_inremote_socket_addr; //远方通讯端口设置}UDP_INFO;typedefstructtagTCPSERVER_INFO{ charszName[20]; //端口对象 structsockaddr_insocket_addr; //本地通讯端口设置 structsockaddr_inremote_socket_addr; //远方通讯端口设置}TCPSERVER_INFO;（3）xml接口<?xmlversion="1.0"encoding="utf-8"?>//转发模拟量<root><common>

<filetype>XXXXXX</filetype>

<filename>XXX</filename>

</common><tana_attribute>

<tana_num>XXXXXX</tana_num></tana_attribute><tanalog1index="0"><tanalog_no>XXXXXX</tanalog_no> <tdatacenter_ID>XXXXXX</tdatacenter_ID><tdevno>XXXXX</tdevno><nPointNo>XXXXXX</nPointNo><dwParam>XXXXXX</dwParam><dwFlag>XXXXXX</dwFlag><btReserved>XXXXXX</btReserved></tanalog1>……</root>设备状态远传数据包(data)<?xmlversion="1.0"encoding="utf-8"?><root><common>

<building_id>XXXXXX</building_id>

<gateway_id>XXX</gateway_id><type>xxxx</type><dataperation="report">

<sequence>XXXXXXXX</sequence>

<parser>yes/no</parser>

<time>YYYYMMDDHHMMSS</time><total>XXX</total><current>XXX</current><meterid="1">

<functionid="1"coding="XXX"error="XXX">设备状态1/0</function>

</meter><meterid="2">

<functionid="1"coding="XXX"error="XXX">设备状态1/0</function>

</meter></data></root>3.1.3接口设计（1）内核接口接口原型VoidWriteRtdbData(UINTuMsg,void*pData,longlParam)接口说明函数是用于接收下位机上送的数据，根据数据类型处理数据，内核模块实现，规约模块调用。输入参数1UINTuMsg数据类型；2void*pData上送的数据；3longlParam上送数据长度及其他信息；输出参数无返回值无接口原型intGetDevState()接口说明函数是用来获取设备通讯状态位，内核模块实现，规约模块调用。输入参数无输出参数无返回值获取设备状态总数接口原型floatGetAnalogueValue(intdev,intno);接口说明函数是用来获取设备能耗值，内核模块实现，规约模块调用。输入参数参数1，Int型设备号；参数2，int型数据点号输出参数无返回值浮点型，获取设备能耗值（2）通讯接口模块通讯接口模块封装成.SO文件形式，对外提供规模模块接口函数。包括有HANDLEOpenComm(constchar*szDevControl,COMMCALLBACKlpCommCallBack,FRAMECALLBACKlpFrameCallBack,intnIdleTime,BOOLbThread)；voidCloseComm(HANDLEhandle)；intGetCommReceiveDataLength(HANDLEhandle)；intCommRead(HANDLEhandle,unsignedchar*pBuffer,intnLength,void*pParam)；intCommWrite(HANDLEhandle,unsignedchar*pBuffer,intnLength,void*pParam)；具体说明如下：接口原型HANDLEOpenComm(constchar*szDevControl,COMMCALLBACKlpCommCallBack,FRAMECALLBACKlpFrameCallBack,intnIdleTime,BOOLbThread)；接口说明打开通讯接口，用来打开串口、网口：由通讯接口模块实现，规约模块调用。输入参数1.constchar*szDevControl；接口描述字符串2.COMMCALLBACKlpCommCallBack；规约通讯回调3.FRAMECALLBACKlpFrameCallBack；断帧回调4intnIdleTime；打开时间5BOOLbThread；是否全双工，TRUE全双工，FALSE为半双工；输出参数无返回值通讯类型的句柄 接口原型voidCloseComm(HANDLEhandle)接口说明关闭通讯接口：由通讯接口模块实现，规约模块调用。输入参数1.HANDLEhandle；通讯类型句柄输出参数无返回值无 接口原型intGetCommReceiveDataLength(HANDLEhandle)接口说明获取缓冲区数据长度：由通讯接口模块实现，规约模块调用。输入参数1.HANDLEhandle；通讯类型句柄输出参数无返回值数据长度接口原型intCommRead(HANDLEhandle,unsignedchar*pBuffer,intnLength,void*pParam)接口说明获取缓冲区数据：由通讯接口模块实现，规约模块调用。输入参数1.HANDLEhandle；通讯类型句柄2.unsignedchar*pBuffer：缓冲区数据地址3.intnLength：数据长度4.void*pParam：读取参数输出参数无返回值读取数据长度接口原型intCommWrite(HANDLEhandle,unsignedchar*pBuffer,intnLength,void*pParam)接口说明发送数据：由通讯接口模块实现，规约模块调用。输入参数1.HANDLEhandle；通讯类型句柄2.unsignedchar*pBuffer：发送缓冲区数据地址3.intnLength：数据长度4.void*pParam：发送参数输出参数无返回值发送数据长度3.1.4设计思路：通讯状态的显示及远传为方便工程人员进行调试与故障诊断，要求配置工具软件除具有报文监视及模拟置数功能外，还需要对设备的通讯状态进行监视。通过在内核模块中建立SOCKET服务器,在配置工具中建立SOCKET客户端，实现数据在数据采集软件和配置工具软件间的传输。主要步骤：（1）采集器与配置工具规约模块定时上送设备通讯状态，内核模块接收后写入各设备对应状态位；配置工具与采集器建立通讯后主动将对应设备的状态传送。规约模块定时上送采集器与服务器通讯状态，内核模块接收并写入对应服务器的状态；配置工具与采集器建立通讯后，主动将对应服务器的状态传送。（2）采集器与服务器采集器与服务器建立通讯后，采集器规约模块定时上送设备通讯状态（注：不能与上送能耗数据中突，当有冲突时，优先上送能耗数据）数据转发主要步骤：（1）如图所示，通过在配置工具中选择对应的转发方式（全站转发、按设备转发），编译后生成的配置文件通过FTP下载至采集器。（2）采集器通过解析配置文件，存贮对应的转发设备信息。设备侧规约实时向内核模块写入设备数据块数据，当定时上送时间到时，通过转发规约转发对应设备对应点的能耗数据。转发规约按照江苏省采集器转发规约的规定。通讯接口驱动本次通讯接口模块设备侧增加对UDP、TCP支持；转发侧增加对UDP、串口驱动的支持；主要步骤：（1）如图所示，通过在配置工具中对端口的通讯参数进行配置，编译后生成的配置文件通过FTP下载至采集器。（2）采集器通过解析配置文件，打开相应的通讯端口，建立通讯。

服务器模块设计4.1功能说明能耗监测服务器主要完成对数据采集器上送的各类数据进行解析处理，并存贮于数据库，并远传上级数据中心。服务器模块主要由四个部分构成：初始化模块、通讯接口模块、内核模块、规约模块。在V1.00版本中已经完成对能耗数据的分类解析及统计，但只是针对建筑总的耗能进行统计。本次V2.00完成对建筑群、建筑、建筑区域能耗的统计分析，并对服务器性能进行优化。4.2功能点描述具体主要实现：各建筑能耗分类15分钟表的统计;各建筑能耗分类1小时表的统计;各建筑能耗分类1天时表的统计;各建筑能耗分类1月表的统计;各建筑区域能耗分类15分钟表的统计;各建筑区域能耗分类时表的统计;各建筑区域能耗分类天时表的统计;各建筑区域能耗分类月表的统计;设备能耗天表的统计；设备能耗月表的统计；（11）通讯状态的存贮；4.3.数据与接口的定义（1）数据定义： #defineSERVER_DEVICE_NO 10000 //服务器设备号 #defineFILE_TYPE_DEVSTATE00011//设备状态桢（2）数据结构定义：typedefstructDEVICE_INFO//设备信息{ chardeviceid[32]; intanaindex; floatdevmoduls;}DEVICEINFO;typedefstruct_tagEnergyItem//分类分项{ intno; chardevno[15]; charenergytype[ENERGYLEN];//分类charenergyitemtype[ENERGYLEN];//分项charfirst_energytype[ENERGYLEN];//一级子项charsecond_energytype[ENERGYLEN];//二级子项 floatmodulus;}EnergyItem;CArray<CString,CString&>m_arrayArea;//区域4.4接口设计规约模块提供三个接口函数与通讯接口模块、内核模块交互，实现数据在模块间的流转。intMessageCallBack(UINTuMsg,WPARAMwParam,LPARAMlParam);BOOLFrameCallBack(BYTE*pData,int&nLength);voidCommCallBack(UINTuMsg,HANDLEhandle,WPARAMwParam,LPARAMlParam);具体定义如下：接口原型intMessageCallBack(UINTuMsg,WPARAMwParam,LPARAMlParam)接口说明消息回调，用来初始化规约：由规约模块实现，内核模块调用。输入参数1.UINTuMsg：消息类型2.WPARAMwParam：数据参数3.LPARAMlParam：长度参数输出参数无返回值初始化成功则返回0，否则返回-1接口原型BOOLFrameCallBack(BYTE*pData,int&nLength)接口说明断帧处理接口，用来对数据进行断帧，丢弃不符合要求数据，保留符合要求桢格式数据：由规约模块实现，通讯接口模块调用。输入参数1.BYTE*pData：接收缓冲区首地址2.int&nLength：接收缓冲区长度输出参数nLength接收缓冲区长度返回值校验帧正确返回TRUE，否则返回FALSE 接口原型voidCommCallBack(UINTuMsg,HANDLEhandle,WPARAMwParam,LPARAMlParam)接口说明通讯处理回调接口，用来对符合桢格式要求的数据进行处理：由规约模块实现，通讯接口模块调用。输入参数1.UINTuMsg：消息类型2.HANDLEhandle：串口句柄3.WPARAMwParam：数据参数4.LPARAMlParam长度参数输出参数无返回值无 内核模块提供WriteRtdbData函数与规约模块进行交互。接口原型VoidWriteRtdbData(UINTuMsg,void*pData,longlParam)接口说明函数是用于接收下位机上送的数据，根据数据类型处理数据，内核模块实现，规约模块调用。输入参数1UINTuMsg数据类型；2void*pData上送的数据；3longlParam上送数据长度及其他信息；输出参数无返回值无4.5处理模式初始化模块启动规约模块和内核模块后，内核模块通过注册的回调函数接口方式接收各个数据采集器传送的能耗数据原始值，通过分类后，存入到目标设备去处理。内核模块处理流程如图3.6所示：图4.1内核模块处理流程通过在内核模块中创建一线程，在线程函数中对能耗数据进行归一化处理；根据设备所属能耗采集点分类分项进行数据分项处理，生成统计值，存入相应实时库位置和数据库。归一化预处理将原始能耗数据不规范的采集时间规范到标准时刻，同时对不同的采集频率、不同的计量单位等进行归一化预处理，为下一步的拆分计算做好准备。把时间误差调整为标准的时间，这样有利于数据的查询。处理数据时也比较方便，不需要再进行时间差异的换算。数据计算要根据现场通过各种分类处理计算，并存入数据库中方便web查询显示到IE浏览器上。传送给web的数据都是经过处理计算得到的结果，这样就减少了web访问数据库的数据量，减轻了网络传输数据的压力的同时，也减轻了web数据计算工作量。对用户的响应时间就比较快。在计算数据时，我们根据配置文件中的建筑号、区域号为单位以分类分项表进行分类分项统计，按15分钟、时，日,月等方式统计出结果存入对应的数据库中。采用按一段时间内统一处理，如采集器前后两次时间间隔很小，取后一次值，如果时间有错漏的，填0处理。内存数据库内存数据库是为了增加计算速度而开设一个内存数据表，这个实时库的表与采集器中的点是一一对应关系，还有中间数据的实时库，所有读取数据都是从实时库中获得，这样就不需要从磁盘库中获取数据，就增加了分析的速度，有利于系统的灵活性。数据存库：数据存库，方便上位机要历史数据直接从数据库查找，同时也可以方便web系统查询数据。其中包括建筑区域的分类分项表、建筑的分类分项表、设备能耗存贮表（按天、月）。主要包括15分钟分类分项表、时分类分项表、天分类分项表、月分类分项表。V2.00与V1.00最显著的特点就是分类分项表各自分开，以前V1.00各分类分项在同一张表里，当数据量大时，查询会很慢。现将各分类分项独立成表，各分类分项包括另外增加对设备通讯状态的通讯处理，方便客户了解设备运行状态，所有的分类分项数据数据库表，参见第六章系统数据库结构设计。图4.2内核组成图Web系统接口设计5.1功能说明本系统主要组成部分用户配置用户配置中心模块主要是系统中相关的基本信息的配置和维护。其中又主要分为3个部分，组织架构信息配置（包括用户、部门、角色、菜单、权限）、建筑信息配置（包括数据中心、建筑、建筑群、建筑区域、建筑区域阀值配置等）、系统设备配置（包括采集器、基本设备、设备报警阀值设置等）数据分析数据分析是本系统的核心的模块。它主要是对系统中各个建筑、建筑群、建筑区域、设备、分类分项等要素相关的能耗数据的统计和分析的过程。通过数据的分析，展示出各种各样的图形和文字报表。节能告警主要是对超过用户预设的相关能耗报警的阀值进行监测，实时的把超标信息展示给客户，让用户掌握建筑中各区域、各个设备的能耗情况及相关的运行情况。专家诊断主要是针对统计出的建筑能耗数据进行判断分析，得出能耗分析的结果，以文字报表的形式告诉客户能耗的诊断结果。系统公告系统中相关的通知信息。5.2外部接口5.2.1显示城市温度基本信息模块模块说明通过websevice的方式采集外方法获取城市相关的信息内容。接口设计stringGetWeatherReport(stringIP)接口原型stringGetWeatherReport(stringIP)接口说明函数是用于接收远程服务天气预报方法返回的字符串信息。输入参数1.IP要返回显示天气城市的ip地址；输出参数无返回值无5.3内部接口5.3.1系统验证模块模块说明该模块主要负责系统中所有的面向用户输入输出的数据及系统内部参数传递的合法性进行验证的功能。接口设计staticboolIsPhone(stringinputData)staticstringFetchInputDigit(HttpRequestreq,stringinputKey,intmaxLen)staticboolIsNumber(stringinputData)staticboolIsNumberSign(stringinputData)staticboolIsHasCHZN(stringinputData)staticboolIsEmail(stringinputData)staticboolIsDateTime(stringstr)staticstringSqlText(stringsqlInput,intmaxLength)staticstringHtmlEncode(stringinputData)staticstringEncode(stringstr)staticstringDecode(stringstr)staticstringSqlTextClear(stringsqlText)staticboolisContainSpecChar(stringstrInput)…具体说明如下：接口原型staticboolIsPhone(stringinputData)接口说明判断是否电话号码格式。输入参数1.stringinputData需要验证的字符串输出参数无返回值是否正确 接口原型staticstringFetchInputDigit(HttpRequestreq,stringinputKey,intmaxLen)接口说明检查Request查询字符串的键值，是否是数字，最大长度限制。输入参数1.HttpRequestreq；Request对象2.StringinputKey;Request键值3.Intmaxlen最大长度输出参数无返回值返回Request查询字符串 接口原型staticboolIsNumber(stringinputData)接口说明是否数字字符串。输入参数1.stringinputData；输入字符串输出参数无返回值是否正确接口原型staticboolIsNumberSign(stringinputData)接口说明是否数字字符串可带正负号。输入参数1.stringinputData；输入字符串输出参数无返回值是否正确接口原型staticboolIsHasCHZN(stringinputData)接口说明检测是否有中文字符。输入参数1.stringinputData；输入字符串输出参数无返回值是否正确接口原型staticboolIsEmail(stringinputData)接口说明检测是否电子邮件格式。输入参数1.stringinputData；输入字符串输出参数无返回值是否正确接口原型staticboolIsDateTime(stringstr)接口说明日期格式字符串判断。输入参数1.stringstr；输入字符串输出参数无返回值是否正确接口原型staticstringSqlText(stringsqlInput,intmaxLength)接口说明检查字符串最大长度，返回指定长度的串输入参数1.stringsqlInput；输入字符串2.intmaxLength；最大长度输出参数无返回值处理后的字符串接口原型staticstringHtmlEncode(stringinputData)接口说明字符串编码输入参数1.stringsqlInput；输入字符串输出参数无返回值处理后的字符串接口原型staticstringDecode(stringstr)接口说明转换成HTML普通编码输入参数1.stringstr；输入字符串输出参数无返回值处理后的字符串接口原型staticstringEncode(stringstr)接口说明转换成HTMLcode输入参数1.stringstr；输入字符串输出参数无返回值处理后的字符串接口原型staticstringSqlTextClear(stringsqlText)接口说明返回清除危险字符的字符串输入参数1.stringsqlText；输入字符串输出参数无返回值处理后的字符串接口原型staticboolisContainSpecChar(stringstrInput)接口说明检查输入的参数是不是某些定义好的特殊字符输入参数1.stringstrInput；输入字符串输出参数无返回值是否正确5.3.2系统权限模块模块说明 该模块主要负责系统中所有用户权限验证的功能以及角色权限相关的操作。接口设计stringGetRolePermision(stringroleid)boolIsHavePermision(stringroleid,stringpermisionid)voidSetRolePermision(stringroleid,stringpermisionidlist)…接口原型stringGetRolePermision(stringroleid)接口说明获取某个角色拥有的权限输入参数1.stringroleid；角色id字符串输出参数无返回值角色权限总字符串接口原型boolIsHavePermision(stringroleid,stringpermisionid)接口说明检查某个角色是否拥有权限输入参数1.stringroleid；角色id字符串2.stringpermisionid；某权限的编号输出参数无返回值是否拥有该权限接口原型voidSetRolePermision(stringroleid,stringpermisionidlist)接口说明设置某个角色的权限信息输入参数1.stringstrInput；输入字符串2.stringpermisionidlist；权限的集合输出参数无返回值无5.3.3系统日志模块模块说明该模块主要负责系统中所有系统运行和用户产生的日志信息。接口设计voidWriteLog(stringinfo,Exceptionse)voidReadlog(stringlogtype)接口原型voidWriteLog(stringinfo)接口说明写系统日志信息输入参数1.stringinfo；日志信息2.Exceptionse系统异常对象输出参数无返回值无接口原型voidReadlog(stringlogtype)接口说明读取日志信息输入参数1.stringlogtype；日志类型输出参数无返回值无5.4系统重点业务模块该模块主要是系统中实现软件需求的重要模块的总集合。5.4.1用户配置模块用户配置中心模块主要是系统中相关的基本信息的配置和维护。其中又主要分为3个部分，组织架构信息配置（包括用户、部门、角色、菜单、权限）、建筑信息配置（包括数据中心、建筑、建筑群、建筑区域、建筑区域阀值配置等）、系统设备配置（包括采集器、基本设备、设备报警阀值设置等）.部门信息单位模块描述：本模块主要包含系统基本的组织部门的信息，提供对部门信息的增删改查的功能单元。预计展示效果图：类公共接口如下：intAdd(NTS_BECM.Model.departmentmodel)//执行部门添加boolExists(intdid)//检测部门是否存在boolUpdate(NTS_BECM.Model.departmentmodel)//部门修改boolDelete(intdid)//部门删除boolDeleteList(stringdidlist)//批量删除NTS_BECM.Model.departmentGetModel(intdid)//返回部门实体类DataSetGetList(stringstrWhere)//根据条件查询部门数据列表对应的数据库结构处理关系：Department（部门组织信息表）部门组织信息配置（组织信息的增删改查单元）用户配置单元关联处理.系统角色模块描述：主要功能是对系统中各个部门下的职位角色进行管理，包括添加、修改、删除、查询、角色权限的分配，菜单分配。预计展示效果图：类公共接口如下：boolExists(intid)//判断角色是否存在intAdd(NTS_BECM.Model.jobrolemodel)//角色添加boolUpdate(NTS_BECM.Model.jobrolemodel)//角色更新boolDelete(intid)//角色删除boolDeleteList(stringidlist)角色批量删除NTS_BECM.Model.jobroleGetModel(intid)//获取角色的实体类DataSetGetList(stringstrWhere)//根据条件返回角色的数据集boolSetJobroleMenuAndPermission(introleid,stringmenustr,stringpermissionstr)//设置角色权限和菜单stringGetJobRoleMenuAndPermission(introleid)//获取角色的菜单和权限对应的数据库结构处理关系：Jobrole（角色信息表）角色信息的配置（角色信息的增删改查单元），角色与菜单权限的关系.系统菜单模块描述：实现系统中所有菜单的维护和按照角色的菜单权限显示对应的菜单信息。预计展示效果图：类公共接口如下：boolExists(intid)//判断菜单是否存在intAdd(NTS_BECM.Model.menumodel)//菜单的添加boolUpdate(NTS_BECM.Model.menumodel)//菜单的更新boolDelete(intid)//删除单个菜单boolDeleteList(stringidlist)//删除多个菜单NTS_BECM.Model.menuGetModel(intid)//获取菜单的实体类DataSetGetList(stringstrWhere)//获取菜单的信息列表对应的数据库结构处理关系：Menu（系统菜单表）系统菜单的基础配置（系统菜单的增删改查单元）菜单权限的显示模块角色菜单配置单元关联处理.系统权限模块描述：本系统基本权限的维护和对角色权限的验证。预计展示效果图：类公共接口如下：boolExists(intid)//权限是否存在intAdd(NTS_BECM.Model.permissionmodel)//权限的添加boolUpdate(NTS_BECM.Model.permissionmodel)//权限的更新boolDelete(intid)//权限的删除boolDeleteList(stringidlist)//权限的批量删除NTS_BECM.Model.permissionGetModel(intid)//获取权限实体类DataSetGetList(stringstrWhere)//权限获取列表boolIsHavePermission(introleid,intpermissioncode)//检查是否拥有该权限对应的数据库结构处理关系：Permission（系统权限表）系统权限的基础配置（系统权限的增删改查单元）角色权限分配单元关联处理.用户模块描述：本系统基本用户基本信息的维护，用户登录、退出等，以及用户与部门和角色的隶属关系的配置功能。预计展示效果图：类公共接口如下：boolExists(intid)//用户是否存在intAdd(NTS_BECM.Model.accountmodel)//用户的添加boolUpdate(NTS_BECM.Model.accountmodel)//用户的更新boolDelete(intid)//用户的删除boolDeleteList(stringidlist)//用户的批量删除NTS_BECM.Model.accountGetModel(intid)//获取用户实体类DataSetGetList(stringstrWhere)//用户获取列表boolaccountlogin(NTS_BECM.Model.accountmodel)//检查用户登录voidaccountlogout(NTS_BECM.Model.accountmodel))//用户退出对应的数据库结构处理关系：Account（用户帐号表）1.用户帐号模块（基本信息的增删改查单元）2.系统登录模块3.系统注销模块4.密码修改模块5.系统记住密码单元模块Userinfo（用户具体信息表）用户具体信息配置（用户附加信息的增删改查单元）用户部门、角色设置模块系统权限验证单元关联处理.数据中心模块描述：本系统在上传模块的功能中负责和上级数据中心对接的中心信息配置，本功能主要是对述信息的添加和维护。预计展示效果图：类公共接口如下：boolExists(objectId)//数据中心是否存在intAdd(NTS_BECM.Model.T_DC_DataCenterBaseInfomodel)//数据中心的添加boolUpdate(NTS_BECM.Model.T_DC_DataCenterBaseInfomodel)//数据中心的更新boolDelete(intid)//数据中心的删除boolDeleteList(stringidlist)//数据中心的批量删除NTS_BECM.Model.T_DC_DataCenterBaseInfoGetModel(intid)//获取数据中心实体类DataSetGetList(stringstrWhere)//数据中心获取列表对应的数据库结构处理关系：T_DC_DataCenterBaseInfo(数据中心表)数据中心的基础配置（中心信息的增删改查单元）建筑隶属关系的处理单元.建筑群模块描述：本功能主要是对述系统中建筑群信息的添加和维护，同时负责对建筑群与建筑之间的映射关系的处理和配置调整。预计展示效果图：类公共接口如下：boolExists(objectId)//建筑群是否存在intAdd(NTS_BECM.Model.T_BD_BuildGroupBaseInfomodel)//建筑群的添加boolUpdate(NTS_BECM.Model.T_BD_BuildGroupBaseInfomodel)//建筑群的更新boolDelete(intid)//建筑群的删除boolDeleteList(stringidlist)/建筑群的批量删除NTS_BECM.Model.T_BD_BuildGroupBaseInfoGetModel(intid)//获取建筑群实体类DataSetGetList(stringstrWhere)//建筑群获取列表对应的数据库结构处理关系：T_BD_BuildGroupBaseInfo（建筑群表）建筑群的基本信息配置（建筑群信息的增删改查单元）建筑群与建筑对应关系配置处理单元.建筑模块描述：本功能主要是对述系统中建筑信息的添加和维护，同时负责对建筑与建筑区域之间的映射关系的处理和配置调整以及建筑的能耗告警阀值的配置。预计展示效果图：类公共接口如下：boolExists(objectId)//建筑是否存在intAdd(NTS_BECM.Model.T_BD_BuildBaseInfomodel)//建筑的添加boolUpdate(NTS_BECM.Model.T_BD_BuildBaseInfomodel)//建筑的更新boolDelete(intid)//建筑的删除boolDeleteList(stringidlist)/建筑的批量删除NTS_BECM.Model.T_BD_BuildBaseInfoGetModel(intid)//获取建筑实体类DataSetGetList(stringstrWhere)//建筑获取列表boolConfigBuildAndBuildGroup(stringbuildid,stringbuildgroupid)//配置建筑与建筑群的关系DatasetShowBuildByGroupid(stringbuildgroupid)//返回某指定建筑群所包含的建筑集合voidConfigMaxValue(stringbuildid)//设置建筑的阀值信息DatasetGetMaxValueByAreaID(stringbuildid)//显示建筑的阀值信息对应的数据库结构处理关系：T_BD_BuildBaseInfo（建筑信息表）建筑信息的基础配置（建筑信息的增删改查的单元）建筑与建筑群的对应关系处理单元建筑与建筑区域的对应关系处理单元.建筑区域模块描述：本功能主要是对系统中建筑区域信息的添加和维护，同时负责对建筑区域与建筑之间的映射关系的处理和配置调整，建筑区域能耗分类分项的阀值设置。预计展示效果图：类公共接口如下：boolExists(objectId)//建筑区域是否存在intAdd(NTS_BECM.Model.BAreamodel)//建筑区域的添加boolUpdate(NTS_BECM.Model.BAreamodel)//建筑区域的更新boolDelete(intid)//建筑区域的删除boolDeleteList(stringidlist)/建筑区域的批量删除NTS_BECM.Model.BAreaGetModel(intid)//获取建筑区域实体类DataSetGetList(stringstrWhere)//建筑区域获取列表boolConfigBuildAreaAndBuild(stringAreabuildid,stringbuildid)//配置建筑与建筑区域的关系DatasetShowBuildAreaByBuildid(stringbuildid)//返回某指定建筑所包含的建筑区域集合voidConfigMaxValue(stringAreabuildid)//设置建筑区域的阀值信息DatasetGetMaxValueByAreaID(stringAreabuildid)//显示建筑区域的阀值信息对应的数据库结构处理关系：BArea（建筑区域表）1.建筑区域信息基本配置2.建筑区域与设备对应关系处理单元3.建筑与建筑区域对应关系处理单元0.建筑附加信息模块描述：本功能主要是对系统中建筑附加信息的添加和维护。预计展示效果图：同建筑类似类公共接口如下：intAdd(NTS_BECM.Model.T_BD_BuildAddFilemodel)//建筑附加信息的添加boolUpdate(NTS_BECM.Model.T_BD_BuildAddFilemodel)//建筑附加信息的更新boolDelete(intid)//建筑附加信息的删除boolDeleteList(stringidlist)//建筑附加信息的批量删除NTS_BECM.Model.T_BD_BuildAddFileGetModel(intid)//获取建筑附加信息实体类DataSetGetList(stringstrWhere)//建筑附加信息获取列表对应的数据库结构处理关系：T_BD_BuildAddFile（建筑扩展项数据表）建筑扩展信息的配置（建筑扩展信息的增删改查单元）1.采集器信息模块描述：本功能主要是对系统中采集器的信息的添加和维护，以及采集器与挂接的设备信息的对应的关系的配置和展示。预计展示效果图：类公共接口如下：boolExists(objectId)//采集器是否存在intAdd(NTS_BECM.Model.T_ST_DataCollectionInfomodel)//采集器信息的添加boolUpdate(NTS_BECM.Model.T_ST_DataCollectionInfomodel)//采集器信息的更新boolDelete(intid)//采集器信息的删除NTS_BECM.Model.T_ST_DataCollectionInfoGetModel(intid)//获取采集器信息实体类DataSetGetList(stringstrWhere)//采集器信息获取列表DatasetGetDeviceList(stringcollectionid)//根据采集器的代码获取该采集器下挂接的设备集合对应的数据库结构处理关系：T_ST_DataCollectionInfo（数据采集器信息表）1.数据采集器基本信息配置（采集器增删改查单元）2.采集器和电器设备对应关系处理单元2.设备信息模块描述：本功能主要是对系统中能耗监测设备的信息的添加和维护，以及采集器与挂接的设备信息的对应的关系的配置和展示。预计展示效果图：类公共接口如下：boolExists(objectId)//设备是否存在intAdd(NTS_BECM.Model.T_ST_MeterUseInfomodel)//设备信息的添加boolUpdate(NTS_BECM.Model.T_ST_MeterUseInfomodel)//设备信息的更新boolDelete(intid)//设备信息的删除NTS_BECM.Model.T_ST_MeterUseInfoGetModel(intid)//获取设备信息实体类DataSetGetList(stringstrWhere)//设备信息获取列表对应的数据库结构处理关系：T_ST_MeterUseInfo（监测仪表使用信息表）1.监测仪表使用信息配置5.4.2数据分析数据分析是本系统的核心的模块。它主要是对系统中各个建筑、建筑群、建筑区域、设备、分类分项等要素相关的能耗数据的统计和分析的过程。通过数据的分析，展示出各种各样的图形和文字报表。主页描述：主要是针对建筑的总体耗能的集中展示。详细功能点分布：建筑的基本信息的描述建筑的总体耗能的描述建筑的电能耗分布展示建筑某区域的耗能情况展示建筑某区域电能耗分布本月与上月、本日与昨日、本周与上周的建筑总能耗同期的对比本月与上月、本日与昨日、本周与上周的建筑区域总能耗同期的对比告警信息提示预计展示效果图：.建筑能耗展示分析描述：该模块主要是展示某个建筑群、建筑、建筑区域或者某个设备的能耗数据的报表显示。详细功能点分布：展示建筑某分类分项本周，本月，当天或者指定时间段的能耗展示建筑区域某分类分项本周，本月，当天或者指定时间段的能耗展示某建筑单位建筑面积，某分类分项本周，本月，当天或者指定时间段的能耗展示某建筑区域单位建筑面积，某分类分项本周，本月，当天或者指定时间段的能耗展示某建筑人均，某分类分项本周，本月，当天或者指定时间段的能耗展示某建筑人均，某分类分项本周，本月，当天或者指定时间段的能耗展示图形的表现方式切换功能，主要包含柱状图、曲线图，区域图子区域某分类分项能耗分布图分类分项原始值坐标展示切换报表的导出。预计展示效果图：类公共接口如下：DataSetGetEnergyItemResult(stringstarttime,stringendtime,stringenergyitemtype)//获取整体报表基本数据DataSetGetEnergyItemResult(stringstarttime,stringendtime,stringenergyitemtype,stringbulidid)//获取建筑报表基本数据DataSetGetEnergyItemResult(stringstarttime,stringendtime,stringenergyitemtype,stringbulidareaid)//获取区域报表数据DataSetGetEnergyItemResult(stringstarttime,stringendtime,stringenergyitemtype,stringdriveid)//获取设备能耗数据对应的数据库结构处理关系：T_EC_EnergyItemDayResult(分类分项能耗拆分结果逐日汇总表)1.统计报表相关模块（文字报表和图形报表）T_EC_EnergyItemHourResult（分类分项能耗拆分结果逐时汇总表）T_EC_EnergyItemResult（15分钟分类分项能耗拆分结果表）.建筑能耗对比描述：按照分类分项，建筑，建筑区域，建筑群或者设备等信息为依据，对各个分类分项的比较分析，或者建筑与建筑之间，设备与设备，建筑区域与建筑区域的比较等等。详细功能点分布：展示建筑内某设备的分类分项指定时间段的能耗建筑某区域设备同期比较建筑某区域设备指定时间内与标杆设备的对比各区域设备指定时间内的对比展示各建筑同期比较（包括、本月与上月、本周与上周、今日与昨日）各建筑与标杆建筑对比（包括、本月与上月、本周与上周、今日与昨日）各建筑间指定时间内的对比展示各建筑区域同期比较（包括、本月与上月、本周与上周、今日与昨日）各建筑区域与标杆建筑区域对比（包括、本月与上月、本周与上周、今日与昨日）各区域间对比展示图形的表现方式切换功能，主要包含柱状图、曲线图，区域图单位面积的对比（总耗能、单位面积耗能、人均耗能）展示建筑、建筑区域、设备分类占比。报表的导出。预计展示效果图：类公共接口如下：DataSetGetEnergyItemResult(stringstarttime,stringendtime,stringenergyitemtype)//获取整体报表基本数据DataSetGetEnergyItemResult(stringstarttime,stringendtime,stringenergyitemtype,stringbulidid)//获取建筑报表基本数据DataSetGetEnergyItemResult(stringstarttime,stringendtime,stringenergyitemtype,stringbulidareaid)//获取区域报表数据DataSetGetEnergyItemResult(stringstarttime,stringendtime,stringenergyitemtype,stringdriveid)//获取设备能耗数据voidCompary(string[]bulididArray,stringbuildid)//建筑数据对比voidCompary(string[]bulidareaidArray,stringbuildAreaid)//建筑区域数据对比voidCompary(string[]deviceidArray,stringdriveid)//设备数据对比对应的数据库结构处理关系：T_EC_EnergyItemDayResult(分类分项能耗拆分结果逐日汇总表)1.统计报表相关模块（文字报表和图形报表）T_EC_EnergyItemHourResult（分类分项能耗拆分结果逐时汇总表）T_EC_EnergyItemResult（分类分项能耗拆分结果表）.能耗排名和数据导出描述：该模块的主要功能是对建筑群，建筑，建筑区域，设备等信息分类的能耗排名的分析展示，同时支持这些信息以excel的形式导出。详细功能点分布：展示各建筑某分类分项本周，本月，当天或者指定时间段的能耗排名展示建筑各区域某分类分项本周，本月，当天或者指定时间段的能耗排名展示某建筑某区域所有设备某分类分项本周，本月，当天或者指定时间段的能耗排名建筑单位面积耗能排名建筑人均耗能排名数据导出预计展示效果图：类公共接口如下：voidShowOrder(string[]bulididArray)//建筑显示能耗排名voidShowOrder(string[]bulidareaidArray)//建筑区域显示能耗排名voidShowOrder(string[]deviceidArray)//设备显示能耗排名对应的数据库结构处理关系：T_EC_EnergyItemDayResult(分类分项能耗拆分结果逐日汇总表)1.统计报表相关模块（文字报表和图形报表）T_EC_EnergyItemHourResult（分类分项能耗拆分结果逐时汇总表）T_EC_EnergyItemResult（分类分项能耗拆分结果表）T_EC_EnergyDevDayResult（设备月能耗表）T_EC_MonthEnergyDevDayResult（设备月能耗表）.设备实时数据描述：该模块主要是显示各个设备的实时的能耗设备数值，提供导出功能。详细功能点分布：按照建筑建筑区域选择设备，显示某设备的实时数据提供实时数据的导出功能预计展示效果图：类公共接口如下：NTS_BECM.Model.T_ST_DeviceModelGetModel(intid)//获取设备实时数据信息实体类voidOutExcelDeviceData()//导出设备的实时数据信息对应的数据库结构处理关系：T_ST_DeviceModel(设备实时数据表)1.获取和展示设备的实时的数据信息.设备通讯状态模块描述：显示建筑区域内设备的通讯状态的情况。详细功能点分布：建筑区域内仪表的通讯状态信息建筑区域内采集器的通讯状态信息预计展示效果图：类公共接口如下：intNTS_BECM.Model.DeviceRunStatusGetModel(intid)//获取设备运行状态的信息对应的数据库结构处理关系：DeviceRunStatus(设备运行状态表)1.获取和展示设备的实时的运行状态的信息5.4.3.人工导入模块描述：对于没有通讯功能的设备采取人工导入的方式保存数据。预计展示效果图：5.4.4节能告警主要是对超过用户预设的相关能耗报警的阀值进行监测，实时的把超标信息展示给客户，让用户掌握建筑中各区域、各个设备的能耗情况及相关的运行情况。描述：本功能主要是对系统中能耗监测设备的信息的阀值配置，设备运行的状态监控以及对设备的告警的信息维护和查询等操作。详细功能点分布：建筑各分类分项能耗超限告警。建筑区域各分类分项能耗超限告警。建筑区域设备各分类分项能耗超限告警。设备通讯状态中断告警采集器通讯状态中断告警历史告警信息的查询和保存预计展示效果图：类公共接口如下：

boolConfigDeviceMaxValue(stringf_meterid)//设置设备的阀值stringGetDeviceMaxValue(stringf_meterid)//获取设备的阀值intGetDeviceRunStatus(stringf_meterid)//获取设备的运行状态intAdd(stringf_meterid,stringContent,datetimeWarnDate)//设备告警信息的添加boolUpdate(stringf_meterid,stringContent,datetimeWarnDate)//设备告警信息的更新boolDelete(stringf_meterid)//告警信息的删除DataSetGetList(stringstrWhere)//告警信息获取列表对应的数据库结构处理关系：DeviceMaxValue（设备阀值表）1.配置设备器报警的阀值HisoryWaring（历史告警信息）1.记录历史的设备报警的信息DeviceRunStatus（设备状态信息表）1.实时显示设备报警状态信息5.4.5专家诊断主要是针对统计出的建筑能耗数据进行判断分析，得出能耗分析的结果，以文字报表的形式告诉客户能耗的诊断结果。1.诊断显示描述：根据设备或者建筑的能耗数据与预设的能耗数据进行比对后，显示出能耗存在的问题。详细功能