JR-T 0107.7—2014 统计数据和元数据交换(SDMX)第7 部分:Web 服务用法指南.pdf
- 文档编号:14660571
- 上传时间:2023-06-25
- 格式:PDF
- 页数:33
- 大小:638.50KB
JR-T 0107.7—2014 统计数据和元数据交换(SDMX)第7 部分:Web 服务用法指南.pdf
《JR-T 0107.7—2014 统计数据和元数据交换(SDMX)第7 部分:Web 服务用法指南.pdf》由会员分享,可在线阅读,更多相关《JR-T 0107.7—2014 统计数据和元数据交换(SDMX)第7 部分:Web 服务用法指南.pdf(33页珍藏版)》请在冰点文库上搜索。
ICS35.240.01A11备案号:
JR中华人民共和国金融行业标准JR/T0107.72014/ISO17369-7:
2013统计数据和元数据交换(SDMX)第7部分:
Web服务用法指南Statisticaldataandmetadataexchange(SDMX)Part7:
GuidelinesfortheuseofWebservices20140828发布20140828实施中国人民银行发布统计数据和元数据交换(SDMX)第7部分:
Web服务用法指南Statisticaldataandmetadataexchange(SDMX)Part7:
Guidelinesfortheuseofwebservices(ISO17369-7:
2013,guidelinesfortheuseofwebservices,IDT)JR/T0107.72014/ISO17369-7:
2013I目次前言.II引言.III1范围.12规范性引用文件.13Web服务和SDMX-ML.14基于SOAP的SDMXWeb服务:
WSDL操作与行为.24.1介绍.24.2SDMXWeb服务命名空间.24.3WSDL操作支持.24.4WSDL操作表.24.5其他行为.45SDMXRESTfulAPI.55.1REST简介.55.2API范围.55.3结构元数据查询.55.4数据和元数据查询.95.5模式查询.135.6适合表述选择.155.7数据压缩.156SDMXWeb服务标准错误.156.1介绍.166.2RESTWeb服务错误处理.166.3SOAPWeb服务.166.4错误分类.166.5客户端导致的错误.166.6服务器导致的错误.176.7CustomErrors1000+.176.8SDMX与HTTP错误映射.17附录A(资料性附录)示例.19JR/T0107.72014/ISO17369-7:
2013II前言JR/T0107统计数据和元数据交换(SDMX)分为七个部分:
第1部分:
框架;第2部分:
信息模型UML概念设计;第3部分:
SDMX-ML模式和文档;第4部分:
SDMX-EDI语法和文档;第5部分:
注册表规范逻辑功能和逻辑接口;第6部分:
SDMX技术说明事项;第7部分:
Web服务用法指南。
本部分为JR/T0107的第7部分。
本部分依据GB/T1.1-2009规则起草。
本部分等同采用ISO17369-7:
2013统计数据和元数据交换(SDMX)第7部分:
Web服务用法指南。
本部分由中国人民银行提出。
本部分由全国金融标准化技术委员会(SAC/TC180)归口。
本部分主要起草单位:
中国人民银行调查统计司、中国金融电子化公司。
本部分主要起草人:
盛松成、徐诺金、姚力、巴运红、任全忠、潘润红、李曙光、韩建国、贾树辉李兴锋、王媛、司燕翔、刘蔚、张艳、吴永强、邓琳莹。
JR/T0107.72014/ISO17369-7:
2013III引言统计数据和元数据交换(SDMX)标准由SDMX国际组织发起并提出。
SDMX国际组织是由国际清算银行(BIS)、经济合作与发展组织(OECD)、欧盟统计局(Eurostat)、欧洲中央银行(ECB)、国际货币基金组织(IMF)、联合国(UN)和世界银行(WB)七个国际组织联合建立,其制定发布的统计数据和元数据交换标准规定了统计人员在采集、处理和交换统计数据时所使用的统计概念和方法,规范了对外披露统计信息时统计数据的机构范围、地理区域、存流量性质、时间属性、频度以及文件格式等内容。
SDMX标准提供了统计数据及元数据交换和共享的标准化格式,可以达到更好地扩展和高效率使用的目的。
目前SDMX标准主要应用领域为部分国家中央银行和统计部门。
本部分作用在于规范我国金融统计标准体系的内部处理和对外发布,促进金融统计的互联互通、信息共享和业务协同,提高信息共享的效率,满足金融综合统计的需要。
本部分中Web服务代表当代互联网技术。
该服务允许计算机应用程序直接在互联网进行数据交换,特别是允许以比过去更加灵活的方式进行模块或分布式计算。
然而,为使得Web服务发挥其功能,需要很多标准,这些标准用于申请和提供数据、用于表示用来打包交换数据的封装数据及用于Web服务的互相描述,可以使Web更容易地集成到使用其他的网络服务作为数据资源的应用程序中。
SDMX关注于使用互联网技术的数据交换,将提供部分关于统计数据和元数据的标准。
然而,很多Web服务标准已经存在,且无需为使其特别应用于统计领域而重新修订。
特别是,SDMX能够使用简单对象访问协议(SOAP)和Web服务描述语言(WSDL)对需要标准化的数据和元数据交换格式进行补充。
在Web服务界,经常使用基于URL语义调用Web服务的REST(表述性状态转移)协议,这种基于REST的服务可以用Web应用描述语言(WADL)标准方式描述,与基于SOAP的XML调用Web服务使用WSDL描述方法一致。
尽管存在SOAP协议和WSDL,但在实施中已发现,实际上各供应商提供的执行程序并不能互用。
为此才开展了Web服务-互用性(WS-I)倡议。
该倡议由一些全部以同样方式、采用相同Web服务标准的供应商发起,且已通过互用性测试进行了验证。
这些供应商出版了说明文件,来描述如何交互使用Web服务标准。
SDMX酌情使用WS-I成果以满足统计领域的需求。
SDMX为这些使用标准提供了指南,这种方式提升了SDMXWeb服务之间的互用性。
允许通用客户应用程序的开发,该程序能够同实施这些指南的任一SDMXWeb服务进行有意义的交流。
本部分为资料性的,其目的不在于给出将SDMX-ML文件和Web服务标准应用于统计数据和元数据交换的最佳实践惯例。
本部分描述了XML格式的SDMXWSDL和WADL,这些规范性文件将APIs正规化。
JR/T0107.72014/ISO17369-7:
20131统计数据和元数据交换(SDMX)第7部分:
Web服务用法指南1范围本部分规定了统计数据和元数据交换的Web服务用法,包括Web服务和SDMX-ML、基于SOAP的SDMXWeb服务:
WSDL操作和行为、SDMXRESTfulAPI、SDMXWeb服务标准错误及示例附件等内容。
本部分适用于统计数据和元数据的交换和共享。
2规范性引用文件下列文件对于本文件的应用是必不可少的。
凡是注日期的引用文件,仅注日期的版本适用于本文件。
凡是不注日期的引用文件,其最新版本(包括所有的修改单)适用于本文件。
WS-I简介文件BasicProfileVersion1.13Web服务和SDMX-ML传统应用程序和服务习惯上通过应用程序接口(APIs)实现其功能。
Web服务也是如此,其提供了函数调用的公共版本,在网络上可通过使用Web服务协议(SOAP或REST)访问这些函数调用。
为使得多个Web服务互用,必须基于这些公共函数建立标准抽象概念或模型。
SDMX得益于具有公共信息模型,并且使用SDMX信息模型作为标准Web服务函数调用的基础,是一种很自然的扩展。
Web服务以XML格式交换数据,即不同Web服务中传递的数据是如何格式化的。
SDMX-ML,作为统计领域内数据和结构元数据交换的标准XML,为Web服务数据的公共序列化提供了可用的XML格式。
对于简单Web服务数据交换,存在一些经常使用的技术远程过程调用(RPCs),一系列基于公共信息模型的XML交换,是实现互用性的更佳方法。
SDMX-ML存在几种不同的文件类型,所有文件类型对于SDMXWeb服务的生成方和用户都非常重要。
a)“结构”报文:
该类报文描述了概念、数据和元数据结构定义和代码表,这些内容定义了统计数据和参考元数据的结构。
每个SDMX符合性数据集或元数据集必须具有一个对其进行描述的相应的数据或元数据结构定义对其进行描述。
当请求XML说明时,必须能够从SDMXWeb服务中获得。
b)“通用”数据报文:
该报文是标记SDMX数据集的“通用”方式。
该方案描述了SDMX数据交换的非特定数据结构定义格式,且该方案要求每个SDMXWeb服务至少使其数据在该格式中可用可以预见,并行服务也将支持其他特定数据结构定义的XML格式来表示数据。
c)“特定结构”数据报文:
该报文是一种标准模式格式,来源于标准化映射和诸多标准标记的结构描述。
该报文仅针对特定数据结构定义的结构,因此每个数据结构定义将具有自己的“特定结构”方案。
该报文用于大数据集的交换,Web服务是否提供的数据格式,取决于其数据交换的要求。
d)“查询”报文:
该报文用于产生基于SOAP的SDMXWeb服务。
所有报文与主模板保持一致,但被分解为特定查询,以便每个服务仅支持对模板报文有意义的领域。
该查询报文在所有数据JR/T0107.72014/ISO17369-7:
20132和元数据结构定义中通用,需要按照具体结构概念(见结构说明)规定的值进行查询。
该报文允许用户查询数据、概念、代码表、数据和元数据结构定义。
e)“注册接口”报文:
所有注册接口(RegistryInterfaces)都是该SDMX-ML报文类型的子元素。
这些接口将在SDMX注册表规范中详细描述。
f)“通用”元数据报文:
该报文是用于报告参考元数据概念,该报文通常与所有类型的参考元数据结构说明通用。
g)“特定结构”元数据报文:
该报文用于向特定的元数据结构定义报告参考元数据概念。
4基于SOAP的SDMXWeb服务:
WSDL操作与行为4.1介绍本部分针对基于SOAPWeb服务的操作和行为。
最重要的是标准WSDL操作列表,它是标准WSDLXML实例的基础,并与该实例一起应用于发展软件包。
本部分还为支持互用性实施的Web服务提供一些指南。
所有SDMXSOAPWeb服务都可以使用WSDL实例进行描述。
每次交换回复内容里,都应包括SDMX中每个XML数据和元数据格式的全局元素。
以下给出了每个已识别模式的函数名称以及SDMX-ML有效载荷数据的类型。
由于不支持SOAPRPC,每个函数的“参数”仅为适当SDMX-ML报文类型的实例。
注意,应用于规定多重报文交换的方案。
分布式WSDL文件说明了SOAP报文的使用方法。
4.2SDMXWeb服务命名空间SDMXWeb服务命名空间1)包含一系列针对基于SOAP服务使用的报文。
每个操作都会产生一个Web服务报文和响应报文。
在每个案例中,为了适应操作实施,对其他SDMX报文进行改良。
此外,错误代码表在SOAP封套中使用(见SDMX报文中的错误元素范例部分)。
4.3WSDL操作支持即使该支持很小并仅包含解释未实现申请操作错误的产生,SDMXWeb服务也必须支持所有已列明的操作,这对互用性很有必要。
4.4WSDL操作表SOAP和WSDL使用的操作表遵循1.1版Web服务互用性规范。
4.4.1数据相关内容如下:
GetStructureSpecificData:
通过GetStructureSpecificDataRequest报文调用该操作,接收GetStructureSpecificDataResponse作为反馈。
GetGenericData:
通过GetGenericDataRequest报文调用该操作,接收GetGenericDataResponse作为反馈。
GetStructureSpecificTimeSeriesData:
通过GetStructureSpecificTimeSeriesDataRequest报文调用该操作,接收GetStructureSpecificTimeSeriesDataResponse作为反馈。
GetGenericTimeSeriesData:
通过GetGenericTimeSeriesDataRequest报文调用该操作,1)例如,SDMXWSDL定义的公开命名空间。
JR/T0107.72014/ISO17369-7:
20133接收GetGenericTimeSeriesDataResponse作为反馈。
4.4.2MetaData相关内容如下:
GetGenericMetadata:
通过GetGenericMetadataRequest报文调用该操作,接收GetGenericMetdataResponse作为反馈。
GetStructureSpecificMetadata:
通过GetStructureSpecificRequest报文调用该操作,接收GetStructureSpecificResponse作为反馈。
4.4.3结构用法相关内容如下:
GetDataflow:
通过GetDataflowRequest报文调用该操作,接收GetDataflowResponse作为反馈。
GetMetadataflow:
通过GetMetadataflowRequest报文调用该操作,接收GetMetadataflowResponse作为反馈。
4.4.4结构相关内容如下:
GetDataStructure:
通过GetDataStructureRequest报文调用该操作,接收GetDataStructureResponse作为反馈。
GetMetadataStructure:
通过GetMetadataStructureRequest报文调用该操作,接收GetMetadataStructureResponse作为反馈。
4.4.5项目方案相关内容如下:
GetCategoryScheme:
通过GetCategorySchemeRequest报文调用该操作,接收GetCategorySchemeResponse作为反馈。
GetConceptScheme:
通过GetConceptSchemeRequest报文调用该操作,接收GetConceptSchemeResponse作为反馈。
GetCodelist:
通过GetCodelistRequest报文调用该操作,接收GetCodelistResponse作为反馈。
GetHierarchicalCodelist:
通过GetHierarchicalCodelistRequest报文调用该操作,接收GetHierarchicalCodelistResponse作为反馈。
GetOrganisationScheme:
通过GetOrganisationsSchemeRequest报文调用该操作,接收GetOrganisationSchemeResponse作为反馈。
GetReportingTaxonomy:
通过GetReportingTaxonomyRequest报文调用该操作,接收GetReportingTaxonomyResponse作为反馈。
4.4.6其他可维护工具相关内容如下:
GetStructureSet:
通过GetStructureSetRequest报文调用该操作,接收GetStructureSetResponse作为反馈。
GetProcess:
通过GetProcessRequestt报文调用该操作,接收GetProcessResponse作为JR/T0107.72014/ISO17369-7:
20134反馈。
GetCategorisation:
通过GetCategorisationRequest报文调用该操作,接收GetCategorisationResponse作为反馈。
GetProvisionAgreement:
通过GetProvisionAgreementRequest报文调用该操作,接收GetProvisionAgreementResponse作为反馈。
GetConstraint:
通过GetConstraintRequest报文调用该操作,接收GetConstraintResponse作为反馈。
4.4.7XML模式(XSD)相关内容如下:
GetDataSchema:
通过GetDataSchemaRequest报文调用该操作,接收GetDataSchemaResponse作为反馈。
GetMetadataSchema:
通过GetMetadataSchemaRequest报文调用该操作,接收GetMetadataSchemaResponse作为反馈。
4.4.8结构元数据通用查询相关内容如下:
GetStructures:
通过GetStructuresRequest报文调用该操作,接收GetStructuresResponse作为反馈。
4.5其他行为4.5.1默认版本当调用服务的报文没有指定版本时,默认返回申请源最新产生的版本。
4.5.2解决参考和特定返回的对象问题2.1版的SDMX-ML查询报文提供了解决参考类型和特定类型对象返回问题的新功能。
SOAPAPI依靠该机制解决参考和特定返回的对象问题(见参考属性的应用和意义部分)。
4.5.3压缩能够使用适当的HTTP头字段(浏览器支持的编码类型)进行压缩。
4.5.4基于SOAP的SDMXWeb服务的实施自WSDL有了标准规范以来,在SDMXWeb服务中的一个新进展是契约优先。
此外它是一个已备XML申请/反馈报文的Web服务(例如,应用程序逻辑接口是XML报文),因此,没有必要为SOAP有效载荷同本地语言类型之间的序列化和非序列化生成桩。
参考方法是完全控制XML报文的请求/反馈。
根据RPC范例,当使用自动生成代码时,将为SOAP申请操作的参数中增加一个额外元素,但是根据标准的SDMXWSDL,在SOAP规范中这个额外元素并不是必要的。
当在java中使用ApacheAxis时,工具包会提供一个服务接口,该接口用DOM元素(DOM元素在Axis2中)读取/返回XML有效载荷。
此外,当使用具有XML网络服务(JAX-WS)的javaAPI时,开发商可以使用Provider(SOAPMessage)接口,他负责创建SOAP请求和反馈报文并指定标准化的WSDL服务。
JR/T0107.72014/ISO17369-7:
20135然而在.Net环境下,没有类似的解决办法。
服务开发商将在.NET网络方式中使用XmlAnyElement参数。
这说明服务方式的参数可以是任何XML元素,从而允许开发商控制XML有效载荷。
这种方法的细节见SDMX标准06部分中的“附件1:
如何消除.NETSDMX网络服务中的额外元素”。
4.5.5WS-I符合性为确保SDMXWeb服务间的互用性,推荐所有SDMXWeb服务均应符合WS-I简介文件1.1的要求。
该文档可在http:
/www.ws-i.org/Profiles/BasicProfile-1.1-2004-08-24.html获得。
推荐内容是关于SOAP和WSDL的用法。
服务通用描述发现和集成(UDDI)对于SDMXWeb服务存在性的推广非常有用,但对于SDMX互用性并非必须。
5SDMXRESTfulAPI5.1REST简介如下说明,SDMXAPI基于REST准则:
REST中,特定信息被称作“资源”。
在SDMX中,特定资源可以是代码表、概念方案、数据结构定义、数据流等。
每一项资源都能够通过全球标示符访问(例如:
一个URI)。
通过HTTP协议中定义的方法(例如:
查询、修改、上传、删除),可以完成资源操作。
该API主要用于数据检索,因此,本标准仅包含HTTP查询的使用方法。
资源的格式有很多种表示方式(例如不同类型和版本的SDMX-ML标准)。
通过使用HTTP协商协议可以选择恰当的表示方式。
5.2API范围RESTfulAPI注重简洁,其目的在于简化有限标准查询的执行,而非丰富SDMX-ML查询报文的语义。
不同于SDMX规范中的其他部分,RESTfulAPI主要进行数据检索(通过HTTP查询)。
更确切地说,API允许:
通过ID、机构ID和版本号的组合,检索结构元数据。
通过关键字(包含通配符选择和OR操作符支持)、数据或元数据流及数据或元数据供应方,检索统计数据或参考元数据。
通过时间信息(起止期间)进一步细化统计数据或参考元数据的查询。
仅检索更新和修订。
以各种格式返回查询结果。
所需格式和返回报文版本在HTTP内容协商(和HTTP协议机制)中指定。
结构元数据指导Web服务解析引用信息(例如,查询数据结构定义时,可在返回的结果中检索概念和代码表)和使用相匹配模块的模块组(例如,借助匹配的数据结构定义检索数据流)。
为保证效率,结构元数据可对结果进行最少信息版本的检索(例如,检索全部的代码表,若没有代码,可检索名称、id等)。
有些元素对被检索资源进行识别,有些元素能够就所需结果给出更多信息或进一步过滤,二者之间应当进行区分。
URL路径部分和查询字符串分别指定了属于第一类别和第二类别的元素。
5.3结构元数据查询JR/T0107.72014/ISO17369-7:
201365.3.1资源包含了下列资源的定义:
datastructure2)metadatastructure3)categoryschemeconceptschemecodelisthierarchicalcodelistorganisationscheme4)agencyscheme5)dataproviderschemedataconsumerschemeorganisationunitschemedataflowmetadataflowreportingtaxonomyprovisionagreementstructuresetprocesscategorizationcontentconstraintattachmentconstraintstructure6)5.3.2参数5.3.2.1资源识别参数下列参数用于识别资源,见表1表1参参数数类类型型描描述述agencyID符合SDMX的字符串常见:
NCNameIDType维护待返回模块的机构resourceID符合SDMX的字符串常见:
IDType待返回模块的idversion符合SDMX的字符串常见:
:
VersionType待返回模块的版本2)为简化URLS,DataStructureDefinition的缩写。
3)为简化URLS,MetadataStructureDefinition的缩写。
4)当组织方案(例如,维护机构)的作用未知或无关时,使用该资源。
5)OrganisationScheme的三个子类(AgencyScheme,DataProviderScheme和DataConsumerScheme)、id和版本参数都有固定值。
更多内容请参考SDMX信息模型中第三部分。
6)可用于检索同供应参数匹配的任一结构元数据。
JR/T0107.72014/ISO17369-7:
20137以下语法详细说明了以上参数:
protocol:
/ws-entry-point/resource/agencyID/re
- 配套讲稿:
如PPT文件的首页显示word图标,表示该PPT已包含配套word讲稿。双击word图标可打开word文档。
- 特殊限制:
部分文档作品中含有的国旗、国徽等图片,仅作为作品整体效果示例展示,禁止商用。设计者仅对作品中独创性部分享有著作权。
- 关 键 词:
- JR-T 0107.72014 统计数据和元数据交换SDMX第7 部分:Web 服务用法指南 JR 0107.7 2014 统计数据 数据 交换 SDMX 部分 Web 服务 用法 指南
![提示](https://static.bingdoc.com/images/bang_tan.gif)
链接地址:https://www.bingdoc.com/p-14660571.html