1、 1附件深圳市建设工程勘察设计业务系统与燃气企业管道系统数据接口方案2目 录1. 简介 32. 名词解释 32.1.1. XML.32.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.
2、业务规则 .1131. 简介为防范因工程勘察造成的燃气管线事故，切实保障我市地下燃气管线设施的安全运行，我局在“深圳市建设工程勘察设计业务系统” （以下简称“勘察设计业务系统” ）建立了数据接口，用于与各燃气企业的管道系统进行数据交换，勘察设计业务系统将勘察单位上传的计划钻孔坐标信息，提供给各燃气企业管道系统，各燃气企业管道系统负责查询工程钻孔周边的燃气管道分布，将查询结果反馈至勘察设计业务系统，告知勘察单位项目范围内地下燃气管线的情况。2. 名词解释2.1.1. XML The Extensible Markup Language(可扩展标识语言)的简写，XML 是一套定义语义标记的规则，这
3、些标记将文档分成许多部件并对这些部件加以标识。它也是元标记语言，即定义了用于定义其他与特定领域有关的、语义的、结构化的标记语言的句法语言。 2.1.2. WebSerivce Web Service是一种新的 Web应用程序分支，他们是自包含、自描述、模块化的应用，可以发布、定位、通过 Web调用。它同时是平台又是一种规范；Web Service 具备了跨平台跨防火墙等诸多优越特性。 3. 模块功能目标由于应用部署环境不同，勘察设计业务系统与各燃气企业的数字化管道维护系统现无法直接互连实现数据的共享。通过开发 WebService接口，由燃气企业开发数据接收服务端接口，部署在广域网，勘察设计业
4、务系统调用此接口完成待核查钻孔数据发送；由勘察设计业务系统开发结果接收服务端接口，部署在广域网，各燃气企业完成内部数据检查工作后调用此接口，将检查结果回写局系统。最终实现核查数据的无缝链接。4数字化管道维护系统勘察设计业务系统广域网燃气企业深圳市住建局数据接收接口结果接收客户端接口数据接收客户端接口结果接收接口 调用调用4. 功能详细需求4.1. 具体实现方式和步骤1. 钻孔数据提交检查时，由勘察设计业务系统调用广东大鹏液化天然气有限公司、燃气集团或其他燃气公司的数字化管道维护系统提供的接口，将勘察大纲中的钻孔坐标数据发送至各燃气公司系统中，并接收数据写入成功或失败标志，以提醒调用方操作的完整
5、性、准确性，最终写入系统日志。2. 各燃气企业接收钻孔坐标数据后，与企业内部管道系统进行数据比对核查，完成核查工作后调用勘察设计业务系统提供的接口，按批次将各次接收的数据连同核查结果返回至勘察设计业务系统，并接收数据写入成功或失败标志，以提醒调用方操作的完整性、准确性，最终写入系统日志。5数 据 接 收 接 口勘察设计业务系统燃气企业管道系统W e b s e r i c e 接 口 调 用 （ 发 送 请 求 命 令 ）W e b s e r i c e 接 口 调 用 （ 返 回 信 息 ）返 回 成 功 或 失 败信 息服 务 端客 户 端插 入 数 据检 查 信 息发 送 待 核 查钻
6、 孔 数 据网 络 异 常 或 操 作 失 败开 始 结 束操 作 成 功图 4.1数据接收接口结 果 接 收 接 口燃气企业管道系统勘察设计业务系统W e b s e r i c e 接 口 调 用 （ 发 送 请 求 命 令 ）W e b s e r i c e 接 口 调 用 （ 返 回 信 息 ）返 回 成 功 或 失 败信 息服 务 端客 户 端插 入 结 果 、记 录 日 志检 查 信 息发 送 核 查结 果网 络 异 常 或 操 作 失 败开 始 结 束操 作 成 功图 4.2结果接收接口64.2. 数据接收接口（燃气方）4.2.1. 燃气集团数据接收接口WriteData(st
7、ring as_Check, string as_XmlData);入参：as_Check 初始化值为空 ;as_XmlData XML格式字符串;出参：result XML格式字符串;4.2.2. 大鹏公司数据接收接口InsertDrillCoordinatesInfo(string username, string passwords, string strInfo);入参：username 登录帐号;Passwords 登录密码;strInfo XML格式字符串;出参：result XML格式字符串。4.2.3. 其他燃气公司数据接收接口ReceiveData (string usern
8、ame, string passwords, string strInfo);入参：username 登录帐号;（燃气公司拟定）Passwords 登录密码; （燃气公司拟定）strInfo XML格式字符串;出参：result XML格式字符串。4.2.4. 钻孔数据表即接口 as_XmlData、strInfo 入参的 XML 格式数据描述。代码 数据类型 可否为空 字段描述PICIDRILL（新增字段） NUMBER N 钻孔批次PRJID（新增字段） NUMBER N 工程编号PRJNAME VARCHAR2 (500) N 工程名称PRJEVEL VARCHAR2 (100) N 工
9、程等级PRJTYPE VARCHAR2 (100) N 勘查性质(内容：工程勘探、地质勘探 )KCBEGINDATE DATE N 勘察开始时间KCENDDATE DATE N 勘察结束时间PRJLEADER VARCHAR2 (100) N 勘察项目负责人7PRJLEADERPHONE VARCHAR2 (100) N 勘察项目负责人联系电话JSUNITCODE VARCHAR2 (100) N 建设单位组织机构代码JSUNITNAME VARCHAR2 (500) N 建设单位名称JSCONTACT VARCHAR2 (100) N 建设单位联系人JSCONTACTPHONE VARCHA
10、R2 (100) N 建设单位联系电话KCUNITCODE VARCHAR2 (100) N 勘察单位组织机构代码KCUNTNAME VARCHAR2 (100) N 勘察单位名称KCCONTACT VARCHAR2 (100) N 勘察单位联系人KCCONTACTPHONE VARCHAR2 (100) N 勘察单位联系电话DRILLID（新增字段） NUMBER N 钻孔编号DRILLCODE VARCHAR2 (10) N 钻孔编码XPOINT VARCHAR2 (20) N 钻孔 X 坐标YPOINT VARCHAR2 (20) N 钻孔 Y 坐标DISTRICT VARCHAR2 (
11、100) N行政区域(内容：罗湖区、福田区、南山区、盐田区、宝安区、龙岗区、光明新区、坪山新区、龙华新区、大鹏新区)STREET VARCHAR2 (100) N 作业街道名称SENDTIME DATE N 发送时间XML 格式示例13461工程名称工程等级 勘探性质PR001勘察开始时间勘察结束时间勘察项目负责人勘察项目负责人联系电话 建设单位组织机构代码建设单位名称建设单位联系人建设单位联系电话 勘察单位组织机构代码勘察单位名称勘察单位联系人勘察单位联系电话 行政区域 街道 钻孔编号01钻孔编号02钻孔编号03钻孔编号048钻孔编号05钻孔编号300 发送时间 4.2.5. 返回信息表即接
12、口 result 出参的 XML 格式数据描述。代码 数据类型 可否为空 字段描述CORPCODE VARCHAR2(20) N 公司编码PICIDRILL NUMBER N 钻孔批次PRJID NUMBER N 工程编号SENDSTATUS VARCHAR2(2) N 发送状态DESCRIPTION VARCHAR2(1000) Y 发送状态描述（只描述发送失败原因）WRITETIME DATE N 写入时间公司编码（CORPCODE）码值描述代码 含义A1 燃气集团A2 大鹏公司A3 。发送状态（SENDSTATUS）码值描述代码 含义1 发送成功0 发送失败XML 格式示例发送成功A11
13、34611写入时间发送失败9A1134610发送失败原因写入时间4.2.6. 业务规则1、勘察设计业务系统调用燃气方接口，如发送数据成功，勘察设计业务系统对此批次钻孔数据进行锁定。待燃气方返回核查结果后，再对此批次数据进行解锁，恢复成可修改状态。而对新添加的钻孔数据，勘察设计业务系统不予限制，可以以新的批次进行数据提交。2、燃气方接口接收到数据后，按批次进行接收。不需与原有批次进行坐标位置比对。勘察设计业务系统会控制只发送未核查的孔信息。4.3. 结果接收接口（住建方）writeDrillRQGWInfo(String username,String passwords,String xmlD
14、ata)入参：username 登录帐号;Passwords 登录密码;xmlData XML 格式字符串;出参：result XML格式字符串;4.3.1. 检查结果数据表即接口 xmlData 入参的 XML 格式数据描述。代码 数据类型 可否为空 字段描述CORPCODE VARCHAR2 N 公司编码CONTACTPER VARCHAR2 N 紧急联系人CONTACTTEL VARCHAR2 N 紧急联系电话PICIDRILL NUMBER N 钻孔批次PRJID NUMBER N 工程编号PRJNAME VARCHAR2 N 工程名称DRILLID NUMBER N 钻孔编号XPOI
15、NT VARCHAR2 N 钻孔 X 坐标YPOINT VARCHAR2 N 钻孔 Y 坐标DEALTIME DATE N 记录处理时间10钻孔信息（DRILLCODE）码值描述代码 含义1 有燃气管道0 无燃气管道XML 格式示例A1紧急联系人紧急联系电话11工程名称（有无燃气管道）1或010000记录处理时间 4.3.2. 返回信息表即接口 result 出参的 XML 格式数据描述。代码 数据类型 可否为空 字段描述CORPCODE VARCHAR2 N 公司编码PICIDRILL NUMBER N 钻孔批次PRJID NUMBER N 工程编号PRJNAME VARCHAR2 N 工程
16、名称RETURNSTATUS VARCHAR2 N 返回状态REMARK VARCHAR2 N 备注DRILLID NUMBER Y 钻孔编号（当返回状态为 2、3、4 时，才明确有问题的孔信息）XPOINT VARCHAR2 Y 钻孔 X 坐标（当返回状态为 2、3、4 时，才明确有问题的孔信息）YPOINT VARCHAR2 Y 钻孔 Y 坐标（当返回状态为 2、3、4 时，才明确有问题的孔信息）RETURNTIME DATE N 回复时间公司编码（CORPCODE）码值描述11代码 含义A1 燃气集团A2 大鹏公司A3 。返回状态（RETURNSTATUS）码值描述代码 含义1 接收成功2 接收失败-与原批次孔的总数不对应3 接收失败-具体孔坐标信息不匹配4 接收失败-其他XML 格式示例接收成功A111工程名称1备注 回复时间接收失败A111工程名称3该批次有问题的孔信息 备注 回复时间4.3.3. 业务规则燃气方按 XML格式要求，发送结果数据。并根据住建方接口返回的成功标志进行操作完整性检查。如提示结果数据与原发送数据有误，需燃气方比对数据后再进行发送。
