能源管理系统软件设计说明书

能源管理系统软件设计说明书变更日志编号版本修改内容修改人修改日期1V0.1初稿。2V0.1增加三百里暖通空调的接口设计3V0.1增加能流平衡的接口设计

目录1引言1.1编写目的本文档是对V2.3.0平台系统软件（以下简称EMSV2.3.0系统或本系统）中的平台功能进行详细分析和讨论后得出的分析说明书，旨在明确本软件模块的功能需求。通过本说明书，可以了解到本软件的开发背景、建设要求、功能需求等。各个模块的开发人员阅读此文档后，以各个模块的功能为基础，兼顾配合服务器模块，完成各自模块的功能。本文档面向的读者是：EMS项目组各成员。1.2项目背景从EMSV2.3.0开始，逐渐深度集成多个子系统，且形成多个通用业务模块,业务逐渐趋向于成熟。为更好应对近期项目需求。EMSV2.3.0希望能够清晰的对业务和服务的各个组件进行梳理设计；因此，系统功能结构需要按照模块的方式进行统一的规划和调整。1.3定义下表列出本报告中专门术语的定义、英文缩写词的原词组和意义、项目组内达成一致意见的专用词汇，同时继承全部的先前过程中定义过的词汇。词汇名称词汇含义备注Redis开源的使用ANSIC语言编写、支持网络、可基于内存亦可持久化的日志型、Key-Value数据库，并提供多种语言的API。XML非常适合万维网传输的可扩展标记语言，提供统一的方法来描述和交换独立于应用程序或供应商的结构化数据OPCOPC(OLEforProcessControl,用于过程控制的OLE)是一个工业标准，管理这个标准国际组织是OPC基金会，OPC基金会现有会员已超过220家。遍布全球，包括世界上所有主要的自动化控制系统、仪器仪表及\t"/subview/135910/_blank"过程控制系统的公司。基于微软的OLE(现在的ActiveX)、COM（部件对象模型）和DCOM（分布式部件对象模型）技术。OPC包括一整套接口、属性和方法的标准集，用于过程控制和\t"/subview/135910/_blank"制造业自动化系统。NginxNginx

(enginex)是一个高性能的HTTP和反向代理服务，也是一个IMAP/POP3/SMTP服务。Nginx是由伊戈尔·赛索耶夫为俄罗斯访问量第二的Rambler.ru站点（俄文：Рамблер）开发的，第一个公开版本0.1.0发布于2004年10月4日。1.4参考资料编号资料名称说明1《V2.3.0需求规格说明书.docx》2《软件版本规范草稿.doc》2任务概述2.1目标2.1.1服务模式公司基于“平台战略”提出的生态平台+综合能源服务平台，目标是建立一个高度开放的，可扩展的，面向能源和数字机电大数据的运营支持平台，即建筑能源与设备运维平台EMS2.3.0平台。在整体战略的驱动下，EMSV2.3.0系统研发的目标定位是依靠能源与机电设备管理，节能服务运维托管两大核心体系为支撑，以强弱电一体化监控和大数据挖掘分析为基础，以运维为核心理念，构建新一代数字机电智慧运维平台系统。2.1.2总体目标2.2运行环境2.2.1硬件环境能源管理系统的服务器由于需要安装数据库软件及工具软件，配置要求较高。通常选择当前的主流机型，物理环境配置如下：服务器端-硬件环境类别要求备注CPU主频2.4GHz或以上CPU内核4核或以上内存32.0GB或以上主机硬盘500GB或以上，7200转UPS2KVA及以上网卡100M或1000M客户端-硬件环境类别要求备注CPU主频2.0GHz或以上CPU内核2核及以上内存4.0GB或以上主机硬盘250GB或以上网卡100M或1000M2.2.2软件环境软件环境配置如下：服务器端-软件环境类别要求备注系统服务器操作系统WindowsServer2012R2（64bit）企业版数据库服务器操作系统WindowsServer2012R2（64bit）企业版数据库MSSQLServer2012企业版（64bit）杀毒软件微软MSEOFFICEMSOFFICE2012客户端（B/S端）-软件环境类别要求备注客户端操作系统不限杀毒软件微软MSEOFFICEMSOFFICE2012浏览器chrome浏览器（推荐使用）、火狐浏览器、IE11浏览器2.2.3开发环境软件环境类别要求备注操作系统Windows10/Win732bit/64位旗舰版数据库MSSQLServer2012R2企业版（64bit）软件开发平台MicrosoftVisualStudio2008(sp1)/2010/2015/2017、IDEAJ2.3需求描述2.3.1概述2.3.2功能需求详见《V2.3.0需求规格说明书.docx》。2.3.3非功能需求本节记录对设计具有重要影响的软件需求和约束，描述相关的重要决策和决策的原因。这些决策一般对设计有很大影响,它们的改变很难通过设计技巧来屏蔽，例如所选用的开发语言,所选用的平台、组件和框架，对关键业务，类和方法的处理等。性能需求1、系统容量N/A1实时数据库支持的数据点总数（单套服务器）500,000点2实时数据库支持的遥控≤15,000点3实时数据库支持的计算量≤10,000点4历史数据库采样数据点个数≤100,000点5存储时间5年6接口网关数量≤100个超过100个场景可通过级联或者后续版本改进方式完成；2、监测和分析数据采集1开关量变位传送时间（网关到系统页面）≤3s2模拟量数据刷新时间（网关到系统页面）≤3s3告警刷新时间（网关到系统页面）≤3s4采样数据储存最小间隔5min5能耗数据储存最小间隔10min页面响应1页面切换、调用响应时间≤3s2统计性数据查询响应时间≤10s3分析性数据查询响应时间≤10s4诊断性数据查询响应时间≤10s3、控制类N/A1定时控制组≤1000个2定时控制组中的项≤100个3联动控制组≤1000个4联动控制项≤100个5联动条件检查周期≤3s6控制执行时间≤3s7控制操作正确率100％8控制成功率≥99%4、负荷率N/A1服务器CPU平均负荷率（正常运行任意30min内）≤30％2服务器CPU平均负荷率（系统故障10s内）≤50％3网络负荷率（正常运行任意30min内）≤30％4网络负荷率（系统故障10s内）≤40％5、APP服务器性能N/A1服务器支持最大并发连接数402服务器带宽≥5M1、历史采样数据存储容量为128000点，应用服务程序做好兼容大于128000点数据的功能，平台预留接口，以备以后扩展；2、前置、后台断点续传的数据以10分钟间隔存储离线数据，可存储至少一个月的数据；3、实时数据库支持的遥控<=5000个；可扩展性需求要有一个良好的设计框架。为了软件能适应未来几年的现场需要，通用数据配置模块应该根据实际需要保持一定的可扩展性、可复用性，这就要求系统升级时对已基于该系统实施的系统兼容，软件设计必须有良好的设计框架。其中包括：第一、采用复用技术。第二、底层业务模块相对独立，统一接口，做到高内聚、低耦合。第三、良好的人机交互界面。系统需要具有足够的灵活性与通用性本软件作为图形与服务器间的接口，模块间传递的参数需具有通用性、设置灵活性等特点，以达到各种接入设备的通用。可测试性需求详见《2.3.0测试用例.xlsx》。可维护性需求无易用性需求系统的使用要考虑现场人员的易用性。本软件的最终用户为现场的运行维护人员，在设计软件时要考虑人员的使用习惯和方便使用；简单易用的系统可以提高现场工程实施人员的效率，降低出错的几率。安全需求安全性保密性：只有授权的用户才能动用和修改信息系统的信息，而且必须防止信息的非法、非授权的访问。完整性：信息必须以其原形被授权的用户所用，也只有授权的用户才能修改信息。目前对用户名、密码存放使用MD5方式进行数据加密。可用性（1）设备备份机制、容错机制，防止在系统出现单点失败时，系统的备份机制保证系统的正常运行。（2）SQLServer系统数据库定期备份（不超过30天）。2.4条件与限制对系统其它的一些条件和限制：1、对于一些公共的、经常使用的代码或函数，避免频繁复制，可封装成公共类或库；2、代码中做好注释，避免无用注释的出现，以增加可维护性；3、尽量减少人工配置，增加默认属性，以增强易用性；4、代码中尽量使用标准STL的内容，以增加系统可移植性；5、做系统设计时，尽量考虑以前老版本的功能，以增加系统的兼容性。6、经过WebService服务程序到后台服务器读取10000个配置点以内的数据时间<=5秒； 7、B/S组态图形软件获取<500个实时数据值时，从发出请求到数据返回时间<=3秒； 8、128000个采样数据点在保存到数据库表的时间<=120秒（此时间有点长，需要进一步优化）； 9、模拟量、脉冲量、开关量总数在<=150000时，主备服务器切换的时间<=30秒；总体设计3.1总体结构系统采用三层C/S以及B/S混合架构，其中数据采集层的功能是通过各个数据采集器、OPC服务器、其它系统将底层各种物理设备、传感器、其它系统数据接入，通过企业内部传输协议将数据统一上传给平台处理层。平台处理层的功能为，收到采集设备数据，经过规约转换，数据进入实时库，提供告警、数据修复、二次采样入库、数据基础分析功能，并将分析、处理之后的数据录入历史数据库。业务展现层的功能为，从平台侧实时库和历史库获取相关信息，支持能管、环境监控、设备运维等业务功能，为用户提供专业服务。3.2总体方案模块设计能流平衡实现方案系统中新增该功能页面，命名为：“能流平衡”，放在“基础分析”菜单的子菜单，排序为第一位。用能分类可筛选，层级可收起，默认展开3层。自定义时间限制规则与能耗分析一致，节点权限需与用户配置权限保持一致，无权限的子级节点参与计算，但置灰表示无权限，且不可点击，有权限的节点可点击跳转至能耗分析页面（另起标签页）。变压器模型只有用电分类，故不需分类分项下拉框。可通过鼠标滚轮对画布区域进行缩放。总体效果图如下：处理流程数据表结构暂无4.1.4内外部接口编号接口名称获取能流平衡数据接口版本V2.3.0路径/ems/action.ashx?action=GetGuideTbMenu提交方式POST参数信息参数名类型中文描述最大长度示例InputsStringJson参数200Inputs:{"particle":0,"Unit":"0","MinutesNum":10,"StartTime":"2018-10-19","EndTime":"2018-10-19","ObjType":"9","ItemCode":"01000","ObjectId":0}返回格式(json){ "ActionInfo":{ "Success":true, "ExceptionMsg":null, "ActionName":null, "ActionUser":null, "ActionTime":"\/Date(1539932851962+0800)\/", "LogType":0, "ActionDateTime":"\/Date(1539932852150+0800)\/", "ActionModel":null, "LogParams":null, "FunctionPoint":null }, "data":{ "id":221, "name":"XX项目根节点", "total":0.0, "branch":0.0, "unit":"kWh", "differ":0.0, "dailyGrowth":"--", "relationship":"001", "allowClick":1, "children":[{ "id":222, "name":"A区变压器", "total":0.0, "branch":0.0, "unit":"kWh", "differ":0.0, "dailyGrowth":"--", "relationship":"001", "allowClick":1, "children":[{ "id":223, "name":"变压器1", "total":0.0, "branch":0.0, "unit":"kWh", "differ":0.0, "dailyGrowth":"--", "relationship":"001", "allowClick":1, "children":[] },{ "id":232, "name":"变压器2", "total":0.0, "branch":0.0, "unit":"kWh", "differ":0.0, "dailyGrowth":"--", "relationship":"001", "allowClick":1, "children":[] },{ "id":236, "name":"变压器3", "total":0.0, "branch":0.0, "unit":"kWh", "differ":0.0, "dailyGrowth":"--", "relationship":"001", "allowClick":1, "children":[] }] },{ "id":241, "name":"B区变压器", "total":0.0, "branch":0.0, "unit":"kWh", "differ":0.0, "dailyGrowth":"--", "relationship":"001", "allowClick":1, "children":[{ "id":242, "name":"变压器4", "total":0.0, "branch":0.0, "unit":"kWh", "differ":0.0, "dailyGrowth":"--", "relationship":"001", "allowClick":1, "children":[] },{ "id":248, "name":"变压器5", "total":0.0, "branch":0.0, "unit":"kWh", "differ":0.0, "dailyGrowth":"--", "relationship":"001", "allowClick":1, "children":[] },{ "id":252, "name":"变压器6", "total":0.0, "branch":0.0, "unit":"kWh", "differ":0.0, "dailyGrowth":"--", "relationship":"001", "allowClick":1, "children":[] }] }] }}4.1.5业务故事描述【作为】系统管理员或各用能科室管理员【我想】知道我的能源去向和总分情况【以便】了解每个能耗点的用能特点，各支路能源损耗情况和排查偷电漏水等问题。节能专家-专家指导实现方案页面中，室内平均温度与图表统计的温度图表曲线中室内平均温度曲线当前时间的平均温度结果相同；当前能耗值/理想能耗值数据取各系统运行表中“系统功率”参数项实际值之和/理想值之和。室外气象取任一系统运行表中“室外温度”“室外湿度”两个参数项的数据。页面中，运行指导、维护建议、专家服务三块数据由定时获取数据服务调用三百里提供接口获得。页面中，节能报告展示后台节能报告管理页面中上传且配置为在前台展示的文档，只支持.doc与.docx格式。处理流程数据库结构TS_EMS_SunBaiLi_Sys_RunningResult（系统运行记录结果表）列名类型是否为空备注说明IDvarchar(50)nGUID,唯一主键IDSysIDvarchar(50)n系统ID，对应TB_EMS_SunBaiLi_Sys表中IDParamIDvarchar(50)n系统运行记录项参数，对应TB_EMS_SunBaiLi_Sys_Running_ParamInfo表中IDTimeIDdatetimen运行记录产生时间ParamValuevarchar(50)yF公式错误运行数据实际值IdealValuevarchar(50)y运行数据理想值Calculationvarchar(max)y算式TS_EMS_SunBaiLi_DiagnosticGuidance（运行指导-维护建议表）列名类型是否为空备注说明IDintN自增主键，唯一标识DATA_DATEvarchar(200)N日期CONTENTvarchar(5000)N内容INFOTYPEintN1：运行指导；2：维护建议信息类型TS_EMS_SunBaiLi_ExpertAdvice（专家提示表）列名类型是否为空备注说明IDintN自增唯一标识DATA_DATEvarchar(200)N日期CONTENTvarchar(5000)N内容TEXTvarchar(5000)N1：运行指导；2：维护建议文本内外部接口编号接口名称获取系统概况信息接口版本V2.3.0路径action.ashx?action=GetsystemInfo提交方式POST参数信息参数名类型中文描述最大长度示例返回格式(json){"ActionInfo":{"Success":true,"ExceptionMsg":null,"ExtendContent":null,"IsExistsDevice":false,"ActionUser":"NTS_admin","LogType":0,"ActionDateTime":"/Date(1503488104628+0800)/","ActionModel":null,"LogParams":null,"FunctionPoint":null},"AvgTemperature":"25",//室内平均温度"CurEnergy":"--",//当前能耗值"IdealEnergy":"--",//理想能耗值"OutTemperature":"30",//室外温度"OutHumidity":"38"//室外湿度}编号接口名称获取能效指标信息接口版本V2.3.0路径action.ashx?action=GetsystemInfo提交方式POST参数信息参数名类型中文描述最大长度示例IdString系统ID1A632353-2147-497E-AA9E-92BD43FB2ACF返回格式(json){"ActionInfo":{"Success":true,"ExceptionMsg":null,"ExtendContent":null,"IsExistsDevice":false,"ActionUser":"NTS_admin","LogType":0,"ActionDateTime":"/Date(1503488104628+0800)/","ActionModel":null,"LogParams":null,"FunctionPoint":null},"Records":"[{"Name":"单位面积冷量","Energy":"-123","Unit":"kW"},{"Name":"冷冻站COP","Energy":"--","Unit":""}]"}编号接口名称运行指导信息接口版本V2.3.0路径action.ashx?action=getdiagnosticguidancemodel提交方式POST参数信息参数名类型中文描述最大长度示例返回格式(json){"ActionInfo":{"Success":true,"ExceptionMsg":null,"ExtendContent":null,"IsExistsDevice":false,"ActionUser":"NTS_admin","LogType":0,"ActionDateTime":"/Date(1503488104628+0800)/","ActionModel":null,"LogParams":null,"FunctionPoint":null},"List":"[{"ID":1,"DATA_DATE":"2018-08-2000:00:00","CONTENT":"指导1","INFOTYPE":1,"data_dateStr":""},{"ID":2,"DATA_DATE":"2018-08-2000:00:00","CONTENT":"指导2","INFOTYPE":1,"data_dateStr":""}]"}编号接口名称获取维护建议信息接口版本V2.3.0路径action.ashx?action=getmaintenanceadvice提交方式POST参数信息参数名类型中文描述最大长度示例返回格式(json){"ActionInfo":{"Success":true,"ExceptionMsg":null,"ExtendContent":null,"IsExistsDevice":false,"ActionUser":"NTS_admin","LogType":0,"ActionDateTime":"/Date(1503488104628+0800)/","ActionModel":null,"LogParams":null,"FunctionPoint":null},"List":"[{"ID":1,"DATA_DATE":"2018-08-2000:00:00","CONTENT":"建议1","INFOTYPE":2,"data_dateStr":""},{"ID":2,"DATA_DATE":"2018-08-2000:00:00","CONTENT":"建议2","INFOTYPE":2,"data_dateStr":""}]"}编号接口名称获取专家服务信息接口版本V2.3.0路径action.ashx?action=GetExpertAdviceModel提交方式POST参数信息参数名类型中文描述最大长度示例返回格式(json){"ActionInfo":{"Success":true,"ExceptionMsg":null,"ExtendContent":null,"IsExistsDevice":false,"ActionUser":"NTS_admin","LogType":0,"ActionDateTime":"/Date(1503488104628+0800)/","ActionModel":null,"LogParams":null,"FunctionPoint":null},"List":"[{"ID":1,"DATA_DATE":"2018-08-2000:00:00","CONTENT":"建议1","TEXT":"建议2","data_dateStr":""},{"ID":2,"DATA_DATE":"2018-08-2000:00:00","CONTENT":"建议2","TEXT":"建议2","data_dateStr":""}]"}编号接口名称获取节能报告信息接口版本V2.3.0路径action.ashx?action=SearchReport提交方式POST参数信息参数名类型中文描述最大长度示例返回格式(json){"Success":true,"ExceptionMsg":null,"TotalPage":0,"List":"[{"CreateTime":"/Date(1534405529553+0800)/""EndDate":"/Date(-62135596800000+0800)/""FileName":null"FileNamePath":null"Id":21"IsShow":1"Operator":null"PageIndex":0"PageSize":0"ReportName":"安装配置手册1.doc""ReportUrl":"\temp_file\EnergySavingRepUpLoad\安装配置手册1180816374.doc""ShowDateStr":"2018/8/16""StartDate":"/Date(-62135596800000+0800)/""UriString":null"reportedId":null},{"CreateTime":"/Date(1534405529553+0800)/""EndDate":"/Date(-62135596800000+0800)/""FileName":null"FileNamePath":null"Id":23"IsShow":1"Operator":null"PageIndex":0"PageSize":0"ReportName":"安装配置手册.doc""ReportUrl":"\temp_file\EnergySavingRepUpLoad\安装配置手册180817374.doc""ShowDateStr":"2018/8/17""StartDate":"/Date(-62135596800000+0800)/""UriString":null"reportedId":null}]"}业务故事描述配置：后台系统信息维护页面添加系统功率、室外温度、室外湿度等参数，需要在能效指标中展示的参数选择展示配置；启动三百里数据上送服务，每小时定时获取运行指导、维护建议、专家服务数据；后台节能报告管理页面上传需展示的文件，并配置为前台展示。前台页面：当前时间为35分时，系统概况、能效指标展示上个小时的数据，35分后展示当前小时数据。节能专家-系统明细实现方案页面头部Tab页展示所有系统信息，点击选中系统表信息，展示系统运行记录结果，并且能够导出。处理流程数据库结构TB_EMS_SunBaiLi_Sys_BasicInfo（系统基础信息表）列名类型是否为空备注说明IDvarchar(50)nGUID作为主键ID，唯一主键SysNumvarchar(200)n系统编号SysCNamevarchar(200)n系统名称IsRootintnOrderIdintn排序，默认为0TB_EMS_SunBaiLi_Sys_Running_ParamInfo（系统运行记录参数表）列名类型是否为空备注说明IDvarchar(50)nGUID唯一主键SysIDvarchar(50)n系统ID，对应TB_EMS_SunBaiLi_Sys_BaseicInfo表中IDParamCodevarchar(50)n参数编码ParamCNamevarchar(200)n参数中文名称UnitNamevarchar(50)y参数单位OrderIDintn排序编号isShowintn0否1是是否专家指导页面展示TS_EMS_SunBaiLi_Sys_RunningResult（系统运行记录结果表）列名类型是否为空备注说明IDvarchar(50)nGUID,唯一主键IDSysIDvarchar(50)n系统ID，对应TB_EMS_SunBaiLi_Sys表中IDParamIDvarchar(50)n系统运行记录项参数，对应TB_EMS_SunBaiLi_Sys_Running_ParamInfo表中IDTimeIDdatetimen运行记录产生时间ParamValuevarchar(50)yF公式错误运行数据实际值IdealValuevarchar(50)y运行数据理想值Calculationvarchar(max)y算式内外部接口编号接口名称系统信息接口版本V2.3.0路径action.ashx?action=SearchSysInfoList提交方式POST参数信息参数名类型中文描述最大长度示例返回格式(json){"ActionInfo":{"Success":true,"ExceptionMsg":null,"ExtendContent":null,"IsExistsDevice":false,"ActionUser":"NTS_admin","LogType":0,"ActionDateTime":"/Date(1503488104628+0800)/","ActionModel":null,"LogParams":null,"FunctionPoint":null},"recordTab":"[{"ItemName":"系统表1","ParamCode":"1A632353-2147-497E-AA9E-92BD43FB2ACF"},{"ItemName":"系统表2","ParamCode":"670FF755-0F09-4C8A-BC9D-C7D6FAF276F6"}]"}编号接口名称根据系统ID获取系统运行记录接口版本V2.3.0路径action.ashx?action=SearchSysRunningRecord提交方式POST参数信息参数名类型中文描述最大长度示例IDString设备ID1A632353-2147-497E-AA9E-92BD43FB2ACFStartDateString开始时间2018-08-20EndDateString结束时间2018-08-20返回格式(json){"ActionInfo":{"Success":true,"ExceptionMsg":null,"ExtendContent":null,"IsExistsDevice":false,"ActionUser":"NTS_admin","LogType":0,"ActionDateTime":"/Date(1503488104628+0800)/","ActionModel":null,"LogParams":null,"FunctionPoint":null},"Records":"[{"TimeId":"时间","CRSYLWQJCU":"cs3","CRSYLWQJCU_LXZ":"cs3理想值","GQGOCZCWZT":"蒸发侧冷冻水流量","GQGOCZCWZT_LXZ":"蒸发侧冷冻水流量理想值"},{"TimeId":"/","CRSYLWQJCU":"kW","CRSYLWQJCU_LXZ":"kW","GQGOCZCWZT":"--","GQGOCZCWZT_LXZ":"--"}]"}编号接口名称下载系统运行记录信息接口版本V2.3.0路径action.ashx?action=DownLoadSysRunningRecord提交方式POST参数信息参数名类型中文描述最大长度示例IDString设备ID1A632353-2147-497E-AA9E-92BD43FB2ACFStartDateString开始时间2018-08-20EndDateString结束时间2018-08-20返回格式(json){"ActionInfo":{"Success":true,"ExceptionMsg":null,"ExtendContent":null,"IsExistsDevice":false,"ActionUser":"NTS_admin","LogType":0,"ActionDateTime":"/Date(1503488104628+0800)/","ActionModel":null,"LogParams":null,"FunctionPoint":null},"DownLoadUrl":"temp_file\系统运行记录20180820161858.xlsx"}业务故事描述后台配置：后台系统信息维护、系统数据源配置页面维护系统、系统参数、绑定数据源等信息；启动三百里数据上送服务，每小时定时上送系统运行记录实际值，获取理想值数据。前台页面：前台展示相关信息（累加量展示数据为上个时间点数据，非累加量为当前整点时间数据）。节能专家-设备明细实现方案页面左侧列表展示所有已导入的暖通设备信息，展示内容有：状态、编号、名称、位置；页面右侧，展示左侧列表中点击选中的设备详细信息以及该设备的运行记录结果；运行记录结果能够选择日期查看，并且能够导出。处理流程数据库结构TB_EMS_SunBaiLi_Device_BasicInfo（设备基础信息表）列名类型是否为空备注说明IDvarchar(50)nGUID作为主键ID，唯一主键DeviceNamevarchar(256)n设备名称DeviceTypevarchar(50)n设备类型DeviceNumbervarchar(100)n设备编号SysIdvarchar(50)y系统ID,对应TB_EMS_SunBaiLi_Sys_BaseicInfo表中IDInstallationPositionvarchar(200)y安装位置Statesinty0：关闭；1：开启启停状态Manufacturervarchar(500)y生产厂商Modelvarchar(500)y规格型号ManufactureDatevarchar(50)y生产日期TB_EMS_SunBaiLi_Device_OtherInfo（设备其他信息表）列名类型是否为空备注说明DeviceIdvarchar(50)n对应TB_EMS_SunBaiLi_Device_BasicInfo表中IDItemIDvarchar(50)n设备类型参数ID，对应TB_EMS_SunBaiLi_Device_ParamInfo表中IDDataValuevarchar(200)y参数值TB_EMS_SunBaiLi_Device_ParamInfo（设备信息参数表）列名类型是否为空备注说明IDvarchar(50)nGUID唯一主键DeviceTypevarchar(50)n对应TB_EMS_SunBaiLi_Device_Type表中IDParamCodevarchar(50)n参数编码ParamCNamevarchar(200)n参数中文名称UnitNamevarchar(50)y参数单位OrderIDintn排序编号TB_EMS_SunBaiLi_Device_Type（设备类型表）列名类型是否为空备注说明IDvarchar(50)nGUID,唯一主键IDCNamevarchar(200)n设备类型中文名称OrderIDintn排序编号内外部接口编号接口名称设备类型信息接口版本V2.3.0路径action.ashx?action=GetSunBaiLiDeviceTypes提交方式POST参数信息参数名类型中文描述最大长度示例返回格式(json){"Success":true,"ExceptionMsg":null,"Records":"[{"ID":"10D3B60E-64C2-44EE-BABC-B305C429E637","CName":"设备类型1","OrderID":1},{"ID":"F5FD2230-EC78-4035-8C5A-EE5897E92D87","CName":"设备类型2","OrderID":2}]"}编号接口名称根据设备类型获取设备列表信息接口版本V2.3.0路径action.ashx?action=SearchDeviceInfoList提交方式POST参数信息参数名类型中文描述最大长度示例DeviceTypeString设备类型（0全部）10D3B60E-64C2-44EE-BABC-B305C429E637KeyWordString设备名称或设备编号关键字测试返回格式(json){"Success":true,"ExceptionMsg":null,"TotalPage":0"DeviceList":"[{"ID":"A799E377-0BED-46D2-B1F3-4C6098A8EDD2","DeviceName":"cehsi1","DeviceNumber":"001","DeviceType":"10D3B60E-64C2-44EE-BABC-B305C429E637","InstallationPosition":"科室1","ManufactureDate":"20180102","Manufacturer":"ddd","Model":"","States":1,"StatesName":"开启","SysId":"","SysName":null},{"ID":"EEE64F53-1FD4-4AD2-A7FA-126F9E200B8E","DeviceName":"cehsi2","DeviceNumber":"002","DeviceType":"10D3B60E-64C2-44EE-BABC-B305C429E637","InstallationPosition":"科室2","ManufactureDate":"20180102","Manufacturer":"ddd2","Model":"","States":0,"StatesName":"关闭","SysId":"","SysName":null}]"}编号接口名称根据设备ID获取设备明细信息接口版本V2.3.0路径action.ashx?action=SearchDeviceItems提交方式POST参数信息参数名类型中文描述最大长度示例String设备IDEEE64F53-1FD4-4AD2-A7FA-126F9E200B8E返回格式(json){"Success":true,"ExceptionMsg":null,"DeviceBaseInfo":"{"ID":"EEE64F53-1FD4-4AD2-A7FA-126F9E200B8E","DeviceName":"cehsi1","DeviceNumber":"001","DeviceType":"10D3B60E-64C2-44EE-BABC-B305C429E637","InstallationPosition":"科室1","ManufactureDate":"20180102","Manufacturer":"ddd","Model":"","States":1,"StatesName":"开启","SysId":"","SysName":null}","DeviceOtherInfos":"[{"ID":"A799E377-0BED-46D2-B1F3-4C6098A8EDD2","DataValue":"1","DeviceType":"10D3B60E-64C2-44EE-BABC-B305C429E637","OrderID":1,"ParamCName":"功率","ParamCode":"TVNFMXMMLA","UnitName":"kW"},{"ID":"C3DFCDFF-1140-4CEE-BBF4-481A0F343688","DataValue":"","DeviceType":"10D3B60E-64C2-44EE-BABC-B305C429E637","OrderID":1,"ParamCName":"电流","ParamCode":"TVNFMXMMLA","UnitName":"m³"}]"}编号接口名称根据设备ID获取设备运行记录信息接口版本V2.3.0路径action.ashx?action=SearchRunningRecord提交方式POST参数信息参数名类型中文描述最大长度示例IDString设备IDEEE64F53-1FD4-4AD2-A7FA-126F9E200B8EStartDateString开始时间2018-08-20EndDateString结束时间2018-08-20返回格式(json){"Success":true,"ExceptionMsg":null,"Records":"[{"TimeId":"时间","CRSYLWQJCU":"cs3","CRSYLWQJCU_LXZ":"cs3理想值","GQGOCZCWZT":"蒸发侧冷冻水流量","GQGOCZCWZT_LXZ":"蒸发侧冷冻水流量理想值"},{"TimeId":"/","CRSYLWQJCU":"kW","CRSYLWQJCU_LXZ":"kW","GQGOCZCWZT":"--","GQGOCZCWZT_LXZ":"--"}]"}编号接口名称下载设备运行记录信息接口版本V2.3.0路径action.ashx?action=DownLoadRunningRecord提交方式POST参数信息参数名类型中文描述最大长度示例IDString设备IDEEE64F53-1FD4-4AD2-A7FA-126F9E200B8EStartDateString开始时间2018-08-20EndDateString结束时间2018-08-20返回格式(json){"Success":true,"ExceptionMsg":null,"DownLoadUrl":"temp_file\运行记录20180820161858.xlsx"}业务故事描述后台配置：后台设备信息维护、设备运行记录表维护、设备数据源配置、设备启停状态绑定页面维护设备参数、运行参数、绑定数据源等信息；启动三百里数据上送服务，每小时定时上送设备运行记录实际值，获取理想值数据。前台页面：前台展示相关信息（累加量展示数据为上个时间点数据，非累加量为当前整点时间数据）。节能专家-图表统计实现方案根据能耗后台，树设备映射功能中环境评估树节点配置数据取得设备点位信息数据，并再页面中以图表展示。处理流程数据库结构内外部接口编号接口名称系统信息接口版本V2.3.0路径action.ashx?action=GetTempratureRoomList提交方式POST参数信息参数名类型中文描述最大长度示例返回格式(json){"Success":true,"ExceptionMsg":null,"avgTempList":"[{"TempratureValue":0,"RecNum":0,"TimeId":"2018-08-1917:00:00","Timehours":17},{"TempratureValue":0,"RecNum":0,"TimeId":"2018-08-1918:00:00","Timehours":18}]","deviceTempList":"[{"DeviceId":168,"RoomId":606,"RoomName":"南京自动化控制系统有限--环境节点一","TempratureModelList":"[{"TempratureValue":0,"RecNum":2423,"TimeId":"2018-08-1917:00:00","Timehours":17},{"TempratureValue":0,"RecNum":2435,"TimeId":"2018-08-1918:00:00","Timehours":18}]"}]"}业务故事描述能耗后台-暖通空调-节能报告管理实现方案能够上传、下载节能报告，列表展示所有已上传节能报告，并且能够控制前台展示。处理流程数据库结构TB_EMS_SunBaiLi_Report（节能报告管理表）列名类型是否为空备注说明IdintN主键唯一标识ReportNamevarchar(200)报告名称CreateTimedatetime上传时间ReportUrlvarchar(MAX)报告地址Operatorvarchar(500)操作人IsShowint0：不展示；1展示是否前台展示内外部接口编号接口名称修改节能报告文件接口版本V2.3.0路径action.ashx?action=UploadReport提交方式POST参数信息参数名类型中文描述最大长度示例idString报告ID1IsShowstring是否前台展示0否1是1返回格式(json){"Success":true,"ExceptionMsg":null}编号接口名称查询节能报告文件接口版本V2.3.0路径action.ashx?action=SearchBackReport提交方式POST参数信息参数名类型中文描述最大长度示例StartDateString开始时间2018-08-20EndDatestring结束时间2018-08-20ReportNamestring报告名称报告PageSizeInt页面最大展示数10PageIndexInt页面索引1SortInt0时间降序1升序0返回格式(json){"Success":true,"ExceptionMsg":null,"TotalCount":1,"TotalPage":1,"List":"[{"ID":1,"CreateTime":"/Date(1534755516577+0800)/","EndDate":"/Date(-62135596800000+0800)/","FileName":null,"FileNamePath":null,"ReportName":"测试.docx","IsShow":0,"Operator":null,"PageIndex":0,"PageSize":0"ReportUrl":"\temp_file\EnergySavingRepUpLoad\测试180820317.docx","ShowDateStr":"2018/8/20","Sort":null","StartDate":"/Date(-62135596800000+0800)/","UriString":null,"reportedId":null}]"}编号接口名称导出节能报告文件接口版本V2.3.0路径action.ashx?action=DownloadBackReport提交方式POST参数信息参数名类型中文描述最大长度示例StartDateString开始时间2018-08-20EndDatestring结束时间2018-08-20ReportNamestring报告名称报告PageSizeInt页面最大展示数10PageIndexInt页面索引1SortInt0时间降序1升序0reportedIdString[]选中报告ID["1"]返回格式(json){"Success":true,"ExceptionMsg":null}编号接口名称删除节能报告文件接口版本V2.3.0路径action.ashx?action=DeleteReport提交方式POST参数信息参数名类型中文描述最大长度示例StartDateString开始时间2018-08-20EndDatestring结束时间2018-08-20ReportNamestring报告名称报告PageSizeInt页面最大展示数10PageIndexInt页面索引1SortInt0时间降序1升序0reportedIdString[]选中报告ID["1"]返回格式(json){"Success":true,"ExceptionMsg":null}编号接口名称修改节能报告文件接口版本V2.3.0路径action.ashx?action=UpdateReport提交方式POST参数信息参数名类型中文描述最大长度示例idString报告ID1IsShowstring是否前台展示0否1是1返回格式(json){"Success":true,"ExceptionMsg":null}业务故事描述配置：查节能报告信息，根据报告名称模糊查询；上传节能报告，支持.txt,.doc,.docx,.xls,.xlsx,.pdf文件；更新文件是否在前台展示，前台目前只支持.doc,.doocx文件预览；删除节能报告；导出节能报告。能耗后台-暖通空调-暖通设备信息导入实现方案能够根据设备类型涉及到的字段，生成模板，提供下载功能；通过下载的模板导入相应的设备信息。处理流程数据库结构TB_EMS_SunBaiLi_Device_BasicInfo（设备基础信息表）列名类型是否为空备注说明IDvarchar(50)nGUID作为主键ID，唯一主键DeviceNamevarchar(256)n设备名称DeviceTypevarchar(50)n设备类型DeviceNumbervarchar(100)n设备编号SysIdvarchar(50)y系统ID,对应TB_EMS_SunBaiLi_Sys_BaseicInfo表中IDInstallationPositionvarchar(200)y安装位置Statesinty0：关闭；1：开启启停状态Manufacturervarchar(500)y生产厂商Modelvarchar(500)y规格型号ManufactureDatevarchar(50)y生产日期TB_EMS_SunBaiLi_Device_OtherInfo（设备其他信息表）列名类型是否为空备注说明DeviceIdvarchar(50)n对应TB_EMS_SunBaiLi_Device_BasicInfo表中IDItemIDvarchar(50)n设备类型参数ID，对应TB_EMS_SunBaiLi_Device_ParamInfo表中IDDataValuevarchar(200)y参数值TB_EMS_SunBaiLi_Device_ParamInfo（设备信息参数表）列名类型是否为空备注说明IDvarchar(50)nGUID唯一主键DeviceTypevarchar(50)n对应TB_EMS_SunBaiLi_Device_Type表中IDParamCodevarchar(50)n参数编码ParamCNamevarchar(200)n参数中文名称UnitNamevarchar(50)y参数单位OrderIDintn排序编号TB_EMS_SunBaiLi_Device_Type（设备类型表）列名类型是否为空备注说明IDvarchar(50)nGUID,唯一主键IDCNamevarchar(200)n设备类型中文名称OrderIDintn排序编号内外部接口编号接口名称下载暖通设备信息导入模板接口版本V2.3.0路径action.ashx?action=DownloadDeviceInfoExcel提交方式POST参数信息参数名类型中文描述最大长度示例返回格式(json){"Success":true,"ExceptionMsg":null}编号接口名称上传暖通设备信息接口版本V2.3.0路径action.ashx?action=InsertSunBaiLiDevice提交方式POST参数信息参数名类型中文描述最大长度示例返回格式(json){"Success":true,"ExceptionMsg":null,"ItemList":"[{"Index":0,"Location":"","Detail":"","Success":true}]"}业务故事描述需点击下载模板按钮，下载最新模板进行设备信息的批量录入。模板下载时需带出既有系统中已更改的相关信息。按照模板指示格式填写完成设备信息后，浏览文件地址，选中并上传。对上传的设备信息进行必要校验，并在下方列表中提示上传结果。能耗后台-暖通空调-设备数据源配置实现方案该页面能够单个新增暖通设备；修改暖通设备信息；删除暖通设备；配置暖通设备的运行参数项点位信息。处理流程数据库结构TB_EMS_SunBaiLi_Device_BasicInfo（设备基础信息表）列名类型是否为空备注说明IDvarchar(50)nGUID作为主键ID，唯一主键DeviceNamevarchar(256)n设备名称DeviceTypevarchar(50)n设备类型DeviceNumbervarchar(100)n设备编号SysIdvarchar(50)y系统ID,对应TB_EMS_SunBaiLi_Sys_BaseicInfo表中IDInstallationPositionvarchar(200)y安装位置Statesinty0：关闭；1：开启启停状态Manufacturervarchar(500)y生产厂商Modelvarchar(500)y规格型号ManufactureDatevarchar(50)y生产日期TB_EMS_SunBaiLi_Device_OtherInfo（设备其他信息表）列名类型是否为空备注说明DeviceIdvarchar(50)n对应TB_EMS_SunBaiLi_Device_BasicInfo表中IDItemIDvarchar(50)n设备类型参数ID，对应TB_EMS_SunBaiLi_Device_ParamInfo表中IDDataValuevarchar(200)y参数值TB_EMS_SunBaiLi_Running_ParamInfo（设备运行记录参数表）列名类型是否为空备注说明IDvarchar(50)nGUID唯一主键DeviceTypevarchar(50)n设备类型ID，对应TB_EMS_SunBaiLi_Device_Type表中IDParamCodevarchar(50)n唯一，系统随机生成10位大写字母参数编码ParamCNamevarchar(200)n参数中文名称UnitNamevarchar(50)y参数单位OrderIDintn排序编号TS_EMS_SunBaiLi_Running_PointInfo（设备运行记录参数-点位关系表）列名类型是否为空备注说明IDintn自增主键，唯一标识DeviceIDvarchar(50)n设备ID，,对应TB_EMS_SunBaiLi_Device_BasicInfo表中IDPointIDintn点位IDParamIDvarchar(50)n设备运行参数ID，对应TB_EMS_SunBaiLi_Running_ParamInfo表中IDColumnNamevarchar(100)n点位所属列名TableNamevarchar(100)n点位所属表名EquipmentIDintn采集设备ID，对应TB_Device表中的ID内外部接口编号接口名称数据源绑定页面获取数据列表接口版本V2.3.0路径action.ashx?action=SearchDevice_DataSourceBind提交方式POST参数信息参数名类型中文描述最大长度示例PageSizeint最大展示条数10PageIndexint当前索引1DeviceNameString设备名称设备1返回格式(json){"Success":true,"ExceptionMsg":null,"TotalCount":6,"TotalPage":1,"list":"[{"DeviceName":"cehsi1""DeviceNumber":"001""ID":"A799E377-0BED-46D2-B1F3-4C6098A8EDD2""DeviceType":"10D3B60E-64C2-44EE-BABC-B305C429E637""DeviceTypeName":"设备类型1""PageIndex":0"PageSize":0},{"DeviceName":"cehsi2""DeviceNumber":"002""ID":"EEE64F53-1FD4-4AD2-A7FA-126F9E200B8E""DeviceType":"10D3B60E-64C2-44EE-BABC-B305C429E637""DeviceTypeName":"设备类型1""PageIndex":0"PageSize":0}]"}编号接口名称数据源绑定页面配置数据源左侧参数接口版本V2.3.0路径action.ashx?action=SearchDevice_RunningParam提交方式POST参数信息