ICS 75-010 SY CCS E 07 中华人民共和国石油天然气行业标准 SY/T 76722022 油气勘探开发专业软件接口规范 Software interface specification for oil and gas exploration and production 2022—11—04 发布 2023 — 05— 04 实施 国家能源局 发布 SY/T 76722022 目 次 前言· 1 范围 2 规范性引用文件 3 术语和定义 4 总则 服务中心构建与应用模式 5.1 组件 5.2 组件关系 5.3 应用模式 6 模型结构 6.1 基础模型 6.2 连接模型 6.3 核心业务模型 7 接口技术要求 7.1 命名规范 7.2 通信协议 7.3 实现要求 7.4 软件连接服务接口 7.5 数据操作服务接口 8服务中心技术实现要求 8.1 服务中心单独实现 8.2集成系统中服务中心实现 10 9应用模式 11 附录A (资料性) 数据交换模型 13 附录B (规范性) 服务接口规范 附录C (资料性) 数据交换关键步骤代码示例 SY/T 7672—2022 前言 本文件按照GB/T 1.1一2020《标准化工作导则第1部分：标准化文件的结构和起草规则》的 规定起草 请注意本文件的某些内容可能涉及专利。本文件的发布机构不承担识别专利的责任。 本文件由石油工业标准化技术委员会石油信息与计算机应用专业标准化委员会提出并归口。 本文件起草单位：昆仑数智科技有限责任公司、中国石油天然气股份有限公司勘探与生产分公 司、中国石油天然气集团有限公司数字和信息化管理部、中油测井技术服务有限责任公司、中国石油 天然气股份有限公司长庆油田分公司、中国石油天然气股份有限公司勘探开发研究院、中海油研究总 院有限责任公司、中海油渤海石油研究院、中海石油（中国）有限公司海南分公司、中国海洋石油集 团有限公司信息技术中心、中国石油化工股份有限公司西南油气分公司、中国石油化工股份有限公司 石油勘探开发研究院。 本文件主要起草人：刘磊、刘雄、马涛、王铁成、杜金虎、张仲宏、卢山、杨剑锋、杨勇、丁建 宇、石玉江、王娟、赵秋生、黄文俊、刘辉、韩永强、刘景义、 白宇辉、包宏、邹媛婷、姜传雷、韩 庆时、安红、陈殿远、徐鹏、胡斌、王永胜。 II SY/T 76722022 油气勘探开发专业软件接口规范 1 范围 本文件规定了基于服务中心模式下，油气勘探开发相关的专业软件和信息系统数据交换的接口技 术要求。 本文件适用于油气勘探开发信息系统与专业软件开发人员开展数据互通和交换功能开发、云化应 用集成和数据交换业务模型定义。 2 规范性引用文件 本文件没有规范性引用文件。 3 术语和定义 下列术语和定义适用于本文件。 3.1 勘探开发专业软件 specialized software for oil and gas exploration and production 为解决油气勘探、开发与生产领域的地质、 地球物理、油气藏工程、采油气工艺等研究、设计、 生产分析、过程控制等特定问题，或满足特定专业数据分析与处理需求的计算机软件。 3.2 服务网关service gateway 基于特定的逻辑，实现将数据、消息、请求等从 个接口／端口转发到另一个接口／端口的服务 进程。 3.3 连接器connector 勘探开发信息系统或专业软件各自单独开发的配套接口连接服务端，主要实现向服务中心对接和 注册，并对目标信息系统／专业软件中业务实体数据的Create（增加）、Read（读取）、Update（更新） 和 Delete（删除）操作功能。 3.4 服务中心 service centre 一个或多个信息系统与若干专业软件之间的接口信息管理服务端，主要实现对接口连接器的信息 管理和网关与路由功能。 3.5 操作台 operation console 面向应用端用户，表现为勘探开发专业软件插件或勘探开发信息系统控制台组件，用于对勘探开 发专业软件或信息系统进行可视化操作的应用程序。 3.6 服务接 service interface 1 SY/T7672—2022 勘探开发信息系统与信息系统、勘探开发信息系统与勘探开发专业软件、勘探开发专业软件与专 业软件之间实现数据传输与信息通信过程所调用的接口。 3.7 交换模型exchangemodel 勘探开发信息系统和勘探开发专业软件、勘探开发专业软件和勘探开发专业软件之间进行数据交 换时所传递的数据结构。 3.8 业务实体business entity 油气勘探开发业务对象的属性、信息等的抽象化数据结构。 3.9 驼峰命名法camel case 又称驼峰式命名法，是电脑程序编写时的一套命名规则（惯例）。当变量名和函式名称是由两 个或多个单词连结在一起而构成唯一识别字时，利用“驼峰式大小写”来表示，可以增加变量和函 式的可读性。单词之间不以空格、连接号“二”或底线“_”连结，共有两种格式。一种是大驼峰法 (upper camel case)，又称帕斯卡命名法，即指当变量名和函式名称是由两个或两个以上单词连结在 一起而构成唯一识别字时，每个单词的首字母都采用大写字母，示例1：FirstName、CamelCase；另 一种是小驼峰法（lowercamelcase），第一个单词以小写字母开始，第二个单词的首字母大写，示例 2 : firstName、camelCase。 4总则 为了满足油气勘探开发专业软件之间、勘探开发信息系统之间、勘探开发专业软件和勘探开发信 息系统之间数据互通与成果共享，应建立一 套基于服务中心的运行机制，用于响应端和请求端搭建起 类似数据服务总线的信息桥功能。当用户由请求端向服务中心发出请求时，服务中心能响应该请求。 服务中心能通过注册中心找到已注册的响应端信息！ 为其建立起数据传输通道。双方按照本文件规定 的数据接口定义及模型结构进行数据交换。 利用服务中心，请求端和响应端宜采用Web Service技术进行通信，可解决企业级及集团级专业 软件与信息系统之间复杂多样的应用调用与数据交换 多对多” 题，并使之简单化、规范化和标准 化，应用模式如图1所示。 服务中心 响应端 Web Service Web Service 服务网关和 请求端 注册中心 图1基于服务中心的应用模式 5服务中心构建与应用模式 5.1组件 服务中心应用模式应包含以下要素： 2 SY/T7672—2022 a）请求端：通过请求端用户可以获取响应端列表并对响应端内的数据进行操作； b）响应端：响应端提供对目标数据源的增、删、改、查服务，并将自身信息注册到注册中心； c）注册中心：注册中心内保存并管理响应端的连接信息，供服务网关与请求端调用； d）服务网关：通过服务网关可以实现请求端和响应端之间的数据通信 e）连接信息：用于描述响应端的连接信息，包含响应端的唯一标识、服务连接地址等； f）数据对象：各个组件数据交换时所传递的数据结构。 5.2组件关系 服务中心要素交互关系如图2所示。在此应用模式中应使用同一个服务网关和注册中心，具体交 互过程如下： a）响应端将连接信息注册到注册中心； b）请求端请求注册中心，并获取响应端连接信息； c）请求端向服务网关发送对响应端的数据请求： d）服务网关根据连接信息将数据请求路由到响应端； e）响应端接收到数据请求后，将数据转换为数据对象后，返回给请求端； f）请求端接收到数据对象后，将数据对象进行解析并应用 连接 信息 借息 请求端 响应端 注册中心 数据对象 数据对象 图2 基于服务中心自的要素交互关系图 5.3 应用模式 5.3.1 应用请求端 基于同一应用模式下，请求端与服务中心关系如图3所示，应具备如下应用逻辑： 服务中心 请求端 用户 操作 操作 请求 请求 连接器 操作台 服务网关和 注册中心 数据交换 私有数据 模型 模型 图3应用请求端与服务中心关系图 a）连接器提供服务接口供操作台进行调用，服务接口应符合7.4、7.5的相关要求； b）用户使用操作台，通过连接器的软件连接服务接口请求服务中心获取目标响应端连接器 3