ICS 75-010 CCS E 07
SY
中华人民共和国石油天然气行业标准
SY/T 7672—2022
油气勘探开发专业软件接口规范 Software interface specification for oil and gas exploration and production
2022—11一04发布
2023-05-04实施
国家能源局 发布 SY/T7672—2022
目 次
前言
II
范围规范性引用文件
1
3 术语和定义
总则服务中心构建与应用模式 5.1 组件 5.2 组件关系 5.3应用模式模型结构
4
5
6
6.1基础模型 6.2连接模型 6.3核心业务模型 7接口技术要求 7.1命名规范 7.2通信协议 7.3 实现要求 7.4 软件连接服务接口 7.5 数据操作服务接口 8服务中心技术实现要求 8.1 服务中心单独实现 8.2集成系统中服务中心实现 9应用模式附录A（资料性） 数据交换模型附录B（规范性） 服务接口规范附录C（资料性） 数据交换关键步骤代码示例
门
广
6
C
.10
: 11 13
39
44 SY/T 7672—2022
前言
本文件按照GB/T1.1一2020《标准化工作导则第1部分：标准化文件的结构和起草规则》的规定起草。
请注意本文件的某些内容可能涉及专利。本文件的发布机构不承担识别专利的责任。 本文件由石油工业标准化技术委员会石油信息与计算机应用专业标准化委员会提出并归口。 本文件起草单位：昆仑数智科技有限责任公司、中国石油天然气股份有限公司勘探与生产分公
司、中国石油天然气集团有限公司数字和信息化管理部、中油测井技术服务有限责任公司、中国石油天然气股份有限公司长庆油田分公司、中国石油天然气股份有限公司勘探开发研究院、中海油研究总院有限责任公司、中海油渤海石油研究院、中海石油（中国）有限公司海南分公司、中国海洋石油集团有限公司信息技术中心、中国石油化工股份有限公司西南油气分公司、中国石油化工股份有限公司石油勘探开发研究院。
本文件主要起草人：刘磊、刘雄、马涛、王铁成、杜金虎、张仲宏、卢山、杨剑锋、杨勇、丁建宇、石玉江、王娟、赵秋生、黄文俊、刘辉、韩永强、刘景义、白宇辉、包宏、邹媛婷、姜传雷、韩庆时、安红、陈殿远、徐鹏、胡斌、王永胜。
II SY/T76722022
油气勘探开发专业软件接口规范
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总则
为了满足油气勘探开发专业软件之间、勘探开发信息系统之间、勘探开发专业软件和勘探开发信息系统之间数据互通与成果共享，应建立一一套基于服务中心的运行机制，用于响应端和请求端搭建起类似数据服务总线的信息桥功能。当用户由请求端向服务中心发出请求时，服务中心能响应该请求。 服务中心能通过注册中心找到已注册的响应端信息，为其建立起数据传输通道。双方按照本文件规定的数据接口定义及模型结构进行数据交换。
利用服务中心，请求端和响应端宜采用WebService技术进行通信，可解决企业级及集团级专业软件与信息系统之间复杂多样的应用调用与数据交换“多对多”问题，并使之简单化、规范化和标准化。应用模式如图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所示，应具备如下应用逻辑：
服务中心
请求端操作请求
用户 1
操作请求
操作台
连接器
服务网关和注册中心
数据交换
私有数据模型
模型
图3应用请求端与服务中心关系图
a）连接器提供服务接口供操作台进行调用，服务接口应符合7.4、7.5的相关要求； b）用户使用操作台，通过连接器的软件连接服务接口请求服务中心获取目标响应端连接器
3 SY/T 7672—2022
信息： c）用户使用操作台，通过连接器的数据操作服务接口对目标响应端连接器发送数据请求； d）服务中心根据响应端连接器信息将数据请求路由到目标响应端连接器： e）连接器接收到从服务中心返回的数据对象后，将数据对象转换为自身能够识别的数据返回给
操作台； f）连接器与服务中心之间通信的数据应符合第6章的相关要求。
5.3.2应用响应端
基于同一应用模式。响应端与服务中心关系如图4所示，应具备如下应用逻辑： a）服务中心提供服务接口，供连接器调用，服务接口应符合7.4、7.5的相关要求； b）服务中心通过专业软件或信息系统连接信息将数据请求路由到目标专业软件或信息系统连
接器： c）目标专业软件或信息系统中的连接器接到数据请求后，通过数据操作在数据库或数据文件中
获取数据，并将数据转换为数据交换模型中的数据对象； d）目标专业软件或信息系统中的连接器将转换好的数据对象返回给服务中心； e）服务中心将数据对象返回给调用方； f）连接器与服务中心之间通信的数据应符合第6章的相关要求。
响应端
服务中心
操作清求
操作请求
数据库或数据文件
连接器
服务网关和注册中心
私有数据模型
数据交换
模型
图4应用响应端与服务中心关系图
6模型结构 6.1 基础模型
基础模型包括BoBinary、BoBase、BoChannel三类，是用于数据通信的基础类型，不具有业务属性，是整个数据交换模型的顶层抽象。数据交换模型中的业务模型都应继承自基础模型，基础模型的继承关系如图5所示。
基础模型中各类之间的继承关系为： a）基础实体EoBase：是所有基础模型的父类，抽象了数据交换模型中业务模型的公共属性，应
由唯一标识、名称组成，用于标识数据的唯一性： b）扩展参数实体EoValueMap：继承基础实体EoBase，应由基础实体EoBase和扩展参数组成，
用于定义未归属到业务模型内的扩展参数： c）字节流类型基类BoBinary：继承扩展参数实体EoValueMap，应由扩展参数实体
EoValueMap、数据地址和字节数据组成，用于定义非结构化的业务模型： d）通道类型基类BoChannel：继承扩展参数实体EoValueMap，应由扩展参数实体EoValueMap、
4 SY/T 7672—2022
通道索引和数据值组成，用于定义通道类的业务模型： e）业务类型基类BoBase：继承扩展参数实体EoValueMap，应由扩展参数实体EoValueMap组
成，用于定义除字节流类型BoBinary和通道类型BoChannel外的业务模型。
URL 数据地址 Byte Date 字节数据
BoBinary 字节流类型基类
UID 唯一标识 Name 名称
EoBase 基础实体
EoValueMap 扩展参数实体
BoBase 业务类型基类
Key-Value Parameters
扩展参数
Index 通道索引 Value 数据值
BoChannel 通道类型基类
图5基础模型继承关系图
6.2连接模型 6.2.1注册信息
连接器与注册中心及服务网关在通过软件连接服务接口进行连接信息交换时，使用连接器注册信息SatelliteInfo，该信息应包含如下核心属性：
id：连接器唯一标识； satelliteName：连接器显示名称： serviceURL：连接器服务发布地址： -hostIP：连接器服务主机地址； source：连接器类型（软件／信息系统名称）； port：连接器服务端口； -lastActive：连接器最后注册时间，用于判断连接器是否已失效。
6.2.2 2调用信息
连接器与服务网关通过数据操作服务接口进行数据操作时，应包含连接器调用信息Metalnfo。连接器调用信息应包含属性：
-satelliteId：连接器唯一标识，应使用连接器注册信息中的id属性； eoCode：业务模型唯一标识，应使用业务模型类名。
6.3核心业务模型
业务模型继承于基础模型。
5