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

PAGE \* MERGEFORMAT PAGE \* MERGEFORMAT 1 国家教育资源智能导航系统 第三方系统资源信息接入协议 科大讯飞信息科技股份有限公司 2014年05月 第 PAGE 2页，共 NUMPAGES 16页 版本记录 版本号 时间 记录人 变更原因 变更描述 V1 2014/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 method Get,Post 是否需要授权 否 请求参数实例： grant_type=client_credentialsclient_id=***client_secret=**** 参数说明 参数名 备注 grant_type 授权方式，目前开放支持client_credentials client_id 分配的客户端授权标识 client_secret 分配的客户端授权密钥 操作成功，http相应状态值为：200，返回json数据格式，得到acces