国家标准 GB/T33604一2017 电力系统简单服务接口规范 simpleservieeinterfaeespeeifeationforpowersystem"m 2017-05-12发布 2017-12-01实施国家质量监督检验检疫总局发布国家标准化管理委员会国家标准
GB/33604一2017 前言本标准按照GB/T1.1一2009给出的规则起草本标准由电力企业联合会提出本标准由全国电网运行与控制标准化技术委员会(SAC/TC446)归口本标准起草单位:国网河北省电力公司、北京科东电力控制系统有限责任公司国家电网公司国家电力调度控制中心、南方电网电力调度控制中心,国电南瑞科技股份有限公司、广东电网有限责任公司电力科学研究院、南京南瑞继保电气有限公司、电力科学研究院、国网四川省电力公司本标准主要起草人习新魁、梅睁、马斌,陈国平、许洪强、叶飞孙炜、厉启鹏、杨立波方文崇顾博川、李一鹏、王亚军,万书鹏、钱锋,李伟龙、赵鹏温丽丽,席俪塘、狄方春、孙名扬、黄运豪
GB/33604一2017 电力系统简单服务接口规范范围本标准规定了用于电力系统生产控制及管理业务简单服务的文本型接口规范,包括文本型服务接口的语法,语义规则,服务体系结构及流程、服务定义,服务管理、服务访问等技术内容本标准适用于电力系统生产控制及管理业务中使用文本型简单服务的应用场合规范性引用文件下列文件对于本文件的应用是必不可少的凡是注日期的引用文件,仅注日期的版本适用于本文件凡是不注日期的引用文件,其最新版本(包括所有的修改单)适用于本文件 GB/T16262.1一2006信息技术抽象语法记法一ASN.1第1部分:基本记法规范 GB/T33602电力系统通用服务协议 DL/T476电力系统实时数据通信应用层协议 IEC61850电力应用自动化通信网络和系统(Communieationnetworksandsystemsforpower utilityautomation 术语和定义下列术语和定义适用于本文件 3.1 服务接口serviceinterface 特定功能的形式化描述,定义了实现功能所需的参数和返回结果 3.2 服务消费者serviceconsumer 根据服务接口描述访问服务的程序 3.3 服务提供者serieepwider 实现服务接口定义的功能并提供服务的程序 3.4 serviee 简单服务simple 能够相对独立运行,具有简单的输人参数和输出结果的应用程序 3.5 粗粒度服务 coarsCgrainedserVice 在一个抽象的接口中封装了大块的业务/技术的服务,以减少服务请求交互的次数缩略语下列缩略语适用于本文件
GB/T33604一2017 BNF,巴科斯范式(HaekusNaurForm) ervice-(OrientedArchitecture) SOA;面向服务的体系架构(Se wSDLweb服务描述语言(webSer rvices sDesecriptionlanguage) XML.可扩展标记语言(extensbleMarkp Language 5 符号定义和语法规则 5.1符号定义本标准参考sOA架构及wSDL语言,提出了用于电力系统的简单服务接口规范,定义了服务请求与应答流程,并满足电力系统在线应用对效率的要求简单服务接口规范的符号说明见表1,定义了类型描述符、路径分隔符、参数措述的起始符和结束符等符号表1简单服务接口规范符号说明序号符号定义 S 服务列表起始符 /Sy 服务列表结束符服务起始符服务结束符系统声明起始符 (!! 系统声明结束符 !! 单行注释引导符！多行注释起始符多行注释结束符 10 赋值连接符 11 类型描述符或用空格分隔路径分隔符 12 13 参数描述起始符参数描述结束符注，以上符号内容均采用英文半角符号 5.2语法规则简单服务接口语法规范采用BNF范式的形式进行描述,详见附录A 服务体系结构及流程 6. 体系结构简单服务体系由服务消费者,服务总线和服务提供者组成,体系结构见图1 图1展示了在服务体系结构中使用简单服务接口规范进行服务的注册,定位,请求和应答的流程
GB/33604一2017 服务总线服务消费者服务提供者服务定义注册 2服务定位 3获取服务定义信息发送服务请求 5按收服务请求 6返回服务应答 7接收服务应答图1使用简单服务接口规范的服务体系结构示意图 6.2服务流程服务流程主要包括以下步骤服务提供者注册服务定义信息 a 服务消费者查询服务定义信息 b 服务消费者接收服务定义信息 c 服务消费者向服务提供者发送服务请求; d 服务提供者接收服务请求; e 服务提供者返回服务应答结果服务消费者接收服务应答结果 g 服务定义服务定义的描述由服务提供者负责,描述格式为 (ServiceNamemodetypel:paraml,modetype2:param2，prompt 服务定义包括服务名称,参数定界符,参数传递模式,参数类型,参数名、提示符等,具体说明如下服务名称(ServieeName);由服务提供者定义,名称应以英文字母开头,并由英文字母或数字 aa 组成; 参数定界符;使用一对括号“()”作为参数定界符，一个服务可以有多个参数,所有参数都位于 b 括号之内,参数之间以逗号分隔; 参数传递模式(mode);参数传输模式包括输人(in)、输出out)和输人输出(inout)三种模式
GB/T33604一2017 参数类型(type);采用AsSC字符串描述,支持基本数据类型(见表2)和基本数据类型对应的 d 数组参数类型的描述分为显式和隐式两种显式描述在类型和参数名前加冒号作为参数类型修饰符,形如;“参数类型;参数名=参数值”;隐式描述参数类型和参数名均可省略,只对服务参数值进行描述,隐式描述仅可用于服务请求,其值所对应的参数类型和参数位置必须与原服务所定义的类型及位置一致; 参数名(param);服务参数的具体名称 e fD 提示符(prompt);用于服务的功能描述,可采用中文或英文表2参数类型支持的数据类型序号类型名称描述 INT8 有符号8位整数有符号16位整数 INTl6 INT32 有符号32位整数 INT64 有符号64位整数无符号8位整数 INT8U INTl6u 无符号16位整数 INT32U 无符号32位整数 INT64U 无符号64位整数 FLO)AT32 有符号32位浮点数 10 FLO)AT64 有符号64位浮点数 11 STRING 字符串服务管理 8 为有效管理和检索服务,采用服务列表的方式对服务进行组织服务列表的描述方式参考XML 形式,典型的服务列表描述格式如下 ?xml version=”1.0”encoding=”?” S ”1.0”Domain ”华北” (ServiceList(instring;hostname，outstring;listL_fle“服务列表服务” iretory(instring;path，outstring[];D)irectoryList Dir “目录服务” 八八 ile GB/33604一2017 ) 从“(S)”到“(/S)"之间可能有若干行,每行描述一个服务,格式与单行服务描述一致; e 提示符(prompt)可以使用中文进行描述,为带双引号的字符串附录B列举了电力系统中适用简单服务接口规范的部分服务服务请求与应答 9.1服务请求格式服务请求描述以字符方式定义,描述服务原语、服务参数等内容,由服务提供者进行解析服务请求完整格式为 S Domain.ServiceName(modetypel:paraml=valuel，modetype2:param2=value2，) 服务请求包括域、服务名称,参数定界符、参数传递模式,参数类型,参数名、参数值其中域定义见第8章,服务名称、参数定界符、参数传递模式、参数类型、参数名定义见第7章在服务请求中,为简便起见,可采用隐式参数描述方式,即省略参数传递模式、参数类型和参数名称,仅将参数值置于其参数位置,但省略部分及参数位置必须与原服务定义完全对应一致参数取值类型包括字符串类型、整数类型、浮点类型和数组类型等,具体描述如下字符串类型;字符串类型用双引号或单引号定界,当字符串中含有单引号时可用双引号定界， a 当字符串中含有双引号时可用单引号定界,当字符串中含有单引号和双引号时,可在单引号和双引号前面插人反斜杠(\'或\“或\”)作为转义符以将其按一般字符处理例如,显式描述为inSTRING;myName “张三”,隐式描述为;“张三”; 整数类型:整数类型可采用十六进制、十进制、八进制和二进制表示,其中十六进制、八进制和 b 二进制分别使用0x,00和0B作为引导符;整数类型数值不加引号;例如，显式描述为;in INT32 ;num=4，隐式描述为:4; 浮点类型:浮点数采用科学计数法或十进制表示,浮点类型数值不加引号,应有小数点;例如，显式描述为:inFIOAT32;value=123.45,隐式描述为;123.45; 数组类型当参数类型为数组时,其参数值可用大括号定界,也可以嵌套,如;INT32 d number=123,456,789y 在这种情况下,类型修饰符和参数名不应省略,以免引起混淆 9.2服务应答格式服务应答描述服务响应成功或失败的信息,应由服务消费者进行解析服务应答格式应采用字符形式的返回码,用于说明服务访问是否成功,并在失败时能表明错误原因,其定义如表3所示表3服务应答定义返回码定义 200 服务访问成功 400 服务访问失败服务访问超时 500 0协议适配本标准定义了访问简单服务的接口规范,并对服务请求进行了描述服务请求可以适配到多个协议和标准上,这些标准和协议包括:GB/T33602,DL/T476,IEC61850、TCP等,详见附录C
GB/T33604一2017 附录 A 规范性附录) 电力系统简单服务接口规范语法定义电力系统简单服务接口规范语法的BNF定义如下,描述了规范的语法结构和组成元素 specification:=definition domain_def“” definition service service_list omain_def:=domain_def“.”|domain_def domain_def::=identifier Xml -start_headerserviee_list_headerservice_list_defservice_Iist_tail service_list _de"?)” xml”version_ xm_start_header m wersion_ddfsite-dder sericeistheader versiondef “”[0-9]十 4 "at= value=” sitedef servicelistdef servicelistdefservice service_list_tail [declaration defineprompt“/八” notation“(”service_ Value value service_name“(”para_list“)” deline identifier name para_define“ paral1st para_define para_define“,”para para para modetype_define“;”para_name“ ”para_value mode “in”|“out”|“inout” type_define:=type_name ” scoped_name“[ type_name=int_typel char_typel float_type string_type scoped_name=int_typel char_typel loatL_ypel string_type int_type::=“INT8”|“INT8U”|“INT16”|“INTl6U”|“INT32”|“INT32U”|“INT64|“INT64U” =“CHAR” char-Iype:- float_type:=“FIOAT32”|“FLOAT64” =“STRING” sstring_type: para_name:=identifier
GB/33604?2017 ara_value:=simple_valuelcomplex_value simple-_value:=value_identifier =(vale" list) complex_value alue_list:=value-Iistvalue value valueidentifier alue.. valueidentifier float char-esxpression =int_expression _expression string_expression inteXpreSSion." SignaleXpresSiondeCexpresSion ocexpression 0xXhex_expresion|oO oBbin_express essio1n hexexpressionhexnum heXeXpresSion heX 0ct_eXpreSs1on. =Oct 0cteXpreSSiOn 0ct_num dec_num deCeXpresSiOn decnum deCeXpression bin_expression bin_num bIn bIn_num expreSsion A F B|CDE nm 8 9 0ct_num 34|5|67 0ct 1n [0-][e]I[A] char_eXpreSS1On t6? signal_expressiondec_expression" dec_expression|signal_expressiondee_ex loat_eXpreSSIOn dec_expressionEsignalL_expressiondec_expressionm DreSSIon string_expression ssichar_expressionchar_expressionhar prompt string_expression
GB/T33604一2017 附录 B 规范性附录) 标准的简单服务描述本标准适用于以粗粒度服务集成应用程序的场景,应用程序具有简单的输人参数以下列举了部分使用简单服务接口规范的服务文件服务;提供远程访问目录和文件的功能; a b) 资源查询服务;提供服务消费者访问系统中服务和资源的状态以及定位功能事件转发服务;提供服务消费者(远程和本地)的事件收发,支持不同系统之间的事件转发 c d 高速数据访问服务;用于快速访问简单数据结构的服务时序数据访问服务;用于访问历史数据的服务,提供基于时序的数据访问功能 e
GB/33604一2017 录附 C 规范性附录适配协议本标准可以适配到多个协议和标准上,包括.GB/T33602、,DL./T476、IEC61850、TCP等,详见图c.1 服务请求者服务提供者简单服务接口简单服务接口 Ec IEc DL门 DL 通用服务协议通用服务协议 61850 476 61850 476 TCP/IP TCP/P 图C.1传输协议适配

电力系统简单服务接口规范GB/T33604-2017解析

1. 规范概述

电力系统简单服务接口规范GB/T33604-2017是为了实现不同的电力系统之间进行数据交换而制定的。该规范描述了电力系统之间通信的基本要求和标准，以确保不同系统之间能够顺利地进行数据交流。

2. 接口定义

根据GB/T33604-2017规范，电力系统简单服务接口采用Web Service技术进行定义。该规范定义了一组常用的服务接口，包括查询、修改、删除等操作，同时还定义了这些操作所需的输入和输出参数。

该规范中还明确了服务接口的命名规则和URI路径，以及接口的访问权限和安全性要求等。

3. 接口实现

电力系统简单服务接口规范GB/T33604-2017要求电力系统实现标准的Web Service接口，并确保接口的正确性和稳定性。在实现过程中，需要遵循规范定义的接口格式和参数要求，并严格控制接口的访问权限。

此外，该规范还提供了相关的代码示例和使用说明，方便电力系统进行接口开发和测试。

4. 使用方法

根据电力系统简单服务接口规范GB/T33604-2017，不同的电力系统可以通过标准的Web Service接口进行数据交换。在使用过程中，需要遵循规范中所定义的各项约束和规则，保证数据的正确性和互操作性。

此外，为了确保接口的可靠性和安全性，电力系统应该严格控制对接口的访问权限，并采取必要的安全措施。

5. 总结

电力系统简单服务接口规范GB/T33604-2017是为了实现不同电力系统之间数据交换而制定的规范。该规范采用Web Service技术进行接口定义，明确了接口的格式、参数和访问权限等要求。

在实际应用中，遵循该规范的约束和规则，能够保证电力系统之间的数据交换具有正确性和互操作性。