[地方标准]db11t553.5-2008政务信息资源共享交换平台技术规范第5部分接口规范（中国大英博物馆）.doc

ics 01.040.35l 72备案号 xx-xxxxdb北京市地方标准db11/t 553.52008政务信息资源共享交换平台技术规范第 5 部分：接口规范technical specification for government information resource sharing and interchange platformpart 5: interface specification2008-05-28 发布2008-07-01 实施北京市质量技术监督局 发布 db11/t 553.52008目次前言.ii1 范围.1 2 规范性引用文件. 错误！未定义书签。3 概述.1 4 政务信息资源目录服务接口 .1 5 政务信息资源交换服务接口 .5 6 认证授权服务接口. 10 附录 a（规范性附录）政务信息资源目录服务接口 xml schema 描述 . 11 附录 b（规范性附录）政务信息资源交换服务接口 xml schema 描述 . 18i前言db11/t 553政务信息资源共享交换平台技术规范，分为 5 个部分：第 1 部分：总体框架；第 2 部分：政务信息资源目录管理；第 3 部分：政务信息资源交换管理；第 4 部分：认证授权；第 5 部分：接口规范。 本部分为 db11/t 553 的第 5 部分。 本标准的附录 a、附录 b 为规范性附录。 本部分由北京市信息化工作办公室提出并归口。本部分的起草单位：北京市信息资源管理中心、中科软科技股份有限公司、北京数贝软件科技有限公 司。本部分主要起草人：黄晓斌、林绍福、冯启民、程军、郭家义、崔建新、赵琰昉、李海蛟、李清、徐 伟、李中、韩霖。iidb11/t 553.52008政务信息资源共享交换平台技术规范第 5 部分：接口规范1范围本部分规定了政务信息资源共享交换平台的接口规范，包括政务信息资源目录服务接口、政务信息资 源交换服务接口和认证授权服务接口。本部分适用于政务信息资源共享交换平台建设的规划、设计和实施。2概述2.1 接口组成政务信息资源共享交换平台提供政务信息资源目录服务接口、政务信息资源交换服务接口和认证授权 服务接口等三类接口。政务信息资源共享交换平台接口组成见图 1。2.2 接口技术要求图1政务信息资源共享交换平台接口组成a） 应至少提供jms和web服务接口；b） 应支持跨语言、跨操作系统调用。3政务信息资源目录服务接口3.1 目录检索接口3.1.1 用户目录检索接口根据指定的检索条件和用户访问权限对政务信息资源目录数据进行查询，并返回结果。用户目录检索接口参数说明见表 1。表 1用户目录检索接口参数表参数名称参数类型可选/必选参数含义query政务信息资源目录查询 对象 metaquery 数组必选用于存放查询条件的值对象。说明：metaquery 查询条件为 非空字符串，metaquery 内部的参数为“与”的关系， metaquery 之间为“或”的关系usercodestring必选用户 id，政务信息资源目录管理系统根据用户访问权限对1查询结果进行过滤a） 返回值：政务信息资源目录数据对象 metadata 数组；b） 政务信息资源目录数据对象 metadata 的 xml schema 定义见附录 a.1；c） 政务信息资源目录数据对象 metadata 的组成结构见图 2；d） 政务信息资源目录查询对象 metaquery 的 xml schema 定义见附录 a.2；e） 政务信息资源目录查询对象 metaquery 的组成结构见图 3。2图2政务信息资源目录数据对象 metadata 的组成结构图3图3政务信息资源目录查询对象 metaquery 的组成结构图43.1.2 角色目录检索接口根据检索条件和角色访问权限对政务信息资源目录数据进行查询，并返回结果。角色目录检索接口参数说明见表 2。表 2角色目录检索接口参数表参数名称参数类型可选/必选参数含义query政务信息资源目录 查询对象 metaquery 数组必选用于存放查询条件的值对象。说明：metaquery 查询条件 为非空字符串，metaquery 内部的参数为“与”的关系， metaquery 之间为“或”的关系rolecodestring必选用户角色 id，政务信息资源目录管理系统根据角色访问权 限对查询结果进行过滤a） 返回值：政务信息资源目录数据对象 metadata 数组；b） 政务信息资源目录数据对象 metadata 的 xml schema 定义见附录 a.1；c） 政务信息资源目录数据对象 metadata 的组成结构见图 2；d） 政务信息资源目录查询对象 metaquery 的 xml schema 定义见附录 a.2；e） 政务信息资源目录查询对象 metaquery 的组成结构见图 3。3.2 目录注册更新接口根据权限实现符合规范的政务信息资源目录数据的注册、更新，并返回注册或更新成功的政务信息资 源目录数据的元数据标识符。目录注册更新接口参数说明见表3。表 3目录注册更新接口参数表参数名称参数类型可选/必选参数含义registerdata政务信息资源目录数据对 象 metadata 数组必选请求目录注册、目录更新的政务信息资源目录数据 对象usercodestring必选用户 id，用于检验用户是否有权限进行目录注册 或目录更新操作isregisterboolean必选true 表示目录注册，false 表示目录更新a） 返回值：如果注册或更新成功，返回注册或更新成功的政务信息资源目录数据的元数据标识符；如果失败，返回-1；b） 政务信息资源目录数据对象 metadata 的 xml schema 定义见附录 a.1；c） 政务信息资源目录数据对象 metadata 的组成结构见图 2。4政务信息资源交换服务接口4.1 数据库交换接口4.1.1 数据库交换请求接口将数据库交换请求信息发送到交换中心，并在发送数据的交换节点与接收数据的交换节点之间建立会 话。数据库交换请求接口参数说明见表 4。表 4数据库交换请求接口参数表参数名称参数类型可选/必选参数含义message数 据 库 交换 请求 对象 dbexrequest必选数据库交换请求信息5参数名称参数类型可选/必选参数含义deliverymodeint可选采用的传送模式，支持的传送模式至少应包括持续传送模式 persistent 和一次性传送模式non_persistentpriorityint可选请求的优先级，共有 10 个优先级。0 是最低优 先级，9 是最高优先级。默认的优先级是 4timetoliveint可选请求的存在时间，单位为毫秒，由发送方指定，0 为无限制a） 返回值：true 表示发送成功，false 表示发送失败；b） 数据库交换请求对象 dbexrequest 的 xml schema 定义见附录 b.1；c） 数据库交换请求对象 dbexrequest 的组成结构见图 4。图4数据库交换请求对象 dbexrequest 的组成结构图4.1.2 数据库数据发送接口将需交换的数据库数据发送给接收数据的交换节点。数据库数据发送接口参数说明见表 5。表 5数据库数据发送接口参数表参数名称参数类型可选/必选参数含义dbdata数据库交换数据对 象 dbexdata必选需要通过数据库数据发送接口发送的数据集a） 返回值：无；b） 数据库交换数据对象 dbexdata 的 xml schema 定义见附录 b.2；c） 数据库交换数据对象 dbexdata 的组成结构见图 5。6图5数据库交换数据对象 dbexdata 的组成结构图4.1.3 数据库数据接收接口接收从提供数据的交换节点发送的数据库数据。数据库数据接收接口参数说明见表 6。表 6数据库数据接收接口参数表参数名称参数类型可选/必选参数含义dbdata数据库交换数据对 象 dbexdata必选需要通过数据库数据接收接口接收的数据集a） 返回值：无；b） 数据库交换数据对象 dbexdata 的组成结构见图 5；c） 数据库交换数据对象 dbexdata 的 xml schema 定义见附录 b.2。4.2 文件交换接口4.2.1 文件交换请求接口将文件交换请求信息发送到交换中心，并在发送数据的交换节点与接收数据的交换节点之间建立会 话。文件交换请求接口参数说明见表 7。表 7文件交换请求接口参数表参数名称参数类型可选/必选参数含义message文件交换 请求 对象 fileexrequest必选文件交换请求信息7参数名称参数类型可选/必选参数含义deliverymodeint可选采用的传送模式，支持的传送模式至少应包括持续 传 送 模式 persistent 和 一次 性 传 送 模式 non_persistentpriorityint可选请求的优先级，共有 10 个优先级。0 是最低优先级，9 是最高优先级。默认的优先级是 4timetoliveint可选请求的存在时间，单位为毫秒，由发送方指定，0为无限制a） 返回值：true 表示发送成功，false 表示发送失败；b） 文件交换请求对象 fileexrequest 的 xml schema 定义见附录 b.3；c） 文件交换请求对象 fileexrequest 的组成结构见图 6。图6文件交换请求对象 fileexrequest 的组成结构图4.2.2 文件数据发送接口将需交换的文件数据发送给接收数据的交换节点。文件数据发送接口参数说明见表 8。表 8文件数据发送接口参数表参数名称参数类型可选/必选参数含义fdata文件 交 换数 据对象 fileexdata必选需要通过文件数据发送接口发送的数据集8a） 返回值：无；b） 文件交换数据对象 fileexdata 的 xml schema 定义见附录 b.4；c） 文件交换数据对象 fileexdata 的组成结构见图 7。4.2.3 文件数据接收接口图7文件交换数据对象 fileexdata 的组成结构图接收从提供数据的交换节点发送的文件数据。文件数据接收接口参数说明见表 9。表 9文件数据接收接口参数表参数名称参数类型可选/必选参数含义fdata文件交换数 据 对象 fileexdata必选需要通过文件数据接收接口接收的数据集a） 返回值：无；b） 文件交换数据对象 fileexdata 的 xml schema 定义见附录 b.4；c） 文件交换数据对象 fileexdata 的组成结构见图 7。95认证授权服务接口认证授权服务接口另作专门规定。10附录a（规范性附录） 政务信息资源目录服务接口 xml schema 描述a.1 政务信息资源目录数据对象xml schema描述1112政务信息资源目录数据对象参数说明见表 a.1：表 a.1 政务信息资源目录数据对象参数表参数名称参数类型参数说明restitlestring资源名称abstractstring资源摘要classstring资源安全限制分级datacharstring资源字符集13参数名称参数类型参数说明datalangstring资源语种desckeysreskeystype关键字说明fminforesformattype资源格式信息idpocressupplytype资源负责方idpoc1resconsumptiontype资源需求方mdcontactressupplytype元数据联系方mddateststring元数据创建日期mdlangstring元数据语种mdidstring元数据标识符mdclassstring元数据安全限制分级onlinesrcstring在线资源链接地址periodresperiodtype时间范围pubdatestring资源出版日期residstring资源标识符rescatrescategorytype资源分类spatdomstring空间范围statementstring数据志说明restypestring资源类型useconstsstring资源使用限制表 a.2 关键字说明（reskeystype）参数表参数名称参数类型参数说明keywordstring关键字thesanamestring词典名称表 a.3 资源格式信息（resformattype）参数表参数名称参数类型参数说明formatnamestring资源格式名称formatverstring资源格式版本表 a.4 资源负责方/元数据联系方（ressupplytype）参数表参数名称参数类型参数说明emailaddstring单位邮箱cntaddressstring单位地址rporgnamestring单位名称表 a.5 资源需求方（resconsumptiontype）参数表参数名称参数类型参数说明emailaddstring单位邮箱cntaddressstring单位地址rporgnamestring单位名称applicationnamestring应用名称表 a.6 时间范围（resperiodtype）参数表14参数名称参数类型参数说明begdatestring起始时间enddatestring结束时间表 a.7 资源分类（rescategorytype）参数表参数名称参数类型参数说明catecodestring类目编码catenamestring类目名称catestdstring分类标准a.2 政务信息资源目录查询对象xml schema描述1516政务信息资源目录查询对象参数说明见表 a.8。表 a.8 政务信息资源目录查询对象参数表参数名称参数类型参数说明metaidstring元数据标识符metacreatedatestring元数据创建日期metalangstring元数据语种metarpaddressstring元数据联系方地址metarpemailstring元数据联系方电子邮件地址metarporgnamestring元数据联系单位metasecuritylevelstring元数据安全限制分级resabstractstring资源摘要resbegindatestring起始时间resenddatestring结束时间rescategorycodestring类目编码rescategorynamestring类目名称rescategorystandardstring分类标准rescharsetstring资源字符集resdataexplainstring数据志说明resformatnamestring资源格式名称resformatversionstring资源格式版本residstring资源标识符reskeywordstring关键字reskeyworddictionaystring辞典名称reslangstring资源语种resnamestring资源名称resonlinesrcstring在线资源链接地址respubdatestring资源出版日期resrpaddressstring资源负责方地址resr