1.简介-深圳市住房和建设局.docVIP

附件 深圳市建设工程勘察设计业务系统与燃气企业管道系统数据接口方案 目　录 1. 简介 3 2. 名词解释 3 2.1.1. XML 3 2.1.2. WebSerivce 3 3. 模块功能目标 3 4. 功能详细需求 4 4.1. 具体实现方式和步骤 4 4.2. 数据接收接口（燃气方） 6 4.2.1. 燃气集团数据接收接口 6 4.2.2. 大鹏公司数据接收接口 6 4.2.3. 其他燃气公司数据接收接口 6 4.2.4. 钻孔数据表 6 4.2.5. 返回信息表 8 4.2.6. 业务规则 9 4.3. 结果接收接口（住建方） 9 4.3.1. 检查结果数据表 9 4.3.2. 返回信息表 10 4.3.3. 业务规则 11 简介 为防范因工程勘察造成的燃气管线事故，切实保障我市地下燃气管线设施的安全运行，我局在“深圳市建设工程勘察设计业务系统” （以下简称“勘察设计业务系统”）建立了数据接口，用于与各燃气企业的管道系统进行数据交换，勘察设计业务系统将勘察单位上传的计划钻孔坐标信息，提供给各燃气企业管道系统，各燃气企业管道系统负责查询工程钻孔周边的燃气管道分布，将查询结果反馈至勘察设计业务系统，告知勘察单位项目范围内地下燃气管线的情况。 名词解释 XML The Extensible Markup Language(可扩展标识语言)的简写，XML是一套定义语义标记的规则，这些标记将文档分成许多部件并对这些部件加以标识。它也是元标记语言，即定义了用于定义其他与特定领域有关的、语义的、结构化的标记语言的句法语言。 WebSerivce Web Service是一种新的Web应用程序分支，他们是自包含、自描述、模块化的应用，可以发布、定位、通过Web调用。它同时是平台又是一种规范；Web Service具备了跨平台跨防火墙等诸多优越特性。 模块功能目标 由于应用部署环境不同，勘察设计业务系统与各燃气企业的数字化管道维护系统现无法直接互连实现数据的共享。 通过开发WebService接口，由燃气企业开发数据接收服务端接口，部署在广域网，勘察设计业务系统调用此接口完成待核查钻孔数据发送；由勘察设计业务系统开发结果接收服务端接口，部署在广域网，各燃气企业完成内部数据检查工作后调用此接口，将检查结果回写局系统。最终实现核查数据的无缝链接。 功能详细需求 具体实现方式和步骤 钻孔数据提交检查时，由勘察设计业务系统调用广东大鹏液化天然气有限公司、燃气集团或其他燃气公司的数字化管道维护系统提供的接口，将勘察大纲中的钻孔坐标数据发送至各燃气公司系统中，并接收数据写入成功或失败标志，以提醒调用方操作的完整性、准确性，最终写入系统日志。 各燃气企业接收钻孔坐标数据后，与企业内部管道系统进行数据比对核查，完成核查工作后调用勘察设计业务系统提供的接口，按批次将各次接收的数据连同核查结果返回至勘察设计业务系统，并接收数据写入成功或失败标志，以提醒调用方操作的完整性、准确性，最终写入系统日志。 图4.1数据接收接口 图4.2结果接收接口 数据接收接口（燃气方） 燃气集团数据接收接口 WriteData(string as_Check, string as_XmlData); 入参：as_Check 初始化值为空; as_XmlData XML格式字符串; 出参：result XML格式字符串; 大鹏公司数据接收接口 InsertDrillCoordinatesInfo(string username, string passwords, string strInfo); 入参：username 登录帐号; Passwords 登录密码; strInfo XML格式字符串; 出参：result XML格式字符串。 其他燃气公司数据接收接口 ReceiveData (string username, string passwords, string strInfo); 入参：username 登录帐号;（燃气公司拟定） Passwords 登录密码; （燃气公司拟定） strInfo XML格式字符串; 出参：result XML格式字符串。 钻孔数据表 即接口as_XmlData、strInfo入参的XML格式数据描述。 代码 数据类型 可否为空 字段描述 PICIDRILL（新增字段） NUMBER N 钻孔批次 PRJID（新增字段） NUMBER N 工程编号 PRJNAME VARCHAR2 (500) N 工程名称 PRJEVEL VARCHAR2 (100)