智慧城市公共信息平台平台接口与服务要求

文章描述:-2022年3月29日发(作者:詹剑峰) 智慧城市公共信息平台平台接口与服务要求 1 范围  本要求 是《智慧城市公共信息平台建设指南》建设要求系列之接口与服 接口与服 接口与服 务要求 。  本部分 要求 分两大部描述平台接口 分两大部描述平台接口 分两大部描述平台接口 分两大部描述平台接口 分两大部描述平台接口 要求 ,第一部分:总体 ,第一部分:总体 ,第一部分:总体 ,第一部分:总体

-

智慧城市公共信息平台平台接口与服务要求2022年3月29日发(作者:詹剑峰)



智慧城市公共信息平台平台接口与服务要求
1 范围
 本要求 是《智慧城市公共信息平台建设指南》建设要求系列之接口与服 接口与服 接
口与服 务要求 。
 本部分 要求 分两大部描述平台接口 分两大部描述平台接口 分两大部描述平台接口
分两大部描述平台接口 分两大部描述平台接口 要求 ,第一部分:总体 ,第一部分:总
体 ,第一部分:总体 ,第一部分:总体 要求 ,总体 要求 描述消息的总体结构、接口
访问方地址使用说明。第二部分:业务 描述消息的总体结构、接口访问方地址使用说明。
第二部分:业务 描述消息的总体结构、接口访问方地址使用说明。第二部分:业务 描述
消息的总体结构、接口访问方地址使用说明。第二部分:业务 描述消息的总体结构、接口
访问方地址使用说明。第二部分:业务 描述消息的总体结构、接口访问方地址使用说明。
第二部分:业务 接口 要求 ,具体描述每个业务应用服接口的 ,具体描述每个业务应用
服接口的 要求 。也就是每一个业务接口 。也就是每一个业务接口 要求 套在总体 要求
内。只有使用业务接口 内。只有使用业务接口 内。只有使用业务接口 内。只有使用业务
接口 要求 +总体 要求 才能正常使用信息平台的应 才能正常使用信息平台的应 才能正
常使用信息平台的应 才能正常使用信息平台的应 用服务来发现,查询管理资源。
 本部分适用于参与公共信息平台设计和研发人员,系统维护及要求 本部分适用于参与
公共信息平台设计和研发人员,系统维护及要求 本部分适用于参与公共信息平台设计和研
发人员,系统维护及要求 本部分适用于参与公共信息平台设计和研发人员,系统维护及要
求 本部分适用于参与公共信息平台设计和研发人员,系统维护及要求 本部分适用于参与
公共信息平台设计和研发人员,系统维护及要求 本部分适用于参与公共信息平台设计和研
发人员,系统维护及要求 本部分适用于参与公共信息平台设计和研发人员,系统维护及要
求 本部分适用于参与公共信息平台设计和研发人员,系统维护及要求 本部分适用于参与
公共信息平台设计和研发人员,系统维护及要求 本部分适用于参与公共信息平台设计和研
发人员,系统维护及要求 本部分适用于参与公共信息平台设计和研发人员,系统维护及要
求 本部分适用于参与公共信息平台设计和研发人员,系统维护及要求 接入公共信息平台
的外部应用开发人员。
智慧城市公共信息平台-平台接口与服务要求
2
2 规范性 引用 文件
下列文件中的条款通过本部分引 用而成为。凡是注日期下列文件中的条款通过本部分引
用而成为。凡是注日期用文件,其随后 用文件,其随后 所有的修改单(不包括勘误内容)
或订版均适用于本部分, 所有的修改单(不包括勘误内容)或订版均适用于本部分, 所
有的修改单(不包括勘误内容)或订版均适用于本部分, 鼓励根据本部分达成协议的各方
研究是否可使用这些文件最新版。凡不注 鼓励根据本部分达成协议的各方研究是否可使用
这些文件最新版。凡不注 日期的引用文件,其最新版本适于部分。
GBT 21063.1 -2007 政务信息资源目录体系 第 1部分:总体框架;
GBT 21063.2 -2007 政务信息资源目录体系 第 2部分:技术要求;
GBT 21063.3 -2007 政务信息资源目录体系 第 3部分:核心元数据;
GBT 21063.4 GBT 21063.4 -2007 政务信息资源目录体系 第 4部分: 政务信息资源分类;
GBT 21063.5 -2007 政务信息资源目录体系 第 5部分:政务信息资源标识 部分:政务信
息资源标识 符编码方案;
 本文 <业务接口 要求 > 引用《 GBT 21063.2 GBT 21063.2 -2007 》中的附录 A 目
录服务 接口;
 本文 <附录 A 要求 所涉及的结构表 所涉及的结构表 所涉及的结构表 所涉及的结


1



构表 >引用《 引用《 GBT 21063.2 GBT 21063.2 -2007 》中的附 》中的附 》中的附
录 A 目录服务接口,及引用《 目录服务接口,及引用《 目录服务接口,及引用《 GBT
21063.2 GBT 21063.2 -2007 》中的附录 》中的附录 C 政务信息资源目 录服务属性集
 本文 <附录 D QUERY D QUERY -RP 范例 >引用 《GBT 21063.2 GBT 21063.2
-2007 》中的附录 》中的附录 F 检 索串示例 9.
智慧城市公共信息平台-平台接口与服务要求
3
3 术语 与定义
GBT 19710 -2005 中规定的与以下术语和义适用于本部分。
 目录
针对拥有共性的数据资源 针对拥有共性的数据资源 针对拥有共性的数据资源 针对拥有
共性的数据资源 文件资 源进行分类,并且为该赋予唯一的文件资 源进行分类,并且为
该赋予唯一的文件资 源进行分类,并且为该赋予唯一的文件资 源进行分类,并且为该赋
予唯一的文件资 源进行分类,并且为该赋予唯一的文件资 源进行分类,并且为该赋予唯
一的文件资 源进行分类,并且为该赋予唯一的源标识符,该部分类及描述的集合统称为资
目录简。
 结构化资源
公共信息平台享的二维库表结构数据,统称为化资源。
 非结构化资源
公共信息平台享的非二维库表结构数据,例如:文本件、视频网络访 公共信息平台享的非
二维库表结构数据,例如:文本件、视频网络访 公共信息平台享的非二维库表结构数据,
例如:文本件、视频网络访 公共信息平台享的非二维库表结构数据,例如:文本件、视频
网络访 公共信息平台享的非二维库表结构数据,例如:文本件、视频网络访 问资源等统
称为非结构化。
 数据交换管理者
管理信息资源结点的机构。
 交换内容提供者
提供信息资源交换内容的机构。
 交换内容使用者
使用信息资源交换内容的机构。
 前置环境
应用单 位接入端系统软硬件及相关网络环境组成的前置元环境。
 目录交换
按订阅模式进行目录资源数据的交换;
 桥接系统
业务数据库与共享的桥接器,保持 交换 数据库与共享的同步 数据库与共享的同步 数据
库与共享的同步 数据库与共享的同步 数据库与共享的同步 数据库与共享的同步 数据库
与共享的同步 数据库与共享的同步 数据库与共享的同步 数据库与共享的同步 ;
 变更捕捉
捕捉数据 资源 变更情况 。
 数据转入
以固定间隔时轮询变更登记表,读取其中的 录并将这些约以固定间隔时轮询变更登记表,
读取其中的 录并将这些约以固定间隔时轮询变更登记表,读取其中的 录并将这些约格式
组成 XML 报文,存储到共享库的换出表中 ;
非结构化数据文件直接通过服务传输至交换中心 器,并有非结构化数据文件直接通过服务


2



传输至交换中心器,并有
智慧城市公共信息平台-平台接口与服务要求
4
分发非结构化数据文件。
 数据交换路由
以固定时间隔轮询应用单位换入表,拆解 以固定时间隔轮询应用单位换入表,拆解 XML
报文,根据目标库自动分拣 报文,根据目标库自动分拣 ;
非结构化数据文件直接通过服务传输至交换中心 器,并有非结构化数据文件直接通过服务
传输至交换中心 器,并有分发非结构化数据文件。
 数据转出
独立运行的进程, 以固定间隔时轮询交换库中的 入表,读取其以固定间隔时轮询交换库
中的 入表,读取其XML 报文,并将数据按定制的格式同步到共享库中 。
非结构化数据文件描述信息存储在队列中,由各服务器根分 非结构化数据文件描述信息存
储在队列中,由各服务器根分 别从中心文件服务器获取所需数据。
 交换管理程序
完成 数据交换审批流程、监控调度系统管理 数据交换审批流程、监控调度系统管理 数据
交换审批流程、监控调度系统管理 数据交换审批流程、监控调度系统管理 数据交换审批
流程、监控调度系统管理 数据交换审批流程、监控调度系统管理 数据交换审批流程、监
控调度系统管理 数据交换审批流程、监控调度系统管理 等功能一套 等功能一套 程序 ,
部署于中心。
 Web 服务
基于 webservice 技术开放的 服务接口,采用约定的 服务接口,采用约定的 XML 作为
交易数据接口, 提供给客户端调用。
 WSDL
Web 服务描述文件, 一个用来描述 一个用来描述 Web 服务和说明如何与 服务和说明
如何与 Web 服务通信的 服务通信的 XML 语言。为用户提供详细的接口说明 。
 访问认证
公共信息平台提供用户认证 服务,由托管应系统的客端调于验公共信息平台提供用户认证
服务,由托管应系统的客端调于验公共信息平台提供用户认证 服务,由托管应系统的客端
调于验用户是否合法;
 应用单位
接入公共信息平台的机构单位。
 主管 单位
公共 信息平台的管理单位 。
 数据 中心
公共 信息平台 的组成部分, 是公共信息平台数据及应用系统存储的地方 。
智慧城市公共信息平台-平台接口与服务要求
5
4 接口服务概述
4.1 接口服务组成
信息资源目录服务包含三种接口,即信息资源基础服务接口、资源服务接口
(发现接口、资源接口)、信息资源管理服务接口。其中,基础接口是将资源服务
接口和管理接口中基础性的操作定义成一个公共接口。这3 类接口实现了信息资
源的发现功能、检索功能和管理功能。
基础接口:提供会话管理功能和服务自描述功能,包含有目录服务初始化接


3



口、目录服务终止接口和服务自描述接口。
发现接口:提供信息资源元数据检索功能和信息资源元数据检索结果提取功
能,包含有目录检索接口以及目录检索结果提取接口。这些接口本身并不提供资
源,而是提供资源基本信息和如何去获得这些资源的元数据。
资源接口:根据发现接口获得信息资源元数据,定位、查资源具体内容的
接口,包含资源内容检索接口及资源内容结果提取接口。
管理接口:提供元数据管理的功能,包含信息资源元数据管理接口。
城市公共信息平台接口服务组成见图1.
智慧城市公共信息平台
基础接口服务资源接口服务
管理接口服务
服务初始化认证授权服务终止发现服务资源服务
资源元数据新
增服务
资源元数据更
新服务
资源元数据删
除服务
资源目录检索
资源目录结果
提取
资源内容检索
资源内容结果
提取
图1. 城市公共信息平台接口服务组成图
智慧城市公共信息平台-平台接口与服务要求
6
4.2 4.2 接口技术要求 接口技术要求 接口技术要求 接口技术要求 接口技术要求
a) 提供基于 SOAP 协议的 web 服务接口
b) 支持跨语言、操作系统调用
智慧城市公共信息平台-平台接口与服务要求
7
5 总体 要求
5. 1 消息结构
每个交易消息 每个交易消息 (包括请求和应答 包括请求和应答 包括请求和应答 包括请
求和应答 )有一个是名字( 有一个是名字( 有一个是名字( 有一个是名字( Message
ame Message ame),交易消息 ),交易消息 ),交易消息 以 XML 格式表达的,根据
格式表达的,根据 XML 的定义,每个 的定义,每个 XML 文件需要有特定的 Root Tag
Root Tag (根 标记),在本 标记),在本 标记),在本 要求 中,用交易名称 中,用交
易名称 +请求类别作为根节点,如初始化接口的包 请求类别作为根节点,如初始化接口
的包 根节点为 initRequest ,而响应包的根节点为 ,而响应包的根节点为 initRespe 。
根节点下之间放业 。根节点下之间放业 务接口数据。
5. 1.1 请求报文范例

5.1.2 响应报文范例


4





5.2 5.2 接口方式
接口采用 WebService 方式,接口协议使用 SOAP 协议,提供标准的 WSDL 文 件。
智慧城市公共信息平台-平台接口与服务要求
8
5.3 5.3 接口地址
公共信息目录服务(以下简称)主要有三个 公共信息目录服务(以下简称)主要有三个
公共信息目录服务(以下简称)主要有三个 wsdl 地址,不同的 地址,不同的 wsdl 下有
不同的方法,文说明。这是根据 webservice 的 soap 协议开放出来的 协议开放出来的
wsdl 地址,第三方应用可以根据实际的部署服务器来使它。
1) 基础接口 WSDL 文件地址: http::< 端 口>escatalogbase?wsdl
 目录服务初始化 –initCatalogService
 目录服务终止 –stopCatalogService
2) 发现接口 WSDL 文件地址: http::< 端 口>esdigcatalog?wsdl
 目录检索 – queryCatalogList
 目录检索结果提取 – queryCatalogResult
3) 资源服务接口: http::< 端口 >esdigresource?wsdl
 资源检索 – getResourceResultset
 资源检索结果提取 – getResourceResultDetail
4) 发现接口 WSDL 文件地址: http::< 端 口>esdigcatalog?wsdl
 资源元数据管理 – metadataManage
5.4 5.4 使用说明
完成资源的检索与发现需要根据以下步骤来操作:
1) 第一步:初始化操作。调用基础接口的“目录服务初始化”获得一个会 话标识符以后
每次调用接口都需要次标识符。
2) 第二步:查询公共信息目录操作。调用发现接口的“目录检索”组织好查询参数,发起
交易,获得查询结果。注:这里的查询结果只有返回命中的查询记录数。比如:返回值是
100,那么表示有100条记录符合查询条件,这个时候需要发起“公共信息目录检索结果提
取”交易才能提取
智慧城市公共信息平台-平台接口与服务要求
9
查询的结果。如果发回值是0,表示没有符合查询条件的记录。
3) 第三步:查询公共信息目录对应的资源。这里的操作也是和上面一样,调用“资源检索”
先要查询下是否有符合查询条件的资源。有资源记录的话,然后在调用“资源检索结果提
取”提取符合条件的资源信息。
4) 第四步:假如调用接口结束后,可调用基础接口里的“目录服务终止”来释放会话标识
符资源信息。
智慧城市公共信息平台-平台接口与服务要求
10
6 业务接口 要求
6.1 6.1 基础接口 要求
6.1.1 目录服务初始化
公共信息目录服务初始化用于建立客户端与服务端的会话,所有其他服务都必须依赖会话。
会话的持续时间为30分钟,若会话持续30分钟没有活动,则会话自动终止。本次初始化


5



作用是客户端认证同时获取会话标识符,后续发起交易时需要传递该会话标识符。
1. 请求报文体 序号 元素名称 元素名称 约束 类型 长度 描述 取值说明 取值说明
1.
protocolVersion
protocolVersionprotocolVersionprotocolVersionprotocolVersionprotocolVersionprotocolVersion
protocolVersionprotocolVersionprotocolVersionprotocolVersion protocolVersion
可选
StringStringStringString String
50
客户端协议版本号
客户端协议实现的 客户端协议实现的 客户端协议实现的 客户端协议实现的 客户端协议
实现的 客户端协议实现的 客户端协议实现的 客户端协议实现的 版本号
2.
idAuthentication idAuthentication idAuthentication idAuthenticationidAuthentication
idAuthenticationidAuthenticationidAuthentication idAuthentication
必选
StringStringStringString String
50
用户名 用户名 用户名 密 码
认证信息。包含用户 认证信息。包含用户 认证信息。包含用户 认证信息。包含用户 认
证信息。包含用户 认证信息。包含用户 身份标识及其密码。 身份标识及其密码。 身份
标识及其密码。 身份标识及其密码。 身份标识及其密码。 格式“ 格式“ <用户名 用
户名 >< 密 码>”
3.
implementationId implementationId implementationId
implementationIdimplementationIdimplementationIdimplementationId implementationId
implementationId
可选
StringStringStringString String
50
应用标识 应用标识
在公共信息平台用 在公共信息平台用 在公共信息平台用 在公共信息平台用 在公共信息
平台用 在公共信息平台用 在公共信息平台用 在公共信息平台用 户体系中注册的第 户
体系中注册的第 户体系中注册的第 户体系中注册的第 户体系中注册的第 户体系中注册
的第 户体系中注册的第 户体系中注册的第 三方应用编号 三方应用编号 三方应用编号
4.
implementationame implementationame implementationame
implementationameimplementationameimplementationameimplementationame
implementationame implementationame
可选
StringStringStringString String
200200200
应用名称 应用名称
在公共信息平台用 在公共信息平台用 在公共信息平台用 在公共信息平台用 在公共信息
平台用 在公共信息平台用 在公共信息平台用 在公共信息平台用 户管系统中注册的 户


6



管系统中注册的 户管系统中注册的 户管系统中注册的 户管系统中注册的 户管系统中注
册的 户管系统中注册的 户管系统中注册的 第三方应用名称 第三方应用名称 第三方应
用名称
5.
otherInfootherInfootherInfo otherInfo otherInfootherInfo
可选
element element
其他信息 其他信息
备用
2. 请求报文体模板 V1.0
testApp12456< idAuthentication> 1<
implementationId > 测试应用

3. 响应报文体
智慧城市公共信息平台-平台接口与服务要求
11
序号 元素名称 元素名称 约束 类型 长度 描述 取值说明 取值说明
1.
referenceIdreferenceIdreferenceIdreferenceId referenceId
必选
StringStringStringString String
50
会话标识 会话标识
当验证成功时返回,否 当验证成功时返回,否 当验证成功时返回,否 当验证成功时返回,
否 当验证成功时返回,否 则设置为空 则设置为空
2.
protocolVersion
protocolVersionprotocolVersionprotocolVersionprotocolVersionprotocolVersionprotocolVersion
protocolVersionprotocolVersionprotocolVersionprotocolVersion protocolVersion
必选
StringStringStringString String
50
服务端协议版本号
服务端协议实现的版本 服务端协议实现的版本 服务端协议实现的版本 服务端协议实现
的版本 服务端协议实现的版本 服务端协议实现的版本 服务端协议实现的版本 服务端协
议实现的版本 服务端协议实现的版本 服务端协议实现的版本 号
3.
resultresult result
必选
Boolean Boolean
处理结果 处理结果
服务器端用该参数表明 服务器端用该参数表明 服务器端用该参数表明 服务器端用该参
数表明 服务器端用该参数表明 服务器端用该参数表明 服务器端用该参数表明 服务器端
用该参数表明 服务器端用该参数表明 服务器端用该参数表明 是否接受建立会话的请 是
否接受建立会话的请 是否接受建立会话的请 是否接受建立会话的请 是否接受建立会话


7



的请 是否接受建立会话的请 是否接受建立会话的请 是否接受建立会话的请 是否接受建
立会话的请 是否接受建立会话的请 求。 truetruetrue 表示建立会话 成功, falsefalse
falsefalse表示建立会 表示建立会 话失败,此时 话失败,此时 话失败,此时 话失败,
此时 referenceIdreferenceIdreferenceIdreferenceIdreferenceIdreferenceId 为空。
4.
pubKey pubKey pubKeypubKey
必选
StringStringStringString String
64
加解密公钥 加解密公钥
5.
otherInfootherInfootherInfo otherInfo otherInfootherInfo
可选
element element
其他信息 其他信息
备用
4. 响应报文体模板
cde2db52-8cee-45f4-9cec-f8a68ebbad5c
V1.0 catalog true
初始化服务成功
6.1.2 目录服务终止
公共信息目录服务终止将结束服务端与客户端的会话,与会话相关的资源将被释放。
1. 请求报文体 序号 元素名称 元素名称 约束 类型 长度 描述 取值说明 取值说明
1.
referenceIdreferenceIdreferenceIdreferenceId referenceId
必选
StringStringStringString String
50
会话标识 会话标识
要终止的会话编号 要终止的会话编号 要终止的会话编号 要终止的会话编号
2.
closeReason closeReasoncloseReasoncloseReason closeReason closeReasoncloseReason
可选
StringStringStringString String
50
终止原因 终止原因
3.
otherInfootherInfootherInfo otherInfo otherInfootherInfo
可选
element element
其他信息 其他信息
备用
2. 求报文体模板
cde2db52-8cee-45f4-9cec-f8a68ebbad5c
智慧城市公共信息平台-平台接口与服务要求


8



12
< closeReason >终止使用< closeReason >
6.1.3 认证授权
认证授权主要是公钥获取接口服务,用于根据客户端应用的请求,取出最新的加解密公钥
并返回给客户端的过程。
公钥获取与其他接口不同,不需要用户验证,不需要会话标识。调用客户端只有获取公钥
后对用户认证信息进行加密才能完成其服务调用。
整个密码加解密的处理过程如下图所示:
图2. .密码加解密的处理过程图
1. 请求报文体 序号 元素名称 元素名称 约束 类型 长度 描述 取值说明 取值说明
1.
otherInfootherInfootherInfo otherInfo otherInfootherInfo
可选
element element
其他信息
备用
2. 请求报文体模板
智慧城市公共信息平台-平台接口与服务要求
13
< pubKeyRequest >
3. 响应报文体 序号 元素名称 元素名称 约束 类型 长度 描述 取值说明 取值说明
1.
pubKey pubKey pubKeypubKey
必选
StringStringStringString String
8
公钥
用于加解密码的密钥
2.
opResultopResult opResult opResult
必选
element element
操作结果
参见《表 参见《表 参见《表 参见《表 A.6A.6A.6 opResultopResult opResult opResult 属
性表》之 属性表》之 属性表》之 说明
3.
otherInfootherInfootherInfo otherInfo otherInfootherInfo
可选
element element
其他信息
备用
4. 响应报文体模板 < pubkey>catalog< pubkey> <
opStatus>true< opStatus > < opRetCode >code< opRetCode > < opRetMsg >message<
opRetMsg > < opResult> < pubKeyRespe >
6.2 6.2 发现接口 要求


9



6.2.1 资源目录检索
公共信息目录检索是服务端根据客户端指定的检索条件,在服务器端从元数据库中检索并
标识出匹配的元数据记录,并将元数据记录保存在结果集中的过程。
结果集的保存时间与会话标识一致,当会话结束后,响应的结果集将被同步删除。
智慧城市公共信息平台-平台接口与服务要求
14
1. 请求报文体 序号 元素名称 元素名称 约束 类型 长度 描述 取值说明 取值说明
1.
referenceIdreferenceIdreferenceIdreferenceId referenceId
必选
StringStringStringString String
50
会话标识 会话标识
2.
replaceIndicatoreplaceIndicato replaceIndicato replaceIndicato replaceIndicato
replaceIndicatoreplaceIndicatoreplaceIndicator
必选
Boolean Boolean
结果集覆盖 结果集覆盖 结果集覆盖 结果集覆盖 结果集覆盖 标志
truetruetrue 表示覆盖原来的查 表示覆盖原来的查 表示覆盖原来的查 表示覆盖原来的查
表示覆盖原来的查 表示覆盖原来的查 表示覆盖原来的查 表示覆盖原来的查 询结果,
询结果, falsefalse falsefalse表示保留 表示保留 原来的查询结果 原来的查询结果 原来
的查询结果
3.
resultSetIDresultSetID resultSetID resultSetIDresultSetID resultSetID
必选
StringStringStringString String
200200200
指定的查询 指定的查询 指定的查询 指定的查询 指定的查询 结果集名称 结果集名称
若存在同名的结果集, 若存在同名的结果集, 若存在同名的结果集, 若存在同名的结果
集, 若存在同名的结果集, 需要根据 需要根据 replaceIndicatorreplaceIndicator
replaceIndicator replaceIndicator replaceIndicator
replaceIndicatorreplaceIndicatorreplaceIndicatorreplaceIndicator判断是 判断是 否需要覆盖
结果集。 否需要覆盖结果集。 否需要覆盖结果集。 否需要覆盖结果集。
4.
databaseame databaseamedatabaseame databaseame databaseame databaseame
databaseames
必选
Element Element Element
要查询的元 要查询的元 要查询的元 要查询的元 要查询的元 数据库名称 数据库名称
数据库名称 数据库名称 数据库名称 列表
客户端指定的要查询元数据库名称列表 元数据库名称列表 元数据库名称列表 元数据库
名称列表
5.
query query query


10



必选
Element Element Element
客户端定制 客户端定制 客户端定制 客户端定制 客户端定制 的检索语句 的检索语句
检索语句必须符合 检索语句必须符合 检索语句必须符合 检索语句必须符合 TypeType
-1型,使用逆波兰 型,使用逆波兰 型,使用逆波兰 型,使用逆波兰 表达式 (RP)(RP)
(RP) 作为检索语 作为检索语 作为检索语 法,参见《附录 法,参见《附录 法,参见
《附录 法,参见《附录 E QUERY QUERY QUERY-RP RP范例》 范例》
6.
preferredRecor preferredRecorpreferredRecorpreferredRecor preferredRecorpreferredRecor
preferredRecor preferredRecorpreferredRecordSyntax dSyntax dSyntaxdSyntaxdSyntax
可选
StringStringStringString String
10
检索结果的 检索结果的 检索结果的 检索结果的 检索结果的 编码方式 编码方式
固定取值 固定取值 :”XML” :”XML” :”XML” :”XML” :”XML”
7.
otherInfootherInfootherInfo otherInfo otherInfootherInfo
可选
Element Element Element
其他信息 其他信息
备用
2. 请求报文体模板
f4973365-a9be-4f80-b5d8-a8b9c7949185
true highResult
BMDB
XML 根据国标的逆波兰表达式
(RP)组合的查询条件„具体规则参考《附录 E QUERY E QUERYE QUERYE QUERY-RP
RP范例》 范例》
3. 响应报文体 序号 元素名称 元素名称 约束 类型 长度 描述 取值说明 取值说明
1.
referenceIdreferenceIdreferenceIdreferenceId referenceId
必选
StringStringStringString String
50
会话标识 会话标识
智慧城市公共信息平台-平台接口与服务要求
15
2.
resultCountresultCount resultCount resultCount resultCount resultCount
必选
umberString umberString
umberStringumberStringumberStringumberStringumberString umberString
20
符合条件 符合条件 符合条件 符合条件 的记录数 的记录数
服务器端执行检索操作得 服务器端执行检索操作得 服务器端执行检索操作得 服务器端


11



执行检索操作得 服务器端执行检索操作得 到的命中记录数,检索失败 到的命中记录数,
检索失败 到的命中记录数,检索失败 到的命中记录数,检索失败 到的命中记录数,检索
失败 到的命中记录数,检索失败 到的命中记录数,检索失败 设置为 设置为 0
3.
searchStatussearchStatus searchStatus
searchStatussearchStatussearchStatussearchStatussearchStatus
必选
StringStringStringString String
7
执行检索 执行检索 执行检索 执行检索 的执行结 的执行结 的执行结 的执行结 果
返回的检索状态信息, 返回的检索状态信息, 返回的检索状态信息, 返回的检索状态信
息, 返回的检索状态信息, successsuccess success success表示检索成功, 表示检索成功,
表示检索成功, failturefailture failture failture failture表示检索失败 表示检索失败 表示检
索失败 表示检索失败
4.
otherInfootherInfootherInfo otherInfo otherInfootherInfo
可选
element element
其他信息 其他信息
备用
4. 响应报文体模板
3720b175-7db7-408d-90cd-108e1f2ec887
9 success

6.2.2 资源目录检索结果提取
目录检索结果由服务器端从结果集中提取并返回若干数据记录给客户端。
1. 请求报文体 序号 元素名称 元素名称 约束 类型 长度 描述 取值说明 取值说明
1.
referenceIdreferenceIdreferenceIdreferenceId referenceId
必选
StringStringStringString String
50
会话标识 会话标识
2.
resultSetIDresultSetID resultSetID resultSetIDresultSetID resultSetID
必选
StringStringStringString String
要抽取的 要抽取的 要抽取的 要抽取的 结果集的 结果集的 结果集的 结果集的 标识
因为系统允许在抽取数据 因为系统允许在抽取数据 因为系统允许在抽取数据 因为系统
允许在抽取数据 因为系统允许在抽取数据 因为系统允许在抽取数据 因为系统允许在抽
取数据 前进行多次检 索,每前进行多次检 索,每前进行多次检 索,每前进行多次检
索,每前进行多次检 索,每前进行多次检 索,每前进行多次检 索,每索都可以指定不同
的结果 索都可以指定不同的结果 索都可以指定不同的结果 索都可以指定不同的结果 索
都可以指定不同的结果 索都可以指定不同的结果 索都可以指定不同的结果 集名称,所以
客户端必须 集名称,所以客户端必须 集名称,所以客户端必须 集名称,所以客户端必须


12



集名称,所以客户端必须 集名称,所以客户端必须 集名称,所以客户端必须 指定要抽取
的数据结果集 指定要抽取的数据结果集 指定要抽取的数据结果集 指定要抽取的数据结
果集 指定要抽取的数据结果集 指定要抽取的数据结果集 指定要抽取的数据结果集 标识
3.
resultSetStartPresultSetStartP resultSetStartP resultSetStartPresultSetStartP
resultSetStartPresultSetStartPresultSetStartP resultSetStartPointoint oint
必选
umberString umberString
umberStringumberStringumberStringumberStringumberString umberString
20
开始抽取 开始抽取 开始抽取 开始抽取 的位置
客户端指定的从第几条记 客户端指定的从第几条记 客户端指定的从第几条记 客户端指
定的从第几条记 客户端指定的从第几条记 客户端指定的从第几条记 客户端指定的从第
几条记 录开始抽取,序号从 录开始抽取,序号从 录开始抽取,序号从 录开始抽取,序
号从 1开 始
4.
numberOfReco numberOfReconumberOfReco numberOfReco numberOfReconumberOfReco
numberOfRecordsResquestedrdsResquested rdsResquestedrdsResquested rdsResquested
rdsResquestedrdsResquested
必选
umberString umberString
umberStringumberStringumberStringumberStringumberString umberString
20
记录数
客户端指定的要抽取记 客户端指定的要抽取记 客户端指定的要抽取记 客户端指定的要
抽取记 客户端指定的要抽取记 客户端指定的要抽取记 客户端指定的要抽取记 录数
5.
elementSeta elementSetaelementSetaelementSeta elementSeta me
必选
element element
结果集属 结果集属 结果集属 结果集属 性
参见表 《参见表 《A.3A.3 elementSetame elementSetame
elementSetameelementSetameelementSetame elementSetame elementSetame结果 集
属性》 集属性》
智慧城市公共信息平台-平台接口与服务要求
16
6.
preferredRecor preferredRecorpreferredRecorpreferredRecor preferredRecorpreferredRecor
preferredRecor preferredRecorpreferredRecordSyntax dSyntax dSyntaxdSyntaxdSyntax
可选
StringStringStringString String
10
提取结果 提取结果 提取结果 提取结果 的编码方 的编码方 的编码方 的编码方 式
固定取值 固定取值 :”XML” :”XML” :”XML” :”XML” :”XML”
7.


13



otherInfootherInfootherInfo otherInfo otherInfootherInfo
可选
element element
其他信息 其他信息
备用
2. 请求报文体模板
f4973365-a9be-4f80-b5d8-a8b9c7949185
highResult 0
30
brief
XML
3. 响应报文体 序号 元素名称 元素名称 约束 类型 长度 描述 取值说明 取值说明
1.
referenceIdreferenceIdreferenceIdreferenceId referenceId
必选
StringStringStringString String
50
会话标识 会话标识
2.
numberOfRecord numberOfRecordnumberOfRecord numberOfRecord
numberOfRecordnumberOfRecord
numberOfRecordnumberOfRecordnumberOfRecordsReturnedsReturnedsReturned sReturned
必选
umberString umberString
umberStringumberStringumberStringumberStringumberString umberString
20
元数 据元数 据元数 据元数 据目
服务器端返回的元数 服务器端返回的元数 服务器端返回的元数 服务器端返回的元数 据
数目
3.
presentStatus presentStatus
presentStatuspresentStatuspresentStatuspresentStatuspresentStatuspresentStatus
必选
StringStringStringString String
7
提取状态 提取状态
服务器端返回的提取 服务器端返回的提取 服务器端返回的提取 服务器端返回的提取 状
态。 successsuccess successsuccess 表示提 表示提 取成功, 取成功, failturefailture failture
failture failture表示提 表示提 取失败
4.
recordsrecords recordsrecordsrecords
必选
element element
结果集
服务器返回的结果集 服务器返回的结果集 服务器返回的结果集 服务器返回的结果集 ,


14



包含一个 或多包含一个 或多包含一个 或多singleRecordsingleRecord
singleRecordsingleRecord singleRecord singleRecordsingleRecordsingleRecord,详细描述 ,
详细描述 ,详细描述 ,详细描述 参见《表 参见《表 A. 5 singleRecordsingleRecord
singleRecordsingleRecord singleRecord singleRecordsingleRecordsingleRecord参数表》 参数
表》 参数表》
5.
otherInfootherInfootherInfo otherInfo otherInfootherInfo
可选
element element
其他信息 其他信息
备用
4. 响应报文体模板
f4973365-a9be-4f80-b5d8-a8b9c7949185
9
success 结构化资源目录 结构化资源目录 结构化
资源目录 结构化资源目录 非结构化资源目录 非结构化资源目录 非结构化资源目录 非
结构化资源目录
智慧城市公共信息平台-平台接口与服务要求
17

6.3 6.3 资源服务接口 资源服务接口 资源服务接口 资源服务接口 资源服务接口 要求
6.3.1 资源内容检索
资源检索是公共信息平台服务端根据客户端发送的请求信息,从共享数据库中读取符合条
件的记录,并将查询结果集相关返回的过程。注意,资源检索功能并不返回具体的结果集,
结果集返回功能将由”资源检索结果提取”服务提供。
结果集的保存时间与会话标识一致,当会话结束后,响应的结果集将被同步删除。
1. 请求报文体 序号 元素名称 元素名称 约束 类型 长度 描述 取值说明 取值说明
1.
referenceIdreferenceIdreferenceIdreferenceId referenceId
必选
StringStringStringString String
50
会话标识 会话标识
2.
resIdresId resId
必选
StringStringStringString String
50
资源标识符 资源标识符
6位字母 位字母 数字加 数字加 ”” 加 1到 23 位数字 位数字
3.
replaceIndicatorreplaceIndicator replaceIndicator replaceIndicator replaceIndicator
replaceIndicatorreplaceIndicatorreplaceIndicatorreplaceIndicator
必选
Boolean Boolean


15



结果集覆盖 结果集覆盖 结果集覆盖 结果集覆盖 标志
truetruetrue 表示覆盖原来的查询 表示覆盖原来的查询 表示覆盖原来的查询 表示覆盖原
来的查询 表示覆盖原来的查询 结果, falsefalse falsefalse表示保留原来 表示保留原来
表示保留原来 表示保留原来 的查询结果 的查询结果
4.
resultSetIDresultSetID resultSetID resultSetIDresultSetID resultSetID
必选
StringStringStringString String
200200200
指定的查询 指定的查询 指定的查询 指定的查询 结果集名称 结果集名称
若存在同名的结果集,需 若存在同名的结果集,需 若存在同名的结果集,需 若存在同名
的结果集,需 若存在同名的结果集,需 若存在同名的结果集,需 若存在同名的结果集,
需 要根据 要根据 replaceIndicatorreplaceIndicator replaceIndicator replaceIndicator
replaceIndicator replaceIndicatorreplaceIndicatorreplaceIndicatorreplaceIndicator判 断是否需
要覆盖结果集。 断是否需要覆盖结果集。 断是否需要覆盖结果集。 断是否需要覆盖结果
集。 断是否需要覆盖结果集。
5.
dataQuery dataQuerydataQuery dataQuery dataQuery
必选
element element
客户端定制 客户端定制 客户端定制 客户端定制 的检索条件 的检索条件
参见《附录 参见《附录 参见《附录 C QUERY QUERY QUERY-RES
RES-DATADATADATADATA说明》 说明》 – dataQuery dataQuerydataQuery dataQuery
dataQuery属性说明 属性说明 属性说明
6.
preferredRecord preferredRecordpreferredRecordpreferredRecord
preferredRecordpreferredRecord preferredRecord
preferredRecordpreferredRecordpreferredRecordSyntaxSyntax SyntaxSyntaxSyntax
可选
StringStringStringString String
10
检索结果的 检索结果的 检索结果的 检索结果的 编码方式 编码方式
固定取值 固定取值 :”XML” :”XML” :”XML” :”XML” :”XML”
7.
otherInfootherInfootherInfo otherInfo otherInfootherInfo
可选
element element
其他信息 其他信息
备用
2. 请求报文体模板
d8137d81-ef76-4dc5-80c7-01dc493f9d3f
GXWgxwAA000 GXWgxwAA000
true
智慧城市公共信息平台-平台接口与服务要求
18


16



XML 取值参考dataQuery属
性说明
3. 响应报文体 序号 元素名称 元素名称 约束 类型 长度 描述 取值说明 取值说明
1.
referenceIdreferenceIdreferenceIdreferenceId referenceId
必选
StringStringStringString String
50
会话标 会话标 会话标 识
2.
resultCountresultCount resultCount resultCount resultCount resultCount
必选
umberString umberString
umberStringumberStringumberStringumberStringumberString umberString
20
符合条 符合条 符合条 件的记 件的记 件的记 录数
服务器端执行检索操 服务器端执行检索操 服务器端执行检索操 服务器端执行检索操 作
得到的命中记录 作得到的命中记录 作得到的命中记录 作得到的命中记录 数,检索失败
设置为 数,检索失败设置为 数,检索失败设置为 数,检索失败设置为 0
3.
searchStatussearchStatus searchStatus
searchStatussearchStatussearchStatussearchStatussearchStatus
必选
StringStringStringString String
7
执行检 执行检 执行检 索的执 索的执 索的执 行结果
返回的检索状态信 返回的检索状态信 返回的检索状态信 返回的检索状态信 息,
successsuccess successsuccess 表示检索 表示检索 成功, failturefailture failture failture
failture表示检 表示检 索失败
4.
opResultopResult opResult opResult
可选
element element
操作信 操作信 操作信 息
详情参见附录 详情参见附录 详情参见附录 详情参见附录 详情参见附录 详情参见附录
表 A.4 -opResultopResult opResult opResult 属性表 属性表
5.
otherInfootherInfootherInfo otherInfo otherInfootherInfo
可选
element element
其他信 其他信 其他信 息
备用
4. 响应报文体模板
d8137d81-ef76-4dc5-80c7-01dc493f9d3f
0 failure


17



failure 错误代码 错误信息

6.3.2 资源内容检索结果提取
资源检索结果提取用于从<资源检索>所得的结果集中提取指定的结果。
1. 请求报文体
智慧城市公共信息平台-平台接口与服务要求
19
序号 元素名称 元素名称 约束 类型 长度 描述 取值说明 取值说明
1.
referenceIdreferenceIdreferenceIdreferenceId referenceId
必选
StringStringStringString String
50
会话标识 会话标识
2.
resultSetIDresultSetID resultSetID resultSetIDresultSetID resultSetID
必选
StringStringStringString String
要抽取的 要抽取的 要抽取的 要抽取的 结果集的 结果集的 结果集的 结果集的 标识
因为系统允许在抽 因为系统允许在抽 因为系统允许在抽 因为系统允许在抽 因为系统允
许在抽 因为系统允许在抽 因为系统允许在抽 因为系统允许在抽 取数据前进行多次 取
数据前进行多次 取数据前进行多次 取数据前进行多次 取数据前进行多次 取数据前进行
多次 取数据前进行多次 取数据前进行多次 检索,每次都 检索,每次都 检索,每次都
检索,每次都 检索,每次都 检索,每次都 检索,每次都 检索,每次都 可以指定不同的
结 可以指定不同的结 可以指定不同的结 可以指定不同的结 可以指定不同的结 可以指
定不同的结 可以指定不同的结 可以指定不同的结 果集名称,所以客 果集名称,所以客
果集名称,所以客 果集名称,所以客 果集名称,所以客 果集名称,所以客 果集名称,
所以客 果集名称,所以客 户端必须指定要抽 户端必须指定要抽 户端必须指定要抽 户端
必须指定要抽 户端必须指定要抽 户端必须指定要抽 户端必须指定要抽 户端必须指定要
抽 取的数据结果集标 取的数据结果集标 取的数据结果集标 取的数据结果集标 取的数
据结果集标 取的数据结果集标 取的数据结果集标 取的数据结果集标 识
3.
resultSetStartPointresultSetStartPoint resultSetStartPoint resultSetStartPointresultSetStartPoint
resultSetStartPointresultSetStartPointresultSetStartPoint
resultSetStartPointresultSetStartPointresultSetStartPoint resultSetStartPoint
必选
umberString umberString
umberStringumberStringumberStringumberStringumberString umberString
20
开始抽取 开始抽取 开始抽取 开始抽取 的位置
客户端指定的从第 客户端指定的从第 客户端指定的从第 客户端指定的从第 客户端指定
的从第 客户端指定的从第 客户端指定的从第 客户端指定的从第 几条记录开始抽 几条
记录开始抽 几条记录开始抽 几条记录开始抽 几条记录开始抽 几条记录开始抽 几条记
录开始抽 取,序号从 取,序号从 取,序号从 1开始
4.


18



numberOfRecordsRe numberOfRecordsRenumberOfRecordsRe numberOfRecordsRe
numberOfRecordsRenumberOfRecordsRe
numberOfRecordsRenumberOfRecordsRenumberOfRecordsRe
numberOfRecordsRenumberOfRecordsResquestedsquested squested squestedsquested
必选
umberString umberString
umberStringumberStringumberStringumberStringumberString umberString
20
记录数
客户端指定的要抽 客户端指定的要抽 客户端指定的要抽 客户端指定的要抽 客户端指定
的要抽 客户端指定的要抽 客户端指定的要抽 客户端指定的要抽 取的记录数 取的记录

5.
numberOfRecordsTo numberOfRecordsTonumberOfRecordsTo numberOfRecordsTo
numberOfRecordsTonumberOfRecordsTo
numberOfRecordsTonumberOfRecordsTonumberOfRecordsTo
numberOfRecordsTonumberOfRecordsTotaltal
必选
umberString umberString
umberStringumberStringumberStringumberStringumberString umberString
20
符合条件 符合条件 符合条件 符合条件 的总共命 的总共命 的总共命 的总共命 中记录
数 中记录数
资源检索接口查询 资源检索接口查询 资源检索接口查询 资源检索接口查询 资源检索接
口查询 资源检索接口查询 资源检索接口查询 资源检索接口查询 得到的总共命中记 得
到的总共命中记 得到的总共命中记 得到的总共命中记 得到的总共命中记 得到的总共命
中记 得到的总共命中记 得到的总共命中记 录数。
6.
preferredRecordSynt preferredRecordSyntpreferredRecordSyntpreferredRecordSynt
preferredRecordSyntpreferredRecordSynt preferredRecordSynt
preferredRecordSyntpreferredRecordSyntpreferredRecordSynt preferredRecordSynt
preferredRecordSyntax
可选
StringStringStringString String
10
提取结果 提取结果 提取结果 提取结果 的编码方 的编码方 的编码方 的编码方 式
固定取值 固定取值 :”XML” :”XML” :”XML” :”XML” :”XML”
7.
otherInfootherInfootherInfo otherInfo otherInfootherInfo
可选
element element
其他信息 其他信息
备用
2. 请求报文体模板
2190bf83-a934-4f4d-995c-f688dc4808ae


19



JTJQDJTJ00000 1
30
3
XML
3. 响应报文体 序号 元素名称 元素名称 约束 类型 长度 描述 取值说明 取值说明
1.
referenceIdreferenceIdreferenceIdreferenceId referenceId
必选
StringStringStringString String
50
会话标识 会话标识
2.
numberOfReco numberOfReconumberOfReco numberOfReco numberOfReconumberOfReco
numberOfRecordsReturnedrdsReturned rdsReturnedrdsReturned
rdsReturnedrdsReturnedrdsReturned
必选
umberString umberString
umberStringumberStringumberStringumberStringumberString umberString
20
元数 据元数 据元数 据元数 据目
服务器端返回的元数 据服务器端返回的元数 据服务器端返回的元数 据服务器端返回的
元数 据服务器端返回的元数 据目
智慧城市公共信息平台-平台接口与服务要求
20
3.
presentStatus presentStatus
presentStatuspresentStatuspresentStatuspresentStatuspresentStatuspresentStatus
必选
StringStringStringString String
7
提取状态 提取状态
服务器端返回的提取状 服务器端返回的提取状 服务器端返回的提取状 服务器端返回的
提取状 服务器端返回的提取状 态。 successsuccess success success表示提取成 表示提取
成 表示提取成 功, failturefailture failture failture failture表示提取失败 表示提取失败 表
示提取失败 表示提取失败
4.
resTyperesType resType
必选
StringStringStringString String
50
资源种类 资源种类
结构化资 源或非结构化资 源或非结构化资 源或非结构化资 源或非结构化资 源或非源,
不同的资种类对应 源,不同的资种类对应 源,不同的资种类对应 源,不同的资种类对应
源,不同的资种类对应 的 singleRecordsingleRecord singleRecordsingleRecord singleRecord
singleRecordsingleRecordsingleRecord中 Item Item 项 不同


20



5.
recordsrecords recordsrecordsrecords
必选
element element
结果集
服务器返回的结果集 服务器返回的结果集 服务器返回的结果集 服务器返回的结果集 ,
包 含一个 或多含一个 或多含一个 或多singleRecordsingleRecord
singleRecordsingleRecord singleRecord singleRecordsingleRecordsingleRecord,详细描述参 ,
详细描述参 ,详细描述参 ,详细描述参 见《 B.2 B.2资源检索结果提取 资源检索结果
提取 资源检索结果提取 资源检索结果提取 资源检索结果提取 结构 》
6.
otherInfootherInfootherInfo otherInfo otherInfootherInfo
可选
element element
其他信息 其他信息
备用
4. 响应报文体模板
687d0aed-6e43-44eb-9d0e-e25eeca83470
3 s
结构化资源 „.(具体结构参
照)
6.4 6.4 管理接口 要求
6.4.1 目录资源元数据管理
目录资源元数据管理接口包含元数据的新增、删除和更新操作,根据不同的操作类型来完
成相应的动作,且元数据管理接口一次只操作一种操作类型的一条元数据记录。
当操作类型为更新时其操作对象为通过“目录检索结果提取”接口返回的元数据,元数据
元素必须符合《核心元数据属性集》要求;
当操作类型为删除时,其操作对象为通过“目录检索结果提取”接口返回的元数据中的特
定一条记录;
智慧城市公共信息平台-平台接口与服务要求
21
当操作类型为创建时,请求方必须按附录B约定的编目要求提供完整的元数据信息。
1. 请求报文 序号 元素名称 元素名称 约束 类型 长度 描述 取值说明 取值说明
1
referenceIreferenceIreferenceIreferenceI referenceI d
必选
StringStringStringString String
50
会话标识 会话标识
2
typetype
必选
Int Int
用于指定进行元数据 用于指定进行元数据 用于指定进行元数据 用于指定进行元数据 用
于指定进行元数据 用于指定进行元数据 用于指定进行元数据 用于指定进行元数据 用于


21



指定进行元数据 的各种管理操作,详细 的各种管理操作,详细 的各种管理操作,详细
的各种管理操作,详细 内容见表 内容见表 内容见表 内容见表 A.6A.6 《元数 据管理类
型定义》 据管理类型定义》 据管理类型定义》 据管理类型定义》
3
recordIdrecordId recordIdrecordIdrecordId recordId
可选
StringStringStringString String
待删除或更新的元数据标识符 (即资 源标识符 )。该标识 符用于在元数据库中指定唯一
的元数据。可以通过目录检索结果提取接口获取其响应消息。 获取其响应消息。 获取其
响应消息。 获取其响应消息。
当 typetype 为 1时,进行 时,进行 元数据插入操作,本参 元数据插入操作,本参 元
数据插入操作,本参 元数据插入操作,本参 数不出现;当 数不出现;当 数不出现;当
typetype type为 2或 3时,进行元数据 时,进行元数据 时,进行元数据 时,进行元数
据 删除或更新操作,本参 删除或更新操作,本参 删除或更新操作,本参 删除或更新操
作,本参 数 为必选参数 为必选参数
为必选参4
Data DataData
可选
XMLXML
待创建或更新的元数据内容,当 数据内容,当 数据内容,当 数据内容,当 数据内容,
当 数据内容,当 typetype 为 1或 3时,进行 时,进行 元数据插入或更新操作,本参数
为必选参数;当 选参数;当 typetype 为 2时,进行元数据删 时,进行元数据删 时,进
行元数据删 时,进行元数据删 除操作,本参数不出现
更新操作时, 更新操作时, 更新操作时, 更新操作时, 更新操作时, 更新操作时,
Data DataData格 式定义为 式定义为 :


me>


, , ,,, ,
RecordsRecords RecordsRecordsRecords 节点包含一组 节点包含一组 节点包含一组 或多
组元数据属性参 或多组元数据属性参 或多组元数据属性参 或多组元数据属性参 或多组
元数据属性参 或多组元数据属性参 或多组元数据属性参 或多组元数据属性参 或多组元
数据属性参 数 itemame itemame itemame和元数 据属性值参数 据属性值参数 据属
性值参数 据属性值参数 据属性值参数 据属性值参数 itemValue itemValue itemValue
itemValue 。itemame itemame itemame itemame取值要求符合《表 取值要求符合《表
取值要求符合《表 核 心元数据属性集》之约 心元数据属性集》之约 心元数据属性集》
之约 心元数据属性集》之约 定
智慧城市公共信息平台-平台接口与服务要求
22
5


22



otherInfootherInfootherInfo otherInfo otherInfootherInfo
可选
StringStringStringString String
其他信息 其他信息
备用
2. 返回报文 序号 元素名称 元素名称 约束 类型 长度 描述 取值说明 取值说明
1.
referenceIdreferenceIdreferenceIdreferenceId referenceId
必选
StringStringStringString String
50
会话标识 会话标识
2.
operationStateoperationState operationStateoperationStateoperationState operationState
operationStateoperationStateoperationStateoperationState
必选
StringStringStringString String
7
执行结果 执行结果
SuccessSuccess Success Success表示执行元数据管理操 表示执行元数据管理操 表示执行
元数据管理操 表示执行元数据管理操 表示执行元数据管理操 作成功; 作成功;
FailtureFailture Failture Failture Failture表示执行元数据管理操 表示执行元数据管理操 表
示执行元数据管理操 表示执行元数据管理操 表示执行元数据管理操 表示执行元数据管
理操 作失败
3.
operationTypeoperationType operationTypeoperationTypeoperationType operationType
operationType
可选
Int Int
操作类型 操作类型
用来表示服务器端执行的元数 用来表示服务器端执行的元数 用来表示服务器端执行的元
数 用来表示服务器端执行的元数 用来表示服务器端执行的元数 用来表示服务器端执行
的元数 据管理操作类型,必须符合《表 据管理操作类型,必须符合《表 据管理操作类型,
必须符合《表 据管理操作类型,必须符合《表 据管理操作类型,必须符合《表 据管理操
作类型,必须符合《表 据管理操作类型,必须符合《表 据管理操作类型,必须符合《表
据管理操作类型,必须符合《表 元数据管理类型定 义》之约元数据管理类型定 义》之约
元数据管理类型定 义》之约元数据管理类型定 义》之约元数据管理类型定 义》之约元数
据管理类型定
义》之约4.
otherInfootherInfootherInfo otherInfo otherInfootherInfo
可选
element element
其他信息 其他信息
当 执行成功时本元素不出现,当 执行成功时本元素不出现,当 执行成功时本元素不出现,
当 执行成功时本元素不出现,当 执行成功时本元素不出现,当 执行成功时本元素不出现,


23



当 执行成功时本元素不出现,执行失败时,格式定为: 执行失败时,格式定为: 执行失
败时,格式定为: 执行失败时,格式定为: 执行失败时,格式定为: 执行失败时,格式
定为: 执行失败时,格式定为: 执行失败时,格式定为: 执行失败时,格式定为: 执
行失败时,格式定为: 执行失败时,格式定为:





,errcode
errcodeerrcodeerrcodeerrcode 表 示错误码, 示错误码, 示错误码,
errMsgerrMsgerrMsgerrMsg errMsg表示错误信息 表示错误信息 表示错误信息
智慧城市公共信息平台-平台接口与服务要求
23
附录 A 要求 所涉及的结构表
表 A.1 databaseListdatabaseList databaseList databaseList 组成 参数名称 约束 参数含义
databaseId databaseIddatabaseId databaseId databaseId
必选
标识一个元数据库,以公共信息平台的应用 标识一个元数据库,以公共信息平台的应用
标识一个元数据库,以公共信息平台的应用 标识一个元数据库,以公共信息平台的应用
标识一个元数据库,以公共信息平台的应用 标识一个元数据库,以公共信息平台的应用
标识一个元数据库,以公共信息平台的应用 标识一个元数据库,以公共信息平台的应用
标识一个元数据库,以公共信息平台的应用 单位 编号代替 编号代替
databaseame databaseamedatabaseame databaseame databaseame databaseame
databaseame
必选
元数据库名称 元数据库名称 元数据库名称
databaseDescribe databaseDescribedatabaseDescribe databaseDescribe databaseDescribe
databaseDescribedatabaseDescribe databaseDescribe
必选
元数据库的基本描述信息 元数据库的基本描述信息 元数据库的基本描述信息 元数据库
的基本描述信息 元数据库的基本描述信息
表 A.2 A.2 服务功能列表 功能标识 交易编码 (transid)(transid)(transid)(transid)(transid)
(transid)(transid) 国标要求 是否支持 含义
init
initRequest initRequest initRequestinitRequest initRequest


用于建立客户端与服务 用于建立客户端与服务 用于建立客户端与服务 用于建立客户端
与服务 用于建立客户端与服务 用于建立客户端与服务 用于建立客户端与服务 用于建立
客户端与服务 用于建立客户端与服务 用于建立客户端与服务 端的会话 端的会话
close closecloseclose
closeRequest closeRequestcloseRequestcloseRequest closeRequest closeRequest




24



终止客户端与服务的 终止客户端与服务的 终止客户端与服务的 终止客户端与服务的 终
止客户端与服务的 终止客户端与服务的 终止客户端与服务的 终止客户端与服务的 终止
客户端与服务的 终止客户端与服务的 会话
capbilitiescapbilities capbilities capbilities capbilitiescapbilities
catalogCapabilitiesRequecatalogCapabilitiesRequecatalogCapabilitiesRequecatalogCapabilitiesR
eque catalogCapabilitiesRequecatalogCapabilitiesRequecatalogCapabilitiesReque
catalogCapabilitiesReque catalogCapabilitiesReque
catalogCapabilitiesRequecatalogCapabilitiesReque
catalogCapabilitiesRequecatalogCapabilitiesReque st


提供服务本身的各种描 提供服务本身的各种描 提供服务本身的各种描 提供服务本身的
各种描 提供服务本身的各种描 提供服务本身的各种描 提供服务本身的各种描 提供服务
本身的各种描 提供服务本身的各种描 提供服务本身的各种描 述信息
searchsearch search
searchRequestsearchRequest searchRequest searchRequestsearchRequest searchRequest


检索目录信息并形成结 检索目录信息并形成结 检索目录信息并形成结 检索目录信息并
形成结 检索目录信息并形成结 检索目录信息并形成结 检索目录信息并形成结 检索目录
信息并形成结 检索目录信息并形成结 检索目录信息并形成结 果集
present present present
presentRequest presentRequest presentRequestpresentRequestpresentRequest presentRequest
presentRequest


目录检索结果提取 ,从 结果 集中提取结果 集中提取结果 集中提取结果
集中提取metadataManagmetadataManag metadataManag
metadataManagmetadataManagmetadataManag metadataManag metadataManag er


对公共信息平台进行远 对公共信息平台进行远 对公共信息平台进行远 对公共信息平台
进行远 对公共信息平台进行远 对公共信息平台进行远 对公共信息平台进行远 对公共信
息平台进行远 对公共信息平台进行远 对公共信息平台进行远 程管理
resSelfDescresSelfDesc resSelfDesc resSelfDesc resSelfDesc
resSelfDescRequestresSelfDescRequest resSelfDescRequest resSelfDescRequest
resSelfDescRequest resSelfDescRequest resSelfDescRequest resSelfDescRequest


资源自描述 资源自描述
dataSearch dataSearchdataSearch dataSearch dataSearch
dataSearchRequest dataSearchRequestdataSearchRequest dataSearchRequest dataSearchRequest
dataSearchRequestdataSearchRequest dataSearchRequest dataSearchRequest




25



检索资源 检索资源
dataPresent dataPresentdataPresent dataPresentdataPresent dataPresent
dataPresentRequest dataPresentRequestdataPresentRequest
dataPresentRequestdataPresentRequest
dataPresentRequestdataPresentRequestdataPresentRequest dataPresentRequest


从检索出的资源结果集 从检索出的资源结果集 从检索出的资源结果集 从检索出的资源
结果集 从检索出的资源结果集 从检索出的资源结果集 从检索出的资源结果集 从检索出
的资源结果集 从检索出的资源结果集 从检索出的资源结果集 中抽取数据 中抽取数据
pubKey pubKey pubKeypubKey
pubKeyRequest pubKeyRequest pubKeyRequestpubKeyRequest pubKeyRequest
pubKeyRequest pubKeyRequest


用于从服务端获取公钥 用于从服务端获取公钥 用于从服务端获取公钥 用于从服务端获
取公钥 用于从服务端获取公钥
智慧城市公共信息平台-平台接口与服务要求
24
表 A. 3 elementSetame elementSetame elementSetameelementSetame elementSetame
elementSetame 结果集属性 结果集属性 结果集属性 结果集属性 结果集属性 参数名称
参数类型 取值 参数含义
genericElementgenericElement genericElement genericElement genericElement
genericElement-SetameSetame Setame Setame
StringStringStringString String
Brief Brief Brief
提取信息资源核心 提取信息资源核心 提取信息资源核心 提取信息资源核心 提取信息资
源核心 提取信息资源核心 提取信息资源核心 提取信息资源核心 元数据
genericElementgenericElement genericElement genericElement genericElement
genericElement-SetameSetame Setame Setame
StringStringStringString String
FullFull Full或空
提取全部的信息资 提取全部的信息资 提取全部的信息资 提取全部的信息资 提取全部的
信息资 提取全部的信息资 提取全部的信息资 提取全部的信息资 源元数据 源元数据
elementSet elementSetelementSetelementSet
List ListList ListList ListList
元数据属性字段标 元数据属性字段标 元数据属性字段标 元数据属性字段标 元数据属性
字段标 元数据属性字段标 元数据属性字段标 元数据属性字段标 识符列表 识符列表
必须符合《表 必须符合《表 必须符合《表 必须符合《表 核心 元数据属性集》的 元数
据属性集》的 元数据属性集》的 元数据属性集》的 元数据属性集》的 元数据属性集》
的 元数据属性集》的 元数据属性集》的 编码要求 编码要求
表 A. 4 opResult opResult opResult 属性表 属性名 类型 长度 约束 参数含义
opStatusopStatus opStatusopStatusopStatusopStatus
StringStringStringString String
8


26



必选
执行结果, 执行结果, 执行结果, 执行结果, 执行结果, ”success” ”success” ”
success” ”success” ”success” ”success” 表示成功 表示成功 表示成功 表示成功 ,”
failture” ,”failture” ,”failture” ,”failture” ,”failture” ,”failture” ,”failture” 表
示失败 表示失败
opRetCodeopRetCode opRetCode opRetCode opRetCode
StringStringStringString String
8
可选
执行结果, 执行结果, 执行结果, 执行结果, 执行结果, ”00000000” ”00000000” ”
00000000” ”00000000” ”00000000” ”00000000” ”00000000” ”00000000” ”
00000000” 表示成功 表示成功 表示成功 表示成功 ,其他表 其他表 其他表 示错误代码
示错误代码
opRetMsgopRetMsg opRetMsg opRetMsg opRetMsg
StringStringStringString String
200200200
可选
错误的说明 错误的说明
表 A. 5 singleRecord singleRecordsingleRecord singleRecordsingleRecord singleRecord参数表
参数名称 参数类型 约束 参数含义
item item
element element
必选
结果集中的元数据 记录,包含一组或多结果集中的元数据 记录,包含一组或多结果集中
的元数据 记录,包含一组或多结果集中的元数据 记录,包含一组或多结果集中的元数据
记录,包含一组或多结果集中的元数据 记录,包含一组或多结果集中的元数据 记录,包
含一组或多结果集中的元数据 记录,包含一组或多结果集中的元数据 记录,包含一组或
多结果集中的元数据 记录,包含一组或多属性参数 属性参数 属性参数 属性参数
itemame itemame itemame itemame和元数 据属性值参和元数 据属性值参和元数
据属性值参和元数 据属性值参和元数 据属性值参和元数 据属性值参和元数 据属性值参
和元数 据属性值参和元数 据属性值参itemValue itemValue itemValue itemValue 。提取的
结果集是核心元数 据时,参。提取的结果集是核心元数 据时,参。提取的结果集是核心
元数 据时,参。提取的结果集是核心元数 据时,参。提取的结果集是核心元数 据时,参。
提取的结果集是核心元数 据时,参。提取的结果集是核心元数 据时,参。提取的结果集
是核心元数 据时,参。提取的结果集是核心元数 据时,参。提取的结果集是核心元数
据时,参itemame itemame itemame取值要求符合《表 取值要求符合《表 取值要求符
合《表 取值要求符合《表 取值要求符合《表 取值要求符合《表 取值要求符合《表 取值
要求符合《表 核心元数据属性 核心元数据属性 核心元数据属性 核心元数据属性 核心元
数据属性 核心元数据属性 核心元数据属性 集》
databaseId databaseIddatabaseId databaseId databaseId
StringStringStringString String
可选
提取全部的信息资源元数据 提取全部的信息资源元数据 提取全部的信息资源元数据 提
取全部的信息资源元数据 提取全部的信息资源元数据 提取全部的信息资源元数据
recordIdrecordId recordIdrecordIdrecordId recordId


27



StringStringStringString String
可选
必须符合表的编码要求 必须符合表的编码要求 必须符合表的编码要求 必须符合表的编
码要求 必须符合表的编码要求 (即资源标识符 即资源标识符 即资源标识符 )
表 A. 6 元数据管理类型定义 名称 取值 含义
智慧城市公共信息平台-平台接口与服务要求
25
创建元数据 创建元数据
1
用于表示该次请求是进行创建元数据操作 用于表示该次请求是进行创建元数据操作 用于
表示该次请求是进行创建元数据操作 用于表示该次请求是进行创建元数据操作 用于表示
该次请求是进行创建元数据操作 用于表示该次请求是进行创建元数据操作 用于表示该次
请求是进行创建元数据操作 用于表示该次请求是进行创建元数据操作
删除元数据 删除元数据
2
用于表示该次请求是进行删除元数据操作 用于表示该次请求是进行删除元数据操作 用于
表示该次请求是进行删除元数据操作 用于表示该次请求是进行删除元数据操作 用于表示
该次请求是进行删除元数据操作 用于表示该次请求是进行删除元数据操作 用于表示该次
请求是进行删除元数据操作 用于表示该次请求是进行删除元数据操作
更新元数据 更新元数据
3
用于表示该次请求是进行更新元数据操作 用于表示该次请求是进行更新元数据操作 用于
表示该次请求是进行更新元数据操作 用于表示该次请求是进行更新元数据操作 用于表示
该次请求是进行更新元数据操作 用于表示该次请求是进行更新元数据操作 用于表示该次
请求是进行更新元数据操作 用于表示该次请求是进行更新元数据操作
表 A. 7 核心元数据属性集
核心元数据属性集的编码规则如下:
第一层代码只有一位阿拉伯数字。其取值为“1”,表示核心元数据。
第二层是核心元数据元素和元数据实体,采用三位阿拉伯数字。该编码结构分为二层:第
一层采用一位阿拉伯数字,核心元数据取值为1;第二层代码采用三位阿拉伯数字,利用
递增顺序码的方法进行编码。例如,“资源名称”的编码为“1.001”,“资源出版日期”的
编码为“1.002”。
第三层是元数据实体所包含的元数据元素,采用五位阿拉伯数字。该编码结构分为三层:
第一层采用一位阿拉伯数字,核心元数据取值为1;第二层代码采用三位阿拉伯数字,利
用递增顺序码的方法进行编码,为该元数据元素所属元数据实体的编码;第三层代码采用
两位阿拉伯数字,利用递增顺序码的方法进行编码。例如,“资源负责单位”的编码为
“1.004.01”。如图A.1所示:
图A.1 核心元数据属性集的编码规则示意图
下面是相应的核心元数据属性集:
编码
中文名称
短名
1.0001.0001.0001.0001.000
资源核心元数据全文 资源核心元数据全文 资源核心元数据全文 资源核心元数据全文
resMetadataresMetadata resMetadata resMetadata resMetadataresMetadataresMetadata


28



1.0011.0011.0011.0011.001
资源名称 资源名称
resTitleresTitle resTitleresTitle
1.0021.0021.0021.0021.002
资源出版日期 资源出版日期 资源出版日期
pubCate pubCate pubCatepubCate
1.0031.0031.0031.0031.003
资源摘要 资源摘要
abstract abstractabstractabstractabstract abstract
智慧城市公共信息平台-平台接口与服务要求
26
1.0041.0041.0041.0041.004
资源负责方 资源负责方
IdPoC IdPoCIdPoCIdPoC
1.004.011.004.011.004.011.004.011.004.011.004.011.004.011.004.01
资源负责单位 资源负责单位 资源负责单位
rpOrgamerpOrgame rpOrgamerpOrgamerpOrgame rpOrgame
1.004.021.004.021.004.021.004.021.004.021.004.021.004.021.004.02
资源负责方地址 资源负责方地址 资源负责方地址
cntAdd cntAddcntAdd
1.004.031.004.031.004.031.004.031.004.031.004.031.004.031.004.03
资源负责方地址 资源负责方地址 资源负责方地址 资源负责
方地址 资源负责方地址
eMailAdd eMailAdd eMailAdd
1.0051.0051.0051.0051.005
资源格式信息 资源格式信息 资源格式信息
FmInfoFmInfoFmInfo FmInfoFmInfo
1.005.011.005.011.005.011.005.011.005.011.005.011.005.011.005.01
资源格式名称 资源格式名称 资源格式名称
fmame fmame
1.005.021.005.021.005.021.005.021.005.021.005.021.005.021.005.02
资源格式版本 资源格式版本 资源格式版本
fmVer fmVer
1.0061.0061.0061.0061.006
关键字说明 关键字说明
DescKeys DescKeys DescKeysDescKeysDescKeys
1.006.011.006.011.006.011.006.011.006.011.006.011.006.011.006.01
关键字
keywordkeywordkeyword keywordkeywordkeyword
1.006.021.006.021.006.021.006.021.006.021.006.021.006.021.006.02
词典名称 词典名称
thesaamethesaame thesaame thesaame
1.0071.0071.0071.0071.007
空间范围 空间范围
spatComspatCom spatComspatCom spatCom


29



1.0081.0081.0081.0081.008
时间范围 时间范围
TimePeriod TimePeriod TimePeriod TimePeriod TimePeriod
1.008.011.008.011.008.011.008.011.008.011.008.011.008.011.008.01
起始时间 起始时间
begCate begCate begCatebegCate
1.008.021.008.021.008.021.008.021.008.021.008.021.008.021.008.02
结束时间 结束时间
endCate endCateendCate
1.0091.0091.0091.0091.009
资源安全限制分级 资源安全限制分级 资源安全限制分级 资源安全限制分级
class class class
1.0101.0101.0101.0101.010
资源语种 资源语种
language language language languagelanguage
1.0111.0111.0111.0111.011
资源字符集 资源字符集
dataChar dataChardataChar dataChar
1.0121.0121.0121.0121.012
资源分类 资源分类
TpCatTpCat TpCat
1.012.011.012.011.012.011.012.011.012.011.012.011.012.011.012.01
类目名称 类目名称
cateamecateamecateamecateame cateame cateame
1.012.021.012.021.012.021.012.021.012.021.012.021.012.021.012.02
类目编码 类目编码
cateCodecateCodecateCodecateCode cateCodecateCode
1.012.031.012.031.012.031.012.031.012.031.012.031.012.031.012.03
分类标准 分类标准
cateStdcateStdcateStdcateStd cateStd
1.0131.0131.0131.0131.013
数据志说明 数据志说明
statementstatementstatementstatementstatement statement
1.0141.0141.0141.0141.014
在线资源链接地址 在线资源链接地址 在线资源链接地址 在线资源链接地址
onLineSrconLineSrc onLineSrc onLineSrconLineSrc
1.0151.0151.0151.0151.015
资源标识符 资源标识符
resIDresID resID
1.0161.0161.0161.0161.016
服务信息 服务信息
ServInfoServInfo ServInfo ServInfoServInfo
1. 016.011. 016.011. 016.011. 016.011. 016.011. 016.011. 016.011. 016.011. 016.01
服务地址 服务地址
servURLservURL servURL servURL


30



1. 016.021. 016.021. 016.021. 016.021. 016.021. 016.021. 016.021. 016.021. 016.02
服务类型 服务类型
servTservT servTservType ype
1.0171.0171.0171.0171.017
元数据标识符 元数据标识符 元数据标识符
mdIdmdId mdId
1.0181.0181.0181.0181.018
元数据语种 元数据语种
mdLangmdLang mdLang
1.0191.0191.0191.0191.019
元数据联系方 元数据联系方 元数据联系方
MdContact MdContact MdContactMdContactMdContact MdContact
1.019.011.019.011.019.011.019.011.019.011.019.011.019.011.019.01
元数据联系单位 元数据联系单位 元数据联系单位
rpOrgamerpOrgame rpOrgamerpOrgamerpOrgame rpOrgame
1.019.021.019.021.019.021.019.021.019.021.019.021.019.021.019.02
元数据联系方地址 元数据联系方地址 元数据联系方地址 元数据联系方地址
cntAdd cntAddcntAdd
1.019.031.019.031.019.031.019.031.019.031.019.031.019.031.019.03
元数据联系方地址 元数据联系方地址 元数据联系方地址 元
数据联系方地址 元数据联系方地址 元数据联系方地址
eMailAdd eMailAdd eMailAdd
智慧城市公共信息平台-平台接口与服务要求
27
1.0201.0201.0201.0201.020
元数据创建日期 元数据创建日期 元数据创建日期
mdCateStmdCateSt mdCateStmdCateSt
表 A. 8 关系运算符属性集
编码
名称
符号
1
小于 less than less thanless than less than less than
<
2
小于 等小于 等less than or equal less than or equalless than or equal less than or equal less
than or equal less than or equalless than or equal less than or equal less than or equal
<=
3
等于 equal equal
=
4
大于 等大于 等greater or equalgreater or equalgreater or equal greater or equalgreater or equal
greater or equal greater or equal greater or equal
>=


31



5
大于 greater thangreater thangreater than greater thangreater thangreater thangreater than
greater than greater than
>
6
不等于 不等于 not equal not equalnot equal not equal not equal
!= (或 <> )
7
模糊匹配 模糊匹配
like likelike
表 A. 9 位置运算符属性集
编码
中文名称
英文名称
1
任意位置出现 任意位置出现 任意位置出现
any position in field any position in field any position in fieldany position in field any position in
field any position in field any position in field
表 A. 10 资源自描述 ResultResult 属性集 属性集 属性集
元素名
父节点
约束
类型
取值说明
版本号
dataDescResult dataDescResultdataDescResult dataDescResult dataDescResultdataDescResult
dataDescResult
可选
StringStringStringString String
0到 9数字 +”.”+0 +”.”+0 +”.”+0 +”.”+0 到 9数字
资源种类 资源种类
dataDescResult dataDescResultdataDescResult dataDescResult dataDescResultdataDescResult
dataDescResult
必选
StringStringStringString String
“结构化资源 ”或”非结构化资源 非结构化资源 ” ,2 ” ,2 ” ,2 者 选其一
资源标识符 资源标识符
dataDescResult dataDescResultdataDescResult dataDescResult dataDescResultdataDescResult
dataDescResult
必选
StringStringStringString String
6位字母 位字母 数字加 数字加 ”” ”” 加 1到 23 位数字 位数字
归属节点 归属节点
dataDescResult dataDescResultdataDescResult dataDescResult dataDescResultdataDescResult
dataDescResult


32



必选 String
4位数字,资源归属的机构编号 位数字,资源归属的机构编号 位数字,资源归属的机构
编号 位数字,资源归属的机构编号 位数字,资源归属的机构编号 位数字,资源归属的机
构编号 位数字,资源归属的机构编号
当前状态 当前状态
dataDescResult dataDescResultdataDescResult dataDescResult dataDescResultdataDescResult
dataDescResult
必选
StringStringStringString String
编目中
编目完成 编目完成
审核中
审核完成 审核完成
注册中
注册完成 注册完成
智慧城市公共信息平台-平台接口与服务要求
28
发布中
发布完成 发布完成
资源所处状态,选择项 资源所处状态,选择项 资源所处状态,选择项 资源所处状态,选
择项 资源所处状态,选择项
开放应用 单位 列表
dataDescResult dataDescResultdataDescResult dataDescResult dataDescResultdataDescResult
dataDescResult
可选
List List
该资源开放的应用 该资源开放的应用 该资源开放的应用 该资源开放的应用 单位 清单
应用 单位
开放应用 开放应用 开放应用 开放应用 单位 列表
可选
element
包含 1~n个应用 个应用 单位 信息
应用 单位 编号
应用 单位
可选
StringStringStringString String
4位数字,资源归属的机构编号 位数字,资源归属的机构编号 位数字,资源归属的机构
编号 位数字,资源归属的机构编号 位数字,资源归属的机构编号 位数字,资源归属的机
构编号 位数字,资源归属的机构编号
应用 单位 名称
应用 单位
可选
StringStringStringString String
资源归属的机构名称 资源归属的机构名称 资源归属的机构名称 资源归属的机构名称
结构化信息 结构化信息


33



dataDescResult dataDescResultdataDescResult dataDescResult dataDescResultdataDescResult
dataDescResult
可选
List List
当资源类型为 当资源类型为 当资源类型为 ”结构化资源 结构化资源 结构化资源 ”时,
将返回 时,将返回 时,将返回 此节点信息,包含了资源对应的表及字 此节点信息,包
含了资源对应的表及字 此节点信息,包含了资源对应的表及字 此节点信息,包含了资源
对应的表及字 此节点信息,包含了资源对应的表及字 此节点信息,包含了资源对应的表
及字 此节点信息,包含了资源对应的表及字 此节点信息,包含了资源对应的表及字 段信
息,用于资源检索使。至少包含 段信息,用于资源检索使。至少包含 段信息,用于资源
检索使。至少包含 段信息,用于资源检索使。至少包含 段信息,用于资源检索使。至少
包含 段信息,用于资源检索使。至少包含 段信息,用于资源检索使。至少包含 段信息,
用于资源检索使。至少包含 段信息,用于资源检索使。至少包含 段信息,用于资源检索
使。至少包含 一个表信息 一个表信息
总数
结构化信息 结构化信息
必选
StringStringStringString String
包含表的个数, 包含表的个数, 包含表的个数, >=1 >=1
表信息
结构化信息 结构化信息
必选
List List
资源包含的表信息 资源包含的表信息 资源包含的表信息 资源包含的表信息
表英文名 表英文名
表信息
必选
StringStringStringString String
表在数据库中的实际名称 表在数据库中的实际名称 表在数据库中的实际名称 表在数据
库中的实际名称 表在数据库中的实际名称
表中文名 表中文名
表信息
必选
StringStringStringString String
表的中文含义 表的中文含义 表的中文含义
限制性 限制性 SQLSQL
表信息
可选
StringStringStringString String
表中记录的过滤条件 表中记录的过滤条件 表中记录的过滤条件 表中记录的过滤条件
列集
表信息
必选
List List
表中包含的字段信息集合, 表中包含的字段信息集合, 表中包含的字段信息集合, 表中


34



包含的字段信息集合, 表中包含的字段信息集合, 表中包含的字段信息集合, 必须 包
含 一个字段信息 一个字段信息 一个字段信息
总数
列集
必选
String String String String String String
包含的字段总数, 包含的字段总数, 包含的字段总数, 包含的字段总数, >=1>=1
字段
列集
必选
List List
字段的属性集合 字段的属性集合 字段的属性集合
名称
字段
必选
StringStringStringString String
字段的标题 字段的标题
字段英文名 字段英文名
字段
必选
StringStringStringString String
字段的实际名称 字段的实际名称 字段的实际名称
字段中文名 字段中文名
字段
必选
StringStringStringString String
字段的含义 字段的含义
数据类型 数据类型
字段
必选
StringStringStringString String
字段的数据类型 ,目前支持如下字段的数据类型 ,目前支持如下字段的数据类型 ,目前
支持如下字段的数据类型 ,目前支持如下字段的数据类型 ,目前支持如下字段的数据类
型 ,目前支持如下字段的数据类型 ,目前支持如下:







智慧城市公共信息平台-平台接口与服务要求
29

是否主键 是否主键


35



字段
必选
StringStringStringString String
“是”表示是主键, 表示是主键, 表示是主键, ”否”表示非主键 表示非主键
长度
字段
可选
StringStringStringString String
字段的长度 字段的长度
精度
字段
可选
StringStringStringString String
字段的精度 字段的精度
非结构化信息 非结构化信息 非结构化信息
dataDescResult dataDescResultdataDescResult dataDescResult dataDescResultdataDescResult
dataDescResult
可选
element
当资源类型为 当资源类型为 当资源类型为 ”非结构化资源 非结构化资源 非结构化资源
非结构化资源 ”时,将返 时,将返 时,将返 时,将返 回此节点信息,包含了资源对应
的文件 回此节点信息,包含了资源对应的文件 回此节点信息,包含了资源对应的文件
回此节点信息,包含了资源对应的文件 回此节点信息,包含了资源对应的文件 回此节点
信息,包含了资源对应的文件 回此节点信息,包含了资源对应的文件 回此节点信息,包
含了资源对应的文件 回此节点信息,包含了资源对应的文件 目录类型等信息,用于资源
检索使。 目录类型等信息,用于资源检索使。 目录类型等信息,用于资源检索使。 目录
类型等信息,用于资源检索使。 目录类型等信息,用于资源检索使。 目录类型等信息,
用于资源检索使。 目录类型等信息,用于资源检索使。 目录类型等信息,用于资源检索
使。 包含一个资源集子元素 包含一个资源集子元素 包含一个资源集子元素 包含一个资
源集子元素 包含一个资源集子元素
资源集
非结构化信息 非结构化信息 非结构化信息
必选
List List
资源对应的文件集合 资源对应的文件集合 资源对应的文件集合 资源对应的文件集合
总数
资源集
必选
StringStringStringString String
文件的数量, 文件的数量, 文件的数量, >=1>=1
资源记录 资源记录
资源集
必选
element
文件的属性集 文件的属性集 文件的属性集


36



目录
资源记录 资源记录
必选
StringStringStringString String
指文件所在的目录或 指文件所在的目录或 指文件所在的目录或 指文件所在的目录或 指
文件所在的目录或 WebWebWeb服务的名称 服务的名称
文件名
资源记录 资源记录
必选
StringStringStringString String
指文件名称或 指文件名称或 指文件名称或 webweb 服务地址 服务地址 服务地址
文件类型 文件类型
资源记录 资源记录
必选
StringStringStringString String
1:视频, :视频, :视频, 2:非视频, :非视频, :非视频, 3:URLURL 服务
地 服务地 址
智慧城市公共信息平台-平台接口与服务要求
30
附录 B QUERY QUERY-RES RES-DATADATADATADATA说明
本附录说明了资源检索查询条件的使用方法,因为元数据指标项的不确定性,无法实现与
国标相同的RP方法,因此此处的具体方法不同于国标。
资源分为两个种类:结构化数据和非结构化数据。
结构化数据既指保存在共享数据库中的数据库记录,一个资源可以跨表编目,形成一个资
源标识符作为唯一标识资源的标志。结构化数据编目后会形成如下的结构信息: <结构化
信息> <总数><总数> <表信息> <表英文名> <表中文名> <列
集> <总数> <字段> <名称> <显示序号> <字段英文名>
<字段中文名> <数据类型> <是否主键> <长度> <精度> <字段> <列
集> <表信息> <限制性SQL>
智慧城市公共信息平台-平台接口与服务要求
31
<结构化信息>
这些信息在资源自描述中将作为结果返回给客户端。
非结构化资源可包含三种文件类型:文档、视频文件、URL。 <非结构化信息> <资源集> <总数> <资源记录> <目录> <文件名> <文件类型
> <资源记录> <资源集> <非结构化信息>
URL指共享应用单位提供的Web服务资源。
URL属性包括:
 目录-指实际的URL路径;
 文件名-指URL服务的名称;
当文件类型为文档、视频文件时,包含的属性含义如下:
 目录-指资源存储的目录;


37



 文件名-指文件名。
B.1 B.1 B.1 dataQuerydataQuery dataQuerydataQuerydataQuery 资源检索申请结构 资源检
索申请结构 资源检索申请结构 资源检索申请结构 资源检索申请结构 资源检索申请结构
资源检索申请结构
依照资源种类的不同,dataQuery的结构也不同。
B.1.1 结构 化资源检索申请 <结构化查询参数> <查询表信息> <表英文名><
表英文名> <字段过滤信息> <字段英文名> <字段值>
智慧城市公共信息平台-平台接口与服务要求
32
这里有一个约束条件:这个字段前必须加上小写表名前缀。比如USER表的id字段 这个
字段值条件必须是:--> <运算符> <连接运算符><连接运算符> <字段过滤信息> <字段过滤
信息> <字段英文名> <字段值> <运算符
> <连接运算符><连接运算符> <字
段过滤信息> <查询表信息> <查询表信息> <表英文名><表英文
名> <字段过滤信息> <字段英文名> <字段值> <运算符> <连接运算符><连接运算符> <字段过
滤信息> <字段过滤信息> <字段英文名> <字段值> <运算符> <连接运算符><连接运算符> <字段过滤信息> <查询表信息> <结构化查询
参数>
B.1.2 非结构 化资源申请
智慧城市公共信息平台-平台接口与服务要求
33
<非结构化查询参数> <目录取值> <目录运算符>
<文件名取值> <文件名运算符> <文件类型> <非结构化查
询参数>
B.2B.2 资源检索结果提取构 资源检索结果提取构 资源检索结果提取构 资源检索结果提
取构 资源检索结果提取构 资源检索结果提取构 资源检索结果提取构 资源检索结果提取
构 资源检索结果提取构
Records包含一个或多个singleRecord,每个singleRecord为一条结果记录。singleRecord包
含若干item属性项,每项item包含itemameitemValue对,表明属性的名称及其值。
对结构化资源而言,每个item即表示一个字段,itemame表示字段名,itemValue表示字
段值。
对非结构化资源,itemame是明确的,只能是“文件名”、“文件类型”、“目录”,itemame
对不同的文件类型的取值含义定义如下图所示: 文件类型 文件类型
itemameitemameitemameitemameitemameitemameitemameitemame 含义
URLURLURL
目录
URLURLURL路径
URLURLURL
文件名


38



URLURLURL服务名称 服务名称
文档 or 视频
目录
资源所在目录 资源所在目录 资源所在目录
文档 or 视频
文件名
资源的文件名 资源的文件名 资源的文件名
B.2.1 结构化资源 singleRecord singleRecord singleRecord singleRecord范例 字段1的标题
字段1的值
智慧城市公共信息平台-平台接口与服务要求
34
字段2的标题 字段2的值
字段1的标题
字段1的值 字段2的标
字段2的值
B.2.1 非结构化资源 singleRecord singleRecord singleRecordsingleRecord 范例 version=encoding=
文件名
目录 video
文件类型 视频 访问路径
http:video

智慧城市公共信息平台-平台接口与服务要求
35
文件名 领导讲话视频服务
目录
http:videoleader
文件类型 URL 访问路径
http:videoleader

智慧城市公共信息平台-平台接口与服务要求
36
附录 C 平台接口 要求 SCHEMA SCHEMA SCHEMA encoding=类型标识符-->
协议数据单元。
协议数据单元
的定义。 ref=ref=ref=


39




name=type=
索取公钥。
智慧城市公共信息平台-平台接口与服务要求
37
索取
公钥请求的定义。 ref=minOccurs= type= 索取公钥响应。
name=索取公钥响应的定义。
type=minOccurs= type= 资源提取响应。
name=资源提取响应的类
型定义。 ref=“failure”表示提取失败。 --> 用于客户端和服务器端传递自定义信息。一旦发生异常,使用本
智慧城市公共信息平台-平台接口与服务要求
38
参数传递详细的异常信息给客户端。 --> type= 资源提取请求。
name= 资源提取请求的类
型定义。 ref=name=type=name=type=ref=default=表示提取结果的编码方式。默认
采用XML方式 -->
name=type=


40



检索响应。

检索响应的类型定义。 ref=name=参数searchStatus取值为“success”表示检索成功;“failure”表
示检索失败 --> 和服务器端传递自定义信息。一旦发生异常,使用本参数传递详细的异常信息给客户端。
-->
智慧城市公共信息平台-平台接口与服务要求
39


资源检索请求。
源检索请求的类型定义。
无效。 --> type=ref=
资源检索过滤条件。
minOccurs=结构化查询参数
type=结构化查询参数定义 结构化查询参数定
义。 查询参数定义
智慧城市公共信息平台-平台接口与服务要求
40
表查询的结构描述
maxOccurs=字段过
滤信息type=字段过滤信息定义 type=运算符运算符链接
运算符type=链接运算符定义 name=非结构化查询参数type=非结构化查询参数定义
非结构化查询参数定义。

运算符文件名取值文件名
运算符type=运算符

41



base=


智慧城市公共信息平台-平台接口与服务要求
41
type= 资源自描述应答。
name=资源自描述应答的
类型定义。 ref=

资源自描述返回结果。
资源自描述应答结果的类型定义。
name=结构化信息minOccurs= 结构化信息
ref=总数 表信息
智慧城市公共信息平台-平台接口与服务要求
42
minOccurs= 非结构化信息
maxOccurs=
本号协议版本,本实现
对应的协议版本 name=资源种类type=资源种类分类 资源种类
name=资源标识符 资源标识符
智慧城市公共信息平台-平台接口与服务要求
43
节点

42



base=

当前状态
value=审核中审核完成注册中
value=发布完成开放应用单位
列表 开放应用单位列表
maxOccurs= 应用单位

智慧城市公共信息平台-平台接口与服务要求
44
应用单位
应用单位
信息 号应用单位名称
name=应用单位编号 应用单位编号

应用单位名称

总数
base=
智慧城市公共信息平台-平台接口与服务要求
45
表信息
表信息定义

表英文名
表中文名

列集
ref=总数


43




智慧城市公共信息平台-平台接口与服务要求
46
制性SQL base=

字段
字段集
ref=显示序号minOccurs=
名称

显示序号

智慧城市公共信息平台-平台接口与服务要求
47
value=字段英
文名 字段英文名
value=字段中
文名 字段中文名
value=数据类
型数据类型
value=

智慧城市公共信息平台-平台接口与服务要求
48

是否主键

长度
base=
精度


44



base=
资源集
ref=总数

智慧城市公共信息平台-平台接口与服务要求
49
资源记录
资源记录
集合
目录

文件名


文件类型
value=
智慧城市公共信息平台-平台接口与服务要求
50
name=type=
资源自描述请求。

资源自描述请求的类型定义。
成,其它字符无效。 --> minOccurs= 资源标识符
value=
type= 初始化请求。
name= 初始化请求的类型定义。
name=type=minOccurs=name=
智慧城市公共信息平台-平台接口与服务要求


45



51
ref=minOccurs= default= 协议版本,本实现对应的协议版本

初始化响应。
初始化
响应的类型定义。 ref=
参数result取值为布尔型。“true”表示建立会话成功;“false”表示建立会话失败,此时
referenceId取为空。 --> minOccurs=minOccurs=minOccurs= 自定义信息。一旦发生异常,使用本参数传递详细的异常信息给客户端。 -->

用于加密解密的公钥
智慧城市公共信息平台-平台接口与服务要求
52
type=目录服务自描
述信息的请求。 name= 目录服务自
描述信息请求的定义。 ref=
name=type=
目录服务自描述信息的响应。
name=目录服务自
描述信息响应的定义。 ref=息资源目录服务name=type=type=maxOccurs=type=
智慧城市公共信息平台-平台接口与服务要求
53


46



ref=

操作返回结果
type=name=type=
type=minOccurs=maxOccurs=
name=type=type= name=type= 支持的功能。
name=
智慧城市公共信息平台-平台接口与服务要求
54
value=value= name= 提供应用单位类型
ref= name=type= 提供
应用单位名称 检索请求。

检索请求的类型定义。
type=ref=default=表示查询结果的编码方式。默认
采用XML方式 --> minOccurs= 智慧城市公共信息平台-平台接口与服务要求
55
检索响应。

检索响应的类型定义。


47



type=“success”表示检索成功;“failure”表示检索失败 --> minOccurs=其它信息,用于客户端和服务器端传递自定义信息。一旦发生异常,
使用本参数传递详细的异常信息给客户端。 --> type=
minOccurs=maxOccurs= type= 元数据库名称。
name= 元数据库名称的类型定
义。 type= name= 检索串的类型是
type-1
智慧城市公共信息平台-平台接口与服务要求
56
type=fixed=信息资源目录服务属性集type=
name= 逆波兰检索表达式。
type=
type= name= type=name=type= type=
智慧城市公共信息平台-平台接口与服务要求
57

操作数。
操作数的类
型定义。 name=type=


48



maxOccurs=
type=
name= type=name=type= 智慧城市公共信息平台-平台接口与服务要求
58
操作符。

操作符的类型定义。
type=

抽象类型。表示元素出现即可,没有取值。


提取请求。
提取
请求的类型定义。 ref=name=type=name=type=ref=default=表示提取结果的编码方式。默认
采用XML方式 -->
name=
智慧城市公共信息平台-平台接口与服务要求
59
元素集名称。

元素集名称的类型定义。
name= type=maxOccurs=

提取响应。
响应的类型定义。

49



ref=“failure”表示提取失败。 --> minOccurs=其它信息,用于客户端和服务器端传递自定义信息。一旦发生异常,
使用本参数传递详细的异常信息给客户端。 --> 智慧城市公共信息平台-平台接口与服务要求
60
记录。
name=type= 提取
状态。 name= 提取状态的类型定义。
value=
name=type=
元数据管理请求。

元数据管理请求的类型定义。
类型“1”,元数据导入操作 类型“2”,元数据删除
操作 类型“3”,元数据更新操作
type=
智慧城市公共信息平台-平台接口与服务要求
61
当type值为1时,进行元数据插入操作,本参数不出现; 当type值为2、3时,进行元数
据删除操作或更新操作,本参数为必选参数。

当type值为1、3时,进行元数据插入或更新操作,本参数为必选参
数; 当type值为2时,进行元数据删除操作操作,本参数不出现。
元数据管理响应。
元数据管理响应的类型定义。
name=
minOccurs= 类型“1”,元数据导入操作 类型
“2”,元数据删除操作 类型“3”,元数据更新操作
智慧城市公共信息平台-平台接口与服务要求


50



智慧城市公共信息平台平台接口与服务要求
1 范围
 本要求 是《智慧城市公共信息平台建设指南》建设要求系列之接口与服 接口与服 接
口与服 务要求 。
 本部分 要求 分两大部描述平台接口 分两大部描述平台接口 分两大部描述平台接口
分两大部描述平台接口 分两大部描述平台接口 要求 ,第一部分:总体 ,第一部分:总
体 ,第一部分:总体 ,第一部分:总体 要求 ,总体 要求 描述消息的总体结构、接口
访问方地址使用说明。第二部分:业务 描述消息的总体结构、接口访问方地址使用说明。
第二部分:业务 描述消息的总体结构、接口访问方地址使用说明。第二部分:业务 描述
消息的总体结构、接口访问方地址使用说明。第二部分:业务 描述消息的总体结构、接口
访问方地址使用说明。第二部分:业务 描述消息的总体结构、接口访问方地址使用说明。
第二部分:业务 接口 要求 ,具体描述每个业务应用服接口的 ,具体描述每个业务应用
服接口的 要求 。也就是每一个业务接口 。也就是每一个业务接口 要求 套在总体 要求
内。只有使用业务接口 内。只有使用业务接口 内。只有使用业务接口 内。只有使用业务
接口 要求 +总体 要求 才能正常使用信息平台的应 才能正常使用信息平台的应 才能正
常使用信息平台的应 才能正常使用信息平台的应 用服务来发现,查询管理资源。
 本部分适用于参与公共信息平台设计和研发人员,系统维护及要求 本部分适用于参与
公共信息平台设计和研发人员,系统维护及要求 本部分适用于参与公共信息平台设计和研
发人员,系统维护及要求 本部分适用于参与公共信息平台设计和研发人员,系统维护及要
求 本部分适用于参与公共信息平台设计和研发人员,系统维护及要求 本部分适用于参与
公共信息平台设计和研发人员,系统维护及要求 本部分适用于参与公共信息平台设计和研
发人员,系统维护及要求 本部分适用于参与公共信息平台设计和研发人员,系统维护及要
求 本部分适用于参与公共信息平台设计和研发人员,系统维护及要求 本部分适用于参与
公共信息平台设计和研发人员,系统维护及要求 本部分适用于参与公共信息平台设计和研
发人员,系统维护及要求 本部分适用于参与公共信息平台设计和研发人员,系统维护及要
求 本部分适用于参与公共信息平台设计和研发人员,系统维护及要求 接入公共信息平台
的外部应用开发人员。
智慧城市公共信息平台-平台接口与服务要求
2
2 规范性 引用 文件
下列文件中的条款通过本部分引 用而成为。凡是注日期下列文件中的条款通过本部分引
用而成为。凡是注日期用文件,其随后 用文件,其随后 所有的修改单(不包括勘误内容)
或订版均适用于本部分, 所有的修改单(不包括勘误内容)或订版均适用于本部分, 所
有的修改单(不包括勘误内容)或订版均适用于本部分, 鼓励根据本部分达成协议的各方
研究是否可使用这些文件最新版。凡不注 鼓励根据本部分达成协议的各方研究是否可使用
这些文件最新版。凡不注 日期的引用文件,其最新版本适于部分。
GBT 21063.1 -2007 政务信息资源目录体系 第 1部分:总体框架;
GBT 21063.2 -2007 政务信息资源目录体系 第 2部分:技术要求;
GBT 21063.3 -2007 政务信息资源目录体系 第 3部分:核心元数据;
GBT 21063.4 GBT 21063.4 -2007 政务信息资源目录体系 第 4部分: 政务信息资源分类;
GBT 21063.5 -2007 政务信息资源目录体系 第 5部分:政务信息资源标识 部分:政务信
息资源标识 符编码方案;
 本文 <业务接口 要求 > 引用《 GBT 21063.2 GBT 21063.2 -2007 》中的附录 A 目
录服务 接口;
 本文 <附录 A 要求 所涉及的结构表 所涉及的结构表 所涉及的结构表 所涉及的结


1



构表 >引用《 引用《 GBT 21063.2 GBT 21063.2 -2007 》中的附 》中的附 》中的附
录 A 目录服务接口,及引用《 目录服务接口,及引用《 目录服务接口,及引用《 GBT
21063.2 GBT 21063.2 -2007 》中的附录 》中的附录 C 政务信息资源目 录服务属性集
 本文 <附录 D QUERY D QUERY -RP 范例 >引用 《GBT 21063.2 GBT 21063.2
-2007 》中的附录 》中的附录 F 检 索串示例 9.
智慧城市公共信息平台-平台接口与服务要求
3
3 术语 与定义
GBT 19710 -2005 中规定的与以下术语和义适用于本部分。
 目录
针对拥有共性的数据资源 针对拥有共性的数据资源 针对拥有共性的数据资源 针对拥有
共性的数据资源 文件资 源进行分类,并且为该赋予唯一的文件资 源进行分类,并且为
该赋予唯一的文件资 源进行分类,并且为该赋予唯一的文件资 源进行分类,并且为该赋
予唯一的文件资 源进行分类,并且为该赋予唯一的文件资 源进行分类,并且为该赋予唯
一的文件资 源进行分类,并且为该赋予唯一的源标识符,该部分类及描述的集合统称为资
目录简。
 结构化资源
公共信息平台享的二维库表结构数据,统称为化资源。
 非结构化资源
公共信息平台享的非二维库表结构数据,例如:文本件、视频网络访 公共信息平台享的非
二维库表结构数据,例如:文本件、视频网络访 公共信息平台享的非二维库表结构数据,
例如:文本件、视频网络访 公共信息平台享的非二维库表结构数据,例如:文本件、视频
网络访 公共信息平台享的非二维库表结构数据,例如:文本件、视频网络访 问资源等统
称为非结构化。
 数据交换管理者
管理信息资源结点的机构。
 交换内容提供者
提供信息资源交换内容的机构。
 交换内容使用者
使用信息资源交换内容的机构。
 前置环境
应用单 位接入端系统软硬件及相关网络环境组成的前置元环境。
 目录交换
按订阅模式进行目录资源数据的交换;
 桥接系统
业务数据库与共享的桥接器,保持 交换 数据库与共享的同步 数据库与共享的同步 数据
库与共享的同步 数据库与共享的同步 数据库与共享的同步 数据库与共享的同步 数据库
与共享的同步 数据库与共享的同步 数据库与共享的同步 数据库与共享的同步 ;
 变更捕捉
捕捉数据 资源 变更情况 。
 数据转入
以固定间隔时轮询变更登记表,读取其中的 录并将这些约以固定间隔时轮询变更登记表,
读取其中的 录并将这些约以固定间隔时轮询变更登记表,读取其中的 录并将这些约格式
组成 XML 报文,存储到共享库的换出表中 ;
非结构化数据文件直接通过服务传输至交换中心 器,并有非结构化数据文件直接通过服务


2



传输至交换中心器,并有
智慧城市公共信息平台-平台接口与服务要求
4
分发非结构化数据文件。
 数据交换路由
以固定时间隔轮询应用单位换入表,拆解 以固定时间隔轮询应用单位换入表,拆解 XML
报文,根据目标库自动分拣 报文,根据目标库自动分拣 ;
非结构化数据文件直接通过服务传输至交换中心 器,并有非结构化数据文件直接通过服务
传输至交换中心 器,并有分发非结构化数据文件。
 数据转出
独立运行的进程, 以固定间隔时轮询交换库中的 入表,读取其以固定间隔时轮询交换库
中的 入表,读取其XML 报文,并将数据按定制的格式同步到共享库中 。
非结构化数据文件描述信息存储在队列中,由各服务器根分 非结构化数据文件描述信息存
储在队列中,由各服务器根分 别从中心文件服务器获取所需数据。
 交换管理程序
完成 数据交换审批流程、监控调度系统管理 数据交换审批流程、监控调度系统管理 数据
交换审批流程、监控调度系统管理 数据交换审批流程、监控调度系统管理 数据交换审批
流程、监控调度系统管理 数据交换审批流程、监控调度系统管理 数据交换审批流程、监
控调度系统管理 数据交换审批流程、监控调度系统管理 等功能一套 等功能一套 程序 ,
部署于中心。
 Web 服务
基于 webservice 技术开放的 服务接口,采用约定的 服务接口,采用约定的 XML 作为
交易数据接口, 提供给客户端调用。
 WSDL
Web 服务描述文件, 一个用来描述 一个用来描述 Web 服务和说明如何与 服务和说明
如何与 Web 服务通信的 服务通信的 XML 语言。为用户提供详细的接口说明 。
 访问认证
公共信息平台提供用户认证 服务,由托管应系统的客端调于验公共信息平台提供用户认证
服务,由托管应系统的客端调于验公共信息平台提供用户认证 服务,由托管应系统的客端
调于验用户是否合法;
 应用单位
接入公共信息平台的机构单位。
 主管 单位
公共 信息平台的管理单位 。
 数据 中心
公共 信息平台 的组成部分, 是公共信息平台数据及应用系统存储的地方 。
智慧城市公共信息平台-平台接口与服务要求
5
4 接口服务概述
4.1 接口服务组成
信息资源目录服务包含三种接口,即信息资源基础服务接口、资源服务接口
(发现接口、资源接口)、信息资源管理服务接口。其中,基础接口是将资源服务
接口和管理接口中基础性的操作定义成一个公共接口。这3 类接口实现了信息资
源的发现功能、检索功能和管理功能。
基础接口:提供会话管理功能和服务自描述功能,包含有目录服务初始化接


3



口、目录服务终止接口和服务自描述接口。
发现接口:提供信息资源元数据检索功能和信息资源元数据检索结果提取功
能,包含有目录检索接口以及目录检索结果提取接口。这些接口本身并不提供资
源,而是提供资源基本信息和如何去获得这些资源的元数据。
资源接口:根据发现接口获得信息资源元数据,定位、查资源具体内容的
接口,包含资源内容检索接口及资源内容结果提取接口。
管理接口:提供元数据管理的功能,包含信息资源元数据管理接口。
城市公共信息平台接口服务组成见图1.
智慧城市公共信息平台
基础接口服务资源接口服务
管理接口服务
服务初始化认证授权服务终止发现服务资源服务
资源元数据新
增服务
资源元数据更
新服务
资源元数据删
除服务
资源目录检索
资源目录结果
提取
资源内容检索
资源内容结果
提取
图1. 城市公共信息平台接口服务组成图
智慧城市公共信息平台-平台接口与服务要求
6
4.2 4.2 接口技术要求 接口技术要求 接口技术要求 接口技术要求 接口技术要求
a) 提供基于 SOAP 协议的 web 服务接口
b) 支持跨语言、操作系统调用
智慧城市公共信息平台-平台接口与服务要求
7
5 总体 要求
5. 1 消息结构
每个交易消息 每个交易消息 (包括请求和应答 包括请求和应答 包括请求和应答 包括请
求和应答 )有一个是名字( 有一个是名字( 有一个是名字( 有一个是名字( Message
ame Message ame),交易消息 ),交易消息 ),交易消息 以 XML 格式表达的,根据
格式表达的,根据 XML 的定义,每个 的定义,每个 XML 文件需要有特定的 Root Tag
Root Tag (根 标记),在本 标记),在本 标记),在本 要求 中,用交易名称 中,用交
易名称 +请求类别作为根节点,如初始化接口的包 请求类别作为根节点,如初始化接口
的包 根节点为 initRequest ,而响应包的根节点为 ,而响应包的根节点为 initRespe 。
根节点下之间放业 。根节点下之间放业 务接口数据。
5. 1.1 请求报文范例

5.1.2 响应报文范例


4





5.2 5.2 接口方式
接口采用 WebService 方式,接口协议使用 SOAP 协议,提供标准的 WSDL 文 件。
智慧城市公共信息平台-平台接口与服务要求
8
5.3 5.3 接口地址
公共信息目录服务(以下简称)主要有三个 公共信息目录服务(以下简称)主要有三个
公共信息目录服务(以下简称)主要有三个 wsdl 地址,不同的 地址,不同的 wsdl 下有
不同的方法,文说明。这是根据 webservice 的 soap 协议开放出来的 协议开放出来的
wsdl 地址,第三方应用可以根据实际的部署服务器来使它。
1) 基础接口 WSDL 文件地址: http::< 端 口>escatalogbase?wsdl
 目录服务初始化 –initCatalogService
 目录服务终止 –stopCatalogService
2) 发现接口 WSDL 文件地址: http::< 端 口>esdigcatalog?wsdl
 目录检索 – queryCatalogList
 目录检索结果提取 – queryCatalogResult
3) 资源服务接口: http::< 端口 >esdigresource?wsdl
 资源检索 – getResourceResultset
 资源检索结果提取 – getResourceResultDetail
4) 发现接口 WSDL 文件地址: http::< 端 口>esdigcatalog?wsdl
 资源元数据管理 – metadataManage
5.4 5.4 使用说明
完成资源的检索与发现需要根据以下步骤来操作:
1) 第一步:初始化操作。调用基础接口的“目录服务初始化”获得一个会 话标识符以后
每次调用接口都需要次标识符。
2) 第二步:查询公共信息目录操作。调用发现接口的“目录检索”组织好查询参数,发起
交易,获得查询结果。注:这里的查询结果只有返回命中的查询记录数。比如:返回值是
100,那么表示有100条记录符合查询条件,这个时候需要发起“公共信息目录检索结果提
取”交易才能提取
智慧城市公共信息平台-平台接口与服务要求
9
查询的结果。如果发回值是0,表示没有符合查询条件的记录。
3) 第三步:查询公共信息目录对应的资源。这里的操作也是和上面一样,调用“资源检索”
先要查询下是否有符合查询条件的资源。有资源记录的话,然后在调用“资源检索结果提
取”提取符合条件的资源信息。
4) 第四步:假如调用接口结束后,可调用基础接口里的“目录服务终止”来释放会话标识
符资源信息。
智慧城市公共信息平台-平台接口与服务要求
10
6 业务接口 要求
6.1 6.1 基础接口 要求
6.1.1 目录服务初始化
公共信息目录服务初始化用于建立客户端与服务端的会话,所有其他服务都必须依赖会话。
会话的持续时间为30分钟,若会话持续30分钟没有活动,则会话自动终止。本次初始化


5



作用是客户端认证同时获取会话标识符,后续发起交易时需要传递该会话标识符。
1. 请求报文体 序号 元素名称 元素名称 约束 类型 长度 描述 取值说明 取值说明
1.
protocolVersion
protocolVersionprotocolVersionprotocolVersionprotocolVersionprotocolVersionprotocolVersion
protocolVersionprotocolVersionprotocolVersionprotocolVersion protocolVersion
可选
StringStringStringString String
50
客户端协议版本号
客户端协议实现的 客户端协议实现的 客户端协议实现的 客户端协议实现的 客户端协议
实现的 客户端协议实现的 客户端协议实现的 客户端协议实现的 版本号
2.
idAuthentication idAuthentication idAuthentication idAuthenticationidAuthentication
idAuthenticationidAuthenticationidAuthentication idAuthentication
必选
StringStringStringString String
50
用户名 用户名 用户名 密 码
认证信息。包含用户 认证信息。包含用户 认证信息。包含用户 认证信息。包含用户 认
证信息。包含用户 认证信息。包含用户 身份标识及其密码。 身份标识及其密码。 身份
标识及其密码。 身份标识及其密码。 身份标识及其密码。 格式“ 格式“ <用户名 用
户名 >< 密 码>”
3.
implementationId implementationId implementationId
implementationIdimplementationIdimplementationIdimplementationId implementationId
implementationId
可选
StringStringStringString String
50
应用标识 应用标识
在公共信息平台用 在公共信息平台用 在公共信息平台用 在公共信息平台用 在公共信息
平台用 在公共信息平台用 在公共信息平台用 在公共信息平台用 户体系中注册的第 户
体系中注册的第 户体系中注册的第 户体系中注册的第 户体系中注册的第 户体系中注册
的第 户体系中注册的第 户体系中注册的第 三方应用编号 三方应用编号 三方应用编号
4.
implementationame implementationame implementationame
implementationameimplementationameimplementationameimplementationame
implementationame implementationame
可选
StringStringStringString String
200200200
应用名称 应用名称
在公共信息平台用 在公共信息平台用 在公共信息平台用 在公共信息平台用 在公共信息
平台用 在公共信息平台用 在公共信息平台用 在公共信息平台用 户管系统中注册的 户


6



管系统中注册的 户管系统中注册的 户管系统中注册的 户管系统中注册的 户管系统中注
册的 户管系统中注册的 户管系统中注册的 第三方应用名称 第三方应用名称 第三方应
用名称
5.
otherInfootherInfootherInfo otherInfo otherInfootherInfo
可选
element element
其他信息 其他信息
备用
2. 请求报文体模板 V1.0
testApp12456< idAuthentication> 1<
implementationId > 测试应用

3. 响应报文体
智慧城市公共信息平台-平台接口与服务要求
11
序号 元素名称 元素名称 约束 类型 长度 描述 取值说明 取值说明
1.
referenceIdreferenceIdreferenceIdreferenceId referenceId
必选
StringStringStringString String
50
会话标识 会话标识
当验证成功时返回,否 当验证成功时返回,否 当验证成功时返回,否 当验证成功时返回,
否 当验证成功时返回,否 则设置为空 则设置为空
2.
protocolVersion
protocolVersionprotocolVersionprotocolVersionprotocolVersionprotocolVersionprotocolVersion
protocolVersionprotocolVersionprotocolVersionprotocolVersion protocolVersion
必选
StringStringStringString String
50
服务端协议版本号
服务端协议实现的版本 服务端协议实现的版本 服务端协议实现的版本 服务端协议实现
的版本 服务端协议实现的版本 服务端协议实现的版本 服务端协议实现的版本 服务端协
议实现的版本 服务端协议实现的版本 服务端协议实现的版本 号
3.
resultresult result
必选
Boolean Boolean
处理结果 处理结果
服务器端用该参数表明 服务器端用该参数表明 服务器端用该参数表明 服务器端用该参
数表明 服务器端用该参数表明 服务器端用该参数表明 服务器端用该参数表明 服务器端
用该参数表明 服务器端用该参数表明 服务器端用该参数表明 是否接受建立会话的请 是
否接受建立会话的请 是否接受建立会话的请 是否接受建立会话的请 是否接受建立会话


7



的请 是否接受建立会话的请 是否接受建立会话的请 是否接受建立会话的请 是否接受建
立会话的请 是否接受建立会话的请 求。 truetruetrue 表示建立会话 成功, falsefalse
falsefalse表示建立会 表示建立会 话失败,此时 话失败,此时 话失败,此时 话失败,
此时 referenceIdreferenceIdreferenceIdreferenceIdreferenceIdreferenceId 为空。
4.
pubKey pubKey pubKeypubKey
必选
StringStringStringString String
64
加解密公钥 加解密公钥
5.
otherInfootherInfootherInfo otherInfo otherInfootherInfo
可选
element element
其他信息 其他信息
备用
4. 响应报文体模板
cde2db52-8cee-45f4-9cec-f8a68ebbad5c
V1.0 catalog true
初始化服务成功
6.1.2 目录服务终止
公共信息目录服务终止将结束服务端与客户端的会话,与会话相关的资源将被释放。
1. 请求报文体 序号 元素名称 元素名称 约束 类型 长度 描述 取值说明 取值说明
1.
referenceIdreferenceIdreferenceIdreferenceId referenceId
必选
StringStringStringString String
50
会话标识 会话标识
要终止的会话编号 要终止的会话编号 要终止的会话编号 要终止的会话编号
2.
closeReason closeReasoncloseReasoncloseReason closeReason closeReasoncloseReason
可选
StringStringStringString String
50
终止原因 终止原因
3.
otherInfootherInfootherInfo otherInfo otherInfootherInfo
可选
element element
其他信息 其他信息
备用
2. 求报文体模板
cde2db52-8cee-45f4-9cec-f8a68ebbad5c
智慧城市公共信息平台-平台接口与服务要求


8



12
< closeReason >终止使用< closeReason >
6.1.3 认证授权
认证授权主要是公钥获取接口服务,用于根据客户端应用的请求,取出最新的加解密公钥
并返回给客户端的过程。
公钥获取与其他接口不同,不需要用户验证,不需要会话标识。调用客户端只有获取公钥
后对用户认证信息进行加密才能完成其服务调用。
整个密码加解密的处理过程如下图所示:
图2. .密码加解密的处理过程图
1. 请求报文体 序号 元素名称 元素名称 约束 类型 长度 描述 取值说明 取值说明
1.
otherInfootherInfootherInfo otherInfo otherInfootherInfo
可选
element element
其他信息
备用
2. 请求报文体模板
智慧城市公共信息平台-平台接口与服务要求
13
< pubKeyRequest >
3. 响应报文体 序号 元素名称 元素名称 约束 类型 长度 描述 取值说明 取值说明
1.
pubKey pubKey pubKeypubKey
必选
StringStringStringString String
8
公钥
用于加解密码的密钥
2.
opResultopResult opResult opResult
必选
element element
操作结果
参见《表 参见《表 参见《表 参见《表 A.6A.6A.6 opResultopResult opResult opResult 属
性表》之 属性表》之 属性表》之 说明
3.
otherInfootherInfootherInfo otherInfo otherInfootherInfo
可选
element element
其他信息
备用
4. 响应报文体模板 < pubkey>catalog< pubkey> <
opStatus>true< opStatus > < opRetCode >code< opRetCode > < opRetMsg >message<
opRetMsg > < opResult> < pubKeyRespe >
6.2 6.2 发现接口 要求


9



6.2.1 资源目录检索
公共信息目录检索是服务端根据客户端指定的检索条件,在服务器端从元数据库中检索并
标识出匹配的元数据记录,并将元数据记录保存在结果集中的过程。
结果集的保存时间与会话标识一致,当会话结束后,响应的结果集将被同步删除。
智慧城市公共信息平台-平台接口与服务要求
14
1. 请求报文体 序号 元素名称 元素名称 约束 类型 长度 描述 取值说明 取值说明
1.
referenceIdreferenceIdreferenceIdreferenceId referenceId
必选
StringStringStringString String
50
会话标识 会话标识
2.
replaceIndicatoreplaceIndicato replaceIndicato replaceIndicato replaceIndicato
replaceIndicatoreplaceIndicatoreplaceIndicator
必选
Boolean Boolean
结果集覆盖 结果集覆盖 结果集覆盖 结果集覆盖 结果集覆盖 标志
truetruetrue 表示覆盖原来的查 表示覆盖原来的查 表示覆盖原来的查 表示覆盖原来的查
表示覆盖原来的查 表示覆盖原来的查 表示覆盖原来的查 表示覆盖原来的查 询结果,
询结果, falsefalse falsefalse表示保留 表示保留 原来的查询结果 原来的查询结果 原来
的查询结果
3.
resultSetIDresultSetID resultSetID resultSetIDresultSetID resultSetID
必选
StringStringStringString String
200200200
指定的查询 指定的查询 指定的查询 指定的查询 指定的查询 结果集名称 结果集名称
若存在同名的结果集, 若存在同名的结果集, 若存在同名的结果集, 若存在同名的结果
集, 若存在同名的结果集, 需要根据 需要根据 replaceIndicatorreplaceIndicator
replaceIndicator replaceIndicator replaceIndicator
replaceIndicatorreplaceIndicatorreplaceIndicatorreplaceIndicator判断是 判断是 否需要覆盖
结果集。 否需要覆盖结果集。 否需要覆盖结果集。 否需要覆盖结果集。
4.
databaseame databaseamedatabaseame databaseame databaseame databaseame
databaseames
必选
Element Element Element
要查询的元 要查询的元 要查询的元 要查询的元 要查询的元 数据库名称 数据库名称
数据库名称 数据库名称 数据库名称 列表
客户端指定的要查询元数据库名称列表 元数据库名称列表 元数据库名称列表 元数据库
名称列表
5.
query query query


10



必选
Element Element Element
客户端定制 客户端定制 客户端定制 客户端定制 客户端定制 的检索语句 的检索语句
检索语句必须符合 检索语句必须符合 检索语句必须符合 检索语句必须符合 TypeType
-1型,使用逆波兰 型,使用逆波兰 型,使用逆波兰 型,使用逆波兰 表达式 (RP)(RP)
(RP) 作为检索语 作为检索语 作为检索语 法,参见《附录 法,参见《附录 法,参见
《附录 法,参见《附录 E QUERY QUERY QUERY-RP RP范例》 范例》
6.
preferredRecor preferredRecorpreferredRecorpreferredRecor preferredRecorpreferredRecor
preferredRecor preferredRecorpreferredRecordSyntax dSyntax dSyntaxdSyntaxdSyntax
可选
StringStringStringString String
10
检索结果的 检索结果的 检索结果的 检索结果的 检索结果的 编码方式 编码方式
固定取值 固定取值 :”XML” :”XML” :”XML” :”XML” :”XML”
7.
otherInfootherInfootherInfo otherInfo otherInfootherInfo
可选
Element Element Element
其他信息 其他信息
备用
2. 请求报文体模板
f4973365-a9be-4f80-b5d8-a8b9c7949185
true highResult
BMDB
XML 根据国标的逆波兰表达式
(RP)组合的查询条件„具体规则参考《附录 E QUERY E QUERYE QUERYE QUERY-RP
RP范例》 范例》
3. 响应报文体 序号 元素名称 元素名称 约束 类型 长度 描述 取值说明 取值说明
1.
referenceIdreferenceIdreferenceIdreferenceId referenceId
必选
StringStringStringString String
50
会话标识 会话标识
智慧城市公共信息平台-平台接口与服务要求
15
2.
resultCountresultCount resultCount resultCount resultCount resultCount
必选
umberString umberString
umberStringumberStringumberStringumberStringumberString umberString
20
符合条件 符合条件 符合条件 符合条件 的记录数 的记录数
服务器端执行检索操作得 服务器端执行检索操作得 服务器端执行检索操作得 服务器端


11



执行检索操作得 服务器端执行检索操作得 到的命中记录数,检索失败 到的命中记录数,
检索失败 到的命中记录数,检索失败 到的命中记录数,检索失败 到的命中记录数,检索
失败 到的命中记录数,检索失败 到的命中记录数,检索失败 设置为 设置为 0
3.
searchStatussearchStatus searchStatus
searchStatussearchStatussearchStatussearchStatussearchStatus
必选
StringStringStringString String
7
执行检索 执行检索 执行检索 执行检索 的执行结 的执行结 的执行结 的执行结 果
返回的检索状态信息, 返回的检索状态信息, 返回的检索状态信息, 返回的检索状态信
息, 返回的检索状态信息, successsuccess success success表示检索成功, 表示检索成功,
表示检索成功, failturefailture failture failture failture表示检索失败 表示检索失败 表示检
索失败 表示检索失败
4.
otherInfootherInfootherInfo otherInfo otherInfootherInfo
可选
element element
其他信息 其他信息
备用
4. 响应报文体模板
3720b175-7db7-408d-90cd-108e1f2ec887
9 success

6.2.2 资源目录检索结果提取
目录检索结果由服务器端从结果集中提取并返回若干数据记录给客户端。
1. 请求报文体 序号 元素名称 元素名称 约束 类型 长度 描述 取值说明 取值说明
1.
referenceIdreferenceIdreferenceIdreferenceId referenceId
必选
StringStringStringString String
50
会话标识 会话标识
2.
resultSetIDresultSetID resultSetID resultSetIDresultSetID resultSetID
必选
StringStringStringString String
要抽取的 要抽取的 要抽取的 要抽取的 结果集的 结果集的 结果集的 结果集的 标识
因为系统允许在抽取数据 因为系统允许在抽取数据 因为系统允许在抽取数据 因为系统
允许在抽取数据 因为系统允许在抽取数据 因为系统允许在抽取数据 因为系统允许在抽
取数据 前进行多次检 索,每前进行多次检 索,每前进行多次检 索,每前进行多次检
索,每前进行多次检 索,每前进行多次检 索,每前进行多次检 索,每索都可以指定不同
的结果 索都可以指定不同的结果 索都可以指定不同的结果 索都可以指定不同的结果 索
都可以指定不同的结果 索都可以指定不同的结果 索都可以指定不同的结果 集名称,所以
客户端必须 集名称,所以客户端必须 集名称,所以客户端必须 集名称,所以客户端必须


12



集名称,所以客户端必须 集名称,所以客户端必须 集名称,所以客户端必须 指定要抽取
的数据结果集 指定要抽取的数据结果集 指定要抽取的数据结果集 指定要抽取的数据结
果集 指定要抽取的数据结果集 指定要抽取的数据结果集 指定要抽取的数据结果集 标识
3.
resultSetStartPresultSetStartP resultSetStartP resultSetStartPresultSetStartP
resultSetStartPresultSetStartPresultSetStartP resultSetStartPointoint oint
必选
umberString umberString
umberStringumberStringumberStringumberStringumberString umberString
20
开始抽取 开始抽取 开始抽取 开始抽取 的位置
客户端指定的从第几条记 客户端指定的从第几条记 客户端指定的从第几条记 客户端指
定的从第几条记 客户端指定的从第几条记 客户端指定的从第几条记 客户端指定的从第
几条记 录开始抽取,序号从 录开始抽取,序号从 录开始抽取,序号从 录开始抽取,序
号从 1开 始
4.
numberOfReco numberOfReconumberOfReco numberOfReco numberOfReconumberOfReco
numberOfRecordsResquestedrdsResquested rdsResquestedrdsResquested rdsResquested
rdsResquestedrdsResquested
必选
umberString umberString
umberStringumberStringumberStringumberStringumberString umberString
20
记录数
客户端指定的要抽取记 客户端指定的要抽取记 客户端指定的要抽取记 客户端指定的要
抽取记 客户端指定的要抽取记 客户端指定的要抽取记 客户端指定的要抽取记 录数
5.
elementSeta elementSetaelementSetaelementSeta elementSeta me
必选
element element
结果集属 结果集属 结果集属 结果集属 性
参见表 《参见表 《A.3A.3 elementSetame elementSetame
elementSetameelementSetameelementSetame elementSetame elementSetame结果 集
属性》 集属性》
智慧城市公共信息平台-平台接口与服务要求
16
6.
preferredRecor preferredRecorpreferredRecorpreferredRecor preferredRecorpreferredRecor
preferredRecor preferredRecorpreferredRecordSyntax dSyntax dSyntaxdSyntaxdSyntax
可选
StringStringStringString String
10
提取结果 提取结果 提取结果 提取结果 的编码方 的编码方 的编码方 的编码方 式
固定取值 固定取值 :”XML” :”XML” :”XML” :”XML” :”XML”
7.


13



otherInfootherInfootherInfo otherInfo otherInfootherInfo
可选
element element
其他信息 其他信息
备用
2. 请求报文体模板
f4973365-a9be-4f80-b5d8-a8b9c7949185
highResult 0
30
brief
XML
3. 响应报文体 序号 元素名称 元素名称 约束 类型 长度 描述 取值说明 取值说明
1.
referenceIdreferenceIdreferenceIdreferenceId referenceId
必选
StringStringStringString String
50
会话标识 会话标识
2.
numberOfRecord numberOfRecordnumberOfRecord numberOfRecord
numberOfRecordnumberOfRecord
numberOfRecordnumberOfRecordnumberOfRecordsReturnedsReturnedsReturned sReturned
必选
umberString umberString
umberStringumberStringumberStringumberStringumberString umberString
20
元数 据元数 据元数 据元数 据目
服务器端返回的元数 服务器端返回的元数 服务器端返回的元数 服务器端返回的元数 据
数目
3.
presentStatus presentStatus
presentStatuspresentStatuspresentStatuspresentStatuspresentStatuspresentStatus
必选
StringStringStringString String
7
提取状态 提取状态
服务器端返回的提取 服务器端返回的提取 服务器端返回的提取 服务器端返回的提取 状
态。 successsuccess successsuccess 表示提 表示提 取成功, 取成功, failturefailture failture
failture failture表示提 表示提 取失败
4.
recordsrecords recordsrecordsrecords
必选
element element
结果集
服务器返回的结果集 服务器返回的结果集 服务器返回的结果集 服务器返回的结果集 ,


14



包含一个 或多包含一个 或多包含一个 或多singleRecordsingleRecord
singleRecordsingleRecord singleRecord singleRecordsingleRecordsingleRecord,详细描述 ,
详细描述 ,详细描述 ,详细描述 参见《表 参见《表 A. 5 singleRecordsingleRecord
singleRecordsingleRecord singleRecord singleRecordsingleRecordsingleRecord参数表》 参数
表》 参数表》
5.
otherInfootherInfootherInfo otherInfo otherInfootherInfo
可选
element element
其他信息 其他信息
备用
4. 响应报文体模板
f4973365-a9be-4f80-b5d8-a8b9c7949185
9
success 结构化资源目录 结构化资源目录 结构化
资源目录 结构化资源目录 非结构化资源目录 非结构化资源目录 非结构化资源目录 非
结构化资源目录
智慧城市公共信息平台-平台接口与服务要求
17

6.3 6.3 资源服务接口 资源服务接口 资源服务接口 资源服务接口 资源服务接口 要求
6.3.1 资源内容检索
资源检索是公共信息平台服务端根据客户端发送的请求信息,从共享数据库中读取符合条
件的记录,并将查询结果集相关返回的过程。注意,资源检索功能并不返回具体的结果集,
结果集返回功能将由”资源检索结果提取”服务提供。
结果集的保存时间与会话标识一致,当会话结束后,响应的结果集将被同步删除。
1. 请求报文体 序号 元素名称 元素名称 约束 类型 长度 描述 取值说明 取值说明
1.
referenceIdreferenceIdreferenceIdreferenceId referenceId
必选
StringStringStringString String
50
会话标识 会话标识
2.
resIdresId resId
必选
StringStringStringString String
50
资源标识符 资源标识符
6位字母 位字母 数字加 数字加 ”” 加 1到 23 位数字 位数字
3.
replaceIndicatorreplaceIndicator replaceIndicator replaceIndicator replaceIndicator
replaceIndicatorreplaceIndicatorreplaceIndicatorreplaceIndicator
必选
Boolean Boolean


15



结果集覆盖 结果集覆盖 结果集覆盖 结果集覆盖 标志
truetruetrue 表示覆盖原来的查询 表示覆盖原来的查询 表示覆盖原来的查询 表示覆盖原
来的查询 表示覆盖原来的查询 结果, falsefalse falsefalse表示保留原来 表示保留原来
表示保留原来 表示保留原来 的查询结果 的查询结果
4.
resultSetIDresultSetID resultSetID resultSetIDresultSetID resultSetID
必选
StringStringStringString String
200200200
指定的查询 指定的查询 指定的查询 指定的查询 结果集名称 结果集名称
若存在同名的结果集,需 若存在同名的结果集,需 若存在同名的结果集,需 若存在同名
的结果集,需 若存在同名的结果集,需 若存在同名的结果集,需 若存在同名的结果集,
需 要根据 要根据 replaceIndicatorreplaceIndicator replaceIndicator replaceIndicator
replaceIndicator replaceIndicatorreplaceIndicatorreplaceIndicatorreplaceIndicator判 断是否需
要覆盖结果集。 断是否需要覆盖结果集。 断是否需要覆盖结果集。 断是否需要覆盖结果
集。 断是否需要覆盖结果集。
5.
dataQuery dataQuerydataQuery dataQuery dataQuery
必选
element element
客户端定制 客户端定制 客户端定制 客户端定制 的检索条件 的检索条件
参见《附录 参见《附录 参见《附录 C QUERY QUERY QUERY-RES
RES-DATADATADATADATA说明》 说明》 – dataQuery dataQuerydataQuery dataQuery
dataQuery属性说明 属性说明 属性说明
6.
preferredRecord preferredRecordpreferredRecordpreferredRecord
preferredRecordpreferredRecord preferredRecord
preferredRecordpreferredRecordpreferredRecordSyntaxSyntax SyntaxSyntaxSyntax
可选
StringStringStringString String
10
检索结果的 检索结果的 检索结果的 检索结果的 编码方式 编码方式
固定取值 固定取值 :”XML” :”XML” :”XML” :”XML” :”XML”
7.
otherInfootherInfootherInfo otherInfo otherInfootherInfo
可选
element element
其他信息 其他信息
备用
2. 请求报文体模板
d8137d81-ef76-4dc5-80c7-01dc493f9d3f
GXWgxwAA000 GXWgxwAA000
true
智慧城市公共信息平台-平台接口与服务要求
18


16



XML 取值参考dataQuery属
性说明
3. 响应报文体 序号 元素名称 元素名称 约束 类型 长度 描述 取值说明 取值说明
1.
referenceIdreferenceIdreferenceIdreferenceId referenceId
必选
StringStringStringString String
50
会话标 会话标 会话标 识
2.
resultCountresultCount resultCount resultCount resultCount resultCount
必选
umberString umberString
umberStringumberStringumberStringumberStringumberString umberString
20
符合条 符合条 符合条 件的记 件的记 件的记 录数
服务器端执行检索操 服务器端执行检索操 服务器端执行检索操 服务器端执行检索操 作
得到的命中记录 作得到的命中记录 作得到的命中记录 作得到的命中记录 数,检索失败
设置为 数,检索失败设置为 数,检索失败设置为 数,检索失败设置为 0
3.
searchStatussearchStatus searchStatus
searchStatussearchStatussearchStatussearchStatussearchStatus
必选
StringStringStringString String
7
执行检 执行检 执行检 索的执 索的执 索的执 行结果
返回的检索状态信 返回的检索状态信 返回的检索状态信 返回的检索状态信 息,
successsuccess successsuccess 表示检索 表示检索 成功, failturefailture failture failture
failture表示检 表示检 索失败
4.
opResultopResult opResult opResult
可选
element element
操作信 操作信 操作信 息
详情参见附录 详情参见附录 详情参见附录 详情参见附录 详情参见附录 详情参见附录
表 A.4 -opResultopResult opResult opResult 属性表 属性表
5.
otherInfootherInfootherInfo otherInfo otherInfootherInfo
可选
element element
其他信 其他信 其他信 息
备用
4. 响应报文体模板
d8137d81-ef76-4dc5-80c7-01dc493f9d3f
0 failure


17



failure 错误代码 错误信息

6.3.2 资源内容检索结果提取
资源检索结果提取用于从<资源检索>所得的结果集中提取指定的结果。
1. 请求报文体
智慧城市公共信息平台-平台接口与服务要求
19
序号 元素名称 元素名称 约束 类型 长度 描述 取值说明 取值说明
1.
referenceIdreferenceIdreferenceIdreferenceId referenceId
必选
StringStringStringString String
50
会话标识 会话标识
2.
resultSetIDresultSetID resultSetID resultSetIDresultSetID resultSetID
必选
StringStringStringString String
要抽取的 要抽取的 要抽取的 要抽取的 结果集的 结果集的 结果集的 结果集的 标识
因为系统允许在抽 因为系统允许在抽 因为系统允许在抽 因为系统允许在抽 因为系统允
许在抽 因为系统允许在抽 因为系统允许在抽 因为系统允许在抽 取数据前进行多次 取
数据前进行多次 取数据前进行多次 取数据前进行多次 取数据前进行多次 取数据前进行
多次 取数据前进行多次 取数据前进行多次 检索,每次都 检索,每次都 检索,每次都
检索,每次都 检索,每次都 检索,每次都 检索,每次都 检索,每次都 可以指定不同的
结 可以指定不同的结 可以指定不同的结 可以指定不同的结 可以指定不同的结 可以指
定不同的结 可以指定不同的结 可以指定不同的结 果集名称,所以客 果集名称,所以客
果集名称,所以客 果集名称,所以客 果集名称,所以客 果集名称,所以客 果集名称,
所以客 果集名称,所以客 户端必须指定要抽 户端必须指定要抽 户端必须指定要抽 户端
必须指定要抽 户端必须指定要抽 户端必须指定要抽 户端必须指定要抽 户端必须指定要
抽 取的数据结果集标 取的数据结果集标 取的数据结果集标 取的数据结果集标 取的数
据结果集标 取的数据结果集标 取的数据结果集标 取的数据结果集标 识
3.
resultSetStartPointresultSetStartPoint resultSetStartPoint resultSetStartPointresultSetStartPoint
resultSetStartPointresultSetStartPointresultSetStartPoint
resultSetStartPointresultSetStartPointresultSetStartPoint resultSetStartPoint
必选
umberString umberString
umberStringumberStringumberStringumberStringumberString umberString
20
开始抽取 开始抽取 开始抽取 开始抽取 的位置
客户端指定的从第 客户端指定的从第 客户端指定的从第 客户端指定的从第 客户端指定
的从第 客户端指定的从第 客户端指定的从第 客户端指定的从第 几条记录开始抽 几条
记录开始抽 几条记录开始抽 几条记录开始抽 几条记录开始抽 几条记录开始抽 几条记
录开始抽 取,序号从 取,序号从 取,序号从 1开始
4.


18



numberOfRecordsRe numberOfRecordsRenumberOfRecordsRe numberOfRecordsRe
numberOfRecordsRenumberOfRecordsRe
numberOfRecordsRenumberOfRecordsRenumberOfRecordsRe
numberOfRecordsRenumberOfRecordsResquestedsquested squested squestedsquested
必选
umberString umberString
umberStringumberStringumberStringumberStringumberString umberString
20
记录数
客户端指定的要抽 客户端指定的要抽 客户端指定的要抽 客户端指定的要抽 客户端指定
的要抽 客户端指定的要抽 客户端指定的要抽 客户端指定的要抽 取的记录数 取的记录

5.
numberOfRecordsTo numberOfRecordsTonumberOfRecordsTo numberOfRecordsTo
numberOfRecordsTonumberOfRecordsTo
numberOfRecordsTonumberOfRecordsTonumberOfRecordsTo
numberOfRecordsTonumberOfRecordsTotaltal
必选
umberString umberString
umberStringumberStringumberStringumberStringumberString umberString
20
符合条件 符合条件 符合条件 符合条件 的总共命 的总共命 的总共命 的总共命 中记录
数 中记录数
资源检索接口查询 资源检索接口查询 资源检索接口查询 资源检索接口查询 资源检索接
口查询 资源检索接口查询 资源检索接口查询 资源检索接口查询 得到的总共命中记 得
到的总共命中记 得到的总共命中记 得到的总共命中记 得到的总共命中记 得到的总共命
中记 得到的总共命中记 得到的总共命中记 录数。
6.
preferredRecordSynt preferredRecordSyntpreferredRecordSyntpreferredRecordSynt
preferredRecordSyntpreferredRecordSynt preferredRecordSynt
preferredRecordSyntpreferredRecordSyntpreferredRecordSynt preferredRecordSynt
preferredRecordSyntax
可选
StringStringStringString String
10
提取结果 提取结果 提取结果 提取结果 的编码方 的编码方 的编码方 的编码方 式
固定取值 固定取值 :”XML” :”XML” :”XML” :”XML” :”XML”
7.
otherInfootherInfootherInfo otherInfo otherInfootherInfo
可选
element element
其他信息 其他信息
备用
2. 请求报文体模板
2190bf83-a934-4f4d-995c-f688dc4808ae


19



JTJQDJTJ00000 1
30
3
XML
3. 响应报文体 序号 元素名称 元素名称 约束 类型 长度 描述 取值说明 取值说明
1.
referenceIdreferenceIdreferenceIdreferenceId referenceId
必选
StringStringStringString String
50
会话标识 会话标识
2.
numberOfReco numberOfReconumberOfReco numberOfReco numberOfReconumberOfReco
numberOfRecordsReturnedrdsReturned rdsReturnedrdsReturned
rdsReturnedrdsReturnedrdsReturned
必选
umberString umberString
umberStringumberStringumberStringumberStringumberString umberString
20
元数 据元数 据元数 据元数 据目
服务器端返回的元数 据服务器端返回的元数 据服务器端返回的元数 据服务器端返回的
元数 据服务器端返回的元数 据目
智慧城市公共信息平台-平台接口与服务要求
20
3.
presentStatus presentStatus
presentStatuspresentStatuspresentStatuspresentStatuspresentStatuspresentStatus
必选
StringStringStringString String
7
提取状态 提取状态
服务器端返回的提取状 服务器端返回的提取状 服务器端返回的提取状 服务器端返回的
提取状 服务器端返回的提取状 态。 successsuccess success success表示提取成 表示提取
成 表示提取成 功, failturefailture failture failture failture表示提取失败 表示提取失败 表
示提取失败 表示提取失败
4.
resTyperesType resType
必选
StringStringStringString String
50
资源种类 资源种类
结构化资 源或非结构化资 源或非结构化资 源或非结构化资 源或非结构化资 源或非源,
不同的资种类对应 源,不同的资种类对应 源,不同的资种类对应 源,不同的资种类对应
源,不同的资种类对应 的 singleRecordsingleRecord singleRecordsingleRecord singleRecord
singleRecordsingleRecordsingleRecord中 Item Item 项 不同


20



5.
recordsrecords recordsrecordsrecords
必选
element element
结果集
服务器返回的结果集 服务器返回的结果集 服务器返回的结果集 服务器返回的结果集 ,
包 含一个 或多含一个 或多含一个 或多singleRecordsingleRecord
singleRecordsingleRecord singleRecord singleRecordsingleRecordsingleRecord,详细描述参 ,
详细描述参 ,详细描述参 ,详细描述参 见《 B.2 B.2资源检索结果提取 资源检索结果
提取 资源检索结果提取 资源检索结果提取 资源检索结果提取 结构 》
6.
otherInfootherInfootherInfo otherInfo otherInfootherInfo
可选
element element
其他信息 其他信息
备用
4. 响应报文体模板
687d0aed-6e43-44eb-9d0e-e25eeca83470
3 s
结构化资源 „.(具体结构参
照)
6.4 6.4 管理接口 要求
6.4.1 目录资源元数据管理
目录资源元数据管理接口包含元数据的新增、删除和更新操作,根据不同的操作类型来完
成相应的动作,且元数据管理接口一次只操作一种操作类型的一条元数据记录。
当操作类型为更新时其操作对象为通过“目录检索结果提取”接口返回的元数据,元数据
元素必须符合《核心元数据属性集》要求;
当操作类型为删除时,其操作对象为通过“目录检索结果提取”接口返回的元数据中的特
定一条记录;
智慧城市公共信息平台-平台接口与服务要求
21
当操作类型为创建时,请求方必须按附录B约定的编目要求提供完整的元数据信息。
1. 请求报文 序号 元素名称 元素名称 约束 类型 长度 描述 取值说明 取值说明
1
referenceIreferenceIreferenceIreferenceI referenceI d
必选
StringStringStringString String
50
会话标识 会话标识
2
typetype
必选
Int Int
用于指定进行元数据 用于指定进行元数据 用于指定进行元数据 用于指定进行元数据 用
于指定进行元数据 用于指定进行元数据 用于指定进行元数据 用于指定进行元数据 用于


21



指定进行元数据 的各种管理操作,详细 的各种管理操作,详细 的各种管理操作,详细
的各种管理操作,详细 内容见表 内容见表 内容见表 内容见表 A.6A.6 《元数 据管理类
型定义》 据管理类型定义》 据管理类型定义》 据管理类型定义》
3
recordIdrecordId recordIdrecordIdrecordId recordId
可选
StringStringStringString String
待删除或更新的元数据标识符 (即资 源标识符 )。该标识 符用于在元数据库中指定唯一
的元数据。可以通过目录检索结果提取接口获取其响应消息。 获取其响应消息。 获取其
响应消息。 获取其响应消息。
当 typetype 为 1时,进行 时,进行 元数据插入操作,本参 元数据插入操作,本参 元
数据插入操作,本参 元数据插入操作,本参 数不出现;当 数不出现;当 数不出现;当
typetype type为 2或 3时,进行元数据 时,进行元数据 时,进行元数据 时,进行元数
据 删除或更新操作,本参 删除或更新操作,本参 删除或更新操作,本参 删除或更新操
作,本参 数 为必选参数 为必选参数
为必选参4
Data DataData
可选
XMLXML
待创建或更新的元数据内容,当 数据内容,当 数据内容,当 数据内容,当 数据内容,
当 数据内容,当 typetype 为 1或 3时,进行 时,进行 元数据插入或更新操作,本参数
为必选参数;当 选参数;当 typetype 为 2时,进行元数据删 时,进行元数据删 时,进
行元数据删 时,进行元数据删 除操作,本参数不出现
更新操作时, 更新操作时, 更新操作时, 更新操作时, 更新操作时, 更新操作时,
Data DataData格 式定义为 式定义为 :


me>


, , ,,, ,
RecordsRecords RecordsRecordsRecords 节点包含一组 节点包含一组 节点包含一组 或多
组元数据属性参 或多组元数据属性参 或多组元数据属性参 或多组元数据属性参 或多组
元数据属性参 或多组元数据属性参 或多组元数据属性参 或多组元数据属性参 或多组元
数据属性参 数 itemame itemame itemame和元数 据属性值参数 据属性值参数 据属
性值参数 据属性值参数 据属性值参数 据属性值参数 itemValue itemValue itemValue
itemValue 。itemame itemame itemame itemame取值要求符合《表 取值要求符合《表
取值要求符合《表 核 心元数据属性集》之约 心元数据属性集》之约 心元数据属性集》
之约 心元数据属性集》之约 定
智慧城市公共信息平台-平台接口与服务要求
22
5


22



otherInfootherInfootherInfo otherInfo otherInfootherInfo
可选
StringStringStringString String
其他信息 其他信息
备用
2. 返回报文 序号 元素名称 元素名称 约束 类型 长度 描述 取值说明 取值说明
1.
referenceIdreferenceIdreferenceIdreferenceId referenceId
必选
StringStringStringString String
50
会话标识 会话标识
2.
operationStateoperationState operationStateoperationStateoperationState operationState
operationStateoperationStateoperationStateoperationState
必选
StringStringStringString String
7
执行结果 执行结果
SuccessSuccess Success Success表示执行元数据管理操 表示执行元数据管理操 表示执行
元数据管理操 表示执行元数据管理操 表示执行元数据管理操 作成功; 作成功;
FailtureFailture Failture Failture Failture表示执行元数据管理操 表示执行元数据管理操 表
示执行元数据管理操 表示执行元数据管理操 表示执行元数据管理操 表示执行元数据管
理操 作失败
3.
operationTypeoperationType operationTypeoperationTypeoperationType operationType
operationType
可选
Int Int
操作类型 操作类型
用来表示服务器端执行的元数 用来表示服务器端执行的元数 用来表示服务器端执行的元
数 用来表示服务器端执行的元数 用来表示服务器端执行的元数 用来表示服务器端执行
的元数 据管理操作类型,必须符合《表 据管理操作类型,必须符合《表 据管理操作类型,
必须符合《表 据管理操作类型,必须符合《表 据管理操作类型,必须符合《表 据管理操
作类型,必须符合《表 据管理操作类型,必须符合《表 据管理操作类型,必须符合《表
据管理操作类型,必须符合《表 元数据管理类型定 义》之约元数据管理类型定 义》之约
元数据管理类型定 义》之约元数据管理类型定 义》之约元数据管理类型定 义》之约元数
据管理类型定
义》之约4.
otherInfootherInfootherInfo otherInfo otherInfootherInfo
可选
element element
其他信息 其他信息
当 执行成功时本元素不出现,当 执行成功时本元素不出现,当 执行成功时本元素不出现,
当 执行成功时本元素不出现,当 执行成功时本元素不出现,当 执行成功时本元素不出现,


23



当 执行成功时本元素不出现,执行失败时,格式定为: 执行失败时,格式定为: 执行失
败时,格式定为: 执行失败时,格式定为: 执行失败时,格式定为: 执行失败时,格式
定为: 执行失败时,格式定为: 执行失败时,格式定为: 执行失败时,格式定为: 执
行失败时,格式定为: 执行失败时,格式定为:





,errcode
errcodeerrcodeerrcodeerrcode 表 示错误码, 示错误码, 示错误码,
errMsgerrMsgerrMsgerrMsg errMsg表示错误信息 表示错误信息 表示错误信息
智慧城市公共信息平台-平台接口与服务要求
23
附录 A 要求 所涉及的结构表
表 A.1 databaseListdatabaseList databaseList databaseList 组成 参数名称 约束 参数含义
databaseId databaseIddatabaseId databaseId databaseId
必选
标识一个元数据库,以公共信息平台的应用 标识一个元数据库,以公共信息平台的应用
标识一个元数据库,以公共信息平台的应用 标识一个元数据库,以公共信息平台的应用
标识一个元数据库,以公共信息平台的应用 标识一个元数据库,以公共信息平台的应用
标识一个元数据库,以公共信息平台的应用 标识一个元数据库,以公共信息平台的应用
标识一个元数据库,以公共信息平台的应用 单位 编号代替 编号代替
databaseame databaseamedatabaseame databaseame databaseame databaseame
databaseame
必选
元数据库名称 元数据库名称 元数据库名称
databaseDescribe databaseDescribedatabaseDescribe databaseDescribe databaseDescribe
databaseDescribedatabaseDescribe databaseDescribe
必选
元数据库的基本描述信息 元数据库的基本描述信息 元数据库的基本描述信息 元数据库
的基本描述信息 元数据库的基本描述信息
表 A.2 A.2 服务功能列表 功能标识 交易编码 (transid)(transid)(transid)(transid)(transid)
(transid)(transid) 国标要求 是否支持 含义
init
initRequest initRequest initRequestinitRequest initRequest


用于建立客户端与服务 用于建立客户端与服务 用于建立客户端与服务 用于建立客户端
与服务 用于建立客户端与服务 用于建立客户端与服务 用于建立客户端与服务 用于建立
客户端与服务 用于建立客户端与服务 用于建立客户端与服务 端的会话 端的会话
close closecloseclose
closeRequest closeRequestcloseRequestcloseRequest closeRequest closeRequest




24



终止客户端与服务的 终止客户端与服务的 终止客户端与服务的 终止客户端与服务的 终
止客户端与服务的 终止客户端与服务的 终止客户端与服务的 终止客户端与服务的 终止
客户端与服务的 终止客户端与服务的 会话
capbilitiescapbilities capbilities capbilities capbilitiescapbilities
catalogCapabilitiesRequecatalogCapabilitiesRequecatalogCapabilitiesRequecatalogCapabilitiesR
eque catalogCapabilitiesRequecatalogCapabilitiesRequecatalogCapabilitiesReque
catalogCapabilitiesReque catalogCapabilitiesReque
catalogCapabilitiesRequecatalogCapabilitiesReque
catalogCapabilitiesRequecatalogCapabilitiesReque st


提供服务本身的各种描 提供服务本身的各种描 提供服务本身的各种描 提供服务本身的
各种描 提供服务本身的各种描 提供服务本身的各种描 提供服务本身的各种描 提供服务
本身的各种描 提供服务本身的各种描 提供服务本身的各种描 述信息
searchsearch search
searchRequestsearchRequest searchRequest searchRequestsearchRequest searchRequest


检索目录信息并形成结 检索目录信息并形成结 检索目录信息并形成结 检索目录信息并
形成结 检索目录信息并形成结 检索目录信息并形成结 检索目录信息并形成结 检索目录
信息并形成结 检索目录信息并形成结 检索目录信息并形成结 果集
present present present
presentRequest presentRequest presentRequestpresentRequestpresentRequest presentRequest
presentRequest


目录检索结果提取 ,从 结果 集中提取结果 集中提取结果 集中提取结果
集中提取metadataManagmetadataManag metadataManag
metadataManagmetadataManagmetadataManag metadataManag metadataManag er


对公共信息平台进行远 对公共信息平台进行远 对公共信息平台进行远 对公共信息平台
进行远 对公共信息平台进行远 对公共信息平台进行远 对公共信息平台进行远 对公共信
息平台进行远 对公共信息平台进行远 对公共信息平台进行远 程管理
resSelfDescresSelfDesc resSelfDesc resSelfDesc resSelfDesc
resSelfDescRequestresSelfDescRequest resSelfDescRequest resSelfDescRequest
resSelfDescRequest resSelfDescRequest resSelfDescRequest resSelfDescRequest


资源自描述 资源自描述
dataSearch dataSearchdataSearch dataSearch dataSearch
dataSearchRequest dataSearchRequestdataSearchRequest dataSearchRequest dataSearchRequest
dataSearchRequestdataSearchRequest dataSearchRequest dataSearchRequest




25



检索资源 检索资源
dataPresent dataPresentdataPresent dataPresentdataPresent dataPresent
dataPresentRequest dataPresentRequestdataPresentRequest
dataPresentRequestdataPresentRequest
dataPresentRequestdataPresentRequestdataPresentRequest dataPresentRequest


从检索出的资源结果集 从检索出的资源结果集 从检索出的资源结果集 从检索出的资源
结果集 从检索出的资源结果集 从检索出的资源结果集 从检索出的资源结果集 从检索出
的资源结果集 从检索出的资源结果集 从检索出的资源结果集 中抽取数据 中抽取数据
pubKey pubKey pubKeypubKey
pubKeyRequest pubKeyRequest pubKeyRequestpubKeyRequest pubKeyRequest
pubKeyRequest pubKeyRequest


用于从服务端获取公钥 用于从服务端获取公钥 用于从服务端获取公钥 用于从服务端获
取公钥 用于从服务端获取公钥
智慧城市公共信息平台-平台接口与服务要求
24
表 A. 3 elementSetame elementSetame elementSetameelementSetame elementSetame
elementSetame 结果集属性 结果集属性 结果集属性 结果集属性 结果集属性 参数名称
参数类型 取值 参数含义
genericElementgenericElement genericElement genericElement genericElement
genericElement-SetameSetame Setame Setame
StringStringStringString String
Brief Brief Brief
提取信息资源核心 提取信息资源核心 提取信息资源核心 提取信息资源核心 提取信息资
源核心 提取信息资源核心 提取信息资源核心 提取信息资源核心 元数据
genericElementgenericElement genericElement genericElement genericElement
genericElement-SetameSetame Setame Setame
StringStringStringString String
FullFull Full或空
提取全部的信息资 提取全部的信息资 提取全部的信息资 提取全部的信息资 提取全部的
信息资 提取全部的信息资 提取全部的信息资 提取全部的信息资 源元数据 源元数据
elementSet elementSetelementSetelementSet
List ListList ListList ListList
元数据属性字段标 元数据属性字段标 元数据属性字段标 元数据属性字段标 元数据属性
字段标 元数据属性字段标 元数据属性字段标 元数据属性字段标 识符列表 识符列表
必须符合《表 必须符合《表 必须符合《表 必须符合《表 核心 元数据属性集》的 元数
据属性集》的 元数据属性集》的 元数据属性集》的 元数据属性集》的 元数据属性集》
的 元数据属性集》的 元数据属性集》的 编码要求 编码要求
表 A. 4 opResult opResult opResult 属性表 属性名 类型 长度 约束 参数含义
opStatusopStatus opStatusopStatusopStatusopStatus
StringStringStringString String
8


26



必选
执行结果, 执行结果, 执行结果, 执行结果, 执行结果, ”success” ”success” ”
success” ”success” ”success” ”success” 表示成功 表示成功 表示成功 表示成功 ,”
failture” ,”failture” ,”failture” ,”failture” ,”failture” ,”failture” ,”failture” 表
示失败 表示失败
opRetCodeopRetCode opRetCode opRetCode opRetCode
StringStringStringString String
8
可选
执行结果, 执行结果, 执行结果, 执行结果, 执行结果, ”00000000” ”00000000” ”
00000000” ”00000000” ”00000000” ”00000000” ”00000000” ”00000000” ”
00000000” 表示成功 表示成功 表示成功 表示成功 ,其他表 其他表 其他表 示错误代码
示错误代码
opRetMsgopRetMsg opRetMsg opRetMsg opRetMsg
StringStringStringString String
200200200
可选
错误的说明 错误的说明
表 A. 5 singleRecord singleRecordsingleRecord singleRecordsingleRecord singleRecord参数表
参数名称 参数类型 约束 参数含义
item item
element element
必选
结果集中的元数据 记录,包含一组或多结果集中的元数据 记录,包含一组或多结果集中
的元数据 记录,包含一组或多结果集中的元数据 记录,包含一组或多结果集中的元数据
记录,包含一组或多结果集中的元数据 记录,包含一组或多结果集中的元数据 记录,包
含一组或多结果集中的元数据 记录,包含一组或多结果集中的元数据 记录,包含一组或
多结果集中的元数据 记录,包含一组或多属性参数 属性参数 属性参数 属性参数
itemame itemame itemame itemame和元数 据属性值参和元数 据属性值参和元数
据属性值参和元数 据属性值参和元数 据属性值参和元数 据属性值参和元数 据属性值参
和元数 据属性值参和元数 据属性值参itemValue itemValue itemValue itemValue 。提取的
结果集是核心元数 据时,参。提取的结果集是核心元数 据时,参。提取的结果集是核心
元数 据时,参。提取的结果集是核心元数 据时,参。提取的结果集是核心元数 据时,参。
提取的结果集是核心元数 据时,参。提取的结果集是核心元数 据时,参。提取的结果集
是核心元数 据时,参。提取的结果集是核心元数 据时,参。提取的结果集是核心元数
据时,参itemame itemame itemame取值要求符合《表 取值要求符合《表 取值要求符
合《表 取值要求符合《表 取值要求符合《表 取值要求符合《表 取值要求符合《表 取值
要求符合《表 核心元数据属性 核心元数据属性 核心元数据属性 核心元数据属性 核心元
数据属性 核心元数据属性 核心元数据属性 集》
databaseId databaseIddatabaseId databaseId databaseId
StringStringStringString String
可选
提取全部的信息资源元数据 提取全部的信息资源元数据 提取全部的信息资源元数据 提
取全部的信息资源元数据 提取全部的信息资源元数据 提取全部的信息资源元数据
recordIdrecordId recordIdrecordIdrecordId recordId


27



StringStringStringString String
可选
必须符合表的编码要求 必须符合表的编码要求 必须符合表的编码要求 必须符合表的编
码要求 必须符合表的编码要求 (即资源标识符 即资源标识符 即资源标识符 )
表 A. 6 元数据管理类型定义 名称 取值 含义
智慧城市公共信息平台-平台接口与服务要求
25
创建元数据 创建元数据
1
用于表示该次请求是进行创建元数据操作 用于表示该次请求是进行创建元数据操作 用于
表示该次请求是进行创建元数据操作 用于表示该次请求是进行创建元数据操作 用于表示
该次请求是进行创建元数据操作 用于表示该次请求是进行创建元数据操作 用于表示该次
请求是进行创建元数据操作 用于表示该次请求是进行创建元数据操作
删除元数据 删除元数据
2
用于表示该次请求是进行删除元数据操作 用于表示该次请求是进行删除元数据操作 用于
表示该次请求是进行删除元数据操作 用于表示该次请求是进行删除元数据操作 用于表示
该次请求是进行删除元数据操作 用于表示该次请求是进行删除元数据操作 用于表示该次
请求是进行删除元数据操作 用于表示该次请求是进行删除元数据操作
更新元数据 更新元数据
3
用于表示该次请求是进行更新元数据操作 用于表示该次请求是进行更新元数据操作 用于
表示该次请求是进行更新元数据操作 用于表示该次请求是进行更新元数据操作 用于表示
该次请求是进行更新元数据操作 用于表示该次请求是进行更新元数据操作 用于表示该次
请求是进行更新元数据操作 用于表示该次请求是进行更新元数据操作
表 A. 7 核心元数据属性集
核心元数据属性集的编码规则如下:
第一层代码只有一位阿拉伯数字。其取值为“1”,表示核心元数据。
第二层是核心元数据元素和元数据实体,采用三位阿拉伯数字。该编码结构分为二层:第
一层采用一位阿拉伯数字,核心元数据取值为1;第二层代码采用三位阿拉伯数字,利用
递增顺序码的方法进行编码。例如,“资源名称”的编码为“1.001”,“资源出版日期”的
编码为“1.002”。
第三层是元数据实体所包含的元数据元素,采用五位阿拉伯数字。该编码结构分为三层:
第一层采用一位阿拉伯数字,核心元数据取值为1;第二层代码采用三位阿拉伯数字,利
用递增顺序码的方法进行编码,为该元数据元素所属元数据实体的编码;第三层代码采用
两位阿拉伯数字,利用递增顺序码的方法进行编码。例如,“资源负责单位”的编码为
“1.004.01”。如图A.1所示:
图A.1 核心元数据属性集的编码规则示意图
下面是相应的核心元数据属性集:
编码
中文名称
短名
1.0001.0001.0001.0001.000
资源核心元数据全文 资源核心元数据全文 资源核心元数据全文 资源核心元数据全文
resMetadataresMetadata resMetadata resMetadata resMetadataresMetadataresMetadata


28



1.0011.0011.0011.0011.001
资源名称 资源名称
resTitleresTitle resTitleresTitle
1.0021.0021.0021.0021.002
资源出版日期 资源出版日期 资源出版日期
pubCate pubCate pubCatepubCate
1.0031.0031.0031.0031.003
资源摘要 资源摘要
abstract abstractabstractabstractabstract abstract
智慧城市公共信息平台-平台接口与服务要求
26
1.0041.0041.0041.0041.004
资源负责方 资源负责方
IdPoC IdPoCIdPoCIdPoC
1.004.011.004.011.004.011.004.011.004.011.004.011.004.011.004.01
资源负责单位 资源负责单位 资源负责单位
rpOrgamerpOrgame rpOrgamerpOrgamerpOrgame rpOrgame
1.004.021.004.021.004.021.004.021.004.021.004.021.004.021.004.02
资源负责方地址 资源负责方地址 资源负责方地址
cntAdd cntAddcntAdd
1.004.031.004.031.004.031.004.031.004.031.004.031.004.031.004.03
资源负责方地址 资源负责方地址 资源负责方地址 资源负责
方地址 资源负责方地址
eMailAdd eMailAdd eMailAdd
1.0051.0051.0051.0051.005
资源格式信息 资源格式信息 资源格式信息
FmInfoFmInfoFmInfo FmInfoFmInfo
1.005.011.005.011.005.011.005.011.005.011.005.011.005.011.005.01
资源格式名称 资源格式名称 资源格式名称
fmame fmame
1.005.021.005.021.005.021.005.021.005.021.005.021.005.021.005.02
资源格式版本 资源格式版本 资源格式版本
fmVer fmVer
1.0061.0061.0061.0061.006
关键字说明 关键字说明
DescKeys DescKeys DescKeysDescKeysDescKeys
1.006.011.006.011.006.011.006.011.006.011.006.011.006.011.006.01
关键字
keywordkeywordkeyword keywordkeywordkeyword
1.006.021.006.021.006.021.006.021.006.021.006.021.006.021.006.02
词典名称 词典名称
thesaamethesaame thesaame thesaame
1.0071.0071.0071.0071.007
空间范围 空间范围
spatComspatCom spatComspatCom spatCom


29



1.0081.0081.0081.0081.008
时间范围 时间范围
TimePeriod TimePeriod TimePeriod TimePeriod TimePeriod
1.008.011.008.011.008.011.008.011.008.011.008.011.008.011.008.01
起始时间 起始时间
begCate begCate begCatebegCate
1.008.021.008.021.008.021.008.021.008.021.008.021.008.021.008.02
结束时间 结束时间
endCate endCateendCate
1.0091.0091.0091.0091.009
资源安全限制分级 资源安全限制分级 资源安全限制分级 资源安全限制分级
class class class
1.0101.0101.0101.0101.010
资源语种 资源语种
language language language languagelanguage
1.0111.0111.0111.0111.011
资源字符集 资源字符集
dataChar dataChardataChar dataChar
1.0121.0121.0121.0121.012
资源分类 资源分类
TpCatTpCat TpCat
1.012.011.012.011.012.011.012.011.012.011.012.011.012.011.012.01
类目名称 类目名称
cateamecateamecateamecateame cateame cateame
1.012.021.012.021.012.021.012.021.012.021.012.021.012.021.012.02
类目编码 类目编码
cateCodecateCodecateCodecateCode cateCodecateCode
1.012.031.012.031.012.031.012.031.012.031.012.031.012.031.012.03
分类标准 分类标准
cateStdcateStdcateStdcateStd cateStd
1.0131.0131.0131.0131.013
数据志说明 数据志说明
statementstatementstatementstatementstatement statement
1.0141.0141.0141.0141.014
在线资源链接地址 在线资源链接地址 在线资源链接地址 在线资源链接地址
onLineSrconLineSrc onLineSrc onLineSrconLineSrc
1.0151.0151.0151.0151.015
资源标识符 资源标识符
resIDresID resID
1.0161.0161.0161.0161.016
服务信息 服务信息
ServInfoServInfo ServInfo ServInfoServInfo
1. 016.011. 016.011. 016.011. 016.011. 016.011. 016.011. 016.011. 016.011. 016.01
服务地址 服务地址
servURLservURL servURL servURL


30



1. 016.021. 016.021. 016.021. 016.021. 016.021. 016.021. 016.021. 016.021. 016.02
服务类型 服务类型
servTservT servTservType ype
1.0171.0171.0171.0171.017
元数据标识符 元数据标识符 元数据标识符
mdIdmdId mdId
1.0181.0181.0181.0181.018
元数据语种 元数据语种
mdLangmdLang mdLang
1.0191.0191.0191.0191.019
元数据联系方 元数据联系方 元数据联系方
MdContact MdContact MdContactMdContactMdContact MdContact
1.019.011.019.011.019.011.019.011.019.011.019.011.019.011.019.01
元数据联系单位 元数据联系单位 元数据联系单位
rpOrgamerpOrgame rpOrgamerpOrgamerpOrgame rpOrgame
1.019.021.019.021.019.021.019.021.019.021.019.021.019.021.019.02
元数据联系方地址 元数据联系方地址 元数据联系方地址 元数据联系方地址
cntAdd cntAddcntAdd
1.019.031.019.031.019.031.019.031.019.031.019.031.019.031.019.03
元数据联系方地址 元数据联系方地址 元数据联系方地址 元
数据联系方地址 元数据联系方地址 元数据联系方地址
eMailAdd eMailAdd eMailAdd
智慧城市公共信息平台-平台接口与服务要求
27
1.0201.0201.0201.0201.020
元数据创建日期 元数据创建日期 元数据创建日期
mdCateStmdCateSt mdCateStmdCateSt
表 A. 8 关系运算符属性集
编码
名称
符号
1
小于 less than less thanless than less than less than
<
2
小于 等小于 等less than or equal less than or equalless than or equal less than or equal less
than or equal less than or equalless than or equal less than or equal less than or equal
<=
3
等于 equal equal
=
4
大于 等大于 等greater or equalgreater or equalgreater or equal greater or equalgreater or equal
greater or equal greater or equal greater or equal
>=


31



5
大于 greater thangreater thangreater than greater thangreater thangreater thangreater than
greater than greater than
>
6
不等于 不等于 not equal not equalnot equal not equal not equal
!= (或 <> )
7
模糊匹配 模糊匹配
like likelike
表 A. 9 位置运算符属性集
编码
中文名称
英文名称
1
任意位置出现 任意位置出现 任意位置出现
any position in field any position in field any position in fieldany position in field any position in
field any position in field any position in field
表 A. 10 资源自描述 ResultResult 属性集 属性集 属性集
元素名
父节点
约束
类型
取值说明
版本号
dataDescResult dataDescResultdataDescResult dataDescResult dataDescResultdataDescResult
dataDescResult
可选
StringStringStringString String
0到 9数字 +”.”+0 +”.”+0 +”.”+0 +”.”+0 到 9数字
资源种类 资源种类
dataDescResult dataDescResultdataDescResult dataDescResult dataDescResultdataDescResult
dataDescResult
必选
StringStringStringString String
“结构化资源 ”或”非结构化资源 非结构化资源 ” ,2 ” ,2 ” ,2 者 选其一
资源标识符 资源标识符
dataDescResult dataDescResultdataDescResult dataDescResult dataDescResultdataDescResult
dataDescResult
必选
StringStringStringString String
6位字母 位字母 数字加 数字加 ”” ”” 加 1到 23 位数字 位数字
归属节点 归属节点
dataDescResult dataDescResultdataDescResult dataDescResult dataDescResultdataDescResult
dataDescResult


32



必选 String
4位数字,资源归属的机构编号 位数字,资源归属的机构编号 位数字,资源归属的机构
编号 位数字,资源归属的机构编号 位数字,资源归属的机构编号 位数字,资源归属的机
构编号 位数字,资源归属的机构编号
当前状态 当前状态
dataDescResult dataDescResultdataDescResult dataDescResult dataDescResultdataDescResult
dataDescResult
必选
StringStringStringString String
编目中
编目完成 编目完成
审核中
审核完成 审核完成
注册中
注册完成 注册完成
智慧城市公共信息平台-平台接口与服务要求
28
发布中
发布完成 发布完成
资源所处状态,选择项 资源所处状态,选择项 资源所处状态,选择项 资源所处状态,选
择项 资源所处状态,选择项
开放应用 单位 列表
dataDescResult dataDescResultdataDescResult dataDescResult dataDescResultdataDescResult
dataDescResult
可选
List List
该资源开放的应用 该资源开放的应用 该资源开放的应用 该资源开放的应用 单位 清单
应用 单位
开放应用 开放应用 开放应用 开放应用 单位 列表
可选
element
包含 1~n个应用 个应用 单位 信息
应用 单位 编号
应用 单位
可选
StringStringStringString String
4位数字,资源归属的机构编号 位数字,资源归属的机构编号 位数字,资源归属的机构
编号 位数字,资源归属的机构编号 位数字,资源归属的机构编号 位数字,资源归属的机
构编号 位数字,资源归属的机构编号
应用 单位 名称
应用 单位
可选
StringStringStringString String
资源归属的机构名称 资源归属的机构名称 资源归属的机构名称 资源归属的机构名称
结构化信息 结构化信息


33



dataDescResult dataDescResultdataDescResult dataDescResult dataDescResultdataDescResult
dataDescResult
可选
List List
当资源类型为 当资源类型为 当资源类型为 ”结构化资源 结构化资源 结构化资源 ”时,
将返回 时,将返回 时,将返回 此节点信息,包含了资源对应的表及字 此节点信息,包
含了资源对应的表及字 此节点信息,包含了资源对应的表及字 此节点信息,包含了资源
对应的表及字 此节点信息,包含了资源对应的表及字 此节点信息,包含了资源对应的表
及字 此节点信息,包含了资源对应的表及字 此节点信息,包含了资源对应的表及字 段信
息,用于资源检索使。至少包含 段信息,用于资源检索使。至少包含 段信息,用于资源
检索使。至少包含 段信息,用于资源检索使。至少包含 段信息,用于资源检索使。至少
包含 段信息,用于资源检索使。至少包含 段信息,用于资源检索使。至少包含 段信息,
用于资源检索使。至少包含 段信息,用于资源检索使。至少包含 段信息,用于资源检索
使。至少包含 一个表信息 一个表信息
总数
结构化信息 结构化信息
必选
StringStringStringString String
包含表的个数, 包含表的个数, 包含表的个数, >=1 >=1
表信息
结构化信息 结构化信息
必选
List List
资源包含的表信息 资源包含的表信息 资源包含的表信息 资源包含的表信息
表英文名 表英文名
表信息
必选
StringStringStringString String
表在数据库中的实际名称 表在数据库中的实际名称 表在数据库中的实际名称 表在数据
库中的实际名称 表在数据库中的实际名称
表中文名 表中文名
表信息
必选
StringStringStringString String
表的中文含义 表的中文含义 表的中文含义
限制性 限制性 SQLSQL
表信息
可选
StringStringStringString String
表中记录的过滤条件 表中记录的过滤条件 表中记录的过滤条件 表中记录的过滤条件
列集
表信息
必选
List List
表中包含的字段信息集合, 表中包含的字段信息集合, 表中包含的字段信息集合, 表中


34



包含的字段信息集合, 表中包含的字段信息集合, 表中包含的字段信息集合, 必须 包
含 一个字段信息 一个字段信息 一个字段信息
总数
列集
必选
String String String String String String
包含的字段总数, 包含的字段总数, 包含的字段总数, 包含的字段总数, >=1>=1
字段
列集
必选
List List
字段的属性集合 字段的属性集合 字段的属性集合
名称
字段
必选
StringStringStringString String
字段的标题 字段的标题
字段英文名 字段英文名
字段
必选
StringStringStringString String
字段的实际名称 字段的实际名称 字段的实际名称
字段中文名 字段中文名
字段
必选
StringStringStringString String
字段的含义 字段的含义
数据类型 数据类型
字段
必选
StringStringStringString String
字段的数据类型 ,目前支持如下字段的数据类型 ,目前支持如下字段的数据类型 ,目前
支持如下字段的数据类型 ,目前支持如下字段的数据类型 ,目前支持如下字段的数据类
型 ,目前支持如下字段的数据类型 ,目前支持如下:







智慧城市公共信息平台-平台接口与服务要求
29

是否主键 是否主键


35



字段
必选
StringStringStringString String
“是”表示是主键, 表示是主键, 表示是主键, ”否”表示非主键 表示非主键
长度
字段
可选
StringStringStringString String
字段的长度 字段的长度
精度
字段
可选
StringStringStringString String
字段的精度 字段的精度
非结构化信息 非结构化信息 非结构化信息
dataDescResult dataDescResultdataDescResult dataDescResult dataDescResultdataDescResult
dataDescResult
可选
element
当资源类型为 当资源类型为 当资源类型为 ”非结构化资源 非结构化资源 非结构化资源
非结构化资源 ”时,将返 时,将返 时,将返 时,将返 回此节点信息,包含了资源对应
的文件 回此节点信息,包含了资源对应的文件 回此节点信息,包含了资源对应的文件
回此节点信息,包含了资源对应的文件 回此节点信息,包含了资源对应的文件 回此节点
信息,包含了资源对应的文件 回此节点信息,包含了资源对应的文件 回此节点信息,包
含了资源对应的文件 回此节点信息,包含了资源对应的文件 目录类型等信息,用于资源
检索使。 目录类型等信息,用于资源检索使。 目录类型等信息,用于资源检索使。 目录
类型等信息,用于资源检索使。 目录类型等信息,用于资源检索使。 目录类型等信息,
用于资源检索使。 目录类型等信息,用于资源检索使。 目录类型等信息,用于资源检索
使。 包含一个资源集子元素 包含一个资源集子元素 包含一个资源集子元素 包含一个资
源集子元素 包含一个资源集子元素
资源集
非结构化信息 非结构化信息 非结构化信息
必选
List List
资源对应的文件集合 资源对应的文件集合 资源对应的文件集合 资源对应的文件集合
总数
资源集
必选
StringStringStringString String
文件的数量, 文件的数量, 文件的数量, >=1>=1
资源记录 资源记录
资源集
必选
element
文件的属性集 文件的属性集 文件的属性集


36



目录
资源记录 资源记录
必选
StringStringStringString String
指文件所在的目录或 指文件所在的目录或 指文件所在的目录或 指文件所在的目录或 指
文件所在的目录或 WebWebWeb服务的名称 服务的名称
文件名
资源记录 资源记录
必选
StringStringStringString String
指文件名称或 指文件名称或 指文件名称或 webweb 服务地址 服务地址 服务地址
文件类型 文件类型
资源记录 资源记录
必选
StringStringStringString String
1:视频, :视频, :视频, 2:非视频, :非视频, :非视频, 3:URLURL 服务
地 服务地 址
智慧城市公共信息平台-平台接口与服务要求
30
附录 B QUERY QUERY-RES RES-DATADATADATADATA说明
本附录说明了资源检索查询条件的使用方法,因为元数据指标项的不确定性,无法实现与
国标相同的RP方法,因此此处的具体方法不同于国标。
资源分为两个种类:结构化数据和非结构化数据。
结构化数据既指保存在共享数据库中的数据库记录,一个资源可以跨表编目,形成一个资
源标识符作为唯一标识资源的标志。结构化数据编目后会形成如下的结构信息: <结构化
信息> <总数><总数> <表信息> <表英文名> <表中文名> <列
集> <总数> <字段> <名称> <显示序号> <字段英文名>
<字段中文名> <数据类型> <是否主键> <长度> <精度> <字段> <列
集> <表信息> <限制性SQL>
智慧城市公共信息平台-平台接口与服务要求
31
<结构化信息>
这些信息在资源自描述中将作为结果返回给客户端。
非结构化资源可包含三种文件类型:文档、视频文件、URL。 <非结构化信息> <资源集> <总数> <资源记录> <目录> <文件名> <文件类型
> <资源记录> <资源集> <非结构化信息>
URL指共享应用单位提供的Web服务资源。
URL属性包括:
 目录-指实际的URL路径;
 文件名-指URL服务的名称;
当文件类型为文档、视频文件时,包含的属性含义如下:
 目录-指资源存储的目录;


37



 文件名-指文件名。
B.1 B.1 B.1 dataQuerydataQuery dataQuerydataQuerydataQuery 资源检索申请结构 资源检
索申请结构 资源检索申请结构 资源检索申请结构 资源检索申请结构 资源检索申请结构
资源检索申请结构
依照资源种类的不同,dataQuery的结构也不同。
B.1.1 结构 化资源检索申请 <结构化查询参数> <查询表信息> <表英文名><
表英文名> <字段过滤信息> <字段英文名> <字段值>
智慧城市公共信息平台-平台接口与服务要求
32
这里有一个约束条件:这个字段前必须加上小写表名前缀。比如USER表的id字段 这个
字段值条件必须是:--> <运算符> <连接运算符><连接运算符> <字段过滤信息> <字段过滤
信息> <字段英文名> <字段值> <运算符
> <连接运算符><连接运算符> <字
段过滤信息> <查询表信息> <查询表信息> <表英文名><表英文
名> <字段过滤信息> <字段英文名> <字段值> <运算符> <连接运算符><连接运算符> <字段过
滤信息> <字段过滤信息> <字段英文名> <字段值> <运算符> <连接运算符><连接运算符> <字段过滤信息> <查询表信息> <结构化查询
参数>
B.1.2 非结构 化资源申请
智慧城市公共信息平台-平台接口与服务要求
33
<非结构化查询参数> <目录取值> <目录运算符>
<文件名取值> <文件名运算符> <文件类型> <非结构化查
询参数>
B.2B.2 资源检索结果提取构 资源检索结果提取构 资源检索结果提取构 资源检索结果提
取构 资源检索结果提取构 资源检索结果提取构 资源检索结果提取构 资源检索结果提取
构 资源检索结果提取构
Records包含一个或多个singleRecord,每个singleRecord为一条结果记录。singleRecord包
含若干item属性项,每项item包含itemameitemValue对,表明属性的名称及其值。
对结构化资源而言,每个item即表示一个字段,itemame表示字段名,itemValue表示字
段值。
对非结构化资源,itemame是明确的,只能是“文件名”、“文件类型”、“目录”,itemame
对不同的文件类型的取值含义定义如下图所示: 文件类型 文件类型
itemameitemameitemameitemameitemameitemameitemameitemame 含义
URLURLURL
目录
URLURLURL路径
URLURLURL
文件名


38



URLURLURL服务名称 服务名称
文档 or 视频
目录
资源所在目录 资源所在目录 资源所在目录
文档 or 视频
文件名
资源的文件名 资源的文件名 资源的文件名
B.2.1 结构化资源 singleRecord singleRecord singleRecord singleRecord范例 字段1的标题
字段1的值
智慧城市公共信息平台-平台接口与服务要求
34
字段2的标题 字段2的值
字段1的标题
字段1的值 字段2的标
字段2的值
B.2.1 非结构化资源 singleRecord singleRecord singleRecordsingleRecord 范例 version=encoding=
文件名
目录 video
文件类型 视频 访问路径
http:video

智慧城市公共信息平台-平台接口与服务要求
35
文件名 领导讲话视频服务
目录
http:videoleader
文件类型 URL 访问路径
http:videoleader

智慧城市公共信息平台-平台接口与服务要求
36
附录 C 平台接口 要求 SCHEMA SCHEMA SCHEMA encoding=类型标识符-->
协议数据单元。
协议数据单元
的定义。 ref=ref=ref=


39




name=type=
索取公钥。
智慧城市公共信息平台-平台接口与服务要求
37
索取
公钥请求的定义。 ref=minOccurs= type= 索取公钥响应。
name=索取公钥响应的定义。
type=minOccurs= type= 资源提取响应。
name=资源提取响应的类
型定义。 ref=“failure”表示提取失败。 --> 用于客户端和服务器端传递自定义信息。一旦发生异常,使用本
智慧城市公共信息平台-平台接口与服务要求
38
参数传递详细的异常信息给客户端。 --> type= 资源提取请求。
name= 资源提取请求的类
型定义。 ref=name=type=name=type=ref=default=表示提取结果的编码方式。默认
采用XML方式 -->
name=type=


40



检索响应。

检索响应的类型定义。 ref=name=参数searchStatus取值为“success”表示检索成功;“failure”表
示检索失败 --> 和服务器端传递自定义信息。一旦发生异常,使用本参数传递详细的异常信息给客户端。
-->
智慧城市公共信息平台-平台接口与服务要求
39


资源检索请求。
源检索请求的类型定义。
无效。 --> type=ref=
资源检索过滤条件。
minOccurs=结构化查询参数
type=结构化查询参数定义 结构化查询参数定
义。 查询参数定义
智慧城市公共信息平台-平台接口与服务要求
40
表查询的结构描述
maxOccurs=字段过
滤信息type=字段过滤信息定义 type=运算符运算符链接
运算符type=链接运算符定义 name=非结构化查询参数type=非结构化查询参数定义
非结构化查询参数定义。

运算符文件名取值文件名
运算符type=运算符

41



base=


智慧城市公共信息平台-平台接口与服务要求
41
type= 资源自描述应答。
name=资源自描述应答的
类型定义。 ref=

资源自描述返回结果。
资源自描述应答结果的类型定义。
name=结构化信息minOccurs= 结构化信息
ref=总数 表信息
智慧城市公共信息平台-平台接口与服务要求
42
minOccurs= 非结构化信息
maxOccurs=
本号协议版本,本实现
对应的协议版本 name=资源种类type=资源种类分类 资源种类
name=资源标识符 资源标识符
智慧城市公共信息平台-平台接口与服务要求
43
节点

42



base=

当前状态
value=审核中审核完成注册中
value=发布完成开放应用单位
列表 开放应用单位列表
maxOccurs= 应用单位

智慧城市公共信息平台-平台接口与服务要求
44
应用单位
应用单位
信息 号应用单位名称
name=应用单位编号 应用单位编号

应用单位名称

总数
base=
智慧城市公共信息平台-平台接口与服务要求
45
表信息
表信息定义

表英文名
表中文名

列集
ref=总数


43




智慧城市公共信息平台-平台接口与服务要求
46
制性SQL base=

字段
字段集
ref=显示序号minOccurs=
名称

显示序号

智慧城市公共信息平台-平台接口与服务要求
47
value=字段英
文名 字段英文名
value=字段中
文名 字段中文名
value=数据类
型数据类型
value=

智慧城市公共信息平台-平台接口与服务要求
48

是否主键

长度
base=
精度


44



base=
资源集
ref=总数

智慧城市公共信息平台-平台接口与服务要求
49
资源记录
资源记录
集合
目录

文件名


文件类型
value=
智慧城市公共信息平台-平台接口与服务要求
50
name=type=
资源自描述请求。

资源自描述请求的类型定义。
成,其它字符无效。 --> minOccurs= 资源标识符
value=
type= 初始化请求。
name= 初始化请求的类型定义。
name=type=minOccurs=name=
智慧城市公共信息平台-平台接口与服务要求


45



51
ref=minOccurs= default= 协议版本,本实现对应的协议版本

初始化响应。
初始化
响应的类型定义。 ref=
参数result取值为布尔型。“true”表示建立会话成功;“false”表示建立会话失败,此时
referenceId取为空。 --> minOccurs=minOccurs=minOccurs= 自定义信息。一旦发生异常,使用本参数传递详细的异常信息给客户端。 -->

用于加密解密的公钥
智慧城市公共信息平台-平台接口与服务要求
52
type=目录服务自描
述信息的请求。 name= 目录服务自
描述信息请求的定义。 ref=
name=type=
目录服务自描述信息的响应。
name=目录服务自
描述信息响应的定义。 ref=息资源目录服务name=type=type=maxOccurs=type=
智慧城市公共信息平台-平台接口与服务要求
53


46



ref=

操作返回结果
type=name=type=
type=minOccurs=maxOccurs=
name=type=type= name=type= 支持的功能。
name=
智慧城市公共信息平台-平台接口与服务要求
54
value=value= name= 提供应用单位类型
ref= name=type= 提供
应用单位名称 检索请求。

检索请求的类型定义。
type=ref=default=表示查询结果的编码方式。默认
采用XML方式 --> minOccurs= 智慧城市公共信息平台-平台接口与服务要求
55
检索响应。

检索响应的类型定义。


47



type=“success”表示检索成功;“failure”表示检索失败 --> minOccurs=其它信息,用于客户端和服务器端传递自定义信息。一旦发生异常,
使用本参数传递详细的异常信息给客户端。 --> type=
minOccurs=maxOccurs= type= 元数据库名称。
name= 元数据库名称的类型定
义。 type= name= 检索串的类型是
type-1
智慧城市公共信息平台-平台接口与服务要求
56
type=fixed=信息资源目录服务属性集type=
name= 逆波兰检索表达式。
type=
type= name= type=name=type= type=
智慧城市公共信息平台-平台接口与服务要求
57

操作数。
操作数的类
型定义。 name=type=


48



maxOccurs=
type=
name= type=name=type= 智慧城市公共信息平台-平台接口与服务要求
58
操作符。

操作符的类型定义。
type=

抽象类型。表示元素出现即可,没有取值。


提取请求。
提取
请求的类型定义。 ref=name=type=name=type=ref=default=表示提取结果的编码方式。默认
采用XML方式 -->
name=
智慧城市公共信息平台-平台接口与服务要求
59
元素集名称。

元素集名称的类型定义。
name= type=maxOccurs=

提取响应。
响应的类型定义。

49



ref=“failure”表示提取失败。 --> minOccurs=其它信息,用于客户端和服务器端传递自定义信息。一旦发生异常,
使用本参数传递详细的异常信息给客户端。 --> 智慧城市公共信息平台-平台接口与服务要求
60
记录。
name=type= 提取
状态。 name= 提取状态的类型定义。
value=
name=type=
元数据管理请求。

元数据管理请求的类型定义。
类型“1”,元数据导入操作 类型“2”,元数据删除
操作 类型“3”,元数据更新操作
type=
智慧城市公共信息平台-平台接口与服务要求
61
当type值为1时,进行元数据插入操作,本参数不出现; 当type值为2、3时,进行元数
据删除操作或更新操作,本参数为必选参数。

当type值为1、3时,进行元数据插入或更新操作,本参数为必选参
数; 当type值为2时,进行元数据删除操作操作,本参数不出现。
元数据管理响应。
元数据管理响应的类型定义。
name=
minOccurs= 类型“1”,元数据导入操作 类型
“2”,元数据删除操作 类型“3”,元数据更新操作
智慧城市公共信息平台-平台接口与服务要求


50

-

智慧城市公共信息平台平台接口与服务要求

发布时间:2022-03-29 20:04:24
文章版权声明:除非注明,否则均为IT技术网-学习WEB前端开发等IT技术的网络平台原创文章,转载或复制请以超链接形式并注明出处。

发表评论

评论列表 (有 12 条评论,274人围观)

最近发表

随便看看

热门文章

标签列表