标准规范下载简介

SY／T 7672-2022 油气勘探开发专业软件接口规范.pdf

油气勘探开发专业软件接口规范

本文件按照GB/T1.1一2020《标准化工作导则第1部分：标准化文件的结构和起草规则》的 规定起草。 请注意本文件的某些内容可能涉及专利。本文件的发布机构不承担识别专利的责任。 本文件由石油工业标准化技术委员会石油信息与计算机应用专业标准化委员会提出并归口。 本文件起草单位：昆仑数智科技有限责任公司、中国石油天然气股份有限公司勘探与生产分公 司、中国石油天然气集团有限公司数字和信息化管理部、中油测井技术服务有限责任公司、中国石油 天然气股份有限公司长庆油田分公司、中国石油天然气股份有限公司勘探开发研究院、中海油研究总 院有限责任公司、中海油渤海石油研究院、中海石油（中国）有限公司海南分公司、中国海洋石油集 团有限公司信息技术中心、中国石油化工股份有限公司西南油气分公司、中国石油化工股份有限公司 石油勘探开发研究院。 本文件主要起草人：刘磊、刘雄、马涛、王铁成、杜金虎、张仲宏、卢山、杨剑锋、杨勇、丁建 宇、石玉江、王娟、赵秋生、黄文俊、刘辉、韩永强、刘景义、白宇辉、包宏、邹媛婷、姜传雷、韩 庆时、安红、陈殿远、徐鹏、胡斌、王永胜。

抽气勘探开发专业软件接口规范

本文件规定了基于服务中心模式下呼和浩特某广场室外工程施工组织设计方案.doc，油气勘探开发相关的专业软件和信息系统数据交换的接口技 术要求。 本文件适用于油气勘探开发信息系统与专业软件开发人员开展数据互通和交换功能开发、云化应 用集成和数据交换业务模型定义

本文件没有规范性引用文件。

下列术语和定义适用于本文件。 3.1 勘探开发专业软件specializedsoftwareforoilandgasexplorationandproduction 为解决油气勘探、开发与生产领域的地质、地球物理、油气藏工程、采油气工艺等研究、设计、 生产分析、过程控制等特定问题，或满足特定专业数据分析与处理需求的计算机软件。 3.2 服务网关servicegateway 基于特定的逻辑，实现将数据、消息、请求等从一个接口/端口转发到另一个接口/端口的服务 进程。 3.3 连接器connector 勘探开发信息系统或专业软件各自单独开发的配套接口连接服务端，主要实现向服务中心对接和 注册，并对目标信息系统/专业软件中业务实体数据的Create（增加）、Read（读取）、Update（更新） 和Delete（删除）操作功能。 3.4 服务中心servicecentre 一个或多个信息系统与若干专业软件之间的接口信息管理服务端，主要实现对接口连接器的信息 管理和网关与路由功能。 3.5 操作台operationconsole 面向应用端用户，表现为勘探开发专业软件插件或勘探开发信息系统控制台组件，用于对勘探开 发专业软件或信息系统进行可视化操作的应用程序。 3.6

服务接口serviceinterface

SYT 70/ 02

系统与信息系统、勘探开发信息系统与勘探开发专业软件、勘探开发专业软件与专 据传输与信息通信过程所调用的接口。

为了满足油气勘探开发专业软件之间、勘探开发信息系统之间、勘探开发专业软件和勘探开发信 息系统之间数据互通与成果共享，应建立一套基于服务中心的运行机制，用于响应端和请求端搭建起 类似数据服务总线的信息桥功能。当用户由请求端向服务中心发出请求时，服务中心能响应该请求 服务中心能通过注册中心找到已注册的响应端信息，为其建立起数据传输通道。双方按照本文件规定 的数据接口定义及模型结构进行数据交换。 利用服务中心，请求端和响应端宜采用WebService技术进行通信，可解决企业级及集团级专业 软件与信息系统之间复杂多样的应用调用与数据交换“多对多”问题，并使之简单化、规范化和标准 化，应用模式如图1所示。

5服务中心构建与应用模式

图1基于服务中心的应用模式

a）请求端：通过请求端用户可以获取响应端列表并对响应端内的数据进行操作； b）响应端：响应端提供对目标数据源的增、删、改、查服务，并将自身信息注册到注册中心； c）注册中心：注册中心内保存并管理响应端的连接信息，供服务网关与请求端调用； d）服务网关：通过服务网关可以实现请求端和响应端之间的数据通信； e）连接信息：用于描述响应端的连接信息，包含响应端的唯一标识、服务连接地址等； f）数据对象：各个组件数据交换时所传递的数据结构。

服务中心要素交互关系如图2所示。在此应用模式中应使用同一个服务网 程如下： a）响应端将连接信息注册到注册中心； b）请求端请求注册中心，并获取响应端连接信息； c）请求端向服务网关发送对响应端的数据请求； d）服务网关根据连接信息将数据请求路由到响应端； e）响应端接收到数据请求后，将数据转换为数据对象后，返回给请求端 f）请求端接收到数据对象后，将数据对象进行解析并应用

图2基于服务中心的要素交互关系图

基于同一应用模式下，请求端与服务中心关系如图3所示，应具备如下应用逻辑，

图3应用请求端与服务中心关系图

a）连接器提供服务接口供操作台进行调用，服务接口应符合7.4、7.5的相关要求； b）用户使用操作台，通过连接器的软件连接服务接口请求服务中心获取目标响应端连接器

信息； c）用户使用操作台，通过连接器的数据操作服务接口对目标响应端连接器发送数据请求； d）服务中心根据响应端连接器信息将数据请求路由到目标响应端连接器； e）连接器接收到从服务中心返回的数据对象后，将数据对象转换为自身能够识别的数据返回给 操作台； f）连接器与服务中心之间通信的数据应符合第6章的相关要求。

基于同一应用模式，响应端与服务中心关系如图4所示，应具备如下应用逻辑： a）服务中心提供服务接口，供连接器调用，服务接口应符合7.4、7.5的相关要求； b）服务中心通过专业软件或信息系统连接信息将数据请求路由到目标专业软件或信息系统连 接器； c）目标专业软件或信息系统中的连接器接到数据请求后，通过数据操作在数据库或数据文件中 获取数据，并将数据转换为数据交换模型中的数据对象； d）目标专业软件或信息系统中的连接器将转换好的数据对象返回给服务中心； e）服务中心将数据对象返回给调用方； f）连接器与服务中心之间通信的数据应符合第6章的相关要求。

图4应用响应端与服务中心关系图

基础模型包括BoBinary、BoBase、BoChannel三类，是用于数据通信的基础类型，不具有业务属 性，是整个数据交换模型的顶层抽象。数据交换模型中的业务模型都应继承自基础模型，基础模型的 继承关系如图5所示。 基础模型中各类之间的继承关系为： a）基础实体EoBase：是所有基础模型的父类，抽象了数据交换模型中业务模型的公共属性，应 由唯一标识、名称组成，用于标识数据的唯一性； b）扩展参数实体EoValueMap：继承基础实体EoBase，应由基础实体EoBase和扩展参数组成， 用于定义未归属到业务模型内的扩展参数； c）字节流类型基类BoBinary：继承扩展参数实体EoValueMap，应由扩展参数实体 EoValueMap、数据地址和字节数据组成，用于定义非结构化的业务模型； d）通道类型基类BoChannel：继承扩展参数实体EoValueMap，应由扩展参数实体EoValueMap、

通道索引和数据值组成，用于定义通道类的业务模型； 业务类型基类BoBase：继承扩展参数实体EoValueMap，应由扩展参数实体EoValueMap组 成，用于定义除字节流类型BoBinary和通道类型BoChannel外的业务模型

连接器与服务网关通过数据操作服务接口进行数据操作时，应包含连接器调用信息Metalnfo。i 连 接器调用信息应包含属性： 一satelliteld：连接器唯一标识，应使用连接器注册信息中的id属性； 一eoCode：业务模型唯一标识，应使用业务模型类名

业务模型继承于基础模型。

开发者应基于基础模型对业务模型进行扩展，且根据业务实际需要增加业务属性，具体示例见 业务模型继承关系应符合表1的规定。

表1业务模型继承关系

遵循驼峰式命名法中的大驼峰命名法的命名惯例，单词之间不以空格断开或连接号 连接，第一个单词首字母采用大写字母，后续单词的首字母亦用大写字母。

遵循驼峰式命名法中的小驼峰命名法的命名惯例，单词之间不以空格断开或连接号 连接，第一个单词首字母采用小写字母，后续单词的首字母用大写字母。

开发者应根据软件连接服务接口和数据操作服务接口定义，进行功能实现。开发者可使用任意 吾言实现

应用响应端连接器应通过此接口将自身的连接器注册信息注册到注册中心，用于应用请求端连接

SY/T 76722022

器或服务网关查询。注册接口应每分钟调用一次，以便确认或保持通信的连通。连接器注册信息的id 属性由注册中心生成，由 satelliteName、serviceURL、hostIP、source、Port 确定其唯一性。连接器注 册信息的lastActive属性应为接口调用时的系统时间。注册中心应根据连接器的lastActive属性判断连 接器活动状态，如果当前时间减去连接器的lastActive属性大于2min时，注册中心判断连接器连接中 断，从注册中心内移除此连接器注册信息。 注册连接器接口应符合B.1的要求

请求端连接器或服务网关应通过此接口查询可使用的连接器列表。此接口应支持根据连接器类型 进行查询。 查询连接器接口应符合B.1的要求

7.5.1获取业务模型列表

通过本接口可以获取连接器支持的业务模型列表。服务网关根据调用信息中的连接器标识将服务 路由到目标连接器，目标连接器返回本连接器支持的业务模型列表。 接口定义内容应符合B.2的要求

7.5.2获取操作类型列表

通过本接口获取指定业务模型支持的操作类型列表。服务网关根据调用信息的连接器标识将服务 路由到目标连接器，目标连接器根据调用信息的业务模型标识返回目标业务模型的操作类型列表。 接口定义内容应符合B.2的要求。

WM-GD01标准下载7.5.3.1保存单个数据

通过本接口对目标业务模型进行单个数据的保存操作。服务网关根据调用信息的连接器标识将服 务路由到目标连接器，目标连接器根据调用信息的业务模型标识对目标业务模型执行保存操作。 接口定义内容应符合B.2的要求

7.5.3.2批量保存数据

通过本接口对目标业务模型进行批量数据的保存操作。服务网关根据调用信息的连接器标识将服 务路由到目标连接器，目标连接器根据调用信息的业务模型标识对目标业务模型执行保存操作。 接口定义内容应符合B.2的要求。

通过本接口查询目标业务模型是否存在。服务网关根据调用信息的连接器标识将服务路由到目标 连接器，目标连接器根据调用信息的业务模型标识查询目标业务模型是否存在。 接口定义内容应符合B.2的要求

7.5.5.1统计所有数据量

通过本接口对目标业务模型进行数量统计。服务网关根据调用信息的连接器标识将服务路由到目 标连接器，目标连接器根据调用信息的业务模型标识对目标业务模型执行数据统计操作。 接口定义内容应符合B.2的要求。

临时便道施工组织设计7.5.5.2根据条件统计数据量

通过本接口对目标业务模型进行带条件参数的数量统计。服务网关根据调用信息的连接器标识 路由到目标连接器，目标连接器根据调用信息的业务模型标识对目标业务模型执行带条件参数的 统计操作。 接口定义内容应符合B.2的要求。