大用户及低压电力集中抄表系统营销系统的数据交换标准(V.2009.02.18).doc

大用户及低压电力集中抄表系统与MIS数据交换接口文档文档修订记录序 号修改时间修 改 人审 核 人备 注12008-5-10李旭 修订22008-7-3李旭 修订32008-7-10李旭 修订42009-2-18李旭修订5678910111213141516171819201 前言 本文档参考计量动化系统附件：共享数据与接口规范(试行).doc，对数据交换内容作了部分修改、新增以及内容定义更加明确化。2 命名规范数据共享的一个重要工作就是数据标识的统一，对交换所涉及的几个系统，应对交换的内容有一致的语义。现就本规范涉及的交换信息进行命名如下（注：区分大小写）。2.1 基本信息标识(Base Info)标识含义objectId对象编号objectName对象名称objectType对象类型changeType对象更新类型changeDate实际更新时间operationDate更新登记时间2.2 数据更新类型标识(Change Type)标识含义CA新增 CD删除CC修改 针对某类对象基本资料数据变更通知信息包构造交易说明:1. 关键字段不变, 其他信息变更,通知数据信息包格式: 变更前值 + 约定分割符号 + 变更后值 2. 主键字段变更, 如更换终端或表计业务, 同时涉及1新增1拆除业务, 需拆分为1个CA,1个CD分不同交易发送。2.3 对象类型标识(ObjectType)系统及应用模块对象类型标识对象类型名称备注AMSAMSB供电局公共对象AMST区县局AMSO供电所LAPLAPF馈线LAPC大客户LAPM大客户表计LAPP计量点关系LAPT大客户终端含配变终端, 居民终端,变电站终端LAPE大客户冻结电量LAPA大客户告警LAPR大客户告警处理结果3 数据定义3.1 基础资料约定: 属性标识带下划线字段为关键字段,用于数据变更通知大客户系统信息同步对象类型属性名称属性标识值类型(最大长度)备注镇区县编号townIdString(32)镇编号区县名称townNameString(64)镇名称所属供电局powerBureauIdString(32)供电所供电所编号powerSupplyOfficeIdString(32)供电所（农电所等）编号供电所名称powerSupplyOfficeNameString(64)所属区县局townIdString(32)馈线线路编号lineIdString(12)线路名称lineNameString(64)电压等级voltageGradeString(8)代码描述 数字描述变电站编号stationIdString(8)所属供电所或镇区编码zoneIdString(32)大客户大客户编号consumerIdString(20)包含居民户大客户名称consumerNameString(64)客户状态userStatusString(1)1运行2销户3新装4业务变更5 暂停客户地址userAddrString(64)所属供电所或镇区编码zoneIdString(32)用接口代码,暂时不管主供线路编号lineIdString(12)客户类别CUSTOMERTYPEString(2)1 大用户专变2 配变 (公变总表)3 公变分表4 10kv线路虚拟考核户(先保留)行业用电分类industryTypeString(8)行业分类00000无行业分类A0000农、林、牧、渔业B0000采矿业C0000制造业D0000电力、燃气及水的生产和供应业E0000建筑业F0000交通运输、仓储、邮政业G0000信息传输、计算机服务和软件业G6000电信和其它信息传输服务业G6100计算机服务和软件业H0000商业、住宿和餐饮业H6300批发和零售业H6600住宿和餐饮业J0000金融、房地产、商务及居民服务业M0000公共事业及管理组织W9901趸售Y0000城乡居民生活用电Z0000全行业用电分类所属台区pubTranNo居民户才有台区属性consumerTypeString(1)0 城网1 农网用电类别useTypeString(8)代码描述 用电类别10大工业20普通工业25非工业/普通工业30非工业40商业50住宅60农业生产70稻田排灌、脱粒用电95其他97龙门关口用电联系人linkManString(32)联系电话linkPhoneString(32)供电电压supplyVoltageString(8)代码描述 请提供代码内容报装容量totalRatedPowerString(10)数字描述大客户终端终端资产编号ddpAssetNoString终端逻辑地址termAddressString(10)终端型号ddpTypeString(20)终端厂家提供相线ddpAaString营销系统没有,终端上电测试完后可以提供，终端厂家提供生产厂家ddpFactoryIdString终端厂家提供终端类型ddpClassString(2)11变电站关口终端12大用户终端13台区终端14集中抄表终端规约ddpProtocalString(1)1广电大用户二期2广电102规约3广电配网抄表规约4广电集中抄表规约5广电719规约营销系统不保存此信息高级密码ddpHighPasswordString营销系统没有,终端上电测试完后可以提供，终端厂家提供营销系统不保存此信息低级密码ddpLowPasswordString营销系统没有,终端上电测试完后可以提供，终端厂家提供营销系统不保存此信息终端状态ddpStatusString(2)10购入20待检30检定40待装50运行60拆回70淘汰80报废90遗失软件版本ddpSoftVersionString营销系统没有,终端上电测试完后可以提供，终端厂家提供营销系统不保存此信息硬件版本ddpHardVersionString营销系统没有,终端上电测试完后可以提供，终端厂家提供营销系统不保存此信息出厂编号ddpSaleIdString额定电压ddpVoltageString额定电流ddpRatingCurrentStringSIM卡电话号码ddpPhonenoString(20)营销系统没有,终端上电测试完后可以提供，终端厂家提供）下同SIM卡号ddpSimnoString(20)通信apnapnString(20)营销系统不保存此信息Apn用户名userNameString(20)营销系统不保存此信息Apn密码passWordString(15)营销系统不保存此信息IP地址ddpIpString(15)大客户编号1consumerId1String(20)大客户编号2consumerId2String(20)大客户编号3consumerId3String(20)大客户编号4consumerId4String(20)大客户表计资产编号ammAssetNoString(24)计量点编号meterSNString(5)计费点号计量点名称measurePointNameString(20)电表型号ammTypeString(8)代码描述请提供代码内容接线方式connectionTypeString(1)代码描述请提供代码内容生产厂家faccodeString(8)代码描述请提供代码内容CT变比ctRatioString(8)代码描述请提供代码内容PT变比ptRatioString(8)代码描述请提供代码内容倍率ammFactoryNoString(6)优先倍率 3 个都传,不符合的部分提示电表序号meterIndexString(5)0-终端自身1-总表1201起-重点户,最多6个暂时预留电表密码meterPasswdString(6)同终端 还需讨论暂时预留通讯方式communicateTypeString(1)0-485方式1-载波通信表(默认)2-其它电表表号meterNoString(12)表通信地址供电线路编码lineIdString(12)备用 抄表线路号readLineNoString(12)抄表组抄表员代码wattfulSNString(24)抄表区段号reactiveSNString(24)抄表册安装地址setAddressString(64)计量方式measureModeString(1)代码描述:1高供高计2高供低计3低供低计出厂编号madeNoString(32)抄表状态writeMeterStateString(1)备用主副表标志mainFlagString(1)0:主表1:副表目前默认为0子母表subFlagString(1)0:母表1:子表大客户编号consumerIdString(20)大客户编号 台区编号终端逻辑地址termAddressString(10)值不空：表示终端跟表计对应关系在营销对应；值空：没有对应关系，需要在大客户里对应供电变压器编号transformerIdString(16)备用行业用电分类industryTypeString(8)代码描述用电类别useTypeString(8)代码描述 报装容量totalRatedPowerString(10)分时标志periodFlagString(1)是否需要抄总峰、谷、平1:要（分时）0:不要（不分时）无功标志pneqFlagString(1)表示是否抄无功总1:是0:不要抄换表时间或换CP/PT时间（公用）changeDateString(20)无换表为空，至少精确到天(格式yyyy-mm-dd hh:mm:ss)下同换表原因changeCauseString(5)代码描述换下有功总downP0String(12)针对拆除表计,无换表为空换下有功峰downP1String(12)同上换下有功平downP2String(12)同上换下有功谷downP3String(12)同上换下无功总downPn0String(12)同上换上有功总upP0String(12)针对新装表计,无换表为空换上有功峰upP1String(12)同上换上有功平upP2String(12)同上换上有功谷upP3String(12)同上换上无功总upPn0String(12)同上计量点关系用户号1consumerId1String(20)母表计量点号1meterSN1String(5)母表用户号2consumerId2String(20)子表计量点号2meterSN2String(5)子表关系描述meterFlagString(1)0: 主副表1: 子母表居民的台区户，终端资料处理方法同大用户3.2 冻结电量对象类型属性名称属性标识值类型备注大用户冻结电量用户编号consumerIdString(20)计量点号meterSNString(20)计费点号 居民用电表表号-计费点号计费次数monSNString(3)抄表时间writeDateString(20)格式:YYYY-MM-DD HH:MI:SS抄表标志writeFlagString(1)0:未抄1:已抄2:估抄本月表码总endP0String(12)主表对居民只有多功能表月冻结才有分费率，其他情况下只有正向有功总居民无需量本月表码峰endP1String(12)本月表码谷endP2String(12)本月表码平endP3String(12)本月表码无功总endPn0String(12)本月表码需量总xendP0String(12)本月表码总fendP0String(12)副表 本月表码峰fendP1String(12)副表本月表码谷fendP2String(12)副表本月表码平fendP3String(12)副表本月表码无功总fendPn0String(12)副表本月表码需量总fxendP0String(12)副表居民户号唯一，包括总表户号3.3 告警管理对象类型属性名称属性标识值类型备注告警管理负控工单号workNoString(32)主站系统产生,用户1天若有多条报警信息,要求只产生1个工单号,向营销系统发送一条报警数据用户号consumerIdString(20)户号产生工单日期workDateString(20)格式:YYYY-MM-DD HH:MI:SS顺序号alarmIdString(12)主站系统产生, 针对每个workNo从1开始编号计量点号meterSNString(20)针对表计告警情况,当为终端告警时此字段为空终端逻辑地址termAddrString(10)终端资产编号dlAssetNoString(20)告警编码AlarmcodeString(4)(大客户提供告警编码名称初始数据关系)告警标识alarmTypeString(1)0：终端告警1：表计报警告警紧急程度alarmlevelString(1)1:紧急告警2:一般3:普通告警时间rodDtString(20)格式:YYYY-MM-DD HH:MI:SS告警信息alarmInfoString(300)将告警信息拼凑为长字符串 配变，居民告警处理同大用户具体事项定义参见接口事项类型定义3.4 告警处理对象类型属性名称属性标识值类型备注告警处理负控工单号workNoString(32)负控工单号,对于用户一天存在多条告警信息,处理信息只返回一次处理人dealManString(10)回传结果处理时间dealDtString(20)回传结果误报标志AlarmflagString(1)0: 误报1: 正常处理结果dealResultString(200)营销回传处理结果说明信息配变，居民告警处理同大用户具体事项定义参见接口事项类型定义4 交换策略4.1 轮询1) 客户端在固定时间间隔访问服务端获取数据.在配置文件中配置时间间隔。2) 时间间隔段时,增量交易,时间间隔比较长时整块交易。4.2 随机根据客户端业务的需要,客户可以通过手工访问的方式随机获取服务器端数据.支持增量交易和整块交易。4.3 通知当数据发生变更时，把最新的数据发送给对方。数据变更一方做客户端，接收数据一方做服务器端。客户端主动通知服务器。5 交换格式5.1 基础资料交换数据交换说明：1. 轮询策略，负控从营销读取基本信息；2. 通知策略，营销将变更基本信息通知负控；5.1.1 镇格式： 语义：AMSB：对象类型标识，参考命名规范字段含义见 3.1基础资料约定: 若按对象类型查询,则objectId=townId5.1.2 供电所格式： 语义：AMSO：对象类型标识，参考命名规范字段含义见 3.1基础资料约定: 若按对象类型查询,则objectId=powerSupplyOfficeId5.1.3 馈线格式： 语义：LAPF：对象类型标识，参考命名规范字段含义见 3.1基础资料约定: 若按对象类型查询,则objectId=lineId5.1.4 大客户格式： 语义：LAPC：对象类型标识，参考命名规范字段含义见 3.1基础资料约定: 若按对象类型查询,则objectId=consumerId5.1.5 大客户终端格式： 语义：LAPT：对象类型标识，参考命名规范字段含义见 3.1基础资料约定: 若按对象类型查询,则objectId=ddpAssetNo5.1.6 大客户表计格式： 语义：LAPM：对象类型标识，参考命名规范字段含义见 3.1基础资料约定: 若按对象类型查询,则objectId=consumerId5.1.7 计量点关系格式： 语义：LAPP: 对象类型标识，参考命名规范字段含义见 3.1基础资料约定: 若按对象类型查询,则objectId=consumerId15.2 冻结电量交换数据交换说明：1. 轮询策略，营销从负控读取冻结表码信息；格式： 语义：LAPE: 对象类型标识，参考命名规范字段含义见 3.1基础资料 5.3 告警管理交换数据交换说明：1. 轮询策略，营销从负控读取告警信息；2. 通知策略，负控将告警信息通知营销；大用户告警事件：格式： raeValue:raeMapValue;raeValue:raeMapValue; raeValue:raeMapValue;raeValue:raeMapValue; 语义：LAPA: 对象类型标识，参考命名规范字段含义见 3.1基础资料注: 字段为告警关键信息(字段:值)的组合字符串,举例: A相电压:0231; B相电压:0222; 5.4 告警处理交换数据交换说明：1. 通知策略，营销将告警处理结果信息通知负控；大用户告警事项处理格式： 语义：LAPR: 对象类型标识，参考命名规范字段含义见 3.1基础资料6 服务列表6.1 大客户(主站)模块服务名称服务内容调用参数返回结果说明大客户LAPServicesetBaseInfo：接收营销发送来的更新基础数据。验证码，对象类型标示，数据更新标示,交换数据无1) 该方法部署在主站系统，营销把更新的及时信息通过该接口交换。2) 交换数据格式见 5.1 中约定LAPServicegetCou：提供冻结电量数据验证码，电表编号，开始时间，结束时间，数据项返回指定时间内指定电表的编号，指定数据项的冻结电量。1) 电表编号为空，所有表计的冻结电量。2) 开始时间与结束时间相等时，返回该点的冻结电量数据。3) 数据项编码参见应用数据编码4) 该方法部署在主站系统，供营销系统调用取抄表行码。5) 返回数据格式见5.2中约定LAPServicegetAlarm：提供告警数据验证码,用户号,开始时间,结束时间. 交换策略返回指定时间段内该用户号的告警信息.1) 起止时间和结束时间等于空且用户号为空,返回所有告警.2) 起止时间和结束时间等于空且用户不为空，返回该用户下所有终端告警3) 起止时间小于结束时间且用户为空返回时间段所有告警.4) 起止时间小于结束时间且用户不为空返回时间段用户下所有告警.5) 该方法部署在主站系统，供营销系统调用获取用户告警信息。6) 返回数据格式见5.3中约定LAPServicesetAlarmResult：接收告警处理结果验证码，交换数据无1) 该方法部署在主站系统，供营销系统调用回存告警处理结果。2) 交换数据格式见5.4中约定6.2 营销系统系统