国家数据共享交换平台（政务外网）库表交换、文件交换
操作指南（V2.0）
国家电子政务外网管理中心
二〇一八年一月
目录
一、指南说明 (4)
（一）概述 (4)
（二）内容概要 (4)
（三）角色说明 (5)
（四）术语和定义 (5)
二、网络接入 (6)
三、工作流程 (6)
（一）资源准备 (6)
（二）资源注册 (6)
（三）资源申请 (7)
（四）资源订阅 (7)
四、库表交换 (8)
（一）库表注册、发布 (8)
1、操作流程 (8)
2、操作步骤 (10)
（二）库表申请、订阅 (42)
1、操作流程 (46)
2、操作步骤 (48)
五、文件交换 (50)
（一）文件注册、发布 (51)
1、操作流程 (51)
2、操作步骤 (52)
（二）文件申请、订阅 (97)
1、操作流程 (97)
2、操作步骤 (99)
一、指南说明
（一）概述
为指导资源提供方和资源需求方通过国家数据共享交换平台（政务外网）提供和使用库表资源、文件资源，特制定本指南。
国家政务信息资源共享的形式有服务接口、库表交换、文件交换。
本指南主要指导资源提供方和资源需求方在国家共享平台通过库表交换、文件交换形式实现国家政务信息资源共享。
服务接口方式的具体操作详见《国家数据共享交换平台（政务外网）服务接口操作指南》（试行）。
（二）内容概要
本指南主要包括网络接入、工作流程、库表交换、文件交换四部分。
网络接入部分主要指导各中央政务部门进行网络整合、接入政务外网的操作。
工作流程部分主要指导资源提供方和资源需求方提供和使用库表、文件资源需要做的关键工作。
库表交换部分主要指导资源提供方和资源需求方进行库表注册、发布、申请、订阅等具体操作。
文件交换部分主要指
导资源提供方和资源需求方进行文件注册、发布、申请、订阅等具体操作。
（三）角色说明
库表、文件资源的提供和使用涉及角色主要有资源提供方操作人员、审核人员和资源需求方操作人员、审核人员。
资源提供方操作人员完成库表、文件注册、发布工作，资源需求方操作人员完成申请、订阅工作。
资源提供方审核人员负责对库表文件注册、申请的审核，资源需求方审核人员负责对库表文件订阅的审核。
（四）术语和定义
本文涉及到的专用名词及术语定义如下：
政务外网局域网：接入政务外网的逻辑隔离区域，与部门其他网络之间有明确边界。
国家共享平台：国家数据共享交换平台（政务外网），对外服务的入口是共享网站（/）。
资源提供方：通过国家共享平台提供资源的中央政务部门、省（自治区、直辖市）。
资源需求方：通过国家共享平台获取资源的中央政务部门、省（自治区、直辖市）。
二、网络接入
中央政务部门需要在政务外网局域网设置政务外网服务区（DMZ）和政务外网终端区，政务外网服务区部署交换前置节点和参与共享交换的服务器，政务外网终端区能主动访问政务外网的终端。
具体操作详见《国家数据共享交换平台（政务外网）部门接入指南》（试行版）中网络接入部分。
三、工作流程
（一）资源准备
资源提供方应对来源于本单位政务信息系统的库表资源和文件资源进行整理，形成便于资源需求方识别与应用的可共享库表和文件资源。
资源提供方应将共享的库表、文件资源对应的目录同步到国家共享平台。
（二）资源注册
资源提供方操作人员在国家共享平台，将准备好的库表、文件资源进行注册并完成发布。
（三）资源申请
资源需求方操作人员在国家共享平台，按照需求进行资源申请。
申请国家共享平台授权的资源，需要国家共享平台审核人员审核，审核通过后，服务接口类型申请审核自动备案，库表、文件申请审核没有备案；申请资源提供方授权的资源，需要资源提供方审核人员审核，审核通过后，服务接口类型申请审核自动备案，库表、文件申请审核没有备案。
（四）资源订阅
资源申请审核通过后，资源需求方操作人员根据资源提供方的资源共享方式（库表交换或文件交换）进行资源订阅，订阅时需指定具体的数据接收部门。
（五）资源变更
资源变更是操作人员对已成功发布并由平台审核员-发布审核【通过】的资源信息进行【变更】的操作过程，进入数据交换系统【资源交换-资源注册-数据库资源/文件资源】中对已注册的资源进行变更。
（六）资源撤销
资源撤销是操作人员对已成功发布并由平台审核员-发
布审核【通过】的资源信息进行【撤销】的操作过程，进入数据交换系统【资源交换-资源注册-数据库资源/文件资源】中对已注册的资源进行撤销。
四、库表交换
（一）库表注册、发布
1、操作流程
采用库表方式进行交换时，资源提供方需在国家共享平台对库表资源进行注册、发布，流程如下：
（1）数据桥接
业务系统技术人员将对外共享交换的数据加载到前置交换数据库表中，并按照业务要求，对交换库表中的数据进行及时更新。
数据源创建业务系统技术人员操作人员操作人员操作人员审核人员
（2）数据源创建并注册
操作人员在交换系统中创建对应的数据源，并对数据源进行配置，配置信息包括数据源名称、数据库类型、数据库驱动类名等；数据源创建完成后进行注册。
（3）资源注册
基于创建好的数据源，资源提供方操作人员在国家共享平台的交换系统中注册数据库表资源，并完成库表资源与目录关联。
（4）资源发布
资源提供方操作人员在国家共享平台的交换系统中对审核通过的库表资源进行发布，并设置相应的发布属性（更新周期、范围、条件等）。
（5）资源变更和撤销
资源提供方操作人员在国家共享平台的交换系统中对平台发布审核通过的库表资源进行变更和撤销操作，即变更是变更注册表资源数据信息的操作；撤销是对已发布表资源信息的撤销和注册表资源信息的删除操作。
2、操作步骤
（1）数据源创建并注册
数据源创建
资源提供方操作人员登录国家共享网站，点击【用户中心】，进入用户中心首页，点击【交换系统】或点击【快捷操作-注册数据资源】跳转到交换系统首页进入到【数据交换系统】中。
在数据交换系统主界面点【基础设施】，然后点击【数据源管理】，进入数据源管理的界面，点击【新增】。
在数据源管理中，关于数据源的详细信息介绍如下：
拆分：将数据源拆分多个子数据源
卸载：原名为“反部署”，现更名为“卸载”。
卸载是指将节点上数据源的信息删除，卸载与部署对应 部署：将中心的数据源下发到各节点上
修改：更改此数据源的配置信息
删除：删除此数据源
进入数据源新增页面，填写数据源信息，确认无误后，点击【确定】，也可点击【取消】，取消新增。
在数据源新增界面中，填写数据源的相关信息如下：
数据源名称：根据需求命名自己的数据源名称。
交换所属域：选择该用户所在的域。
节点名称：选择该用户所属的节点。
数据库类型：选择该用户所使用到的数据库类型，支持Oracle、Sqlserver、Sybase、db2、Mysql5等。
驱动类名：默认加载出来的。
连接URL：连接数据库所在服务器的路径及端口号和库名等参数。
用户名：数据库用户名。
密码：数据库密码。
最小连接数：最小能够同时接受多少客户的连接，默认是5，可以选择默认即可。
最大连接数：最大能够同时接受多少客户的连接，默认是25，可以选择默认即可。
有效性检查SQL：用来验证数据库连接的查询语句。
Schema名称：数据库对象的集合，一个用户对应一个Schema。
备注：根据需求自己填写即可。
查询数据源可以根据数据源名称、数据库类型、节点名称进行查询，如下图所示：
●新增数据库资源
若添加数据库资源，进入数据交换系统，点击【资源交换-资源注册-数据库资源】，进入数据库资源列表页面，
点击【新增】。
在数据库资源中，关于数据库资源的详细信息介绍如下： 表资源：在该库下所有表的信息获取到并进行注册
修改：更改此数据库资源的信息项
删除：删除该数据库资源项
进入数据库资源新增页面，填写数据库资源信息，确认无误后，点击【确定】，也可点击【取消】，取消新增。
新增数据库资源信息如下：
数据库资源名称：数据库的名称。
数据源名称：选择在数据源管理中创建的数据源。
应用系统名称：该应用系统的名称。
所属机构：默认显示即可。
姓名：填写创建此数据库资源的操作人即可。
职务：填写对应的职务即可。
电话：根据相对应的格式填写电话。
手机：根据相对应的格式填写手机号。
邮箱：填写联系邮箱。
数据库描述：填写数据库的备注信息。
●修改数据库资源
进入数据库资源列表页面，找到要修改的数据库资源，在右侧【操作】列中，点击【修改】。
进入数据库资源修改页面，修改信息，确认无误后，点击【确认】，也可点击【取消】，取消修改。
注：点击【确定】时，如果该数据库资源已经有交换任务或被发布/订阅资源使用，页面会提示“该数据库资源已被使用，并要求用户再次确认是否更新数据库资源”，避免错误操作。
删除数据库资源
在删除数据库资源操作时，一次可选中一个数据库资源进行删除操作，也可选中多个数据库资源进行批量删除操作。
在数据库资源列表页面，选择要删除的数据库资源，点击【删除】。
弹出删除提示框，点击【确定】，删除数据库资源；点击【取消】，取消删除。
注：如果要删除数据库资源已经有交换任务或已经被发布/订阅资源使用，则提示被哪个（些）资源使用，不允许删除。
查询数据库资源
进入数据交换系统，点击【资源交换-资源注册-数据库资源】，进入数据库资源列表页面，可根据数据库名称、注册时间等来进行查询。
数据库资源注册完成后，需要继续对数据库中的表进行注册。
（2）资源注册
资源提供方操作人员登录国家共享网站，点击【用户中心】，进入用户中心首页，点击【交换系统】或点击【快捷操作-注册数据资源】跳转到交换系统首页进入到【数据交换系统】中。
进入数据交换系统，点击【资源交换-资源注册-数据库资源】，进入数据库资源列表页面，找到数据库资源，点击操作列【表资源】。
进入表资源列表页面，点击【注册资源】，弹出请选择导入的表页面，选择要导入的表，点击【确定】，也可点击【取消】。
点击【确定】后，进入表资源注册页面，填写表资源信息，确认无误后，点击【确定】，也可点击【取消】。
新增表资源信息如下：
表资源名称：Source,表资源名称不可以重复。
组织机构：该登录当前用户的所属机构。
数据库表名：注册时选择的默认的表资源名称。
Schema名称：该注册的表资源所在的数据库名称。
更新周期：根据选择的对应的周期进行表资源的更新；
每日/每日更新一次；每周/每周更新一次；每月/每月更新一次；每季度/每季度（三个月）更新一次；
每半年/每半年更新一次；每年/每年更新一次；实时/根据表资源的改动同步进行更新。
所属域：例如/公共域。
来源系统：该用户所属的组织机构下的来源系统信息。
目录标识：选择该用户所创建的目录标识作为注册该表资源的挂接目录。
是否共享：分为有条件共享和无条件共享；有条件共享/申请该表资源时由发布方进行审核；无条件共享/
申请该表资源时由国家平台审核员进行审核。
开放类型：若选择“是”时，下方会出现开放条件说明框，填写相关说明信息；若选择“否”时，开放条
件说明框会隐藏，无需填写相关说明信息。
附件：注册该表资源时可以添加相关附件进行注册，附件大小不能超过20M。
描述：注册该表资源的描述信息。
列属性：分别为数据项名称、字段名、字段类型、长度/精度、是否主键、是否为空；其中数据项名称是
指对该表资源中其中的一个字段的信息的描述情况，
可以进行修改，默认是和字段名一致，方便认识了解
该字段的含义；其余的信息都是默认展示的，针对该
字段在表中的信息记录回显出来进行展示。
点击【确定】，保存所做配置返回到表资源注册列表页，如图所示：注册成功时无需进行表资源的注册提交操作，直接点击【部门审核-发布审核-表发布】进行发布即可。
（3）资源发布
资源提供方操作人员登录共享网站，进入交换系统，在数据交换系统主界面点击【资源交换-资源发布】，点击【表发布】选项卡，进入表资源发布界面。
注：表资源注册成功后，直接进行表资源发布即可。
选择发布资源
可以通过“资源名称”进行查询。
●进行资源发布
选择一条记录点击【发布】，进行发布操作。
表资源发布信息如下：
抽取方式：系统提供四种抽取方式：触发器、时间戳、标志位字段和全量。
时间间隔：设计每间隔多长时间，数据交换一次。
定时：设置什么时间开始交换数据。
条件设置：交换数据的条件。
附件设置：设置字段的附件。
备注：发布成功之后，在【已发布资源-表发布】中，该发布的表资源自动是“启动”的状态，该发布的表资源在被订阅并且由订阅方在【资源交换-订阅资源-已订阅资源】点击【启动】时，进行表资源的数据交换。
表资源发布成功后，需要部门审核员进行“发布审核”
的操作，在【部门审核-发布审核-表资源】中，选择一条已发布的表资源记录点击【审核】进行发布审核操作。
进入表资源发布审核的列表页面中，回显表资源注册时详情信息数据，填写部门审核意见进行相关操作。
若点击【不通过】时，表资源发布审核未通过，在【资源交换-资源注册-数据库资源】选择注册表资源的数据库资源所在记录点击【表资源】进入表资源注册列表页，由部门审核员发布审核时点击【不通过】的表资源记录此时状态显
示为“部门发布审核驳回”。
此时可以进行该表资源的“修改”和“删除”操作，若点击“删除”按钮时，则该注册的表资源记录不能被删除成功，会提示：资源已经发布，删除失败。
若点击【资源交换-资源发布-已发布资源-表发布】列表页中，找到要停止启动的表资源记录点击【停止】，会提示：该资源没有提交停止申请，不允许直接停止。
注：“停止申请”需要部门发布审核通过后并由平台发布审核通过后，在
【资源交换-资源发布-已发布资源-表发布】列表页中，该被“部门发布审核”和“平台发布审核”通过的表资源记录此时的操作状态就显示为“停止申请”。
回到【资源交换-资源注册-数据库资源】选择注册表资源的数据库资源所在记录点击【表资源】进入表资源注册列表页，找到被部门发布审核“不通过”的表资源记录，点击“修改”按钮时，则会进入该表资源的修改列表页，并回显注册该表资源时填写的相关信息数据。
点击“确定”，保存该修改的表资源相关数据信息并返回表资源注册列表页；点击“取消”，不保存该修改的表资源相关数据信息并返回表资源注册列表页。
点击【修改】后，不改变该修改的表资源此时的状态，状态显示依旧为“部门发布审核驳回”，继续点击【资源交换-资源发布-已发布资源-表发布】选择在表资源注册列表页中被修改后的记录点击【修改】，保存后返回表资源已发布列表页，此时在【资源交换-资源注册-数据库资源-表资源】列表页中该已发布修改的表资源状态显示为“部门发布审核中”，继续由部门发布审核即可。
注：在【资源交换-资源注册-数据库资源-表资源】列表页中找到被部门审核发布“不通过”的表资源记录点击“修改”确定保存后，并在【资源交换-资源发布-已发布资源-表发布】列表页中找到相同的表资源记录点击“修改”并确认保存后，返回表资源
注册列表页，此时的状态才会改变为“部门发布审核中”重新在【部门审核-发布审核-表资源】列表页中进行审核即可。
在【部门审核-发布审核-表资源】列表页中找到要审核的表资源记录点击【审核】，跳转到表资源发布审核详情页面，此时点击“通过”后在【资源交换-资源注册-数据库资源-表资源】列表页中该被部门发布审核通过的表资源记录状态显示为“平台发布审核中”。
在【平台审核-发布审核-表资源】列表页中找到部门发布审核的表资源记录进行平台发布审核操作。
进入表资源发布审核的列表页面中，回显表资源注册的详情信息数据和部门审核意见信息，填写平台发布审核意见进行相关操作。
若点击【不通过】时，表资源发布审核未通过，在【资源交换-资源注册-数据库资源】选择注册表资源的数据库资源所在记录点击【表资源】进入表资源注册列表页，由平台审核员发布审核时点击【不通过】的表资源记录此时状态显示为“平台发布审核驳回”。
此时可以进行该表资源的“修改”和“删除”操作，若点击“删除”按钮时，则该注册的表资源记录不能被删除成功，会提示：资源已经发布，删除失败。
若点击【资源交换-资源发布-已发布资源-表发布】列表页中，找到要停止启动的表资源记录点击【停止】，会提示：该资源没有提交停止申请，不允许直接停止。
注：“停止申请”需要部门发布审核通过后并由平台发布审核通过后，在【资源交换-资源发布-已发布资源-表发布】列表页中，该被“部门发布审核”和“平台发布审核”通过的表资源记录此时的操作状态就显示为“停止申请”。
回到【资源交换-资源注册-数据库资源】选择注册表资源
的数据库资源所在记录点击【表资源】进入表资源注册列表页，找到被平台发布审核“不通过”的表资源记录，点击“修改”按钮时，则会进入该表资源的修改列表页，并回显注册该表资源时填写的相关信息数据。
点击“确定”，保存该修改的表资源相关数据信息并返回表资源注册列表页；点击“取消”，不保存该修改的表资源相关数据信息并返回表资源注册列表页。
点击【修改】后，不改变该修改的表资源此时的状态，
状态显示依旧为“平台发布审核驳回”，继续点击【资源交换-资源发布-已发布资源-表发布】选择在表资源注册列表页中被修改后的记录点击【修改】，保存后返回表资源已发布列表页，此时在【资源交换-资源注册-数据库资源-表资源】列表页中该已发布修改的表资源状态显示为“部门发布审核中”，重新由部门发布审核通过后继续由平台发布审核即可。
注：在【资源交换-资源注册-数据库资源-表资源】列表页中找到被平台审核发布“不通过”的表资源记录点击“修改”确定保存后，并在【资源交换-资源发布-已发布资源-表发布】列表页中找到相同的表资源记录点击“修改”并确认保存后，返回表资源注册列表页，此时的状态才会改变为“部门发布审核中”重新在【部门审核-发布审核-表资源】列表页中进行审核即可。
此时由部门发布审核重新进行审核操作，部门发布审核“通过”后在【平台审核-发布审核-表资源】列表页中选择被部门发布审核“通过”的表资源记录点击审核并“通过”审核，返回表资源平台发布审核列表页，进入【资源交换-资源注册-数据库资源-表资源】列表页中被平台发布审核“通过”的表资源记录，此时状态显示为“平台发布审核通过”。
（4）资源变更
资源提供方操作人员登录共享网站，进入交换系统，在数据交换系统主界面点击【资源交换-资源注册-数据库资源】选择注册表资源的数据库资源所在记录点击【表资源】进入表资源注册列表页，选择要进行变更的表资源记录点击【变更】。
点击【变更】后跳转到该表资源的变更页面，回显注册该表资源时填写的相关数据信息并填写“变更原因”进行该表资源变更的相关操作。
此时可以进行“提交”和“取消”操作。
若点击“取消”按钮时则取消本次的变更操作并返回表资源注册列表页面；若点击“提交”按钮时则提交本次变更操作并返回表资源注册列表页面，此时该提交变更的表资源的状态显示为“部门变更审核中”。
点击【资源交换-部门审核-变更审核-表资源】列表页面中选择一条表资源变更记录，进行表资源变更审核操作点击【审核】。
进入到表资源变更审核的详细信息列表页面，回显该表资源的相关信息展示以及变更申请原因，填写部门变更审核意见进行变更操作即可。
若点击“返回”按钮时，不保存变更审核操作并返回表资源变更审核列表页面。
若点击“不通过”按钮时，完成变更审核操作并返回表资源变更审核列表页面。
此时点击【资源交换-资源注册-数据库资源】选择注册表资源的数据库资源所在记录点击【表资源】进入表资源注册列表页面。
被该
部门变更审核“不通过”的表资源记录的状态由“部门变更审核中”变为“部门变更审核驳回”。
操作栏中【变更】和【撤销】按钮显示出来。
点击【变更】按钮提交变更操作，此时在【部门审核-变更审核-表资源】列表页面选择变更操作的表资源记录点击【审核】后跳转到表资源变更审核详情页面，此时点击【通过】，完成部门变更审核并返回表资源变更审核列表页面。
点击【资源交换-资源注册-数据库资源】选择注册表资源的数据库资源所在记录点击【表资源】进入表资源注册列表页面。
此时被部门变更审核通过的表资源记录状态显示为“平台变更审核中”。
平台审核员在【资源交换-平台审核-变更审核-表资源】列表页中选择部门变更审核通过的表资源记录点击【审核】进行平台变更审核操作。
进入到表资源平台审核的详情页面中，回显该表资源注册时的详情信息以及变更申请原因和部门变更审核意见，填写平台变更审核意见进行变更操作。
若点击“返回”按钮时，不保存平台变更审核操作并返回平台变更审核表资源列表页面；若点击“不通过”按钮时，完成平台变更审核操作并返回平台变更审核表资源列表页面。
此时点击【资源交换-资源注册-数据库资源】选择注册表资源的数据库资源所在记录点击【表资源】进入表资源注册列表页面，该被平台变更审核“不通过”的表资源记录状态由“平台变更审核中”变为“平台变更审核驳回”并且操作栏中【变更】和【撤销】按钮显示出来。
