2023数字换流站业务交互技术规范.docx

《2023数字换流站业务交互技术规范.docx》由会员分享，可在线阅读，更多相关《2023数字换流站业务交互技术规范.docx（59页珍藏版）》请在第一文库网上搜索。

1、数字换流站业务交互技术规范前言偌误!未定义书签.I范围32规范性引用文件33 才五利C34 缩略语36总体原则47技术要求471接口交互472口67.3接口功能78测试要求55附录A（规范性）返回码56附录B（规范性）告警级别58附录C（规范性）告警类型59数字换流站业务交互技术规范1范围本文件规定了数字换流站业务交互部分的系统构成、总体原则和技术要求，包括数据、告警、文件、日志、视频、三维、控制、卡片等业务交互接口。本文件适用于换流站的数字化建设，指导数字换流站的设计、研发、验收和应用。2规范性引用文件下列文件中的内容通过文中的规范性引用而构成本文件必不可少的条款。其中，注日期的引用文件，仅

2、该日期对应的版本适用于本文件：不注日期的引用文件，其最新版本(包括所有的修改单)适用于本文件。GB/T22239信息安全技术网络安全等级保护基本要求GB/T30149电网通用模型描述规范3术语和定义数字换流站digita1converterstation运用先进数字技术、信息技术发展创新成果，统筹布局数字化基础设施，具有强化设备广泛互联、状态深度感知、数据融合贯通、管理精益高效能力的换流站。公共组件pub1iccomponent具备数据接入、处理.、存储和分析能力，对外提供服务接口供应用调用，支撑业务应用功能实现的软件。基础应用basicapp1ication具备定的生产业务处理能力，满足运行

3、监视、运维分析、业务管控等共性数字化需求的应用软件。高级应用advancedapp1ication具有较强专业性或信息综合处理能力的应用软件，是基础应用的增强和补充，满足状态预测、健康评估、诊断分析等生产业务的差异化需求。4缩略语API：应用程序接口(APPIiCationProgrammingInterface)CIM：公共信息模型(CommoninformationMode1)JSON：数据交换格式(JaVaSeriP1ObjectNotation)MQ：消息队列(MessageQueue)UR1：统一资源定位系统(UniformResource1ocator)XM1：可扩展标记语言（Ex

4、tensib1eMarkup1anguage）UTF-8：8位元可变长度统一码（万国码）字符编码（UnicodeTransformationFormat-8bit）5系统构成数字站公共组件由若干数据组件和业务组件组合而成，公共组件基于基础数据实现业务功能的处理和响应：作为服务端，公共组件对外提供一系列业务交互接口，支撑应用获取数据、告警、文件等信息。数字站业务交互框架如图1所示。业务交互支持本地及远方访问数字站公共组件等，业务交互应满足如下主耍功能：a）提供请求订阅实时数据的能力：b）提供请求存储历史数据的能力：c）提供请求订阅告警数据的能力：d）提供请求发送文件数据的能力：e）提供请求获取视

5、频数据的能力：f）提供请求获取二维模型的能力：）提供请求数据模型的能力：h）提供请求设备台账数据的能力.图1数字站业务交互框架示意图6总体原则业务交互应遵循以下基本技术原则：a）业务交互应通过做服务架构实现统的信息访问接口；b）交互接口参数应采用JSoN格式定义：c）交互接口应具备权限校验机制：d）安全防护应符合GB/T22239规定7技术要求1.1.1 交互1.1.2 1.1总体要求公共组件与应用之间使用统一的数据交互接口，数据交互内容使用17F-8编码的JSON格式字符串，用于应用读取公共组件的实时数据、收发公共组件的告警消息、读写公共组件的历史数据、文件数据、视频数据以及三维数据等，交互

6、数据分为请求接口输入参数和回调接口返回参数，交互时需要进行用户权限校验。1.1.3 交互内容公共组件与应用之间交互的数据内容如下：a）实时数据：包括装置上送的模拟量、相量量测、状态量的实时变化数据：b）历史数据：包括公共组件存储的状态量、模拟量等历史数据；c）告警数据：包括实时告警数据和历史告警数据：d）文件数据：包括录波文件、图形文件等：e）日志数据：包括应用运行日志、操作日志等：f）视频数据：包括视频流、快照图片等：g）三维数据：包括三维信息、三维画面等。1.1.4 交互方式公共组件与应用之间的数据交互方式包括数据杳询、数据订阅（WebSoCket方式）、数据订阅（消息队列）和数据存储四种

7、方式，要求如下：a）数据查询：应用通过主动请求方式查询需要的数据，交互方式采用HTTP（HTTPS）协议，使用RESTfu1设计风格，查询的数据应支持查询条件过滤，查询的数据类型包括实时数据、历史数据、告警数据和文件数据等，数据查询交互方式如图2所示：b）数据订阅CebSocke1方式）：应用主动向公共组件建立WebSOCke1连接，并向公共组件进行数据订阅，订阅后公共组件周期向应用推送订阅的数据，同时实时推送变化的数据，订阅的数据应支持查询条件过海，数据订阅（WebSoCket方式）如图3所示：c）数据订阅（消息队列方式）：应用通过消息中间件以订阅主题的方式请求数据，公共组件通过消息中间件周

8、期向应用推送订阅的数据，同时实时推送变化的数据，数据订阅（消息队列方式）如图4所示；d）数据存储：应用调用公共组件提供的历史数据交互接口写入需要保存的历史数据，交互方式采用HnP（HTTPS）协议，使用RESTfU1设计风格,数据存储交互方式如图5所示。图4数据订阅(消息队列方式)图5数据存储7.2接口定义7. 2.1总体要求接口是由公共组件基于微服务框架提供的一组服务，用于读取和修改数据、收发消息、读写文件等。接口风格参照RESTfUIAPI规范，以HTTP(S)UR1的形式体现资源和对应的接口方法。完整的接口方法由域名(IP地址)、版本、路径(端点)、HTTP动词(GET和POST)、过滤

9、信息(参数)、状态码、返回结果等组成。8. 2.2UR1接口采用的HTTP(s)UR1形式，如表1所示，接口UR1中各组成部分的说明如下所列，如表2所小O表1HTTP(s)UR1形式序号UR1组成形式1 http(s):/host:portv(ncs(endpoint表2UR1组成部分序号UR1组成部分说明1host:port采用http协议访问接”所能的生机地址和端口2CS固定词，表示数字站3vin表示版本号，如当前版本号为VI4(endpoint表示路径(端点)，用于标识具体的接口采用本文件的接口UR1中，(endpoint之前的部分(BPhttp(s)host:port)vncsw或者“

10、http(S):(v(n)cs”需根据数字站的情况进行组装.具体的接口内容在endpoint)部分定义。7.2.3请求方法查询和数据获取类型的接口，采用HTTPGET方法。其他类型的接口采用HnPPOST方法。如表3所示。表3请求方法方法描述GET读取动作POST请求动作1.2.4 消息头部消息头部如表4所示。表4消息头部制性名称类型是否必选Content-Type交互类型：权限认证交互(app1ication-*wform-Ur1encoded)其它交互(app1ication/json)String是.Authorizationtoken令牌String是X-UW-IDAPI网关身份认证I

11、DString否X-HW-APPKEyAPI网关身份认证KEYString否1.2.5 请求体请求体为JSoN格式的对象，应具有以下字段，如表5所示。表5请求体属性名称类型是否必选id请求IDInt是C1ientId客户端Id（应用注册时由权限认证服务提供）String是body请求内容（具体内容见各接1详细说明）Object是1.2.6 返回体返回体为JSON格式的对象，应有以下字段，如表6所示。表6返回体属性名称类型是否必选id请求IDInt是code返回码（应符合表A）String是message返回码描述String是body返回内容（具体内容见各接11详细说明）Object是2. 3

12、接口功能7. 3.1权限认证管理8. 3,1.1总体要求应符合OAUth2.0要求，应用前后端交互的权限认证宜采用客户端模式，对接口进行访问认证和安全管控。应用部署时，应在管理平台注册备案，获取两个身份识别码，客户端ID（c1ientid）和客户端密钥（CIientsecret）。应用在调用公共组件接口时，权限认证服务通过验证令牌和白名单确保服务调用方的合法性。令牌默认有效期为24小时，超时后需要重新调用接口获取新的令牌。7.3.1.2权限获取权限获取接口定义如表7所示，客户端诂求Content-Type为app1ication/X-WWW-forrur1encoded,请求参数采用表单传值方

13、式，如表8所示，返回成功时数据格式定义如表9所示。表7权限获取接口定义请求方法POST请求地址auth-serviceoauthtoken怖议应用http(s表8权限获取请求体定义属性名称类型是否必选描述grant,1ypeToken类型String是固定填写C1ienJCreden1iaISscope信号索引键String是固定填写a11CIienJid客户端账号String是客户端账号，由平台分配c1icnt_sccrct客户端密码String是客户端解码，由平台分配表9权限获取返回体定义属性名称类型描述access.,token认证TokenString获取到的令牌(Oken_typeT

14、oken类型StringToken类型expires_in过期时间1ong过期时间scope权限范困String表示申请的权限范惧，默认为a11code返何码String应符合表A.1message返回玛描述String返回码对应的描述信息jti声明String唯一标识符7.3.1.3权限校验权限校验接口定义如表10所示，请求参数采用表服传值方式，其定义如表11所示，校验成功时返回数据格式定义加表12所示，校验失败时返回数据格式定义如表13所示。表10权限校驶接口定义请求方法POST请求地址auth-service/oauth/check_token协议应用http(s)表11权限校验请求体定义属性名称类型是否必选描述token令牌String是待校验的令牌表12权限校险成功返回体定义属性名称类型是否必选描述C1iCnJid客户端IDString是C1ien1的配置项即客户端IDscope授权范围String是由请求时参数决定exp