当前位置:文档之家› 省系统接口说明范文

省系统接口说明范文

附件1:市级系统接口参考页面1 说明本文档是关于……,要求……。

已达到……目的。

2 参考页面第一步客户端首先要设置web service的连接地址、用户名和密码三项。

远程地址固定为:http://124.133.54.21/services/DataService。

用户名和密码为省总队分配。

参考界面如下:帐号:3702-00-01密码:第二步企业填报自己月报数据然后提交。

第三步市级用户审核企业提交的月报数据。

第四步市级进入提交审核页面。

审核通过的企业将在“企业列表”中显示。

将企业选择进“已选企业”。

然后点击“上传至省平台”按钮。

操作完成。

参考界面如下:附件2:山东省节能信息系统数据导入接口协议1 简介本协议用于山东省节能信息系统与通过API接入山东省节能信息系统的客户端的数据传输通讯。

两者的数据传输通讯采用TCP协议、短连接方式,山东省节能信息系统为服务器方。

缩略语清单:client :所有通过Web Service接口接入山东省节能信息系统的客户端2 Web Service接口说明2.1 山东省节能信息系统Web Service地址WSDL:http://124.133.54.21/services/DataService?wsdl地址:http://124.133.54.21/services/DataService2.2 接口说明2.2.1 i mportYearReportData方法public String importYearReportData(String loginName,String loginPwd,String cityCode,int year,String reportData)方法说明:从各地市系统上传本市已经审核确认的企业年报数据到省系统,如果省系统中企业当年年报数据还未上传过,则添加年报数据,如果年报数据已经上传过,则更新已上传年报数据。

返回值定义:第一行为错误代码,其他行为调用失败时的详细错误信息ok:数据导入成功invalidate-city:错误的地市编码invalidate-date:错误的年份invalidate-user:访问用户不可用not-allow-op:用户没有操作权限illegal-report-data:不合法的报表数据格式error-report-style:错误的报表样式error-verify-relations:错误的校验关系2.2.2 i mportMonthReportData方法public String importMonthReportData(String loginName,String loginPwd,String cityCode,int year,int month,String reportData)方法说明:从各地市系统上传本市已经审核确认的企业月报数据到省系统,如果省系统中企业当月月报数据还未上传过,则添加月报数据,如果月报数据已经上传过,则更新已上传月报数据。

返回值定义:第一行为错误代码,其他行为当调用失败时的详细错误信息ok:数据导入成功invalidate-city:错误的地市编码invalidate-date:错误的年份或月份invalidate-user:访问用户不可用not-allow-op:用户没有操作权限illegal-report-data:不合法的报表数据格式error-report-style:错误的报表样式error-verify-relations:错误的校验关系2.2.3 e xportDictionarypublic String exportDictionary(String catalog)方法说明:导出省级系统定义的各类字典编码数据,企业注册信息、月报数据、年报数据中相关字段所使用的编码将从系统定义的字典编码中选取。

参数说明:返回值定义:返回的各种字典编码数据,每行为一条编码,每个编码包含code和name,中间用“$@$”分隔。

返回值示例:1.能源种类01$@$原煤02$@$洗精煤…2.计量单位0103$@$毫克0106$@$微克…3.产品指标0001$@$万元产值综合能耗(当量值)$@$万元产值综合能耗(等量值)…4.企业类型001$@$国家千家重点用能单位002$@$省千户重点用能单位003$@$市属重点用能单位5.行业分类06$@$煤炭17$@$纺织…6.行业编码06$@$煤炭开采和洗选业08$@$黑色金属采选业…7.产业编码1$@$第一产业2$@$第二产业3$@$第三产业4$@$其他产业8.省级编码$@$山东…9.地市编码$@$济南$@$青岛…10.区县编码$@$市辖区$@$历下区$@$市中区…3 错误码使用说明对于方法调用的返回值,ok代表数据导入成功,其他表示失败,具体错误码见下表。

4 附录4.1 报表数据格式定义1. 年报和月报数据格式包含多个表数据(表定义见附录4.3、4.4、4.5),每个表包含1到多个用能单位的上报数据,即:表1的上报数据,表2的上报数据,…,表n的上报数据。

2. 每个表数据第一行是表名标识行,以“@@”开头,后跟表数据所对应的表的编码,第二行是表字段定义行,定义了该表所使用的字段名称,各个字段名之间用“$@$”分隔。

剩下行是表数据行,存放各个企业对该表的上报数据,要求数据行的各个字段值必须和字段定义行的各个字段相一致,各个数据值之间用“$@$”分隔。

各行之间用回车换行(\r\n)分隔。

3. 填报的数据,对于字符型和日期型,要求在数据两边加单引号。

4. 报表数据各行的各个字段要求必须有值,如果企业数据没有填写,那么使用初始数据填充,数值型数据初始值为0,字符型和日期型数据初始值为空字符串(不是null)。

5. 要求导入的数据要遵循对应报表的数据校验关系,系统会根据数据校验关系对数据进行校验,校验不通过时不能被导入,并返回错误码。

6. 导入数据可以传入指定报表的某个年月的多家企业的报表数据。

导入时如果该企业该年月有数据则采用覆盖的方式处理,否则数据为添加的方式。

7. 每次调用接口上报年报或月报的企业数量不要超过50家,如果需要上报企业超过50家,建议分为多次调用上报。

月报报表数据格式示例:@@nyqyzcxxbqy_code$@$qy_name$@$qy_qyfl_code$@$qy_address$@$qy_hy_code$@$qy_province$@$qy_city$@$qy_coun ty$@$qy_sscy$@$des'-0'$@$'山东XXXX有限公司'$@$'06'$@$'山东省xx 市xx 路xx 号'$@$'001'$@$''$@$''$@$''$@$''$@$'1'$@$''…@@nygjxfkcbqy_code$@$nyzl_code$@$qkcl$@$gjl_swl$@$gjl_je$@$xfl_gyscxf$@$xfl_gyscxf_yyycl$@$xfl_fgyscxf$ @$xfl_ysgjxf$@$qmkcl$@$cyzbxs$@$dwfzr$@$tjfzr$@$tbr$@$dh$@$tbrq…@@nygjxfkcb_zyzbqy_code$@$bq_zhnyxfl$@$sq_zhnyxfl$@$bq_gyzcz_dnj$@$bq_gyzcz_snj$@$sq_gyzcz_dnj$@$sq_fgyscxf$ @$sq_dlxfhj$@$sq_gyscdlxf$@$sq_dlcc$@$sq_hlfdtr…@@nygjxfkcfbqy_code$@$nyzl_code$@$hlfd$@$gr$@$ymrx$@$lj$@$ly$@$zq$@$trqyh$@$jgmzp$@$nyjgzhcc$@$hsly$@$dw fzr$@$tjfzr$@$tbr$@$dh$@$tbrq…@@dwcpzhnhzbqkbqy_code$@$cpzb_code$@$bnd_zxz$@$bnd_mxz$@$snd_mxz$@$snd_zxz$@$dwfzr$@$tjfzr$@$tbr$@$dh$@$tbrq…4.2 地市编码表4.3 企业注册信息表定义4.4 需要导入年报报表定义暂无4.5 需要导入月报报表定义4.6 客户端调用方法本节介绍如何使用XFire工具访问数据接口进行数据操作,开发语言为JAVA。

你也可以采用其他你所熟悉的SOAP兼容库进行开发。

该程序只作为参考实现,未考虑运行效率,请客户端开发者根据自己实际情况修改。

首先我们通过 http://124.133.54.21/services/DataService?wsdl可以获得 WSDL 文件 DataService.wsdl ,并将其放在 src 目录下面,接着我们通过程序访问该 WSDL 文件,并调用需测试的方法。

此时测试类 WebServiceClientTest.java 的关键代码如下所示:String wsdl = " DataService.wsdl " ; // 对应的WSDL文件Resource resource = new ClassPathResource(wsdl);Client client = new Client(resource.getInputStream(), null ); // 根据WSDL创建客户实例Object[] params = new Object[6];params [0] = "loginUser" ; //用户名params [1] = "loginPwd" ; //用户口令params [2] = "3701" ; //地市编码params [3] = 2010 ; //年报年份params [4] = "" ; //年报数据// 调用特定的Web Service方法Object[] results = client.invoke( "importYearReportData" , params);System.out.println( "result: " + results[0]);。

相关主题