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

更新时间:2024-06-05 17:05:01 阅读量: 综合文库 文档下载

说明:文章内容仅供预览,部分内容可能不全。下载后的文档,内容与下面显示的完全一致。下载之前请确认下面内容是否您想要的,是否完整无缺。

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

? 本要求 是《智慧城市公共信息平台建设指南》建设要求系列之接口与服 接口与服 接口与服 务要求 。

? 本部分 要求 分两大部描述平台接口 分两大部描述平台接口 分两大部描述平台接口 分两大部描述平台接口 分两大部描述平台接口 要求 ,第一部分:总体 ,第一部分:总体 ,第一部分:总体 ,第一部分:总体 要求 ,总体 要求 描述消息的总体结构、接口访问方地址使用说明。第二部分:业务 描述消息的总体结构、接口访问方地址使用说明。第二部分:业务 描述消息的总体结构、接口访问方地址使用说明。第二部分:业务 描述消息的总体结构、接口访问方地址使用说明。第二部分:业务 描述消息的总体结构、接口访问方地址使用说明。第二部分:业务 描述消息的总体结构、接口访问方地址使用说明。第二部分:业务 接口 要求 ,具体描述每个业务应用服接口的 ,具体描述每个业务应用服接口的 要求 。也就是每一个业务接口 。也就是每一个业务接口 要求 套在总体 要求 内。只有使用业务接口 内。只有使用业务接口 内。只有使用业务接口 内。只有使用业务接口 要求 +总体 要求 才能正常使用信息平台的应 才能正常使用信息平台的应 才能正常使用信息平台的应 才能正常使用信息平台的应 用服务来发现,查询管理资源。

? 本部分适用于参与公共信息平台设计和研发人员,系统维护及要求 本部分适用于参与公共信息平台设计和研发人员,系统维护及要求 本部分适用于参与公共信息平台设计和研发人员,系统维护及要求 本部分适用于参与公共信息平台设计和研发人员,系统维护及要求 本部分适用于参与公共信息平台设计和研发人员,系统维护及要求 本部分适用于参与公共信息平台设计和研发人员,系统维护及要求 本部分适用于参与公共信息平台设计和研发人员,系统维护及要求 本部分适用于参与公共信息平台设计和研发人员,系统维护及要求 本部分适用于参与公共信息平台设计和研发人员,系统维护及要求 本部分适用于参与公共信息平台设计和研发人员,系统维护及要求 本部分适用于参与公共信息平台设计和研发人员,系统维护及要求 本部分适用于参与公共信息平台设计和研发人员,系统维护及要求 本部分适用于参与公共信息平台设计和研发人员,系统维护及要求 接入公共信息平台的外部应用开发人员。

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

2 规范性 引用 文件

下列文件中的条款通过本部分引 用而成为。凡是注日期下列文件中的条款通过本部分引 用而成为。凡是注日期用文件,其随后 用文件,其随后 所有的修改单(不包括勘误内容)或订版均适用于本部分, 所有的修改单(不包括勘误内容)或订版均适用于本部分, 所有的修改单(不包括勘误内容)或订版均适用于本部分, 鼓励根据本部分达成协议的各方研究是否可使用这些文件最新版。凡不注 鼓励根据本部分达成协议的各方研究是否可使用这些文件最新版。凡不注 日期的引用文件,其最新版本适于部分。 GB/T 21063.1 -2007 政务信息资源目录体系 第 1部分:总体框架; GB/T 21063.2 -2007 政务信息资源目录体系 第 2部分:技术要求; GB/T 21063.3 -2007 政务信息资源目录体系 第 3部分:核心元数据; GB/T 21063.4 GB/T 21063.4 -2007 政务信息资源目录体系 第 4部分: 政务信息资源分类; GB/T 21063.5 -2007 政务信息资源目录体系 第 5部分:政务信息资源标识 部分:政务信息资源标识 符编码方案;

? 本文 <业务接口 要求 > 引用《 GB/T 21063.2 GB/T 21063.2 -2007 》中的附录 A 目录服务 接口;

? 本文 <附录 A 要求 所涉及的结构表 所涉及的结构表 所涉及的结构表 所涉及的结

1

构表 >引用《 引用《 GB/T 21063.2 GB/T 21063.2 -2007 》中的附 》中的附 》中的附 录 A 目录服务接口,及引用《 目录服务接口,及引用《 目录服务接口,及引用《 GB/T 21063.2 GB/T 21063.2 -2007 》中的附录 》中的附录 C 政务信息资源目 录服务属性集 ? 本文 <附录 D QUERY D QUERY -RPN 范例 >引用 《GB/T 21063.2 GB/T 21063.2 -2007 》中的附录 》中的附录 F 检 索串示例 9. 智慧城市公共信息平台-平台接口与服务要求 3

3 术语 与定义

GB/T 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 Name Message Name),交易消息 ),交易消息 ),交易消息 以 XML 格式表达的,根据 格式表达的,根据 XML 的定义,每个 的定义,每个 XML 文件需要有特定的 Root Tag Root Tag (根 标记),在本 标记),在本 标记),在本 要求 中,用交易名称 中,用交易名称 +请求类别作为根节点,如初始化接口的包 请求类别作为根节点,如初始化接口的包 根节点为 initRequest ,而响应包的根节点为 ,而响应包的根节点为 initResponse 。根节点下之间放业 。根节点下之间放业 务接口数据。

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://:< 端 口>/es/catalogbase?wsdl ? 目录服务初始化 –initCatalogService ? 目录服务终止 –stopCatalogService

2) 发现接口 WSDL 文件地址: http://:< 端 口>/es/digcatalog?wsdl ? 目录检索 – queryCatalogList

? 目录检索结果提取 – queryCatalogResult

3) 资源服务接口: http://:< 端口 >/es/digresource?wsdl ? 资源检索 – getResourceResultset

? 资源检索结果提取 – getResourceResultDetail

4) 发现接口 WSDL 文件地址: http://:< 端 口>/es/digcatalog?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.

implementationName implementationName implementationName implementationNameimplementationNameimplementationNameimplementationName implementationName implementationName 可选

StringStringStringString String 200200200

应用名称 应用名称

在公共信息平台用 在公共信息平台用 在公共信息平台用 在公共信息平台用 在公共信息平台用 在公共信息平台用 在公共信息平台用 在公共信息平台用 户管系统中注册的 户

6

管系统中注册的 户管系统中注册的 户管系统中注册的 户管系统中注册的 户管系统中注册的 户管系统中注册的 户管系统中注册的 第三方应用名称 第三方应用名称 第三方应用名称 5.

otherInfootherInfootherInfo otherInfo otherInfootherInfo 可选

element element 其他信息 其他信息 备用

2. 请求报文体模板 V1.0 testApp/12456 1 测试应用 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 >终止使用 6.1.3 认证授权

认证授权主要是公钥获取接口服务,用于根据客户端应用的请求,取出最新的加解密公钥并返回给客户端的过程。

公钥获取与其他接口不同,不需要用户验证,不需要会话标识。调用客户端只有获取公钥后对用户认证信息进行加密才能完成其服务调用。 整个密码加解密的处理过程如下图所示: 图2. .密码加解密的处理过程图

1. 请求报文体 序号 元素名称 元素名称 约束 类型 长度 描述 取值说明 取值说明 1.

otherInfootherInfootherInfo otherInfo otherInfootherInfo 可选

element element 其他信息 备用

2. 请求报文体模板

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

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 < opStatus>true < opRetCode >code < opRetMsg >message 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.

databaseName databaseNamedatabaseName databaseName databaseName databaseName databaseNames 必选

Element Element Element

要查询的元 要查询的元 要查询的元 要查询的元 要查询的元 数据库名称 数据库名称 数据库名称 数据库名称 数据库名称 列表

客户端指定的要查询元数据库名称列表 元数据库名称列表 元数据库名称列表 元数据库名称列表 5.

query query query

10

必选

Element Element Element

客户端定制 客户端定制 客户端定制 客户端定制 客户端定制 的检索语句 的检索语句 检索语句必须符合 检索语句必须符合 检索语句必须符合 检索语句必须符合 TypeType -1型,使用逆波兰 型,使用逆波兰 型,使用逆波兰 型,使用逆波兰 表达式 (RPN)(RPN) (RPN) 作为检索语 作为检索语 作为检索语 法,参见《附录 法,参见《附录 法,参见《附录 法,参见《附录 E QUERY QUERY QUERY-RPN RPN范例》 范例》 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 根据国标的逆波兰表达式(RPN)组合的查询条件?具体规则参考《附录 E QUERY E QUERYE QUERYE QUERY-RPN RPN范例》 范例》

3. 响应报文体 序号 元素名称 元素名称 约束 类型 长度 描述 取值说明 取值说明 1.

referenceIdreferenceIdreferenceIdreferenceId referenceId 必选

StringStringStringString String 50

会话标识 会话标识

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

resultCountresultCount resultCount resultCount resultCount resultCount 必选

NumberString NumberString NumberStringNumberStringNumberStringNumberStringNumberString NumberString 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 必选

NumberString NumberString NumberStringNumberStringNumberStringNumberStringNumberString NumberString 20

开始抽取 开始抽取 开始抽取 开始抽取 的位置

客户端指定的从第几条记 客户端指定的从第几条记 客户端指定的从第几条记 客户端指定的从第几条记 客户端指定的从第几条记 客户端指定的从第几条记 客户端指定的从第几条记 录开始抽取,序号从 录开始抽取,序号从 录开始抽取,序号从 录开始抽取,序号从 1开 始 4.

numberOfReco numberOfReconumberOfReco numberOfReco numberOfReconumberOfReco numberOfRecordsResquestedrdsResquested rdsResquestedrdsResquested rdsResquested rdsResquestedrdsResquested 必选

NumberString NumberString NumberStringNumberStringNumberStringNumberStringNumberString NumberString 20 记录数

客户端指定的要抽取记 客户端指定的要抽取记 客户端指定的要抽取记 客户端指定的要抽取记 客户端指定的要抽取记 客户端指定的要抽取记 客户端指定的要抽取记 录数 5.

elementSetNa elementSetNaelementSetNaelementSetNa elementSetNa me 必选

element element

结果集属 结果集属 结果集属 结果集属 性

参见表 《参见表 《A.3A.3 elementSetName elementSetName elementSetNameelementSetNameelementSetName elementSetName elementSetName结果 集属性》 集属性》

智慧城市公共信息平台-平台接口与服务要求 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 必选

NumberString NumberString NumberStringNumberStringNumberStringNumberStringNumberString NumberString 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 必选

NumberString NumberString NumberStringNumberStringNumberStringNumberStringNumberString NumberString 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 必选

NumberString NumberString NumberStringNumberStringNumberStringNumberStringNumberString NumberString 20

开始抽取 开始抽取 开始抽取 开始抽取 的位置

客户端指定的从第 客户端指定的从第 客户端指定的从第 客户端指定的从第 客户端指定的从第 客户端指定的从第 客户端指定的从第 客户端指定的从第 几条记录开始抽 几条记录开始抽 几条记录开始抽 几条记录开始抽 几条记录开始抽 几条记录开始抽 几条记录开始抽 取,序号从 取,序号从 取,序号从 1开始 4.

18

numberOfRecordsRe numberOfRecordsRenumberOfRecordsRe numberOfRecordsRe numberOfRecordsRenumberOfRecordsRe

numberOfRecordsRenumberOfRecordsRenumberOfRecordsRe

numberOfRecordsRenumberOfRecordsResquestedsquested squested squestedsquested 必选

NumberString NumberString NumberStringNumberStringNumberStringNumberStringNumberString NumberString 20 记录数

客户端指定的要抽 客户端指定的要抽 客户端指定的要抽 客户端指定的要抽 客户端指定的要抽 客户端指定的要抽 客户端指定的要抽 客户端指定的要抽 取的记录数 取的记录数 5.

numberOfRecordsTo numberOfRecordsTonumberOfRecordsTo numberOfRecordsTo numberOfRecordsTonumberOfRecordsTo

numberOfRecordsTonumberOfRecordsTonumberOfRecordsTo numberOfRecordsTonumberOfRecordsTotaltal 必选

NumberString NumberString NumberStringNumberStringNumberStringNumberStringNumberString NumberString 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

JTJQD/JTJ00000 1 30 3

XML

3. 响应报文体 序号 元素名称 元素名称 约束 类型 长度 描述 取值说明 取值说明 1.

referenceIdreferenceIdreferenceIdreferenceId referenceId 必选

StringStringStringString String 50

会话标识 会话标识 2.

numberOfReco numberOfReconumberOfReco numberOfReco numberOfReconumberOfReco numberOfRecordsReturnedrdsReturned rdsReturnedrdsReturned rdsReturnedrdsReturnedrdsReturned 必选

NumberString NumberString NumberStringNumberStringNumberStringNumberStringNumberString NumberString 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 节点包含一组 节点包含一组 节点包含一组 或多组元数据属性参 或多组元数据属性参 或多组元数据属性参 或多组元数据属性参 或多组元数据属性参 或多组元数据属性参 或多组元数据属性参 或多组元数据属性参 或多组元数据属性参 数 itemName itemName itemName和元数 据属性值参数 据属性值参数 据属性值参数 据属性值参数 据属性值参数 据属性值参数 itemValue itemValue itemValue itemValue 。itemName itemName itemName itemName取值要求符合《表 取值要求符合《表 取值要求符合《表 核 心元数据属性集》之约 心元数据属性集》之约 心元数据属性集》之约 心元数据属性集》之约 定

智慧城市公共信息平台-平台接口与服务要求 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 必选

标识一个元数据库,以公共信息平台的应用 标识一个元数据库,以公共信息平台的应用 标识一个元数据库,以公共信息平台的应用 标识一个元数据库,以公共信息平台的应用 标识一个元数据库,以公共信息平台的应用 标识一个元数据库,以公共信息平台的应用 标识一个元数据库,以公共信息平台的应用 标识一个元数据库,以公共信息平台的应用 标识一个元数据库,以公共信息平台的应用 单位 编号代替 编号代替

databaseName databaseNamedatabaseName databaseName databaseName databaseName databaseName 必选

元数据库名称 元数据库名称 元数据库名称

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

catalogCapabilitiesRequecatalogCapabilitiesRequecatalogCapabilitiesRequecatalogCapabilitiesReque 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 elementSetName elementSetName elementSetNameelementSetName elementSetName elementSetName 结果集属性 结果集属性 结果集属性 结果集属性 结果集属性 参数名称 参数类型 取值 参数含义 genericElementgenericElement genericElement genericElement genericElement genericElement-SetNameSetName SetName SetName StringStringStringString String Brief Brief Brief

提取信息资源核心 提取信息资源核心 提取信息资源核心 提取信息资源核心 提取信息资源核心 提取信息资源核心 提取信息资源核心 提取信息资源核心 元数据 genericElementgenericElement genericElement genericElement genericElement genericElement-SetNameSetName SetName SetName 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 必选

结果集中的元数据 记录,包含一组或多结果集中的元数据 记录,包含一组或多结果集中的元数据 记录,包含一组或多结果集中的元数据 记录,包含一组或多结果集中的元数据 记录,包含一组或多结果集中的元数据 记录,包含一组或多结果集中的元数据 记录,包含一组或多结果集中的元数据 记录,包含一组或多结果集中的元数据 记录,包含一组或多结果集中的元数据 记录,包含一组或多属性参数 属性参数 属性参数 属性参数 itemName itemName itemName itemName和元数 据属性值参和元数 据属性值参和元数 据属性值参和元数 据属性值参和元数 据属性值参和元数 据属性值参和元数 据属性值参和元数 据属性值参和元数 据属性值参itemValue itemValue itemValue itemValue 。提取的结果集是核心元数 据时,参。提取的结果集是核心元数 据时,参。提取的结果集是核心元数 据时,参。提取的结果集是核心元数 据时,参。提取的结果集是核心元数 据时,参。提取的结果集是核心元数 据时,参。提取的结果集是核心元数 据时,参。提取的结果集是核心元数 据时,参。提取的结果集是核心元数 据时,参。提取的结果集是核心元数 据时,参itemName itemName itemName取值要求符合《表 取值要求符合《表 取值要求符合《表 取值要求符合《表 取值要求符合《表 取值要求符合《表 取值要求符合《表 取值要求符合《表 核心元数据属性 核心元数据属性 核心元数据属性 核心元数据属性 核心元数据属性 核心元数据属性 核心元数据属性 集》 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 资源负责单位 资源负责单位 资源负责单位

rpOrgNamerpOrgName rpOrgNamerpOrgNamerpOrgName rpOrgName 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 资源格式名称 资源格式名称 资源格式名称 fmName fmName

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 词典名称 词典名称

thesaNamethesaName thesaName thesaName 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 类目名称 类目名称

cateNamecateNamecateNamecateName cateName cateName

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 元数据联系单位 元数据联系单位 元数据联系单位

rpOrgNamerpOrgName rpOrgNamerpOrgNamerpOrgName rpOrgName 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说明

本附录说明了资源检索查询条件的使用方法,因为元数据指标项的不确定性,无法实现与国标相同的RPN方法,因此此处的具体方法不同于国标。 资源分为两个种类:结构化数据和非结构化数据。

结构化数据既指保存在共享数据库中的数据库记录,一个资源可以跨表编目,形成一个资源标识符作为唯一标识资源的标志。结构化数据编目后会形成如下的结构信息: <结构化信息> <总数> <表信息> <表英文名/> <表中文名/> <列集> <总数/> <字段> <名称/> <显示序号/> <字段英文名/> <字段中文名/> <数据类型/> <是否主键/> <长度/> <精度/> <限制性SQL/>

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

这些信息在资源自描述中将作为结果返回给客户端。

非结构化资源可包含三种文件类型:文档、视频文件、URL。 <非结构化信息> <资源集> <总数/> <资源记录> <目录/> <文件名/> <文件类型/> URL指共享应用单位提供的Web服务资源。 URL属性包括:

? 目录-指实际的URL路径; ? 文件名-指URL服务的名称;

当文件类型为文档、视频文件时,包含的属性含义如下: ? 目录-指资源存储的目录;

37

? 文件名-指文件名。

B.1 B.1 B.1 dataQuerydataQuery dataQuerydataQuerydataQuery 资源检索申请结构 资源检索申请结构 资源检索申请结构 资源检索申请结构 资源检索申请结构 资源检索申请结构 资源检索申请结构

依照资源种类的不同,dataQuery的结构也不同。

B.1.1 结构 化资源检索申请 <结构化查询参数> <查询表信息> <表英文名> <字段过滤信息> <字段英文名/> <字段值/> 智慧城市公共信息平台-平台接口与服务要求 32

<运算符/> <连接运算符> <字段过滤信息> <字段英文名/> <字段值/> <运算符/> <连接运算符> <查询表信息> <表英文名> <字段过滤信息> <字段英文名/> <字段值/> <运算符/> <连接运算符> <字段过滤信息> <字段英文名/> <字段值/> <运算符/> <连接运算符>

B.1.2 非结构 化资源申请 智慧城市公共信息平台-平台接口与服务要求 33

<非结构化查询参数> <目录取值/> <目录运算符/> <文件名取值/> <文件名运算符/> <文件类型/>

B.2B.2 资源检索结果提取构 资源检索结果提取构 资源检索结果提取构 资源检索结果提取构 资源检索结果提取构 资源检索结果提取构 资源检索结果提取构 资源检索结果提取构 资源检索结果提取构

Records包含一个或多个singleRecord,每个singleRecord为一条结果记录。singleRecord包含若干item属性项,每项item包含itemName/itemValue对,表明属性的名称及其值。 对结构化资源而言,每个item即表示一个字段,itemName表示字段名,itemValue表示字段值。

对非结构化资源,itemName是明确的,只能是“文件名”、“文件类型”、“目录”,itemName对不同的文件类型的取值含义定义如下图所示: 文件类型 文件类型 itemNameitemNameitemNameitemNameitemNameitemNameitemNameitemName 含义 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 范例 文件名 abc.rmvb 目录 /video 文件类型 视频 访问路径 http://www.hzmltx.com.cn/video/abc.rmvb 智慧城市公共信息平台-平台接口与服务要求 35

文件名 领导讲话视频服务 目录 http://www.hzmltx.com.cn/video/leader 文件类型 URL 访问路径 http://www.hzmltx.com.cn/video/leader

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

附录 C 平台接口 要求 SCHEMA SCHEMA SCHEMA 索取公钥。 智慧城市公共信息平台-平台接口与服务要求 37

索取公钥请求的定义。 索取公钥响应。 资源提取响应。

参数传递详细的异常信息给客户端。 --> 资源提取请求。 资源提取请求的类型定义。

40

本文来源:https://www.bwwdw.com/article/ush6.html

Top