第三方系统资源元数据信息同步协议探索.docx

PAGE \* MERGEFORMAT PAGE \* MERGEFORMAT 1国家教育资源智能导航系统第三方系统资源信息接入协议 科大讯飞信息科技股份有限公司2014年05月 第 PAGE 2页，共 NUMPAGES 16页 版本记录 版本号时间记录人变更原因变更描述V12014/6/13李斌松初步完成文档目的教育资源集中展示系统搜索和导航需要第三方教育资源系统的资源元数据，例如国家教育资源公共服务平台、安徽教育云平台、学科网等资源系统。为了实现汇集的第三方资源信息能在集中展示系统中可被导航，需要保证第三方资源目录属性符合集中展示系统要求。同时，为了保证汇集资源的搜索效果，也需要第三方资源信息包含必要的扩展属性。为此，本文档定义了元数据描述标准。在统一的元数据标准下，集中展示系统提供多种灵活的资源信息交换方式与第三方资源系统进行信息汇总与同步。只要第三方资源系统满足信息交换接口，就可以将资源信息同步到集中展示平台。元数据标准描述元数据描述标准包含了资源元数据字段定义、资源类型定义及相关定义的样例。详细内容参见《资源元数据标准描述》，相关枚举类型字段值，请参见《资源字段枚举值.xlsx》。资源信息交换接口第三方系统同步资源元数据到教育资源集中展示系统之前，需要标准化《资源元数据字段定义》中定义的枚举类型字段值，各个枚举类型字段值，请参考《资源字段枚举值.xlsx》文档。根据第三方系统的实际情况，系统提供两种数据同步接口：SFTP接口第三方系统把自己已有资源元数据信息按照《资源元数据标准描述》导出写入到txt文件中，再通过SFTP方式上传到教育资源集中展示系统提供的FTP Server。教育资源集中展示系统定时扫描FTP Server目录，检查是否有txt文件，如果发现新txt文件，解析txt文件中资源元数据信息入库。并把解析过的txt文件转移到其他文件夹中备份。数据同步支持全量和增量同步方式，第三方系统首次同步数据使用全量同步资源元数据，以后定期增量同步资源元数据数据。资源同步交互时序图如下图所示：（FTP数据交互时序图）数据格式第三方系统同步资源元数据到教育资源集中展示系统之前，需要标准化资源元数据，标准化的字段有：资源类型、知识点、年级、学科、课本、单元、课、出版社、资源来源、资源扩展名，标准化字段信息请参考附件《资源元数据标准描述》。Txt同步文件数据格式定义如下：第三方接入资源系统每次导出的所有资源元数据写入同一个txt文件中。txt文件包含多条资源元数据，每条完整资源元数据使用特殊字符串区分开始和结束。资源开始字符串：s==========s\r\n资源结束字符串：e==========e\r\n一条完整资源元数据包含多个字段，每一行包含一个字段信息，格式为：字段名称 =字段值\r\n，等号（=）前后各有一个空格。资源元数据所有字段名称请参考《4.1资源元数据字段定义》文件中换行符为：\r\n。资源信息增加、更新、删除使用status字段值标识，新增0，更新1，删除-1完整资源元数据格式如下：具体实例，请参考附件： 文件名格式Txt文件名格式分为增量和全量两种格式，如下：增量文件格式：resource_第三方系统编码_时间.txt，其中时间为资源元数据同步时间，时间格式为yyyymmdd。全量文件格式：resource_第三方系统编码_all.txt例如安徽资源云平台同步数据给教育资源集中展示系统文件名格式：resource_anhuitxt或resource_anhui_all.txt。Restful接口第三方系统调用教育资源集中展示系统开放RestfulAPI接口，实时增量同步资源元数据，第三方系统同步数据之前，需要通过用户名和密码获取oauth2服务请求token。服务调用过程如下图：初次接入教育资源集中展示系统，资源数据量比较大，全量导入资源数据方式采用FTP接口全量导入数据。获取oauth2 服务请求token请求说明url/oauth2/oauth/token?请求参数格式Form表单形式提交Http methodGet,Post是否需要授权否请求参数实例：grant_type=client_credentialsclient_id=***client_secret=****参数说明参数名备注grant_type授权方式，目前开放支持client_credentialsclient_id分配的客户端授权标识client_secret分配的客户端授权密钥操作成功，http相应状态值为：200，返回json数据格式，得到access_token，实例数据如下：{access_token:e0b97df8-8b17-41bc-861f-598b5b3e1dc5,token_typ