DB4201-T 536.2-2017“云端武汉”政务数据资源目录体系与数据交换技术规范 第2部分：数据共享交换

备案号：0071-2017DB4201Technicalspecificationsfor"W武汉市质量技术监督局武汉市互联网信息办公室发布IDB4201/T536.2—2017前言 12规范性引用文件 13术语与定义 14缩略语 35数据交换体系总体框架 3 2共享交换服务建设流程36数据共享交换技术规范 6 7数据资源交换管理规范 （资料性附录）数据接口参数示例28 （资料性附录）SDK调用示例32参考文献 DB4201/T536.2—2017本标准按照GB/T1.1-2009《标准化工作导则第1部分：标准的结构和编写》给出的规则起草。本标准由武汉市互联网信息办公室提出并归口。本标准起草单位：武汉市信息中心、武汉市标准化研究院。本标准主要起草人：王留军、袁远明、崔新强、黄勇、张洁、肖迎霜、董波涛、向小雪、李文、刘肖骏。DB4201/T536.2—20171“云端武汉”政务数据资源目录体系与数据交换技术规范第2部分：数据共享交换本标准规定了“云端武汉”政务数据共享交换中的术语与定义、缩略语、数据交换体系总体框架、数据共享交换技术规范、数据资源交换管理规范。本标准规范适用于武汉市各行政机关或其他依法经授权、受委托行使行政职能的组织采集、归集和共享交换政务数据资源。2规范性引用文件下列文件对于本文件的应用是必不可少的。凡是注日期的引用文件，仅所注日期的版本适用于本文件。凡是不注日期的引用文件，其最新版本（包括所有的修改单）适用于本文件。武政办[2015]146号《武汉市政务数据资源共享管理暂行办法》武网发[2016]9号《武汉市政务云平台数据资源安全管理实施细则》3术语与定义下列术语和定义适用于本文件。3.1行政主管部门administrativedepartment行政机关或者其他依法经授权、受委托行使行政职能的组织。3.2武汉政务云数据中心Wuhangovernmentclouddatacenter指按“物理分散、逻辑集中”的原则将各行政主管部门政务数据资源进行归集，为各行政主管部门的数据共享提供支撑的技术服务平台。简称“数据中心”。3.3政务数据资源governmentdataresource行政主管部门通过数据中心进行传输、交换、存储的非涉密数据，是具有某个作用功能的元数据集合。3.42DB4201/T536.2—2017各行政主管部门可共享的单个政务数据资源不可再分割的组成元素。3.5服务及服务项serviceandserviceitem服务项主要是指数据提供单位可对外公开的单个服务，为实现政务数据资源的交换而提供的一组对数据项操作的集合，数据项可来自于多个政务数据资源，而服务是整个服务项集合的总称。3.6数据需求方datademandside指通过数据中心获取政务数据资源的各行政主管部门。3.7管理者manager指数据中心的运维单位。3.8数据提供方dataprovider指向数据中心提供数据资源的各行政主管部门。3.9共享交换服务sharedexchangeservice各行政主管部门之间根据自身的办事事项进行政务数据资源交换工作的统称。共享交换服务所涉及的数据资源由各行政主管部门自身的业务信息系统所提供、产生、发布并进行运行管理。3.10共享信息服务系统sharedinformationservicesystem对各行政主管部门提供的共享交换服务及接口统一维护管理的平台系统。3.11又称服务接口，本标准中专指各行政主管部门间政务数据资源共享交换的技术实现手段，具体技术形式包含：数据接口、前置数据库两种。3.12访问密钥标识/秘密访问密钥API_key/API_secret根据非对称加密的方法来验证某个请求者身份。DB4201/T536.2—201733.13会话session指用户与服务器进行的一次交互，包括从发起到退出的整个过程。4缩略语下列缩略语适用于本文件。HTTP：超文本传输协议（HyperTextTransferProtocol）API：应用程序编程接口（ApplicationProgrammingInterface）URL：统一资源定位符（UniformResourceLocator）XML：可扩展标记语言（ExtensibleMarkupLanguage）5数据交换体系总体框架5.1总体技术架构5.1.1组成政务数据共享交换体系技术总体架构包括交换信息库和共享交换服务系统两方面组成。5.1.2交换信息库交换信息库是各行政主管部门为实现政务数据共享交换而建立的前置虚拟交换区，交换区内存储可提供的共享交换服务信息。5.1.3共享交换服务系统前置数据库子系统由交换前置服务器、交换信息库、交换适配器及相关中间件等组成。前置数据库子系统与各行政主管部门业务应用系统之间通过建立虚拟共享交换区，实现数据采集交换，保证部门业务数据库和业务应用系统的独立性。数据接口子系统为各行政主管部门对外共享交换服务数据接口提供注册、挂接、配置、授权等管理。交换管理子系统实现对整个数据交换过程的配置、部署、执行和整个共享交换服务系统运行进行监控、管理。5.2共享交换服务建设流程如图1所示，共享交换服务建设包括4个环节：a)申请：数据需求方整理各自办事业务、应用系统、服务事项等需要，依法依规提出政务数据共享交换申请，按照“政务数据共享交换申请单”模版格式要求填写相关信息，单位盖章后报至市政务数据主管部门；DB4201/T536.2—20174b)确认：市政务数据主管部门受理共享交换申请后，对需求合理性进行初审，通过后转交数据提供方确认，数据提供方应在5个工作日内反馈意见。如有分歧，由市政务数据主管部门组织需求方、提供方协商达成一致，双方依据协商结果填写《政务数据共享交换确认单》，加盖公章后提交市政务数据主管部门备案；c)实施：共享交换需求确认后，对于数据中心上已发布的数据服务，由数据中心直接完成权限配置和数据推送；对于数据中心上未发布的数据服务，由市政务数据主管部门指导数据提供方开展设计开发，并由数据中心工作人员完成该项数据服务的对接工作，全部工作应在30个工作日内完成；d)考核：市政务数据主管部门对各部门数据共享工作响应程度、实施进度、工作质量进行考核。对不按照要求进行数据共享交换的部门，予以通报批评；情节特别严重的部门，市政务数据主管部门将取消其通过数据中心共享其他部门数据的资格。DB4201/T536.2—20175数据需求方数据中心数据提供方开始整理办事事项涉及的共享数据资源及相关信息创建服务申请单登记所需数据项和对应政务部门拒绝结束-申请与反馈审核服务同意申请单收集各政务部门反馈结果服务接口实施挂接通知结果给服务涉及相关政务部门提供方结合需求方申请内容，给出反馈意见意见一并提交审核与需求方、提供方协商协商结果形成需求方、提供方、管理方的三方确认单是否已有相关服务没有各政务部门分别进行新建服务工作图1共享交换服务建设流程图5.2.1政务数据共享交换申请单各行政主管部门登记共享交换服务申请内容，需按照附录A中表A.1进行相关信息填写。5.2.2政务数据共享交换确认单数据需求方、提供方就政务数据共享交换申请内容达成一致意见后，需按照附录A中表A.2进行相关信息填写。DB4201/T536.2—201766数据共享交换技术规范6.1概述结合武汉市政务数据资源共享交换工作特点，将各行政主管部门利用数据中心进行数据共享交换的方式划分为：数据接口、前置数据库两种类型。本部分逐一介绍每个交换方式的技术规范要求，各行政主管部门在利用数据中心进行数据共享交换时，需要结合自身采用的数据交换方式，遵循相对应的技术规范要求，同时也为第三方相关单位的研发工作提供标准依据。6.2交换模式6.2.1数据接口类型各行政主管部门的数据接口，应遵循如图2所示的交换模式进行政务数据资源交换。各数据提供方的数据接口在共享信息服务系统中集中注册、挂接、发布，其相关访问地址、帐号、密码等信息不对外公布，只显示业务描述、请求参数、响应参数等基本信息。各数据需求方访问共享信息服务系统公示的统一访问地址，调取自身权限范围内的数据接口，共享信息服务系统将数据提供方返回的结果信息进行封装整理后，统一返回至各数据需求方。数据提供方工商数据接口公安工商数据接口公安数据接口共享信息服务系统根据注册发布的数据接口信息，分别调取访问共享信息服务系统API认证机制接口注册监控管理发布接口授权管理接口注册监控管理发布接口授权管理共享信息服务系统共享信息服务系统封装返回结果，统一返回各政务部门息服务系统，调取授权范围内的数据接口民政数据接口工商民政数据接口工商数据接口数据需求方图2数据接口交换模式示意图DB4201/T536.2—201776.2.2前置数据库类型利用数据中心采用数据库模式进行政务数据交换的各行政主管部门，应遵循如图3所示的交换模式进行政务数据资源交换。各数据提供方的数据库及业务表信息在共享信息服务系统中集中注册、挂接、发布，根据定时抓取、定时推送或FTP上传文件导入三种形式，将各行政主管部门业务数据传至共享信息服务系统提供的前置交换区中，各数据需求方利用共享信息服务系统提供的直接访问数据库、调取接口、FTP文件导出三种方式，访问自身权限范围内的数据业务表信息。数据提供方公安公安数据库民政民政数据库工商数据库根据定时抓取、定时推送或FTP文件导入等方式，将提供方政务数据传至前置交换区共享信息服务系统前置交换区数据库注册业务表订阅数据库注册业务表订阅授权管理监控管理发布数据业务表统一访问共享信息服务系统，查阅授权范围内的业务表共享信息服务系统封装返回结果，统一返回各政务部门公安公安数据库数据需求方民政民政数据库工商工商数据库图3前置数据库交换模式示意图6.3数据接口交换规则6.3.1数据接口管理流程数据接口注册、发布流程各数据提供方的数据接口在共享信息服务系统中集中注册、挂接、发布，其工作流程如图4所示，注册发布包括6个环节：DB4201/T536.2—20178a)指定类目：共享信息服务系统结合各行政主管部门数据特性，按照“服务分类”标准为每个行政主管部门初始相关的接口类目，后期若行政主管部门需要新增服务接口类目，可直接向数据中心管理员申请；b)登记、注册：由各数据提供方行政主管部门登记自身对外提供的接口及相关参数信息；c)提交：由行政主管部门提交发布申请至数据中心；d)审核：由平台中心对各行政主管部门的数据接口内容进行审核；e)配置、测试：审核通过后，由数据中心管理员结合数据接口内容，配置并测试各数据提供方接f)发布：数据接口配置、测试成功后，其数据接口才发布完成。其他行政主管部门可定位该数据接口，查阅相关的描述说明，并申请数据接口的访问权限。DB4201/T536.2—20179·图4数据接口注册、发布流程图DB4201/T536.2—2017数据接口订阅、授权流程各数据需求方通过共享信息服务系统统一提出申请，由数据中心管理员进行审核，对所选数据接口进行调取授权，其工作流程如图5所示，订阅授权包括4个环节：a)申请：各数据需求方通过共享信息服务系统统一提出对已发布数据接口的调取申请；b)审核：由平台中心对各行政主管部门的数据接口订阅请求进行审核；c)授权：为各数据需求方授权相应的数据接口调取权限；d)配置、测试：数据中心管理员配合各数据需求方进行数据接口调取的测试工作，保证数据需求方成功获取所需的接口数据。数据需求方数据中心开始选择所需数据接口提出订阅申请提交审核不通过审核订阅申请通过分配访问权限配置、测试接口测试成功结束图5数据接口订阅、授权流程图DB4201/T536.2—20176.3.2技术要求提供方数据接口发布规范.1数据接口示例数据提供方所发布的数据接口内容，参照附录B表B.1示例进行描述。.2接口命名规范数据提供方数据接口的命名遵循以下规则：a)应由半角格式的英文或数字组成，不允许包含全角格式、汉字或特殊字符，所有数据接口的命名为无缝连写，首词汇采用小写字母，其余每个词汇的缩写的首字母采用大写；b)命名在本规则范围内应唯一，若不同行政主管部门的数据接口名称出现重复，可在数据接口名称前增加“虚拟名称”用于区分不同的行政主管部门。最终格式例如：“虚拟名称.真实数据接口名称（gaj.getPersonByIDCard）”;c)虚拟名称命名应为半角格式的英文无缝连写；d)本规则范围内不允许接口的命名与其对应版本号同时重复。.3数据接口基础属性规范数据接口的基础属性除命名外，还包括：接口版本号、接口描述、接口类型、返回报文类型、访问地址、访问帐号、访问密码、提供方名称、技术联系人、联系人电话，属性具体说明如下：a)接口版本号定义：描述数据接口的版本信息注解：必选项；最大出现次数为1b)接口描述定义：描述数据接口的功能作用注解：必选项；最大出现次数为1c)接口类型定义：描述数据接口的访问方式类型注解：必选项；最大出现次数为1d)返回报文类型定义：描述调取本数据接口返回报文的格式类型（xml或josn格式）注解：必选项；最大出现次数为1e)访问地址定义：描述数据接口的调取访问地址注解：必选项；最大出现次数为1f)访问帐号定义：描述调取数据接口时所需的帐号注解：必选项；最大出现次数为1g)访问密码定义：描述调取数据接口时所需的密码注解：必选项；最大出现次数为1h)提供方名称定义：数据接口提供单位名称DB4201/T536.2—2017注解：必选项；最大出现次数为1i)技术联系人定义：负责数据接口对接调试工作技术人员姓名注解：必选项；最大出现次数为1j)联系人电话定义：负责数据接口对接调试工作技术人员的手机号码或座机号码注解：必选项；最大出现次数为.4请求参数规范调取数据提供方数据接口所需的各请求参数描述应遵循以下规则：a)各参数命名应由半角格式的英文、数字或“_”符号组成，不允许包含全角格式、汉字或其他特殊字符，所有数据接口的请求参数为无缝连写；b)各参数首词汇全部采用小写字母，其余每个词汇的缩写的首字母采用大写；c)每个请求参数的属性包括：名称、类型、数据长度、是否必须、默认值、描述，属性具体说明定义：描述请求参数的英文名称注解：必选项；最大出现次数为12)类型定义：描述请求参数对应的数据类型注解：必选项；最大出现次数为13)数据长度定义：描述请求参数最大长度限制注解：必选项；最大出现次数为14)是否必须定义：描述请求参数是否为必填项注解：必选项；最大出现次数为15)默认值定义：描述请求参数的默认数值，说明当调取数据接口时该参数不传值的情况下，默认的数值注解：可选项；最大出现次数为16)描述定义：说明请求参数的含义及用途注解：必选项；最大出现次数为.5响应参数规范数据提供方数据接口的响应返回结果中各参数描述应遵循以下规则：a)各参数命名应由半角格式的英文、数字或“_”符号组成，不允许包含全角格式、汉字或其他特殊字符，所有数据接口的响应参数为无缝连写；b)各参数首词汇全部采用小写字母，其余每个词汇的缩写的首字母采用大写；c)所有的响应数据编码皆为utf-8格式；d)每个响应参数的属性包括：名称、类型、数据长度、示例值、描述，属性具体说明如下：DB4201/T536.2—2017定义：描述响应参数的英文名称注解：必选项；最大出现次数为12)类型定义：描述请求参数对应的数据类型注解：必选项；最大出现次数为13)数据长度定义：描述响应参数最大长度限制注解：必选项；最大出现次数为14)示例值定义：描述响应参数的示例数值，为需求方提供返回示例注解：必选项；最大出现次数为15)描述定义：说明响应参数的含义及用途注解：必选项；最大出现次数为.6错误结果参数规范调取数据提供方数据接口出现错误时，其返回结果内容应遵循以下规则：a)各参数命名应为半角格式的英文、数字或“_”符号组成，不允许包含全角格式、汉字或其他特殊字符，所有数据接口的错误结果参数为无缝连写；b)各参数首词汇全部采用小写字母，其余每个词汇的缩写的首字母采用大写；c)每个错误结果参数的属性包括：名称、类型、数据长度、示例值、描述，属性具体说明如下：定义：描述错误结果参数的英文名称注解：必选项；最大出现次数为12)类型定义：描述错误结果参数对应的数据类型注解：必选项；最大出现次数为13)数据长度定义：描述错误结果参数最大长度限制注解：必选项；最大出现次数为14)示例值定义：描述错误结果参数的示例数值，为需求方提供返回错误结果示例注解：必选项；最大出现次数为15)描述定义：说明错误结果参数的含义及用途注解：必选项；最大出现次数为.7错误代码定义数据提供方数据接口应包括错误代码及其对应的描述说明，每个错误代码定义的属性包括：错误代码、错误消息、错误说明，属性具体说明如下：a)错误代码DB4201/T536.2—2017定义：描述错误结果参数的代码编号注解：必选项；最大出现次数为1b)错误消息定义：描述错误代码对应的错误消息内容注解：可选项；最大出现次数为1c)错误说明定义：描述错误代码对应的中文描述注解：必选项；最大出现次数为1需求方数据接口使用规范.1访问地址规范数据需求方调取提供方数据接口时，其访问地址为共享信息服务系统提供的统一访问URL。URL的格式例如：公共访问IP地址(http://localhost:9099/api/ws/rest)?公共请求参数+业务请求参数。URL地址参数说明：a)URL地址中各参数应由半角格式的英文、数字或“_”符号组成，不允许包含全角格式、汉字或其他特殊字符，所有数据接口的请求参数为无缝连写；b)URL地址中各参数首词汇全部采用小写字母，其余每个词汇的缩写的首字母采用大写；c)URL里的所有请求参数名和参数值的数据编码皆为utf-8格式；d)参数名与参数值拼装起来的URL长度小于1024个字符时，可以用GET发起请求；参数类型含byte[]类型或拼装完成的请求URL过长时，应用POST发起请求；e)公共请求参数详见.2公共请求参数规范章节；f)业务请求参数详见.4请求参数规范章节。.2公共请求参数规范数据需求方在调取数据接口时，应按照共享信息服务系统要求，传入系统所需的公共请求参数，公共请求参数描述遵循以下规则：a)各参数命名应由半角格式的英文、数字或“_”符号组成，不允许包含全角格式、汉字或其他特殊字符，所有公共请求参数为无缝连写；b)各参数首词汇全部采用小写字母，其余每个词汇的缩写的首字母采用大写；c)每个公共请求参数的属性包括：名称、类型、是否必须、默认值、描述，属性具体说明如下：定义：描述公共请求参数的英文名称注解：必选项；最大出现次数为12)类型定义：描述公共请求参数对应的数据类型注解：必选项；最大出现次数为13)数据长度定义：描述公共请求参数最大长度限制注解：必选项；最大出现次数为14)是否必须定义：描述公共请求参数是否为必填项注解：必选项；最大出现次数为1DB4201/T536.2—20175)默认值定义：描述公共请求参数的默认数值，说明当调取数据接口时该参数不传值的情况下，默认的数值内容注解：可选项；最大出现次数为16)描述定义：说明公共请求参数的含义及用途注解：必选项；最大出现次数为1表1数据接口访问公共请求参数表method是无是无是无时间戳，格式为YYYY-MM-DD客户端请求最大时间误差为10分钟v5是是无.3数据接口示例共享信息服务系统向数据需求方提供所需数据接口调取方式，如附录B表B.2示例所示。认证机制.1API认证简介为保证数据接口访问调取的安全性，防止恶意、超权限访问数据接口，各数据需求方行政主管部门通过共享信息服务系统调取相关数据接口之前，应进行资质认证。系统通过使用API_Key/API_Secret加密的方法来验证各行政主管部门身份，API_Key(以下简称为“AK”)是系统为每个访问者分配的唯一标识；API_Secret(以下简称为“AS”)是用于加密的认证字符串，调取数据接口时，根据特定算法将“AS”与请求参数信息组合加密形成需求方的验证密匙，具体方法详见.3签名算法章节描述。AS信息严格保密，仅限行政主管部门管理员和数据中心管理员有权查阅。.2API认证方式共享信息服务系统获取各数据需求方发送的HTTP请求后，按以下步骤进行需求方身份资质认证：a)获取数据需求方的API_Key信息，判断该数据需求方是否存在，若不存在，系统将拒绝该请求；若存在，则执行后续的验证工作；b)根据签名算法得出本次数据接口调取请求的合法签名内容，与数据需求方请求时提供的sign值比对，若不一致，系统将拒绝该请求；若一致，则执行后续的验证工作；DB4201/T536.2—2017c)判断请求是否超时，即共享信息服务系统服务器收到数据接口调取请求的时间需要符合以下要求：“{timestamp}-10min<服务器接收到请求时间<{timestamp}+10min”；其中，timestamp代表需求方调取数据接口的请求时间。为了防止数据需求方服务器与共享信息服务系统服务器时钟不同步而导致的认证失败，引入10分钟的宽松系数。若共享信息服务系统服务器收到数据接口调取请求的时间不符合以上时间要求，则认为请求超时，系统将拒绝该请求；若符合上述要求，则表示认证成功，系统将按照数据需求方的请求内容进行操作。.3签名算法为了防止调取API数据接口过程中被黑客恶意篡改，数据需求方在调取任何一个API数据接口时都需要携带签名（公共参数中的“sign”参数对应的内容），共享信息服务系统会根据请求参数，对签名进行验证，签名不合法的请求将会被拒绝。共享信息服务系统目前只运用MD5签名算法，计算签名内容过程如下：a)对所有API请求参数（包括公共参数和业务参数，除去sign参数和byte[]类型的参数），根据参数名称的ASCII码表的顺序排序。如：foo=1,bar=2,foo_bar=3,foobar=4排序后的顺序是bar=2,foo=1,foo_bar=3,foobar=4；b)将排序好的参数名和参数值拼装在一起，根据上一步的示例得到的结果为：bar2foo1foo_bar3foobar4；c)把拼装好的字符串采用utf-8编码，使用签名算法对编码后的字节流进行摘要。使用MD5算法，在拼装的字符串前后加上API_Secret，再进行摘要，如：md5(AS+bar2foo1foo_bar3foobar4+AS)；d)将进行摘要后所得到的字节流结果统一转成大写字母。6.4前置数据库交换规则6.4.1前置数据库管理流程数据库业务表注册、发布流程.1定时抓取模式各数据提供方的数据库业务表在共享信息服务系统中集中注册、挂接、发布，由共享信息服务系统定时抓取各数据提供方的数据库业务表数据模式的工作流程如图6所示，注册发布包括4个环节：a)提交信息：由各数据提供方向数据中心管理员提供自身业务数据库的基础配置信息（线下填写纸质或电子文档形式完成）；b)登记、注册：由数据中心管理员登记各数据提供方的业务数据库相关信息；c)配置、测试：数据中心管理员为每个数据提供方分配前置交换区，创建对应数据库表结构，配置、调试前置交换区抓取各数据提供方数据库业务表数据功能；d)发布：数据库业务表抓取数据功能配置、测试成功后，其前置交换区数据库内所有业务表自动发布完成。其他行政主管部门可定位该数据库业务表，查阅相关的描述说明，并申请业务表的访问权限。DB4201/T536.2—2017数据提供方数据中心开始开始登记、注册数据库业务表信息配置、测试数据抓取测试成功发布结束提交自身数据库及业务表相关信息（线下）图6数据库注册、发布流程图（定时抓取模式）.2定时推送模式各数据提供方的数据库业务表在共享信息服务系统中集中注册、挂接、发布，由各数据提供方定时推送自身数据库业务表数据至共享信息服务系统模式的工作流程如图7所示，注册发布包括4个环节：a)提交信息：由各数据提供方向数据中心管理员提供自身业务表的基础配置信息（线下填写纸质或电子文档形式完成）；b)分配交换区：各数据提供方配合数据中心管理员为该行政主管部门分配前置交换区，创建相应数据库表结构；c)配置、测试：各数据提供方配合数据中心管理员配置、调试定时向前置交换区推送自身数据库业务表数据功能是否正常（线下完成）；d)发布：数据库推送数据功能配置、测试成功后，其前置交换区数据库内所有业务表自动发布完成。其他行政主管部门可定位该数据库业务表，查阅相关的描述说明，并申请业务表的访问权限。DB4201/T536.2—2017测图7数据库注册、发布流程图（定时推送模式）.3FTP文件上传模式各数据提供方的数据库业务表在共享信息服务系统中集中注册、挂接、发布，由各数据提供方将自身数据库业务表数据制作成相关文件导入至共享信息服务系统模式的工作流程如图8所示，注册发布包括4个环节：a)提交信息：由各数据提供方向数据中心管理员提供自身业务表的基础配置信息（线下填写纸质或电子文档形式完成）；b)分配交换区：各数据提供方配合数据中心管理员为本部门分配前置交换区，创建相应数据库表c)配置、测试：各数据提供方制作相关文件，通过FTP上传，配合数据中心管理员调试向前置交换区导入自身数据库业务表数据功能是否正常（线下完成）；d)发布：相关数据文件导入业务表数据功能配置、测试成功后，其前置交换区数据库内所有业务表自动发布完成。其他行政主管部门可定位该数据库业务表，查阅相关的描述说明，并申请业务表的访问权限。DB4201/T536.2—2017数据提供方数据中心开始开始提交自身业务表相关信息（线下）配置、测试FTP上传文件导入分配交换区成功发布结束结束图8数据库注册、发布流程图（FTP文件上传模式）数据库业务表订阅、授权流程各数据需求方通过共享信息服务系统统一提出申请，由数据中心管理员审核授权对所选数据库业务表进行访问。具体工作流程如图9所示，订阅授权包括以下4个环节：a)申请：各数据需求方通过共享信息服务系统统一提出对已发布数据库业务表的访问申请；b)审核：由平台中心对各数据需求方的数据库业务表订阅请求进行审核；c)授权：为各数据需求方授权相应的数据库业务表访问权限；d)配置、测试：数据中心管理员配合各数据需求方配置、测试查询数据库业务表数据功能，保证需求方成功获取所需的业务表数据。DB4201/T536.2—2017图9数据库业务表订阅、授权流程图6.4.2技术要求建表规范创建前置交换区表结构需遵循以下规范：a)前置交换区数据库类型目前暂定为Oracle，所有业务表均建成“周期快照事实”，后续可根据实际需要扩展其他类型格式的数据库；b)业务表数据的更新周期若为每天，且每周期全量数据量小于100万条，需要按月份分表，按周期分区。每个分区内含本周期全量数据，历史表数据保留半年（例如：8月1日，清空当年1月份历史数据）；c)业务表数据的更新周期若为每天，且每周期全量数据量大于100万条，需要按周期分表，不需要分区。每个表内含本周期全量数据，历史表数据根据存储情况制定保留方案；DB4201/T536.2—2017d)业务表数据的更新周期若大于每天小于等于每月，且每周期全量数据量小于100万条，需要按月分表，按周期分区。每个分区内含该周期全量数清空当年1月份历史数据）；e)业务表数据的更新周期若大于每天小于等于每月，且每周期全量数据量大于100万条，需要按月份分表，按周期分区。每个分区内含该周期全量数据，历史表数据根据存储情况制定保留方f)业务表数据的更新周期若大于每月，需要按周期分表，不需要分区。每个表内含该周期全量数据，历史表数据根据存储情况制定保留方案；g)每张业务表中新增时间戳字段（insert_time，以下简称“时间戳”），用于记录每条数据的更新传输时间。字段具体的赋值方式详见后文各更新传输数据模式规范中描述介绍；h)每个行政主管部门前置交换区创建一张更新传输数据记录表（以下简称“更新记录表”用于保存该行政主管部门前置交换区每次更新传输数据的相关信息，包括：更新传输时间等。表内各字段具体的赋值方式详见各更新传输数据模式规范中的描述介绍。提供方规范.1数据库配置参数示例数据中心管理员为每个提供方分配前置交换区数据库，建立相应表结构时，需要各数据提供方按附录B表B.3示例出示的相关参数填写。.2数据库配置参数说明结合上述数据库配置参数示例，各参数要求如下：a)提供方名称定义：描述提供数据库信息的单位名称注解：必选项；最大出现次数为1b)数据库名称定义：描述数据提供方业务数据库英文名称注解：必选项；最大出现次数为1c)数据库类型定义：描述数据提供方业务数据库类型，目前支持数据库类型为主流数据库和国产数据库，后续可根据实际需要扩展其他类型格式的数据库注解：必选项；最大出现次数为1d)数据库IP地址定义：描述提供方业务数据库IP地址注解：必选项；最大出现次数为1e)数据库MAC地址定义：描述提供方业务数据库MAC地址注解：可选项；最大出现次数为1f)端口定义：描述提供方业务数据库对应端口内容注解：必选项；最大出现次数为1g)用户名定义：描述访问提供方业务数据库时需登录的用户名DB4201/T536.2—2017注解：必选项；最大出现次数为1h)密码定义：描述访问提供方业务数据库时需登录的密码注解：必选项；最大出现次数为1i)技术联系人定义：负责数据接口对接调试工作技术人员姓名注解：必选项；最大出现次数为1j)联系人电话定义：负责数据接口对接调试工作技术人员的手机号码或座机号码注解：必选项；最大出现次数为1k)业务表信息定义：描述提供方数据库各业务表的相关信息，包含业务表名称、业务表说明、业务表更新频率、业务表当前记录数、业务表每周期更新数据量、业务表数据保存周期六个子属性，以下逐一介绍注解：必选项；最大出现次数为N1)业务表名称定义：描述数据库业务表英文名称注解：必选项；最大出现次数为12)业务表说明定义：数据库业务表存储内容及含义的中文概要说明注解：必选项；最大出现次数为13)业务表更新频率定义：描述数据库业务表数据的更新频率周期（天、周、月、年）注解：必选项；最大出现次数为14)业务表当前记录数定义：描述数据库业务表当前数据量，为分配前置交换区做参考依据注解：必选项；最大出现次数为15)业务表每周期更新数据量定义：描述数据库业务表每个更新周期内变动的数据量，为分配前置交换区做参考依据注解：必选项；最大出现次数为16)业务表数据保存周期定义：描述数据库业务表数据保存周期，为分配前置交换区做参考依据注解：必选项；最大出现次数为1l)业务表字段信息定义：描述数据库业务表各字段相关信息，包含字段名称、字段描述、字段类型3个子属性，以下逐一介绍注解：必选项；最大出现次数为N定义：描述业务表字段英文名称注解：必选项；最大出现次数为12)字段描述定义：描述业务表字段含义及说明注解：必选项；最大出现次数为1DB4201/T536.2—20173)字段类型定义：描述业务表字段存储时对应的数据类型注解：必选项；最大出现次数为.3定时抓取模式规范采用共享信息服务系统“定时抓取”各数据提供方数据库业务表数据信息方式时，结合数据库配置参数示例，需各数据提供方提供数据库属性包括：数据库IP地址、端口、数据库名、用户名、密码、业务表信息、业务表字段信息，属性具体说明参照.2章节中的相关描述说明。在本模式下，各业务表的“时间戳”字段和“更新记录表”内容由共享信息服务系统在抓取数据时自动赋值。.4定时推送模式规范采用各数据提供方“定时推送”自身数据库业务表数据信息至共享信息服务系统方式时，需各数据提供方提供数据库属性包括：数据库名称、业务表信息、业务表字段信息，属性具体说明参照.2章节中的相关描述说明。在本模式下，各数据提供方推送数据至前置交换区时，需要向各业务表的“时间戳”字段和“更新记录表”进行赋值。.5FTP文件上传模式规范采用各数据提供方通过FTP文件上传方式将自身数据库业务表数据信息传至共享信息服务系统时，需各数据提供方提供数据库属性包括：数据库名称、业务表信息、业务表字段信息，属性具体说明参照.2章节中的相关描述说明。各数据提供方将自身政务数据制作为数据文件上传至前置交换区指定FTP文件服务器上，共享信息服务系统根据设置，定时扫描相关文件并执行文件，实现导入业务表结构及相关数据的功能，同时向各业务表的“时间戳”字段和“更新记录表”进行赋值，上传至FTP文件服务器相关文件命名及格式需要遵循以下规范：a)为实现文件的解析、适配，要求上传的文件格式目前定为CSV、EXCEL、XML；后续可根据实际需要扩展支持其他类型格式；b)文件命统一命名为：“上传日期（YYYYMMDD）+数据库名称+文件名称”。需求方规范.1概述基于前置数据库交换模式，各数据提供方的相关政务数据集中存储在前置交换区内，因此，各数据需求方可结合自身需要，选择直接访问数据库、调取接口、FTP文件导出三种方式，实现政务数据交换功能。.2直接访问数据库采用直接访问数据库查询数据时，数据需求方根据授权情况，获取前置交换区访问ip地址、端口、用户名、密码、数据库名称、业务表名、字段名信息，共享信息服务系统从提供方获取的信息为视图数据，非原始业务数据，数据需求方无权查阅数据提供方的原始业务数据。.3数据接口DB4201/T536.2—2017采用数据接口获取数据时，共享信息服务系统将查询数据功能封装为一个对外发布的API数据接口，数据需求方根据授权情况，调取该数据接口，具体规范要求详见需求方数据接口章节描述.4FTP文件导出采用FTP文件导出获取数据时，共享信息服务系统将查询出的数据组装制作成需求方指定文件格式，存放至前置交换区FTP文件服务器中，供数据需求方访问下载，目前FTP文件支持CSV、EXCEL、XML三种格式，后续可根据实际需要扩展支持其他类型格式。7数据资源交换管理规范7.1概述7.1.1数据资源交换体系管理架构包括数据资源交换体系使用和管理的三个角色和六项活动。三个角色是政务共享交换服务的数据提供方、管理者和数据需求方。六项活动是指：规划、开发、注册、运维、服务、使用。如图10所示。图10数据资源交换体系总体管理架构7.1.2数据提供方、管理者、数据需求方三方共同对数据资源共享交换体系进行规划、制定。数据提供方负责完成本部门政务数据资源对外服务接口的开发，同时负责本部门服务接口内容的登记、注册以及日常维护；管理者负责各行政主管部门服务接口的对接调试、访问授权以及系统维护管理；数据需求方有权查询发布的服务接口并访问调取相应的政务数据资源。7.2角色职责7.2.1数据提供方数据提供方的管理职责包括：a)负责本部门政务数据资源共享交换服务接口建设的规划；b)负责开发服务接口具体实现功能；c)负责本部门服务接口内容的登记、注册及日常更新升级维护，保证对所提交数据的真实性、完整性、时效性；DB4201/T536.2—2017d)配合数据中心管理员调试服务接口功能。7.2.2管理者管理者指数据中心管理员，其管理职责包括：a)负责协调全市各行政主管部门完成政务数据资源共享交换服务接口建设方案；b)为各提供方分配前置交换区；c)对各行政主管部门的服务接口内容审核、发布；d)配置、调试各提供方服务接口功能；e)配合需求方调试服务接口功能；f)提供政务数据资源的访问、获取服务接口。7.2.3数据需求方数据需求方的管理职责包括：a)负责本部门各政务数据资源共享交换需求方案的规划；b)访问调取在授权范围内的政务数据资源，实现数据交换功能；c)保证查阅数据资源的保密性和安全性，不得违规将数据提供给第三方。7.3管理环节7.3.1管理环节与角色关系如图10所示，政务数据共享交换体系建设和管理各项活动与所涉及的角色关系如下：a)“规划”环节：由数据提供方、管理者、数据需求方共同完成；b)“开发”环节：由数据提供方、数据需求方各自完成；c)“注册”环节：由数据提供方完成；d)“运维”环节：由数据中心管理员完成；e)“服务”环节：由数据中心管理员完成；f)“使用”环节：由数据需求方完成。7.3.2规划规划工作主要由数据提供方、管理者、数据需求方共同完成。该活动的主要内容包括：a)各数据提供方、数据需求方按照其管理范围和职责权限梳理、规划自身政务数据资源共享交换b)管理者协调数据提供方、数据需求方制定政务数据资源共享交换方案；c)各数据提供方、数据需求方制定政务数据资源共享交换服务接口建设计划。7.3.3开发开发工作主要由数据提供方、数据需求方各自分别完成。该活动的主要内容包括：a)数据提供方、数据需求方各自分别结合政务数据资源共享交换方案，开发自身信息化业务系统，实现政务数据资源对外共享功能；b)数据提供方负责相关可共享交换数据资源的更新、上报维护。7.3.4注册注册工作主要由数据提供方完成。该活动的主要内容包括：DB4201/T536.2—2017a)数据提供方登记、注册政务数