深圳市建设工程勘察设计业务系统与燃气企业管道系统数据接口方案

目录1.
简介32.
名词解释32.
1.
1.
XML32.
1.
2.
WebSerivce33.
模块功能目标34.
功能详细需求44.
1.
具体实现方式和步骤44.
2.
数据接收接口(燃气方)64.
2.
1.
燃气集团数据接收接口64.
2.
2.
大鹏公司数据接收接口64.
2.
3.
其他燃气公司数据接收接口64.
2.
4.
钻孔数据表64.
2.
5.
返回信息表84.
2.
6.
业务规则94.
3.
结果接收接口(住建方)94.
3.
1.
检查结果数据表94.
3.
2.
返回信息表104.
3.
3.
业务规则11简介为防范因工程勘察造成的燃气管线事故,切实保障我市地下燃气管线设施的安全运行,我局在"深圳市建设工程勘察设计业务系统"(以下简称"勘察设计业务系统")建立了数据接口,用于与各燃气企业的管道系统进行数据交换,勘察设计业务系统将勘察单位上传的计划钻孔坐标信息,提供给各燃气企业管道系统,各燃气企业管道系统负责查询工程钻孔周边的燃气管道分布,将查询结果反馈至勘察设计业务系统,告知勘察单位项目范围内地下燃气管线的情况.

名词解释XMLTheExtensibleMarkupLanguage(可扩展标识语言)的简写,XML是一套定义语义标记的规则,这些标记将文档分成许多部件并对这些部件加以标识.
它也是元标记语言,即定义了用于定义其他与特定领域有关的、语义的、结构化的标记语言的句法语言.

WebSerivceWebService是一种新的Web应用程序分支,他们是自包含、自描述、模块化的应用,可以发布、定位、通过Web调用.
它同时是平台又是一种规范;WebService具备了跨平台跨防火墙等诸多优越特性.
模块功能目标由于应用部署环境不同,勘察设计业务系统与各燃气企业的数字化管道维护系统现无法直接互连实现数据的共享.
通过开发WebService接口,由燃气企业开发数据接收服务端接口,部署在广域网,勘察设计业务系统调用此接口完成待核查钻孔数据发送;由勘察设计业务系统开发结果接收服务端接口,部署在广域网,各燃气企业完成内部数据检查工作后调用此接口,将检查结果回写局系统.
最终实现核查数据的无缝链接.

功能详细需求具体实现方式和步骤钻孔数据提交检查时,由勘察设计业务系统调用广东大鹏液化天然气有限公司、燃气集团或其他燃气公司的数字化管道维护系统提供的接口,将勘察大纲中的钻孔坐标数据发送至各燃气公司系统中,并接收数据写入成功或失败标志,以提醒调用方操作的完整性、准确性,最终写入系统日志.

各燃气企业接收钻孔坐标数据后,与企业内部管道系统进行数据比对核查,完成核查工作后调用勘察设计业务系统提供的接口,按批次将各次接收的数据连同核查结果返回至勘察设计业务系统,并接收数据写入成功或失败标志,以提醒调用方操作的完整性、准确性,最终写入系统日志.

图4.
1数据接收接口图4.
2结果接收接口数据接收接口(燃气方)燃气集团数据接收接口WriteData(stringas_Check,stringas_XmlData);入参:as_Check初始化值为空;as_XmlDataXML格式字符串;出参:resultXML格式字符串;大鹏公司数据接收接口InsertDrillCoordinatesInfo(stringusername,stringpasswords,stringstrInfo);入参:username登录帐号;Passwords登录密码;strInfoXML格式字符串;出参:resultXML格式字符串.
其他燃气公司数据接收接口ReceiveData(stringusername,stringpasswords,stringstrInfo);入参:username登录帐号;(燃气公司拟定)Passwords登录密码;(燃气公司拟定)strInfoXML格式字符串;出参:resultXML格式字符串.
钻孔数据表即接口as_XmlData、strInfo入参的XML格式数据描述.
代码数据类型可否为空字段描述PICIDRILL(新增字段)NUMBERN钻孔批次PRJID(新增字段)NUMBERN工程编号PRJNAMEVARCHAR2(500)N工程名称PRJEVELVARCHAR2(100)N工程等级PRJTYPEVARCHAR2(100)N勘查性质(内容:工程勘探、地质勘探)KCBEGINDATEDATEN勘察开始时间KCENDDATEDATEN勘察结束时间PRJLEADERVARCHAR2(100)N勘察项目负责人PRJLEADERPHONEVARCHAR2(100)N勘察项目负责人联系电话JSUNITCODEVARCHAR2(100)N建设单位组织机构代码JSUNITNAMEVARCHAR2(500)N建设单位名称JSCONTACTVARCHAR2(100)N建设单位联系人JSCONTACTPHONEVARCHAR2(100)N建设单位联系电话KCUNITCODEVARCHAR2(100)N勘察单位组织机构代码KCUNTNAMEVARCHAR2(100)N勘察单位名称KCCONTACTVARCHAR2(100)N勘察单位联系人KCCONTACTPHONEVARCHAR2(100)N勘察单位联系电话DRILLID(新增字段)NUMBERN钻孔编号DRILLCODEVARCHAR2(10)N钻孔编码XPOINTVARCHAR2(20)N钻孔X坐标YPOINTVARCHAR2(20)N钻孔Y坐标DISTRICTVARCHAR2(100)N行政区域(内容:罗湖区、福田区、南山区、盐田区、宝安区、龙岗区、光明新区、坪山新区、龙华新区、大鹏新区)STREETVARCHAR2(100)N作业街道名称SENDTIMEDATEN发送时间XML格式示例13461工程名称工程等级勘探性质PR001勘察开始时间勘察结束时间勘察项目负责人勘察项目负责人联系电话建设单位组织机构代码建设单位名称建设单位联系人建设单位联系电话勘察单位组织机构代码勘察单位名称勘察单位联系人勘察单位联系电话行政区域街道钻孔编号01钻孔编号02钻孔编号03钻孔编号04钻孔编号05钻孔编号300发送时间返回信息表即接口result出参的XML格式数据描述.
代码数据类型可否为空字段描述CORPCODEVARCHAR2(20)N公司编码PICIDRILLNUMBERN钻孔批次PRJIDNUMBERN工程编号SENDSTATUSVARCHAR2(2)N发送状态DESCRIPTIONVARCHAR2(1000)Y发送状态描述(只描述发送失败原因)WRITETIMEDATEN写入时间公司编码(CORPCODE)码值描述代码含义A1燃气集团A2大鹏公司A3.
.
.
发送状态(SENDSTATUS)码值描述代码含义1发送成功0发送失败XML格式示例发送成功A1134611写入时间发送失败A1134610发送失败原因写入时间业务规则1、勘察设计业务系统调用燃气方接口,如发送数据成功,勘察设计业务系统对此批次钻孔数据进行锁定.
待燃气方返回核查结果后,再对此批次数据进行解锁,恢复成可修改状态.
而对新添加的钻孔数据,勘察设计业务系统不予限制,可以以新的批次进行数据提交.