ICS35.240.01 A11 备案号： JR 中华人民共和国金融行业标准 JR/T0107.7—2014/1S017369-7:2013 统计数据和元数据交换（SDMX） 第7部分：Web 服务用法指南 Statistical data and metadata exchange (SDMX)- Part7:Guidelinesfortheuseofwebservices (1S017369-7:2013,guidelinesfortheuseofwebservices,IDT) 2014 - 08 - 28 发布 2014- 08- 28实施 发布 中国人民银行 JR/T 0107.72014/IS0 17369-7:2013 目 次 前言 II 引言 II 范围 1 规范性引用文件 2 Web服务和SDMX-ML 3 基于SOAP的SDMX Web服务：WSDL操作与行为， 4 2 4. 1 介绍. 4. 2 SDMX Web服务命名空间， 4. 3 WSDL操作支持 4. 4 WSDL操作表. 4. 5 其他行为 SDMX RESTful 5 API 5. 1 REST简介. 5. 2 API范围. 5. 3 结构元数据查询 5. 4 数据和元数据查询 6 5. 5 模式查询. 13 5. 6 适合表述选择 15 5. 7 数据压缩 15 SDMX 6 Web服务标准错误， 15 6. 1 介绍 16 6. 2 REST Web服务错误处理 16 6.3 SOAP Web服务 16 6. 4 错误分类 16 6.5 客户端导致的错误 16 6. 6 服务器导致的错误， 17 6.7 Custom Errors - 1000+ 17 6. 8 SDMX与HTTP错误映射. 17 附录A（资料性附录） 示例， 19 JR/T 0107.72014/1S0 17369-7:2013 前 言 JR/T0107《统计数据和元数据交换（SDMX）》分为七个部分： 一第1部分：框架； 一第2部分：信息模型 UML概念设计； 第3部分：SDMX-ML模式和文档； 一第4部分：SDMX-EDI语法和文档； 一第5部分：注册表规范 逻辑功能和逻辑接口； 一第6部分：SDMX技术说明事项： 第7部分：Web服务用法指南。 本部分为JR/T0107的第7部分。 本部分依据GB/T1.1-2009规则起草 本部分等同采用IS017369-7：2013《统计数据和元数据交换（SDMX）第7部分：Web服务用法指南》。 本部分由中国人民银行提出。 本部分由全国金融标准化技术委员会（SAC/TC180）归口。 本部分主要起草单位：中国人民银行调查统计司、中国金融电子化公司。 本部分主要起草人：盛松成、徐诺金、姚力、巴运红、任全忠、潘润红、李曙光、韩建国、贾树辉 李兴锋、王媛、司燕翔、刘蔚、张艳、吴永强、邓琳莹。 II JR/T0107.72014/1S017369-7:2013 引言 统计数据和元数据交换（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正规化。 III JR/T 0107.72014/IS017369-7:2013 统计数据和元数据交换（SDMX） 第7部分：Web服务用法指南 1范围 本部分规定了统计数据和元数据交换的Web服务用法，包括Web服务和SDMX-ML、基于SOAP的SDMXWeb 服务：WSDL操作和行为、SDMXRESTfulAPI、SDMXWeb服务标准错误及示例附件等内容。 本部分适用于统计数据和元数据的交换和共享。 2规范性引用文件 凡是不注日期的引用文件，其最新版本（包括所有的修改单）适用于本文件 wS-I简介文件BasicProfileVersionl.l 3Web服务和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) 的非特定数据结构定义格式，且该方案要求每个SDMXWeb服务至少使其数据在该格式中可用 可以预见，并行服务也将支持其他特定数据结构定义的XML格式来表示数据。 “特定结构”数据报文：该报文是一种标准模式格式，来源于标准化映射和诸多标准标记的 结构描述。该报文仅针对特定数据结构定义的结构，因此每个数据结构定义将具有自已的“特 定结构”方案。该报文用于大数据集的交换，Web服务是否提供的数据格式，取决于其数据交 换的要求。 (P 但被分解为特定查询，以便每个服务仅支持对模板报文有意义的领域。该查询报文在所有数据 1