智慧城市公共信息平台-附件七：接口与服务要求

1、附件七智慧城市公共信息平台平台接口与服务要求（试行）中华人民共和国住房和城乡建设部建筑节能与科技司 二。一三年三月1 范围 12 规范性引用文件 23 术语与定义 34 接口服务概述 54.1 接口服务组成 54.2 接口技术要求 65 总体要求 75.1 消息结构 75.1.1 请求报文范例 75.1.2 响应报文范例 75.2 接口方式 75.3 接口地址 85.4 使用说明 86 业务接口要求 106.1 基础接口要求 106.1.1 目录服务初始化 106.1.2 目录服务终止 116.1.3 认证授权 126.2 发现接口要求 136.2.1 资源目录检索 136.2.2 资源目录检

2、索结果提取 156.3 资源服务接口要求 176.3.1 资源内容检索 176.3.2 资源内容检索结果提取 186.4 管理接口要求 206.4.1 目录资源元数据管理 20附录 A 要求所涉及的结构表 23表 A.1 databaseList 组成 23表A.2服务功能列表 23表A.3elementSetName 结果集属性 24表 A.4 opResult 属性表 24表 A.5 singleRecord 参数表 24表A.6元数据管理类型定义 24表A.7核心元数据属性集 25表A.8关系运算符属性集 27表A.9位置运算符属性集 27表 A.10 资源自描述Result 属性集 2

3、7附录 B QUERYRESDATA说明 308.1 dataQuery 资源检索申请结构 318.1.1 结构化资源检索申请结构 318.1.2 非结构化资源申请结构 328.2 资源检索结果提取结构 338.2.1 结构化资源singleRecord 范例 338.2.2 非结构化资源singleRecord 范例 34附录 C 平台接口要求SCHEMA 36附录D QUERYRPN范例 65D.1 示例一 65D.2 示例二 65附录 E 资源目录范例 68E.1 资源目录要求SCHEMA 68E.2 结构化资源目录模板 89E.3 非结构化资源目录模板 981 范围本要求是智慧城市公共

4、信息平台建设指南建设要求系列之接口与服务要求。本部分要求分两大部分描述平台接口要求，第一部分：总体要求，总体要求描述消息的总体结构、接口访问方、接口地址、使用说明。第二部分：业务接口要求，具体描述每个业务应用服务接口的要求。也就是每一个业务接口要求套在总体要求内。只有使用业务接口要求+总体要求才能正常使用信息平台的应用服务来发现，查询，管理资源。本部分适用于参与公共信息平台设计和研发人员，系统维护人员及要求接入公共信息平台的外部应用的开发人员。2 规范性引用文件凡是注日期的引用文件， 其随后所有的修改单（不包括勘误的内容）或修订版均不适用于本部分，鼓励根据本部分达成协议的各方研究是否可使用这些

5、文件的最新版本。凡是不注日期的引用文件，其最新版本适用于本部分。GB/T 21063.1-2007政务信息资源目录体系第 1 部分：总体框架；总体框架;GB/T 21063.2-2007政务信息资源目录体系第 2 部分：技术要求；技术要求;GB/T 21063.3-2007政务信息资源目录体系第 3 部分：核心元数据；核心元数据;GB/T21063.4-2007政务信息资源目录体系第 4 部分：政务信息资源分类；GB/T 21063.5-2007政务信息资源目录体系第 5 部分：政务信息资源标识政务信息资源标识符编码方案；? 本文业务接口要求 引用 GB/T 21063.2-2007 中的附录

6、A 目录服务接口；? 本文附录A 要求所涉及的结构表引用GB/T 21063.2-2007 中的附录 A 目录服务接口，及引用GB/T21063.2-2007 中的附录C 政务信息资源目录服务属性集本文 附录D QUERY-RPN例弓|用 GB/T 21063.2-2007中的附录F检索串示例9.3 术语与定义GB/T 19710-2005 中规定的与以下术语和定义适用于本部分。目录针对拥有共性的数据资源/ 文件资源进行分类，并且为该分类赋予唯一的资源标识符，该部分分类及分类描述的集合统称为资源目录，简称目录。结构化资源公共信息平台共享的二维库表结构数据，统称为结构化资源。非结构化资源公共信息

7、平台共享的非二维库表结构数据，例如：文本文件、视频、网络访问资源等统称为非结构化资源。数据交换管理者管理信息资源结点的机构。交换内容提供者提供信息资源交换内容的机构。交换内容使用者使用信息资源交换内容的机构。前置环境应用单位接入端系统软硬件及相关网络环境组成的应用单位前置系统的单元环境。目录交换按订阅模式进行目录资源数据的交换；桥接系统业务数据库与共享数据库的桥接器，保持交换数据库与共享数据库的同步；变更捕捉捕捉数据资源变更情况。数据转入以固定间隔时间轮询变更登记表，读取其中的记录，并将这些记录以约定的格式组成XML艮文，存储到共享库的换出表中；非结构化数据文件直接通过文件服务传输至交换中心文

8、件服务器，并有中心 分发非结构化数据文件。数据交换路由以固定时间问隔轮询应用单位换入表，拆解XML艮文，根据目标库自动分拣；非结构化数据文件直接通过文件服务传输至交换中心文件服务器，并有中心分发非结构化数据文件。数据转出独立运行的进程，以固定间隔时间轮询交换库中的换入表，读取其中的XML报文，并将数据按定制的格式同步到共享库中。非结构化数据文件描述信息存储在信息队列中，由各服务器根据队列信息分别从中心文件服务器获取所需数据文件。交换管理程序完成数据交换审批流程、交换监控、交换调度、系统管理等功能一套程序，部署于中心。WebK 务基于webservice技术开放的服务接口，采用约定的XML乍为交

9、易数据接口，提供给客户端调用。WSDLWeb!务描述文件，一个用来描述 Web!务和说明如何与 Web!务通信的XML 语言。为用户提供详细的接口说明。访问认证公共信息平台提供用户认证服务，由托管应用系统的客户端调用，用于验证用户是否合法；应用单位接入公共信息平台的机构单位。主管单位公共信息平台的管理单位。数据中心公共信息平台的组成部分，是公共信息平台数据及应用系统数据存储的地方。4接口服务概述4.1 接口服务组成信息资源目录服务包含三种接口，即信息资源基础服务接口、资源服务接口 （发现接口、资源接口）、信息资源管理服务接口。其中，基础接口是将资源服务 接口和管理接口中基础性的操作定义成一个公

10、共接口。这3类接口实现了信息资源的发现功能、检索功能和管理功能。基础接口 ：提供会话管理功能和服务自描述功能， 包含有目录服务初始化接 口、目录服务终止接口和服务自描述接口。发现接口 ：提供信息资源元数据检索功能和信息资源元数据检索结果提取功能，包含有目录检索接口以及目录检索结果提取接口。这些接口本身并不提供资源，而是提供资源基本信息和如何去获得这些资源的元数据。资源接口：根据发现接口获得信息资源元数据， 定位、查找资源具体内容的 接口，包含资源内容检索接口及资源内容结果提取接口。管理接口：提供元数据管理的功能，包含信息资源元数据管理接口。城市公共信息平台接口服务组成见图1.图1.城市公共信息

11、平台接口服务组成图4.2 接口技术要求a)提供基于SOAFW议的web服务接口b) 支持跨语言、跨操作系统调用5总体要求5.1 消息结构每个交易消息（包括请求和应答）有一个是名字（Message Name,交易消息 以XMLB式表达的，根据XML勺定义，每个XML±件需要有特定的Root Tag （根 标记），在本要求中，用交易名称+请求类别作为根节点，如初始化接口的请求包 根节点为initRequest ,而响应包的根节点为initResponse 。根节点下之间放业 务接口数据。5.1.1 请求报文范例<initRequest><protocolVersion/

12、><idAuthentication /><implementationId /><implementationName/><otherInfo/></initRequest>5.1.2 响应报文范例<initResponse><referenceId></referenceId><protocolVersion></protocolVersion><pubKey></pubKey><result></result><

13、;otherInfo ></otherInfo ></initResponse>5.2 接口方式接口采用WebService方式，接口协议使用 SOAFW议，提供标准的 WSDLC 件。5.3 接口地址公共信息目录服务(以下简称目录服务)主要有三个wsdl 地址， 不同的 wsdl下有不同的方法，下文有说明。这是根据webservice 的 soap 协议开放出来的wsdl 地址，第三方应用可以根据实际的部署的服务器地址来使用它。1) 基 础 接 口 WSDL 文 件 地 址 ： http:/<ip 地 址 >:< 端口 >/es/cata

14、logbase?wsdl目录服务初始化 -initCatalogService目录服务终止 -stopCatalogService2) 发 现 接 口 WSDL 文 件 地 址 ： http:/<ip 地 址 >:< 端 口 >/es/digcatalog?wsdl目录检索-queryCatalogList目录检索结果提取-queryCatalogResult3) 资源服务接口：http:/<ip 地址 >:< 端口 >/es/digresource?wsdl资源检索-getResourceResultset 资源检索结果提取-getResour

15、ceResultDetail4) 发 现 接 口 WSDL 文 件 地 址 ： http:/<ip 地 址 >:< 端 口 >/es/digcatalog?wsdl资源元数据管理 -metadataManage5.4 使用说明完成资源的检索与发现需要根据以下步骤来操作完成：1) 第一步：初始化操作。调用基础接口的“目录服务初始化”获得一个会话标识符以后每次调用接口都需要次标识符。2) 第二步：查询公共信息目录操作。调用发现接口的“目录检索”组织好查询参数，发起交易，获得查询结果。注：这里的查询结果只有返回命中的查询记录数。比如： 返回值是100， 那么表示有100条记录

16、符合查询条件， 这个时候需要发起 “公共信息目录检索结果提取”交易才能提取查询的结果。如果发回值是0，表示没有符合查询条件的记录。3) 第三步：查询公共信息目录对应的资源。这里的操作也是和上面一样，调用 “资源检索”先要查询下是否有符合查询条件的资源。有资源记录的话，然后在调用“资源检索结果提取”提取符合条件的资源信息。4) 第四步：假如调用接口结束后，可调用基础接口里的“目录服务终止”来释放会话标识符资源信息。6业务接口要求6.1 基础接口要求6.1.1 目录服务初始化公共信息目录服务初始化用于建立客户端与服务端的会话，所有其他服务 都必须依赖会话。会话的持续时间为30分钟，若会话持续30分

17、钟没有活动，则会 话自动终止。本次初始化作用是客户端认证同时获取会话标识符，后续发起交易时需要传递该会话标识符。1 .请求报文体序号元素名称约束长度描述取值说明1.protocolVersion可选String50客户端协议 版本号客户端协议实现的 版本号2.idAuthentication必选String50用户名/密 码认证信息。包含用户 身份标识及其密码。格式“用户名/密 码”3.implementationId可选String50应用标识在公共信息平台用 户体系中注册的第 三方应用编号4.implementationName可选String200应用名称在公共信息平台用 户管系统中注册

18、的 第二方应用名称5.otherInfo可选element其他信息备用2 .请求报文体模板<initRequest><protocolVersion>V1.0</protocolVersion><idAuthentication>testApp/12456</ idAuthentication><implementationId>1</ implementation ><implementationName>U试应用 </implementationName><otherInfo/

19、></initRequest>3 .响应报文体序号元素名称约束长度描述取值说明1.referenceld必选String50会话标识当验证成功时返回，否 则设置为空2.protocolversion必选String50服务端协议 版本号服务端协议实现的版本 号3.result必选Boolean处理结果服务器端用该参数表明 是否接受建立会话的请 求。true表小建立会话 成功，false表小建立会 话失败，此时referenceId 为空。4.pubKey必选String64加解密公钥5.otherInfo可选element其他信息备用4 .响应报文体模板<initRes

20、ponse><referenceId>cde2db52-8cee-45f4-9cec-f8a68ebbad5</referenceId><protocolVersion>V1.0</protocolVersion><pubKey>catalog</pubKey><result>true </result><otherInfo>初始化服务成功 </otherInfo></initResponse>5 .1.2目录服务终止公共信息目录服务终止将结束服务端与客户端

21、的会话，与会话相关的资源将被释放。1 .请求报文体序号元素名称约束长度描述取值说明1.referenceId必选String50会话标识要终止的会话编号2.closeReason可选String50终止原因3.otherInfo可选element其他信息备用2 .求报文体模板<initRequest><referenceId>cde2db52-8cee-45f4-9cec-f8a68ebbad5</referenceId>< closeReason 终止使用 </ closeReason > <otherInfo/></i

22、nitRequest>6.1.3认证授权认证授权主要是公钥获取接口服务，用于根据客户端应用的请求，取出最 新的加解密公钥并返回给客户端的过程。公钥获取与其他接口不同，不需要用户验证，不需要会话标识。调用客户 端只有获取公钥后对用户认证信息进行加密才能完成其服务调用。整个密码加解密的处理过程如下图所示：图2.密码加解密的处理过程图1 .请求报文体序 号元素名称约束长度描述取值说明1.otherInfo可选element其他信 息备用2 .请求报文体模板<pubKeyRequest><otherInfo></otherInfo></ pubKeyRe

23、quest >3 .响应报文体序 号元素名称约束长度描述取值说明1.pubKey必选String8公钥用于加解密密码的 密钥2.opResult必选element操作 结果参见表 A.6opResult属性表之 说明3.otherInfo可选element其他 信息备用4 .响应报文体模板<pubKeyResponse><pubkey>catalog</ pubkey><opResult>< opStatus>true </ opStatus >< opRetCode :code</ opRetCode

24、>< opRetMsg >message</ opRetMsg ></ opResult><otherInfo></otherInfo></ pubKeyResponse >6.2发现接口要求6.2.1 资源目录检索公共信息目录检索是服务端根据客户端指定的检索条件，在服务器端从元 数据库中检索并标识出匹配的元数据记录，并将元数据记录保存在结果集中的过程。结果集的保存时间与会话标识一致，当会话结束后，响应的结果集将被同 步删除。1 .请求报文体序号元素名称约束长度描述取值说明1.referenceId必选String5

25、0会话标识2.replaceIndicato r必选Boolean结果集覆盖 标志true表不覆盖原来的查 询结果，false表小保留 原来的查询结果3.resultSetID必选String200指定的查询 结果集名称若存在同名的结果集，需要根据replaceIndicator 判断是否需要覆盖结果集。4.databaseName s必选Element要查询的元 数据库名称 列表客户端指定的要查询的 元数据库名称列表5.query必选Element客户端定制 的检索语句检索语句必须符合Type-1型，使用逆波兰 表达式（RPN）乍为检索语 法，参见附录E QUERYRPN范例6.prefer

26、redRecor dSyntax可选String10检索结果的 编码方式固定取值：" XML7.otherInfo可选Element其他信息备用2 .请求报文体模板<searchRequest><referenceId>f4973365-a9be-4f80-b5d8-a8b9c794918区/referenceId><replaceIndicator>true</replaceIndicator><resultSetID>highResult</resultSetID><databaseNames：B

27、MDB</databaseNames><preferredRecordSyntax>XML</preferredRecordSyntax><query>10§国标的逆波兰表达式（RPN）&合的查询条件具体规则参考附录 E QUERYRPNOh </query></searchRequest>3 .响应报文体序号元素名称约束长度描述取值说明1.referenceId必选String50会话标识2.resultCount必选NumberString20符合条件 的记录数服务器端执行检索操作得 到的命中记录数，

28、检索失败 设置为03.searchStatus必选String7执行检索 的执行结 果返回的检索状态信息， success表小检索成功， failture表小检索失败4.otherInfo可选element其他信息备用4 .响应报文体模板<searchResponse><referenceId>3720b175-7db7-408d-90cd-108e1f2ec88N/referenceId><resultCount>9</resultCount><searchStatus：succes</searchStatus><

29、otherInfo></otherInfo></searchResponse>5 .2.2资源目录检索结果提取目录检索结果由服务器端从结果集中提取并返回若干数据记录给客户端1 .请求报文体序号元素名称约束长度描述取值说明1.referenceId必选String50会话标识2.resultSetID必选String要抽取的 结果集的 标识因为系统允许在抽取数据 前进行多次检索，每次检 索都可以指定/、同的结果 集名称，所以客户端必须 指定要抽取的数据结果集 标识3.resultSetStartP oint必选NumberString20开始抽取 的位置客户端指定的

30、从第几条记录开始抽取，序号从 1开始4.numberOfReco rdsResquested必选NumberString20记录数客户端指定的要抽取的记 录数5.elementSetNa me必选element结果集属 性参见表表A.3elementSetName 结果 集属性6.preferredRecor dSyntax可选String10提取结果 的编码方 式固定取值：" XML7.otherInfo可选element其他信息备用2 .请求报文体模板<presentRequest><referenceId>f4973365-a9be-4f80-b5d8-

31、a8b9c794918区/referenceId><resultSetID+ighResult</resultSetID><resultSetStartPoint»</resultSetStartPoint><numberOfRecordsResquested30</numberOfRecordsResquested><elementSetName><genericElementSetName：brief</genericElementSetName></elementSetName>

32、;<preferredRecordSyntaxXML</preferredRecordSyntax></presentRequest>3 .响应报文体序号元素名称约束长度描述取值说明1.referenceId必选String50会话标识2.numberOfRecord sReturned必选NumberString20元数据数 目服务器端返回的元数 据数目3.presentStatus必选String7提取状态服务器端返回的提取 状态。success表小提 取成功，failture表小提 取失败4.records必选element结果集服务器返回的结果集， 包含一

33、个或多个singleRecord,详细描述参见表A.5singleRecord参数表5.otherInfo可选element其他信息备用4 .响应报文体模板<presentResponse><referenceId>f4973365-a9be-4f80-b5d8-a8b9c794918区/referenceId><numberOfRecordsReturned»</numberOfRecordsReturned><presentStatus>success：/presentStatus><records>构

34、化资源目录/非结构化资源目录</records><otherInfo></otherInfo></presentResponse>5 .3资源服务接口要求6.3.1资源内容检索资源检索是公共信息平台服务端根据客户端发送的请求信息，从共享数据 库中读取符合条件的记录，并将查询结果集相关返回的过程。 注意，资源检索功 能并不返回具体的结果集，结果集返回功能将由“资源检索结果提取”服务提供。结果集的保存时间与会话标识一致，当会话结束后，响应的结果集将被同步删除。1 .请求报文体序号元素名称约束长度描述取值说明1.referenceld必选String5

35、0会话标识2.resid必选String50资源标识符6位字母/数字加”加1到23位数字3.replaceIndicator必选Boolean结果集覆盖 标志true表不覆盖原来的查询 结果，false表小保留原来 的查询结果4.resultSetID必选String200指定的查询 结果集名称若存在同名的结果集，需要根据 replaceindicator 判 断是否需要覆盖结果集。5.dataQuery必选element客户端定制 的检索条件参见附录CQUERYRESDATA 说明- dataQuery属，件t兑明6.preferredRecordSyntax可选String10检索结果的

36、编码方式固定取值：" XML7.otherinfo可选element其他信息备用2 .请求报文体模板<dataSearchRequest><referenceId>d8137d81-ef76-4dc5-80c7-01dc493f9d3</referenceId><resId>GXWgxwAA00®/resId><resultSetID>GXWgxwAA00住/resultSetID><replaceIndicator>true</replaceIndicator><pref

37、erredRecordSyntaxXML</preferredRecordSyntax><dataQuery加值参考 dataQuery属性说明 </dataQuery></dataSearchRequest>3 .响应报文体序 号元素名称约束长度描述取值说明1.referenceId必选String50会话标 识2.resultCount必选NumberString20符合条 件的记 录数服务器端执行检索操 作得到的命中记录 数，检索失败设置为03.searchStatus必选String7执行检 索的执 行结果返回的检索状态信息，success表小

38、检索 成功，failture表小检 索失败4.opResult可选element操作信 息详情参见附录表A.4-opResult 属性表5.otherInfo可选element其他信 息备用4 .响应报文体模板<dataSearchResponse><referenceId>d8137d81-ef76-4dc5-80c7-01dc493f9d3</referenceId><resultCount>0</resultCount><searchStatus>ailure</searchStatus><opRe

39、sult><opStatus>ailure </opStatus><opRetCode>|误彳t码 </opRetCode><opRetMsg>ihyi信息 </opRetMsg></opResult><otherInfo></otherInfo></dataSearchResponse>5 .3.2资源内容检索结果提取资源检索结果提取用于从崔源才索 所得的结果集中提取指定的结果。序号元素名称约束长度描述取值说明1.referenceId必选String50会话标识2.

40、resultSetID必选String要抽取的 结果集的 标识因为系统允许在抽 取数据前进行多次 检索，每次检索都 可以指定/、同的结 果集名称，所以客 户端必须指7E要抽 取的数据结果集标 识3.resultSetStartPoint必选NumberString20开始抽取 的位置客户端指定的从第 几条记录开始抽 取，序号从1开始4.numberOfRecordsRe squested必选NumberString20记录数客户端指定的要抽 取的记录数5.numberOfRecordsTo tal必选NumberString20符合条件 的总共命 中记录数资源检索接口查询 得到的总共命中记 录

41、数。6.preferredRecordSynt ax可选String10提取结果 的编码方 式固定取值：" XML7.otherInfo可选element其他信息备用2 .请求报文体模板<dataPresentRequest><referenceId>2190bf83-a934-4f4d-995c-f688dc4808a&/referenceId><resultSetID>JTJQD/JTJ000«/resultSetID><resultSetStartPoint>1</resultSetStartP

42、oint><numberOfRecordsResquested30</numberOfRecordsResquested><numberOfRecordsTotal>3</numberOfRecordsTotal><preferredRecordSyntax>XML</preferredRecordSyntax></dataPresentRequest>3 .响应报文体序号元素名称约束长度描述取值说明1.referenceId必选String50会话标识2.numberOfRecordsReturned必选Nu

43、mberString20元数据数 目服务器端返回的元数据数 目3.presentstatus必选String7提取状态服务器端返回的提取状态。success表小提取成 功，failture表小提取失败4.resType必选String50资源种类结构化资源或非结构化资 源，/、同的资源种类对应 的 singleRecord 中 Item 项 /、同5.records必选element结果集服务器返回的结果集，包 含一个或多个singleRecord,详细描述参 见B.2资源检索结果提取 结构6.otherInfo可选element其他信息备用4 .响应报文体模板<dataPresentR

44、esponse><referenceId>687d0aed-6e43-44eb-9d0e-e25eeca8347</referenceId><numberOfRecordsReturned：3</numberOfRecordsReturned><presentStatus>s</presentStatus><resType绍构化资源 </resType><records><singleRecord> .</singleReco婚（结构参照）</records>&l

45、t;otherInfo></otherInfo></dataPresentResponse>6.4管理接口要求6.4.1目录资源元数据管理目录资源元数据管理接口包含元数据的新增、删除和更新操作，根据不同 的操作类型来完成相应的动作，且元数据管理接口 一次只操作一种操作类型的一 条元数据记录。当操作类型为更新时其操作对象为通过“目录检索结果提取”接口返回的 元数据，元数据元素必须符合核心元数据属性集要求；当操作类型为删除时，其操作对象为通过“目录检索结果提取”接口返回 的元数据中的特定一条记录;当操作类型为创建时，请求方必须按附录B勺定的编目要求提供完整的元数 据信

46、息。1 .请求报文序号元素名称约束长度描述取值说明1referencel d必选String50会话标识2type必选Int用于指定进行元数据 的各种管理操作，详细 内容见表 A.6元数 据管理类型定义3recordId可选String待删除或待更新的 元数据标识符（即资 源标识符）。该标识 符附于在元数据库 中指定唯一的元数 据。可以通过目录 检索结果提取接口 族取其响应消息。当type为1时，进行 元数据插入操作，本参 数不出现；当type为 2或3时，进行元数据 删除或更新操作，本参 数为必选参数4Data可选XML待创建或更新的兀 数据内容，当type 为1或3时，进行 兀数据插入或更

47、新 操作，本参数为必 选参数；当type为 2时，进行元数据删 除操作，本参数不 出现更新操作时，Data格 式定义为：<records><item><itemName></itemNa me><itemValue></itemVal ue></item></records>,Records节点包含一组 或多组元数据属性参 数itemName和元数 据属性值参数 itemValue。 itemName 取值要求符合表核 心元数据属性集之约 定5otherInfo可选String其他信息备用2 .返回

48、报文序号元素名称约束长度描述取值说明1.referenceld必选String50会话标识2.operationstate必选String7执行结果Success表示执行元数据管理操 作成功；Failture表示执行元数据管理操 作失败3.operationType可选Int操作类型用来表示服务器端执行的元数 据管理操作类型，必须符合表 元数据管理类型定义之约定4.otherInfo可选element其他信息当执行成功时本元素不出现,当执行失败时，格式定为：<errCode></errCode><errMsg></errMsg> , errcod

49、e 表 不错误码，errMsg表小错误信息附录A要求所涉及的结构表表 A.1 databaseList 组成参数名称约束参数含义databaseld必选标识一个元数据库，以公共信息平台的应用单位 编号代替databaseName必选元数据库名称databaseDescribe必选元数据库的基本描述信息表A.2服务功能列表功能标识交易编码(transid)国标要求是否支持含义initinitRequest是是用于建立客户端与服务 端的会话closecloseRequest是是终止客户端与服务端的 会话capbilitiescatalogCapabilitiesReque st是是提供服务本身的各

50、种描 述信息searchsearchRequest是是检索目录信息并形成结 果集presentpresentRequest是是目录检索结果提取，从结果集中提取结果metadataManag er否否对公共信息平台进行远 程管理resSelfDescresSelfDescRequest否是资源自描述dataSearchdataSearchRequest否是检索资源dataPresentdataPresentRequest否是从检索出的资源结果集 中抽取数据pubKeypubKeyRequest否是用于从服务端获取公钥表A.3 elementSetName 结果集属性参数名称参数类型取值参数含义g

51、enericElement -SetNameStringBrief提取信息资源核心 元数据genericElement -SetNameStringFull或空提取全部的信息资 源元数据elementSetList<String>元数据属性字段标 识符列表必须符合表核心 元数据属性集的 编他要求表A.4 opResult属性表属性名长度约束参数含义opStatusString8必选执行结果，"succes表示成功，"failture 表示失败opRetCodeString8可选执行结果，”表示成功，其他表示错误代 码opRetMsgString200可选错误的说

52、明表 A.5 singleRecord 参数表参数名称参数类型约束参数含义itemelement必选结果集中的元数据记录，包含一组或多组元数据属性参数itemName和元数据属性值参数 itemValue。提取的结果集是核心兀数据时，参数itemName取值要求符合表核心兀数据属性集databaseIdString可选提取全部的信息资源元数据recordIdString可选必须符合表的编码要求（即资源标识符）表A.6元数据管理类型定义名称取值含义创建元数据1用于表示该次请求是进行创建元数据操作删除元数据2用于表示该次请求是进行删除元数据操作更新兀数据3用于表示该次请求是进行更新兀数据操作表A.

53、7核心元数据属性集核心元数据属性集的编码规则如下：第一层代码只有一位阿拉伯数字。其取值为“1”，表示核心元数据。第二层是核心元数据元素和元数据实体，采用三位阿拉伯数字。该编码结构分为二层：第一层采用一位阿拉伯数字，核心元数据取值为 1；第二层代码采 用三位阿拉伯数字，利用递增顺序码的方法进行编码。例如，“资源名称”的编码为“1.001”，“资源出版日期”的编码为“ 1.002”。第三层是元数据实体所包含的元数据元素，采用五位阿拉伯数字。该编码结构分为三层：第一层采用一位阿拉伯数字，核心元数据取值为 1；第二层代码 采用三位阿拉伯数字，利用递增顺序码的方法进行编码，为该元数据元素所属元 数据实体

54、的编码；第三层代码采用两位阿拉伯数字，利用递增顺序码的方法进行 编码。例如，”资源负责单位”的编码为“1.004.01 "。如图A.1所示：X . X X X e X X第三层代码第二层代码第一层代码图A.1核心元数据属性集的编码规则示意图卜面是相应的核心元数据属性集:编码中文名称短名1.000资源核心元数据全文resMetadata1.001资源名称resTitle1.002资源出版日期pubCate1.003资源摘要abstract1.004资源负责方IdPoC1.004.01资源负责单位rpOrgName1.004.02资源负责方地址cntAdd1.004.03资源负责方电子邮件地址eMailAdd1.005资源格式信息FmInfo1.005.01资源格式名称fmName1.005.02资源格式版本