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 目 次 前言 . II 1 范围. . 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 范围 本技术规范规定了大型科学仪器设施共享服务平台的总则、数据交换概述与模式、数据对接规范内 容、数据传输安全。 本技术规范适用于广东省行政区域内的高等院校、科研院所、其他企事业单位等大型科学仪器设施 所依托管理的法人单位自行建设、与其他单位合建、或委托第三方运行服务机构建设的大型科学仪器设 施共享服务平台(以下简称管理单位在线服务平台)与广东省科技资源共享服务平台(广东省科研设施 与仪器共享服务平台,以下简称省共享平台)进行数据交互。 2
4、规范性引用文件 下列文件对于本文件的应用是必不可少的。凡是注日期的引用文件,仅所注日期的版本适用于本文 件。凡是不注日期的引用文件,其最新版本(包括所有的修改单)适用于本文件。 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 数据交换规范内容 6.1 用户
8、认证接口 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 在线服务平台根据登录账号U的信息,在数据库(比如一个数
9、据库表,维护省共享平台账号和在 线服务平台账号的绑定关系)查找是否有和省共享平台账号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 接口描述 DB44/T 21922019 3 省共享平台通
10、过该接口将预约请求推送至管理单位在线服务平台,获取相应在线服务平台返回的仪 器预约服务网址见表1和表2。 表1 请求消息参数描述 参数名称 类型 是否允许为空 描述 innerId String 否 仪器在所属单位内部的唯一编码 resourceType String 否 仪器类型(1科学仪器中心;2重大科研基础设 施;3科学仪器服务单元;4单台套仪器) insCode String 否 管理单位的唯一标识 userName String 否 请求用户的信息 表2 响应消息参数描述 参数名称 类型 是否允许为空 描述 仪器预约服务网址 String 否 仪器预约服务网址 6.2.2 预约请求流
11、程 6.2.2.1 在线服务平台发布预约仪器服务。 6.2.2.2 用户在省共享平台点击预约按钮,接口将用户的预约请求送至相应的在线服务平台。 6.2.2.3 在线服务平台接收到省共享平台推送的预约请求,通过在线平台的预约审核流程对预约请求 进行审核,并根据审核结果返回具体的仪器预约服务网址,预约服务网址中必须包括该仪器的开放日期 和即时安排情况。 6.2.2.4 省共享平台根据返回的仪器预约服务网址让用户重定向到该地址上,在线服务平台按照6.1 的要求进行用户认证登录后,跳转到仪器预约详细页面。 6.2.2.5 返回预约网址后用户取消预约将不进行用户认证和预约详情页面跳转。 6.3 订单查询
12、接口 6.3.1 接口描述 省共享平台通过该接口将用户的查询请求推送至在线服务平台,获取用户在该平台所有订单数据见 表3和表4。 表3 请求消息参数描述 参数名称 类型 是否允许为空 描述 userName String 否 用户的唯一标识(省共享平台用户名或管理单位在线 服务平台用户标识) userType String 否 用户类型(省共享平台用户;管理单位在线服务平台 用户) insCode String 否 管理单位的唯一标识(管理单位用户) DB44/T 21922019 4 表4 响应消息参数描述 参数名称 类型 是否允许为空 描述 用户的订单数据 集合 JSON格式化数据 否 省
13、共享平台的用户在在线服务平台进行仪器预约形 成的订单数据的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 String 否 用户类型(省共享平台用户;管理单位在
15、线服务平台用户) innerId String 否 仪器在所属单位内部的唯一编码 resourceType String 否 仪器类型(科学仪器中心;重大科研基础设施;科学仪器服务 单元;单台套科学仪器设备) insCode String 否 管理单位的唯一标识 表6 响应消息参数描述 6.4.2 订单详情流程 6.4.2.1 在线服务平台发布订单详情页面查看服务。 6.4.2.2 用户点击订单查询中的查看详情按钮,接口将用户的订单详情请求送至相应的在线服务平台。 参数名称 类型 是否允许为空 描述 订单详细内容数据 集合 JSON格式化数 据 否 JSON格式化的仪器订单详细内容,具体内容字
16、 段要求见附录A中表A.2 DB44/T 21922019 5 6.4.2.3 在线服务平台接收到省共享平台推送的详情查看请求,通过在线平台的审核流程对请求进行 审核,并根据审核结果返回具体仪器预约成功的订单详情数据。在线服务平台需参照附录A中表A.2 的规范将仪器订单详情数据返回给省共享平台。 6.5 仪器数据报送接口 6.5.1 接口描述 管理单位在线服务平台上报科学仪器中心、重大科研基础设施、科学仪器服务单元、单台套科学仪 器设备数据的接口见表7和表8。 表7 请求消息参数描述 参数名称 类型 是否允许为空 描述 insCode String 否 管理单位的唯一标识 instruType
17、 Int 否 填报数据类型(科学仪器中心;重大科研基础设 施;科学仪器服务单元;单台套科学仪器设备) 仪器数据集合 JSON格式化数 据 否 JSON格式化的仪器数据报送集合,详细内容见附 录B中表B.1至B.6 表8 响应消息参数描述 参数名称 类型 是否允许为空 描述 code String 否 状态码 successInstrus String 是 上报成功的仪器内部编码集合 successNum String 是 上报成功的仪器的数量 invalidInstrus String 是 因填写信息错误导致失败的仪器内部编码 invalidNum String 是 因填写信息错误导致失败的仪
18、器数量 invalidMessage String 是 因填写信息错误致失败的信息返回 repeatedNstrus String 是 因重复上报导致失败的仪器内部编码集合 repeatedNum String 是 因重复上报导致失败的仪器数量 repeatedMessage String 是 因重复上报导致失败的信息返回 6.5.2 上报流程 6.5.2.1 该信息可以是省共享平台发布报送通知后推送,也可以是在线服务平台新增仪器后主动推送。 6.5.2.2 在线服务平台通过该接口推送四大类仪器数据至省共享平台。在线服务平台通过接口报送的 数据格式参照附录B中仪器数据报送的数据集合。 6.5.
19、2.3 省共享平台验证单位唯一标识和仪器类别的正确性,验证通过获取仪器数据,并返回相应响 应参数。 6.5.2.4 省共享平台对上报的仪器数据进行验证,验证通过进行数据库存储,已报过的数据则进行更 新,并返回相应响应参数。 6.6 服务成效接口 6.6.1 接口描述 管理在线服务平台将服务成效的数据上报到省共享平台的接口见表9和表10。 DB44/T 21922019 6 表9 请求消息参数描述 参数名称 类型 是否为空 描述 insCode String 否 管理单位的唯一标识 服务成效数据集合 JSON格式化数据 否 详细内容要求见附录C表C.1服务成效报送 的数据集合 表10 响应消息参
20、数描述 参数名称 类型 是否为空 描述 code String 否 状态码 successSerEffect String 是 上报成功的服务成效内部编码集合 successNum String 是 上报成功的服务成效的数量 invalidSerEffect String 是 因填写信息错误导致失败的服务成效内部编码 invalidNum String 是 因填写信息错误导致失败的服务成效数量 invalidMessage String 是 因填写信息错误导致失败的信息返回 repeatedSerEffect String 是 因重复上报导致失败的服务成效内部编码集合 repeatedNum
21、String 是 因重复上报导致失败的服务成效数量 repeatedMessage String 是 因重复上报导致失败的信息返回 6.6.2 服务成效流程 6.6.2.1 该信息可以是省共享平台发布报送通知后推送,也可以是在线服务平台新增服务成效后推送。 6.6.2.2 在线服务平台调用该接口将单位的服务成效数据推送至省共享平台。在线服务平台通过该接 口报送的服务成效数据参照附录C中的服务成效接口的示例。 6.6.2.3 省共享平台首先验证单位唯一标识的正确性,通过则获取服务成效数据,验证失败则返回相 应的状态码。 6.6.2.4 省共享平台将上报的服务成效数据进行验证,通过则保存到数据库中
22、,并返回相应的响应参 数。 6.7 管理制度接口 6.7.1 接口描述 管理单位在线服务平台上报本单位管理制度调用的接口见表11和表12。 表11 请求消息参数描述 参数名称 类型 是否为空 描述 insCode String 否 管理单位的唯一标识 管理制度集合 JSON格式化数据 否 JSON格式化的管理制度集合,详细内容要求 见附录D中表D.1 DB44/T 21922019 7 表12 响应消息参数描述 参数名称 类型 是否为空 描述 code String 否 状态码 successReg String 是 上报成功的管理制度内部编码集合 successNum String 是 上报
23、成功的管理制度的数量 invalidReg String 是 因填写信息错误导致失败的管理制度内部编码 invalidNum String 是 因填写信息错误导致失败的管理制度数量 invalidMessage String 是 因填写信息错误导致失败的信息返回 repeatedReg String 是 因重复上报导致失败的管理制度内部编码集合 repeatedNum String 是 因重复上报导致失败的管理制度数量 repeatedMessage String 是 因重复上报导致失败的信息返回 6.7.2 管理制度流程 6.7.2.1 该信息可以是省共享平台发布报送通知后推送,也可以是在线
- 1.请仔细阅读文档,确保文档完整性,对于不预览、不比对内容而直接下载带来的问题本站不予受理。
- 2.下载的文档,不会出现我们的网址水印。
- 3、该文档所得收入(下载+内容+预览)归上传者、原创作者;如果您是本文档原作者,请点此认领!既往收益都归您。
下载文档到电脑,查找使用更方便
5000 积分 0人已下载
下载 | 加入VIP,交流精品资源 |
- 配套讲稿:
如PPT文件的首页显示word图标,表示该PPT已包含配套word讲稿。双击word图标可打开word文档。
- 特殊限制:
部分文档作品中含有的国旗、国徽等图片,仅作为作品整体效果示例展示,禁止商用。设计者仅对作品中独创性部分享有著作权。
- 关 键 词:
- DB44 2192-2019 大型科学仪器设施共享服务平台数据交换规范 2192 2019 大型 科学仪器 设施 共享 服务 平台 数据 交换 规范
