DB44∕T 2192-2019 大型科学仪器设施共享服务平台数据交换规范(广东省).pdf
《DB44∕T 2192-2019 大型科学仪器设施共享服务平台数据交换规范(广东省).pdf》由会员分享,可在线阅读,更多相关《DB44∕T 2192-2019 大型科学仪器设施共享服务平台数据交换规范(广东省).pdf(30页珍藏版)》请在咨信网上搜索。
1、ICS 35.240.01 L 70 DB44 广东省地方标准 DB44/T 21922019 大型科学仪器设施共享服务平台 数据交换规范 Data exchange specification of major scientific instrument and facility sharing service platform 2019 - 10 - 31 发布 2020 - 01 - 31 实施 广东省市场监督管理局 发 布 DB44/T 21922019 I 目 次 前言 . II1 范围 . . 1 2 规范性引用文件 . . 1 3 术语和定义 . . 1 4 总则 . . 1 5
2、 数据交换概述与模式 . 2 6 数据交换规范内容 . . 2 7 数据传输安全 . . 7 附录A(资料性附录) 服务订单信息表 . . 8 附录B(资料性附录) 仪器数据报送的数据集合 . 11附录C(资料性附录) 服务成效数据集合 . 22附录D(资料性附录) 管理制度信息表 . 24参考文献 . 25 DB44/T 21922019 II 前 言 本标准按照GB/T 1.1-2009给出的规则起草。 本标准由广东省科技基础条件平台中心提出。 本标准由广东省科学技术厅归口。 本标准起草单位:广东省科技基础条件平台中心、广东省标准化研究院。 本标准主要起草人:方少亮、林珠、李莎、赵晓萌、郑
3、伟鸿、陈树敏、罗亮、周俊杰、谢燕文、崔晓雷、卢智星、罗俊博、马志平、易露、严家琼。 DB44/T 21922019 1 大型科学仪器设施共享服务平台数据交换规范 1 范围 本技术规范规定了大型科学仪器设施共享服务平台的总则、 数据交换概述与模式、 数据对接规范内容、数据传输安全。 本技术规范适用于广东省行政区域内的高等院校、 科研院所、 其他企事业单位等大型科学仪器设施所依托管理的法人单位自行建设、 与其他单位合建、 或委托第三方运行服务机构建设的大型科学仪器设施共享服务平台(以下简称管理单位在线服务平台)与广东省科技资源共享服务平台(广东省科研设施与仪器共享服务平台,以下简称省共享平台)进行
4、数据交互。 2 规范性引用文件 下列文件对于本文件的应用是必不可少的。 凡是注日期的引用文件, 仅所注日期的版本适用于本文件。凡是不注日期的引用文件,其最新版本(包括所有的修改单)适用于本文件。 GB/T 2260-2007 中华人民共和国行政区划代码 GB/T 2659-2000 世界各国和地区名称代码 GB/T 13745-2009 学科分类与代码 DB44/T 2193-2019 大型科学仪器设施共享服务平台运行规范 3 术语和定义 DB44/T 2192-2019界定的术语和定义适用于本文件。 4 总则 本标准所指接口是指软件开发过程中的软接口,采用Web Service技术(一种跨编
5、程语言和跨操作系统平台的远程调用技术) 进行编写, 各表中的数据类型参考Java语言进行表述, 其他语言请参考执行。除单条录入、批量导入、数据远程抓取等方式外,管理单位还可以按照本标准的数据标准及格式规范,通过接口的方式报送数据,接口开发需省共享平台与管理单位在线服务平台协作开发。 本标准所指数据交换规范内容, 适用于管理单位已建在线服务平台, 并与省共享平台进行数据交换的情况,按本标准进行用户认证、预约请求、订单查询、订单详情、仪器数据报送、管理制度等数据的交互, 凡属于海关监管的大型科学仪器设施信息在数据交换过程中应填写相应的海关信息, 具体见附录表B.2。对于管理单位无在线服务平台,而采
6、用省共享平台实现在线服务的情况,省共享平台已提供仪器预约、信息展示、共享制度、服务订单和成效收集等相关服务,无需使用本标准进行数据交互。 本标准所指用户的唯一标识依据用户类型进行区分, 当用户类型为省共享平台用户时, 采用省共享平台用户名作为唯一标识;当用户类型为管理单位用户时,采用管理单位在线服务平台的用户标识。本标准所指管理单位唯一标识是由省共享平台统一分配的管理单位唯一识别编码, 一个管理单位下可有多个用户账号。 DB44/T 21922019 2 5 数据交换概述与模式 5.1 提交方式 基于信息系统采用接口推送、手动填报或EXCEL表格导入等方式实现数据交换。主要通过接口推送的方式,
7、实现多平台互联互通。 5.2 提交流程 5.2.1 接口推送 管理单位应按照统一标准和规范, 建立在线服务平台并提供服务, 同时将在线服务平台与省共享平台对接,对接信息包括用户认证、预约请求、订单查询、订单详情、仪器数据报送、管理制度等数据。 5.2.2 手动填报和 EXCEL 填报 未建设在线服务平台的管理单位, 可通过省共享平台进行填报, 填报时可以手动录入, 也可以EXCEL表格导入。 5.3 提交内容 提交内容应包括:管理制度信息、大型科学仪器设施信息(包括科学仪器中心基本信息、重大科研基础设施信息、科学仪器服务单元信息、单台(套)科学仪器设备信息)、服务订单和服务成效等。 6 数据交
8、换规范内容 6.1 用户认证接口 6.1.1 用户在省共享平台登录账号,登录后才有预约的权限。 6.1.2 用户发起“预约仪器”请求,在线服务平台将预约服务网址重定向到省共享平台的 authorize接口,省共享平台返回授权码(code)到在线服务平台注册的回调地址(redirect_url),访问该仪器的预约服务网址。 6.1.3 在线服务平台检查用户在在线服务平台的登录状态。若是该用户已登录状态,则直接转到仪器预约页面;若处于未登录状态,则进行步骤 6.1.4。 6.1.4 在线服务平台通过 oauth2.0 协议从省共享平台取得当前账号 U 的信息。 6.1.5 在线服务平台根据登录账号
9、 U 的信息, 在数据库(比如一个数据库表, 维护省共享平台账号和在线服务平台账号的绑定关系)查找是否有和省共享平台账号 U 绑定的在线服务平台账号,如果找到了绑定账号进行步骤 6.1.7,如果没找到绑定账号,进行步骤 6.1.6。 6.1.6 用户可能有在线服务平台账号但是还没绑定,也可能没有在线服务平台账号,此时可跳转至用户注册页面或账号绑定页面进行注册或绑定。 6.1.7 在线服务平台找到平台中登录账号 U 对应的绑定账号,后台则自动登录该账号。 6.1.8 返回用户最初访问的仪器预约页面。 6.1.9 用户长时间未操作,应注销用户登录。 6.2 预约请求接口 6.2.1 接口描述 DB
10、44/T 21922019 3 省共享平台通过该接口将预约请求推送至管理单位在线服务平台, 获取相应在线服务平台返回的仪器预约服务网址见表1和表2。 表1 请求消息参数描述 参数名称 类型 是否允许为空 描述 innerId String 否 仪器在所属单位内部的唯一编码 resourceType String 否 仪器类型(1 科学仪器中心;2 重大科研基础设施;3 科学仪器服务单元;4 单台套仪器) insCode String 否 管理单位的唯一标识 userName String 否 请求用户的信息 表2 响应消息参数描述 参数名称 类型 是否允许为空 描述 仪器预约服务网址 Stri
11、ng 否 仪器预约服务网址 6.2.2 预约请求流程 6.2.2.1 在线服务平台发布预约仪器服务。 6.2.2.2 用户在省共享平台点击预约按钮,接口将用户的预约请求送至相应的在线服务平台。 6.2.2.3 在线服务平台接收到省共享平台推送的预约请求,通过在线平台的预约审核流程对预约请求进行审核, 并根据审核结果返回具体的仪器预约服务网址, 预约服务网址中必须包括该仪器的开放日期和即时安排情况。 6.2.2.4 省共享平台根据返回的仪器预约服务网址让用户重定向到该地址上,在线服务平台按照 6.1的要求进行用户认证登录后,跳转到仪器预约详细页面。 6.2.2.5 返回预约网址后用户取消预约将不
12、进行用户认证和预约详情页面跳转。 6.3 订单查询接口 6.3.1 接口描述 省共享平台通过该接口将用户的查询请求推送至在线服务平台, 获取用户在该平台所有订单数据见表3和表4。 表3 请求消息参数描述 参数名称 类型 是否允许为空 描述 userName String 否 用户的唯一标识(省共享平台用户名或管理单位在线服务平台用户标识) userType String 否 用户类型(省共享平台用户;管理单位在线服务平台用户) insCode String 否 管理单位的唯一标识(管理单位用户) DB44/T 21922019 4 表4 响应消息参数描述 参数名称 类型 是否允许为空 描述 用
13、户的订单数据集合 JSON 格式化数据 否 省共享平台的用户在在线服务平台进行仪器预约形成的订单数据的 JSON 格式化集合,具体内容要求见附录 A 中表 A.1 6.3.2 订单查询流程 6.3.2.1 在线服务平台发布订单查询服务。订单查询接口可用于省共享平台查询在线服务平台中的订单信息,也可用于在线服务平台直接将服务订单推送至省共享平台。 6.3.2.2 用户如需查询在管理单位在线服务平台的预约成功的订单情况,可调用该接口将用户的查询请求送至相应的在线服务平台。 6.3.2.3 在线服务平台接收到省共享平台推送的查询请求,通过在线平台的审核流程对查询请求进行审核, 并根据审核结果返回订单
14、数据。 在线服务平台返回给省共享平台的该用户的仪器预约的订单数据应该为实时状态,确保数据真实有效。 6.3.2.4 用户可以在在线服务平台返回的订单数据中进行订单的详情查看操作。 6.4 订单详情接口 6.4.1 接口描述 省共享平台通过该接口将订单详情请求推送至在线服务平台, 获取相应在线服务平台返回预约仪器的订单详情数据见表5和表6。 表5 请求消息参数描述 参数名称 类型 是否允许为空 描述 orderId String 否 订单号,用户预约仪器的订单唯一标识 userName String 否 用户的唯一标识 (省共享平台用户名或管理单位在线服务平台用户标识) userType Str
15、ing 否 用户类型(省共享平台用户;管理单位在线服务平台用户) innerId String 否 仪器在所属单位内部的唯一编码 resourceType String 否 仪器类型(科学仪器中心;重大科研基础设施;科学仪器服务单元;单台套科学仪器设备) insCode String 否 管理单位的唯一标识 表6 响应消息参数描述 6.4.2 订单详情流程 6.4.2.1 在线服务平台发布订单详情页面查看服务。 6.4.2.2 用户点击订单查询中的查看详情按钮, 接口将用户的订单详情请求送至相应的在线服务平台。 参数名称 类型 是否允许为空 描述 订单详细内容数据集合 JSON 格式化数据 否
16、 JSON 格式化的仪器订单详细内容,具体内容字段要求见附录 A 中表 A.2 DB44/T 21922019 5 6.4.2.3 在线服务平台接收到省共享平台推送的详情查看请求,通过在线平台的审核流程对请求进行审核,并根据审核结果返回具体仪器预约成功的订单详情数据。在线服务平台需参照附录 A 中表 A.2的规范将仪器订单详情数据返回给省共享平台。 6.5 仪器数据报送接口 6.5.1 接口描述 管理单位在线服务平台上报科学仪器中心、重大科研基础设施、科学仪器服务单元、单台套科学仪器设备数据的接口见表7和表8。 表7 请求消息参数描述 参数名称 类型 是否允许为空 描述 insCode Str
17、ing 否 管理单位的唯一标识 instruType Int 否 填报数据类型(科学仪器中心;重大科研基础设施;科学仪器服务单元;单台套科学仪器设备) 仪器数据集合 JSON 格式化数据 否 JSON 格式化的仪器数据报送集合,详细内容见附录 B 中表 B.1 至 B.6 表8 响应消息参数描述 参数名称 类型 是否允许为空 描述 code String 否 状态码 successInstrus String 是 上报成功的仪器内部编码集合 successNum String 是 上报成功的仪器的数量 invalidInstrus String 是 因填写信息错误导致失败的仪器内部编码 inv
18、alidNum String 是 因填写信息错误导致失败的仪器数量 invalidMessage String 是 因填写信息错误致失败的信息返回 repeatedNstrus String 是 因重复上报导致失败的仪器内部编码集合 repeatedNum String 是 因重复上报导致失败的仪器数量 repeatedMessage String 是 因重复上报导致失败的信息返回 6.5.2 上报流程 6.5.2.1 该信息可以是省共享平台发布报送通知后推送, 也可以是在线服务平台新增仪器后主动推送。 6.5.2.2 在线服务平台通过该接口推送四大类仪器数据至省共享平台。在线服务平台通过接口
19、报送的数据格式参照附录 B 中仪器数据报送的数据集合。 6.5.2.3 省共享平台验证单位唯一标识和仪器类别的正确性,验证通过获取仪器数据,并返回相应响应参数。 6.5.2.4 省共享平台对上报的仪器数据进行验证,验证通过进行数据库存储,已报过的数据则进行更新,并返回相应响应参数。 6.6 服务成效接口 6.6.1 接口描述 管理在线服务平台将服务成效的数据上报到省共享平台的接口见表9和表10。 DB44/T 21922019 6 表9 请求消息参数描述 参数名称 类型 是否为空 描述 insCode String 否 管理单位的唯一标识 服务成效数据集合 JSON 格式化数据 否 详细内容要
20、求见附录 C 表 C.1 服务成效报送的数据集合 表10 响应消息参数描述 参数名称 类型 是否为空 描述 code String 否 状态码 successSerEffect String 是 上报成功的服务成效内部编码集合 successNum String 是 上报成功的服务成效的数量 invalidSerEffect String 是 因填写信息错误导致失败的服务成效内部编码 invalidNum String 是 因填写信息错误导致失败的服务成效数量 invalidMessage String 是 因填写信息错误导致失败的信息返回 repeatedSerEffect String 是
21、 因重复上报导致失败的服务成效内部编码集合 repeatedNum String 是 因重复上报导致失败的服务成效数量 repeatedMessage String 是 因重复上报导致失败的信息返回 6.6.2 服务成效流程 6.6.2.1 该信息可以是省共享平台发布报送通知后推送, 也可以是在线服务平台新增服务成效后推送。 6.6.2.2 在线服务平台调用该接口将单位的服务成效数据推送至省共享平台。在线服务平台通过该接口报送的服务成效数据参照附录 C 中的服务成效接口的示例。 6.6.2.3 省共享平台首先验证单位唯一标识的正确性,通过则获取服务成效数据,验证失败则返回相应的状态码。 6.6
22、.2.4 省共享平台将上报的服务成效数据进行验证,通过则保存到数据库中,并返回相应的响应参数。 6.7 管理制度接口 6.7.1 接口描述 管理单位在线服务平台上报本单位管理制度调用的接口见表11和表12。 表11 请求消息参数描述 参数名称 类型 是否为空 描述 insCode String 否 管理单位的唯一标识 管理制度集合 JSON 格式化数据 否 JSON 格式化的管理制度集合,详细内容要求见附录 D 中表 D.1 DB44/T 21922019 7 表12 响应消息参数描述 参数名称 类型 是否为空 描述 code String 否 状态码 successReg String 是
23、上报成功的管理制度内部编码集合 successNum String 是 上报成功的管理制度的数量 invalidReg String 是 因填写信息错误导致失败的管理制度内部编码 invalidNum String 是 因填写信息错误导致失败的管理制度数量 invalidMessage String 是 因填写信息错误导致失败的信息返回 repeatedReg String 是 因重复上报导致失败的管理制度内部编码集合 repeatedNum String 是 因重复上报导致失败的管理制度数量 repeatedMessage String 是 因重复上报导致失败的信息返回 6.7.2 管理制度
24、流程 6.7.2.1 该信息可以是省共享平台发布报送通知后推送,也可以是在线服务平台新增管理制度后主动推送。本接口推送的文件格式使用 PDF。 6.7.2.2 在线服务平台通过该接口推送管理制度至省共享平台。 6.7.2.3 省共享平台验证单位唯一标识和仪器类别的正确性,验证通过则获取管理制度数据,否则返回响应状态码。 附录 D 中表 D.1 的 regCode 与请求参数中的 insCode 这两个字段同时确定唯一一条管理制度。必须将上面这三个字段都赋上正确的参数,避免与其他制度冲突。多次提交相同的管理制度,只保存最后一次提交的数据。 6.7.2.4 省共享平台对上报的管理制度数据进行验证,
25、验证通过则进行数据库存储,若数据已报过,则进行数据更新,并返回响应状态码。 7 数据传输安全 在线服务平台与省共享平台之间的数据交换接口采用三方面的数据安全策略,具体要求如下: 该省共享平台 Web Service 接口采用 Https 协议进行访问; 仪器的预约和用户跨平台登录采用 oauth2.0 接口,可以提升用户数据的安全性,防止非授权单位平台获取用户的信息; 仪器数据推送时,采用管理单位的唯一标识 insCode 进行验证。 DB44/T 21922019 8 A A 附 录 A (资料性附录) 服务订单信息表 表A.1规定了标准中所提及的服务订单的主要内容。 表A.2规定了标准中所
- 配套讲稿:
如PPT文件的首页显示word图标,表示该PPT已包含配套word讲稿。双击word图标可打开word文档。
- 特殊限制:
部分文档作品中含有的国旗、国徽等图片,仅作为作品整体效果示例展示,禁止商用。设计者仅对作品中独创性部分享有著作权。
- 关 键 词:
- DB44T 2192-2019 大型科学仪器设施共享服务平台数据交换规范广东省 DB44 2192 2019 大型 科学仪器 设施 共享 服务 平台 数据 交换 规范 广东省
1、咨信平台为文档C2C交易模式,即用户上传的文档直接被用户下载,收益归上传人(含作者)所有;本站仅是提供信息存储空间和展示预览,仅对用户上传内容的表现方式做保护处理,对上载内容不做任何修改或编辑。所展示的作品文档包括内容和图片全部来源于网络用户和作者上传投稿,我们不确定上传用户享有完全著作权,根据《信息网络传播权保护条例》,如果侵犯了您的版权、权益或隐私,请联系我们,核实后会尽快下架及时删除,并可随时和客服了解处理情况,尊重保护知识产权我们共同努力。
2、文档的总页数、文档格式和文档大小以系统显示为准(内容中显示的页数不一定正确),网站客服只以系统显示的页数、文件格式、文档大小作为仲裁依据,平台无法对文档的真实性、完整性、权威性、准确性、专业性及其观点立场做任何保证或承诺,下载前须认真查看,确认无误后再购买,务必慎重购买;若有违法违纪将进行移交司法处理,若涉侵权平台将进行基本处罚并下架。
3、本站所有内容均由用户上传,付费前请自行鉴别,如您付费,意味着您已接受本站规则且自行承担风险,本站不进行额外附加服务,虚拟产品一经售出概不退款(未进行购买下载可退充值款),文档一经付费(服务费)、不意味着购买了该文档的版权,仅供个人/单位学习、研究之用,不得用于商业用途,未经授权,严禁复制、发行、汇编、翻译或者网络传播等,侵权必究。
4、如你看到网页展示的文档有www.zixin.com.cn水印,是因预览和防盗链等技术需要对页面进行转换压缩成图而已,我们并不对上传的文档进行任何编辑或修改,文档下载后都不会有水印标识(原文档上传前个别存留的除外),下载后原文更清晰;试题试卷类文档,如果标题没有明确说明有答案则都视为没有答案,请知晓;PPT和DOC文档可被视为“模板”,允许上传人保留章节、目录结构的情况下删减部份的内容;PDF文档不管是原文档转换或图片扫描而得,本站不作要求视为允许,下载前自行私信或留言给上传者【曲****】。
5、本文档所展示的图片、画像、字体、音乐的版权可能需版权方额外授权,请谨慎使用;网站提供的党政主题相关内容(国旗、国徽、党徽--等)目的在于配合国家政策宣传,仅限个人学习分享使用,禁止用于任何广告和商用目的。
6、文档遇到问题,请及时私信或留言给本站上传会员【曲****】,需本站解决可联系【 微信客服】、【 QQ客服】,若有其他问题请点击或扫码反馈【 服务填表】;文档侵犯商业秘密、侵犯著作权、侵犯人身权等,请点击“【 版权申诉】”(推荐),意见反馈和侵权处理邮箱:1219186828@qq.com;也可以拔打客服电话:4008-655-100;投诉/维权电话:4009-655-100。