中山大学大数据共享交换平台接入要求规范.doc

中山大学数据共享交换平台接入规范(试行)中山大学信息化管理办公室2018年5月目录1. 概述 . 读者 . 目的 . 相关术语 . 信息资源目录 . 数据交换方式 . 数据交换模式 . 数据日期概念 . 增量条件 62. 交换体系设计 . 总体设计 . 架构设计 . SFTP服务架构 . 数据库物理架构 . 数据交换方式 . 文件方式交换 . 轮询交换(固定周期)、通报交换(不固定周期)提供的文件 . 实时交换方式提供的文件 . 文件路径说明 . 数据库方式交换 . WEB服务方式交换 . 系统接入方式 133. 数据交换模式 . 实时交换 . 数据报文请求 . 数据文件请求 . 数据报文推送 . 数据文件推送 . 轮询交换(固定周期) . 采集过程 . 供数过程 . 通报交换(不定周期) 274. 接口设计 . 接口总体说明 . 通信模式 . 安全控制 . 错误处理 . 消息定义 . 消息体 . 系统ID(系统编码) . 接口编码 . 接口详细设计 . 资源目录管理 . 数据文件请求模式接口 . 数据报文请求模式接口 . 数据采集服务接口 . 供数服务 . 点对点供数 . 数据文件推送 . 数据报文推送 . 消息通知模式 . 通报交换(不固定周期) 505. 数据权限 . 资源权限 . 字段级权限 516. 附录1—错误码 527. 附录2—web服务使用说明 . 使用交换平台的接口 . 接入方实现的服务 . 报文样例 57概述中山大学数据共享交换平台(下称“交换平台”)是负责传输校内不同信息系统间数据的平台,各业务系统通过与数据交换平台对接,实现业务数据在不同业务系统之间顺畅、实时、批量传输。读者与交换平台对接的信息系统建设方与交换平台对接的信息系统开发方交换平台开发方交换平台运维管理方目的本文档是中山大学数据共享交换平台接口需求及设计方案相关文档,可用于指导对接接口开发、联调、测试工作。相关术语术语说明数据共享交换平台下文如无特殊说明,简称交换平台。业务系统需要实施数据共享交换的业务信息系统,如人事信息管理系统、教务信息管理系统等。ok文件标志文件,在数据文件生成完成后产生的空文件,供数据需求方判断文件是否可读取资源代码资源如果是数据库表,则资源代码为:数据提供方表名。资源如果是文件,则资源代码为:文件名去掉系统ID和后缀。资源如果是报文,则资源代码为:返回报文中result中的tablename。dcroot交换平台sftp根目,实际为登录后的files目录syroot交换平台为每个业务系统配置的专属sftp根目录。不同的业务系统的根目录不同,实际为登录后的files目录单一资源资源目录中一个资源ID定义为一个资源,当资源为一个文件或一个表时,为单一资源复合资源资源目录中一个资源ID定义为一个资源,当资源为一类资源,即对应多个文件或多个消息时,为复合资源。例如一份完整档案,包含多个不同类型文件集合,此集合属于一个复合资源。信息资源目录信息资源目录为数据共享交换的依据,目录所含内容既是对共享信息资源的描述,也是数据交换关系的描述。在数据共享交换中的一张数据库表、一个文件或一类文件都是属于信息资源,注册于信息资源目录中。中山大学信息资源目录由数据模型管理平台管理,数据共享交换实施前需要数据提供方注册,并由数据管理员审核通过后对全校发布。下表详细介绍资源的属性字段名称字段类型是否必填说明resourceIDString是资源ID,一个资源的唯一IDmultiFlagchar是是否包含多个文件标识:S:单一资源(对应一个文件,一个表);M:复合资源(可多个文件,多个消息定义为一个资源ID,对应一类资源,一类消息)。resourceAliasString是资源代码:(1)当multiFlag=S时:数据库表为:数据提供方表名,文件类型为:文件名去掉系统ID和后缀,报文类型为:返回报文中result中的tablename;(2)当multiFlag=M时:自定义的这一类资源的类别名称,如果是文件类型,建议