EMS V1.20能源管理系统 KPI子系统 概要设计说明书 V1.00

PAGEEMSV1.2KPI子系统功能概要设计说明书V1.00文件编号生效日期受控编号保密级别一级版本号V1.00修改次数0总页数正文附录无编制吴晓彦审核批准(版权所有,翻版必究)评审记录对《EMSV1.20平台功能概要设计说明书V1.00》的评审意见：上述问题修改验证后，由验证后，本文件即可发布。评审人员签字：问题修改验证结果：验证人签字：时间：年月日变更日志编号版本修改内容修改人修改日期1V1.00定稿。吴晓彦目录TOC\o"2-3"\h\z\t"标题1,1"1引言 11.1编写目的 11.2背景 11.3定义 11.4参考资料 12总体设计 22.1需求规定 22.1.1功能边界 22.1.2性能边界 22.2运行环境 22.2.1硬件环境 22.2.2软件环境 22.3概要设计决策 22.3.1设计原则 22.3.2设计决策 32.4开发环境 42.5界面设计 42.6功能模块划分 52.7系统结构 62.7.1系统框架图 63模块设计 73.1KPI子系统 73.1.1实现方案 73.1.2数据库表结构 73.1.3计算方法 83.1.4执行流程 93.1.5接口 9KPI子系统功能概要设计说明书V1.00PAGE11引言1.1编写目的本文档是对天溯EMSV1.20能源管理系统软件V1.2（以下简称NTS-9000系统或本系统）进行详细分析和讨论后得出的分析说明书，旨在明确本软件模块的功能需求。通过本说明书，可以了解到本软件的开发背景、建设要求、功能需求等。各个模块的开发人员阅读此文档后，以各个模块的功能为基础，兼顾配合服务器模块，完成各自模块的功能。本文档面向的读者是：EMSV1.20项目组各成员。1.2背景原天溯NTS-9000强弱电一体化平台系统软件V1.20及EMSV1.15以前的版本，在业务、规模及相关功能上无法支撑快速发展的客户需求，在此基础上对客户需求进行分析、筛选并结合目前系统的架构，对功能进行升级/完善、规模扩充，实现对医院、商业载体等实现全面的监测、分析，给运维人员提供便利，给管理者提供决策分析。1.3定义下表列出本报告中专门术语的定义、英文缩写词的原词组和意义、项目组内达成一致意见的专用词汇，同时继承全部的先前过程中定义过的词汇。词汇名称词汇含义备注常规定额水、电、气等能耗种类定额经营性定额单位床日、万元收入、业务量定额1.4参考资料编号资料名称说明1EMSV1.20系统需求包-140828-一阶段需求.xlsx2总体设计2.1需求规定2.1.1功能边界1）首页KPI概览。显示总区域的KPI数据，如消耗百分比、消耗值，数据通过仪表盘显示展示。模块要求：能够灵活配置KPI总览显示的项，经营性KPI和常规类型KPI可以灵活搭配。2）KPI定额管理。主要展示常规能源种类的定额值以及KPI数据信息（包括节能、正常等数据），其中KPI数据信息以二层树模型展示。3）经营性KPI。主要展示经营性相关的kPI数据信息，如百分比、消耗值，以仪表盘的形式展示（不包括节能、正常等数据）。2.1.2性能边界首页KPI数据请求响应时间不超过3s。2.2运行环境2.2.1硬件环境硬件环境类别要求备注CPU2.0GHz以上CPU内存2.0GB或以上主机硬盘80GB或以上2.2.2软件环境软件环境类别要求备注操作系统Windows2000/2003或WindowsXPSP3或Win2008R232bit或Win732bit旗舰版数据库SQL2000SP3及以上或MSSQL2005开发版（32bit）或MSSQLServer2008企业版（32bit）2.3概要设计决策2.3.1设计原则要有一个良好的设计框架。为了软件能适应未来几年的现场需要，通用数据配置模块应该根据实际需要保持一定的可扩展性、可复用性，这就要求系统升级时对已基于该系统实施的系统兼容，软件设计必须有良好的设计框架。其中包括：第一、采用复用技术。第二、底层业务模块相对独立，统一接口，做到高内聚、低耦合。第三、良好的人机交互界面。系统的使用要考虑现场人员的易用性本软件的最终用户为现场的运行维护人员，在设计软件时要考虑人员的使用习惯和方便使用；简单易用的系统可以提高现场工程实施人员的效率，降低出错的几率。系统需要具有足够的灵活性KPI子系统中KPI首页总览应根据实际数据准备情况，可自由配置显示的时间段、显示的项（电能耗、经营性能耗等）。2.3.2设计决策本节记录对概要设计具有重要影响的软件需求和约束，描述相关的重要决策和决策的原因。这些决策一般对设计有很大影响,它们的改变很难通过设计技巧来屏蔽，例如所选用的开发语言,所选用的平台、组件和框架，对关键业务，类和方法的处理等。2.3.2.1KPI数据查询设计设计决策KPI数据查询模块标识号001问题描述首页请求的KPI数据包含两大类：经营性能耗KPI和常规能耗KPI数据KPI定额功能需要查询常规能耗KPI数据以及定额数据经营性能耗功能需要查询与经营业务相关的KPI数据假设条件可选方案1返回数据的接口类中包括两大类：经营性能耗KPI和常规能耗KPI数据，定额数据信息优点：不用重复设计接口类，一个功能类完成2项任务。缺点：当首页请求后，后台返回数据有冗余。可选方案2为经营类数据、定额数据和常规类数据均建立一个接口类优点：由于每个页面请求的数据和每一个接口类均对应，逻辑更加清晰。缺点：由于两大类KPI数据，本质上是相同的，因此存在不同类做相同任务的弊端。决策使用方案1影响当“KPI定额”功能请求数据时，此时返回结果包括：常规能耗KPI数据和定额数据；反之，当“经营性能耗KPI”功能请求数据时，此时仅返回与经营相关的KPI数据，定额数据为null。相关决策2.4开发环境开发用机器类别要求备注CPU2.40GHzCPU内存4G主机硬盘250G网卡100Mb/s操作系统Windows7旗舰版64bitwindowsxp开发环境MicrosoftVisualStudio2010旗舰版2.5界面设计界面1

界面2界面32.6功能模块划分 2.7系统结构2.7.1系统框架图 3模块设计3.1KPI子系统3.1.1实现方案 首页KPI要能够灵活搭配各类KPI组合显示，同时满足设置时间条件，如当月、上月、当年、上年四类，以保证首页面可以有数据展示。因此，首页需要在数据库中添加一张表，用来存在配置信息。 KPI定额管理功能和1.1版本基本一致，通过选择区域对象和时间粒度，将各类常规能耗的定额值，KPI数据读出，以仪表盘的形式展示。 经营性KPI功能可以视为对常规KPI的扩展，将经营性数据纳入其中制定KPI。因此，需要建立一张与业务相关的基本表，存放业务类型、业务项描述信息、业务计算单位。另外，还需要一张表来存放具体的业务数据，如单位床数、业务量、万元收入信息。而定额信息的描述，为了和已有常规定额区分对1.1.定额表，添加一个标识字段，说明是否为经营类定额。3.1.2数据库表结构经营业务表（TD_EMS_BusinessType）该表主要存放与客户业务相关的，衡量能耗的参数。字段名描述类型说明PK_BusinessTypeVarchar(10)PKDescription对象描述varchar(32)关于此定额的辅助说明Unit单位Varchar(5)Notnull例子：<1，"按床位数"，"张">，<2，"按业务量"，"人次"><3,''按单位空调面积","KWh/m2",><4,"按万元收入","T/元">经营数据表（TB_EMS_BusinessData）字段名描述类型说明BusinessDataIDint自动编号PKRecordTime时间Datetime时刻点当月经营数量notnullZValue属性数值floatNullFK_BusinessData_BusinessTypeInt外键，与经营业务ID对应；notnullAreaIDInt关联tb_area中的areaid；notnullRecordType年、月Int1：月2：年；notnull例子：<1，'2014-09-01',5000，1，35>：2014年9月，实际使用床位数5000张，该区域ID为35.<2，'2014-09-01',100000，2，1>：2014年9月，业务量10万人次，该区域ID为1.<3，'2014-05-01',3000，3，1>：2014年5月，空调覆盖面积3千平，该区域ID为1.<4，'2014-04-01',300000，4，1>：2014年4月，本月万元收入30万，该区域ID为1.经营定额表（TB_EMS_Quota）字段名描述类型说明PK_QuotaID自增idintPKQUOTAID定额idint定额id；notnullOBJECTTYPE对象类型smallint对象类型；notnullOBJECTID对象idint对象id；notnullOBJECTDESC对象描述varchar(32)对象描述QUOTATYPE定额类型smallint1:月定额2：年定额；notnullItemCode业务代码varchar(5)分类分项代码；包括：经营类和常规类两种数据。QUOTATIME定额时间datetime定额时间；notnullQUOTAVALUE定额值float定额值IsBusiness标志是否为经营业务类型Smallint1：是经营业务2：常规类型能耗区域附加信息表（TB_EMS_AreaInfo） 在KPI评价中，如按面积评价，在1.1版本中区域附加信息表中已经包含了”面积“的配置。计算单位面积KPI可以从此表读取数据。KPI配置表（TD_EMS_KPIConfig）字段名描述类型说明KPIConfigID自增idintPKType经营类型和常规类型int1：常规类型2：经营类型；notnullCode经营类或常规类编码Varchar(10)notnullTimeDisplay配置首页KPI显示的时间范围IntNotnull。1:上月2：上年3：本月4：本年举例：<1,1,"01000",3>首页需要显示一个电的KPI，统计时间范围为本月；<21,"1",1>首页需要显示一个单位床日的KPI，统计时间范围为上月；<3,1,"4",2>首页需要显示一个万元收入的KPI，统计时间范围为上年；备注：1.2一阶段中，数据条目即为4行。其它需要表TS_EMS_Datacenter_Area_HourTS_EMS_Datacenter_Area_DayTS_EMS_Datacenter_Area_Month3.1.3计算方法（1）单位床日能耗KPI=（总能耗数据）/床日数。当给定时间（本月、本年、上月、上年）类型时，总能耗数据为该时间段内的能耗消费值。（2）单位业务量KPI=（总能耗数据）/业务量。总能耗数据同上。业务量：由床日数、门诊数按不同权重计算所得。（3）本月（年）床日数=本月（年）内每个住院病人的住院天数累加起来，每月（年）由维护人员手工录入上月（年）的月（年）度床日数；业务量=门诊人次、住院人次的加权合计数，业务量也是每月（年）由维护人员手工录入上月（年）的业务量（业务量=业务量为床日数+门诊数量/3）。（4）单位面积能耗KPI=月（年）总电能耗/建筑面积。（5）单位空调面积KPI=空调总电能耗/空调覆盖区域面积。（6）万元收入能耗KPI=月（年）总耗能/月（年）万元收入。3.1.4执行流程KPI总览定额和经营KPI执行3.1.5接口3.1.5.1首页KPI配置类//KPI显示配置类publicclassKPIConfigModel{publicintID{get;set;}//id值///<summary>///1：常规类型2经营类型///</summary>publicintType{get;set;}///<summary>///常规类或经营类编码///</summary>publicstringCode{get;set;}///<summary>///1:上月2：上年3：本月4：本年///</summary>publicintTimeDisplay{get;set;}}3.1.5.2KPI查询类//KPI查询参数类publicclassQueryKPIModel{///<summary>///对象ＩＤ///</summary>[DataMember]publicintAreaID{get;set;}///<summary>///定额时间///</summary>[DataMember]publicDateTimeQuotaTime{get;set;}///<summary>///定额时间类型：0月1年///</summary>[DataMember]publicintQuotaType{get;set;}///<summary>///KPI类型：0常规类型1经营业务///</summary>[DataMember]publicintIsBusiness{get;set;}///<summary>///该值为：常规类型水、电等编码或经营业务编码///</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数据封装publicclassEnergStatisticsModel{publicstringQuotaName{get;set;}//定额名字publicdecimalConsumPercent{get;set;}//占用百分比publicdecimalConsumValue{get;set;}//消耗值publicdecimalQuotaValue{get;set;}//定额值publicdecimalUnit{get;set;}//单位publicdecimalEvaluation{get;set;}//评价系数节能正常超额}//定额对象封装publicclassQuotaModel{publicstringQuotaName{get;set;}//名字publicdecimalQuotaValue{get;set;}//定额值publicdecimalUnit{get;set;}//单位publicstringItemCode{get;set;}//分类分项名字}3.1.5.4KPI接口函数（1）WCF方法定义：publicList<KPIConfigModel>GetKPIConfigs();取值流程：首先读取数据库中的KPI配置表，根据表中的数据获取List<KPIConfigModel>类型的结果。（2）WCF方法定义：publicList<ResultKPIStatistics>GetKPIEnergy();功能：根据KPI配置表中的数据获取List<KPIConfigModel>类型的结果，组装为QueryKPIModel对象