DB44/T 2192-2019 大型科学仪器设施共享服务平台数据交换规范

ICS35.240.01

L70

DB44

广东省地方标准

DB44/T2192—2019

大型科学仪器设施共享服务平台

数据交换规范

Dataexchangespecificationofmajorscientificinstrumentand

facilitysharingserviceplatform

2019-10-31发布2020-01-31实施

广东省市场监督管理局发布

DB44/T2192—2019

目次

前言................................................................................II

1范围..............................................................................1

2规范性引用文件....................................................................1

3术语和定义........................................................................1

4总则..............................................................................1

5数据交换概述与模式................................................................2

6数据交换规范内容..................................................................2

7数据传输安全......................................................................7

附录A（资料性附录）服务订单信息表..................................................8

附录B（资料性附录）仪器数据报送的数据集合.........................................11

附录C（资料性附录）服务成效数据集合...............................................22

附录D（资料性附录）管理制度信息表.................................................24

参考文献............................................................................25

I

DB44/T2192—2019

前言

本标准按照GB/T1.1-2009给出的规则起草。

本标准由广东省科技基础条件平台中心提出。

本标准由广东省科学技术厅归口。

本标准起草单位：广东省科技基础条件平台中心、广东省标准化研究院。

本标准主要起草人：方少亮、林珠、李莎、赵晓萌、郑伟鸿、陈树敏、罗亮、周俊杰、谢燕文、崔

晓雷、卢智星、罗俊博、马志平、易露、严家琼。

II

DB44/T2192—2019

大型科学仪器设施共享服务平台数据交换规范

1范围

本技术规范规定了大型科学仪器设施共享服务平台的总则、数据交换概述与模式、数据对接规范内

容、数据传输安全。

本技术规范适用于广东省行政区域内的高等院校、科研院所、其他企事业单位等大型科学仪器设施

所依托管理的法人单位自行建设、与其他单位合建、或委托第三方运行服务机构建设的大型科学仪器设

施共享服务平台（以下简称管理单位在线服务平台）与广东省科技资源共享服务平台（广东省科研设施

与仪器共享服务平台，以下简称省共享平台）进行数据交互。

2规范性引用文件

下列文件对于本文件的应用是必不可少的。凡是注日期的引用文件，仅所注日期的版本适用于本文

件。凡是不注日期的引用文件，其最新版本（包括所有的修改单）适用于本文件。

GB/T2260-2007中华人民共和国行政区划代码

GB/T2659-2000世界各国和地区名称代码

GB/T13745-2009学科分类与代码

DB44/T2193-2019大型科学仪器设施共享服务平台运行规范

3术语和定义

DB44/T2192-2019界定的术语和定义适用于本文件。

4总则

本标准所指接口是指软件开发过程中的软接口，采用WebService技术（一种跨编程语言和跨操作

系统平台的远程调用技术）进行编写，各表中的数据类型参考Java语言进行表述，其他语言请参考执行。

除单条录入、批量导入、数据远程抓取等方式外，管理单位还可以按照本标准的数据标准及格式规范，

通过接口的方式报送数据，接口开发需省共享平台与管理单位在线服务平台协作开发。

本标准所指数据交换规范内容，适用于管理单位已建在线服务平台，并与省共享平台进行数据交换

的情况，按本标准进行用户认证、预约请求、订单查询、订单详情、仪器数据报送、管理制度等数据的

交互，凡属于海关监管的大型科学仪器设施信息在数据交换过程中应填写相应的海关信息，具体见附录

表B.2。对于管理单位无在线服务平台，而采用省共享平台实现在线服务的情况，省共享平台已提供仪

器预约、信息展示、共享制度、服务订单和成效收集等相关服务，无需使用本标准进行数据交互。

本标准所指用户的唯一标识依据用户类型进行区分，当用户类型为省共享平台用户时，采用省共享

平台用户名作为唯一标识；当用户类型为管理单位用户时，采用管理单位在线服务平台的用户标识。本

标准所指管理单位唯一标识是由省共享平台统一分配的管理单位唯一识别编码，一个管理单位下可有多

个用户账号。

1

DB44/T2192—2019

5数据交换概述与模式

5.1提交方式

基于信息系统采用接口推送、手动填报或EXCEL表格导入等方式实现数据交换。主要通过接口推送

的方式，实现多平台互联互通。

5.2提交流程

5.2.1接口推送

管理单位应按照统一标准和规范，建立在线服务平台并提供服务，同时将在线服务平台与省共享平

台对接，对接信息包括用户认证、预约请求、订单查询、订单详情、仪器数据报送、管理制度等数据。

5.2.2手动填报和EXCEL填报

未建设在线服务平台的管理单位，可通过省共享平台进行填报，填报时可以手动录入，也可以EXCEL

表格导入。

5.3提交内容

提交内容应包括：管理制度信息、大型科学仪器设施信息（包括科学仪器中心基本信息、重大科研

基础设施信息、科学仪器服务单元信息、单台（套）科学仪器设备信息)、服务订单和服务成效等。

6数据交换规范内容

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在线服务平台根据登录账号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接口描述

2

DB44/T2192—2019

省共享平台通过该接口将预约请求推送至管理单位在线服务平台，获取相应在线服务平台返回的仪

器预约服务网址见表1和表2。

表1请求消息参数描述

参数名称类型是否允许为空描述

innerIdString否仪器在所属单位内部的唯一编码

resourceTypeString否仪器类型（1科学仪器中心；2重大科研基础设

施；3科学仪器服务单元；4单台套仪器）

insCodeString否管理单位的唯一标识

userNameString否请求用户的信息

表2响应消息参数描述

参数名称类型是否允许为空描述

仪器预约服务网址String否仪器预约服务网址

6.2.2预约请求流程

在线服务平台发布预约仪器服务。

用户在省共享平台点击预约按钮，接口将用户的预约请求送至相应的在线服务平台。

在线服务平台接收到省共享平台推送的预约请求，通过在线平台的预约审核流程对预约请求

进行审核，并根据审核结果返回具体的仪器预约服务网址，预约服务网址中必须包括该仪器的开放日期

和即时安排情况。

省共享平台根据返回的仪器预约服务网址让用户重定向到该地址上，在线服务平台按照6.1

的要求进行用户认证登录后，跳转到仪器预约详细页面。

返回预约网址后用户取消预约将不进行用户认证和预约详情页面跳转。

6.3订单查询接口

6.3.1接口描述

省共享平台通过该接口将用户的查询请求推送至在线服务平台，获取用户在该平台所有订单数据见

表3和表4。

表3请求消息参数描述

参数名称类型是否允许为空描述

userNameString否用户的唯一标识（省共享平台用户名或管理单位在线

服务平台用户标识）

userTypeString否用户类型（省共享平台用户；管理单位在线服务平台

用户）

insCodeString否管理单位的唯一标识（管理单位用户）

3

DB44/T2192—2019

表4响应消息参数描述

参数名称类型是否允许为空描述

用户的订单数据JSON格式化数据否省共享平台的用户在在线服务平台进行仪器预约形

集合成的订单数据的JSON格式化集合，具体内容要求见

附录A中表A.1

6.3.2订单查询流程

在线服务平台发布订单查询服务。订单查询接口可用于省共享平台查询在线服务平台中的订

单信息，也可用于在线服务平台直接将服务订单推送至省共享平台。

用户如需查询在管理单位在线服务平台的预约成功的订单情况，可调用该接口将用户的查询

请求送至相应的在线服务平台。

在线服务平台接收到省共享平台推送的查询请求，通过在线平台的审核流程对查询请求进行

审核，并根据审核结果返回订单数据。在线服务平台返回给省共享平台的该用户的仪器预约的订单数据

应该为实时状态，确保数据真实有效。

用户可以在在线服务平台返回的订单数据中进行订单的详情查看操作。

6.4订单详情接口

6.4.1接口描述

省共享平台通过该接口将订单详情请求推送至在线服务平台，获取相应在线服务平台返回预约仪器

的订单详情数据见表5和表6。

表5请求消息参数描述

参数名称类型是否允许为空描述

orderIdString否订单号，用户预约仪器的订单唯一标识

userNameString否用户的唯一标识（省共享平台用户名或管理单位在线服务平台

用户标识）

userTypeString否用户类型（省共享平台用户；管理单位在线服务平台用户）

innerIdString否仪器在所属单位内部的唯一编码

resourceTypeString否仪器类型（科学仪器中心；重大科研基础设施；科学仪器服务

单元；单台套科学仪器设备）

insCodeString否管理单位的唯一标识

表6响应消息参数描述

参数名称类型是否允许为空描述

订单详细内容数据JSON格式化数否JSON格式化的仪器订单详细内容，具体内容字

集合据段要求见附录A中表A.2

6.4.2订单详情流程

在线服务平台发布订单详情页面查看服务。

用户点击订单查询中的查看详情按钮，接口将用户的订单详情请求送至相应的在线服务平台。

4

DB44/T2192—2019

在线服务平台接收到省共享平台推送的详情查看请求，通过在线平台的审核流程对请求进行

审核，并根据审核结果返回具体仪器预约成功的订单详情数据。在线服务平台需参照附录A中表A.2

的规范将仪器订单详情数据返回给省共享平台。

6.5仪器数据报送接口

6.5.1接口描述

管理单位在线服务平台上报科学仪器中心、重大科研基础设施、科学仪器服务单元、单台套科学仪

器设备数据的接口见表7和表8。

表7请求消息参数描述

参数名称类型是否允许为空描述

insCodeString否管理单位的唯一标识

instruTypeInt否填报数据类型（科学仪器中心；重大科研基础设

施；科学仪器服务单元；单台套科学仪器设备）

仪器数据集合JSON格式化数否JSON格式化的仪器数据报送集合，详细内容见附

据录B中表B.1至B.6

表8响应消息参数描述

参数名称类型是否允许为空描述

codeString否状态码

successInstrusString是上报成功的仪器内部编码集合

successNumString是上报成功的仪器的数量

invalidInstrusString是因填写信息错误导致失败的仪器内部编码

invalidNumString是因填写信息错误导致失败的仪器数量

invalidMessageString是因填写信息错误致失败的信息返回

repeatedNstrusString是因重复上报导致失败的仪器内部编码集合

repeatedNumString是因重复上报导致失败的仪器数量

repeatedMessageString是因重复上报导致失败的信息返回

6.5.2上报流程

该信息可以是省共享平台发布报送通知后推送，也可以是在线服务平台新增仪器后主动推送。

在线服务平台通过该接口推送四大类仪器数据至省共享平台。在线服务平台通过接口报送的

数据格式参照附录B中仪器数据报送的数据集合。

省共享平台验证单位唯一标识和仪器类别的正确性，验证通过获取仪器数据，并返回相应响

应参数。

省共享平台对上报的仪器数据进行验证，验证通过进行数据库存储，已报过的数据则进行更

新，并返回相应响应参数。

6.6服务成效接口

6.6.1接口描述

管理在线服务平台将服务成效的数据上报到省共享平台的接口见表9和表10。

5

DB44/T2192—2019

表9请求消息参数描述

参数名称类型是否为空描述

insCodeString否管理单位的唯一标识

服务成效数据集合JSON格式化数据否详细内容要求见附录C表C.1服务成效报送

的数据集合

表10响应消息参数描述

参数名称类型是否为空描述

codeString否状态码

successSerEffectString是上报成功的服务成效内部编码集合

successNumString是上报成功的服务成效的数量

invalidSerEffectString是因填写信息错误导致失败的服务成效内部编码

invalidNumString是因填写信息错误导致失败的服务成效数量

invalidMessageString是因填写信息错误导致失败的信息返回

repeatedSerEffectString是因重复上报导致失败的服务成效内部编码集合

repeatedNumString是因重复上报导致失败的服务成效数量

repeatedMessageString是因重复上报导致失败的信息返回

6.6.2服务成效流程

该信息可以是省共享平台发布报送通知后推送，也可以是在线服务平台新增服务成效后推送。

在线服务平台调用该接口将单位的服务成效数据推送至省共享平台。在线服务平台通过该接

口报送的服务成效数据参照附录C中的服务成效接口的示例。

省共享平台首先验证单位唯一标识的正确性，通过则获取服务成效数据，验证失败则返回相

应的状态码。

省共享平台将上报的服务成效数据进行验证，通过则保存到数据库中，并返回相应的响应参

数。

6.7管理制度接口

6.7.1接口描述

管理单位在线服务平台上报本单位管理制度调用的接口见表11和表12。

表11请求消息参数描述

参数名称类型是否为空描述

insCodeString否管理单位的唯一标识

管理制度集合JSON格式化数据否JSON格式化的管理制度集合，详细内容要求

见附录D中表D.1

6

DB44/T2192—2019

表12响应消息参数描述

参数名称类型是否为空描述

codeString否状态码

successRegString是上报成功的管理制度内部编码集合

successNumString是上报成功的管理制度的数量

invalidRegString是因填写信息错误导致失败的管理制度内部编码

invalidNumString是因填写信息错误导致失败的管理制度数量

invalidMessageString是因填写信息错误导致失败的信息返回

repeatedRegString是因重复上报导致失败的管理制度内部编码集合

repeatedNumString是因重复上报导致失败的管理制度数量

repeatedMessageString是因重复上报导致失败的信息返回

6.7.2管理制度流程

该信息可以是省共享平台发布报送通知后推送，也可以是在线服务平台新增管理制度后主动

推送。本接口推送的文件格式使用PDF。

在线服务平台通过该接口推送管理制度至省共享平台。

省共享平台验证单位唯一标识和仪器类别的正确性，验证通过则获取管理制度数据，否则返

回响应状态码。附录D中表D.1的regCode与请求参数中的insCode这两个字段同时确定唯一一条管理

制度。必须将上面这三个字段都赋上正确的参数，避免与其他制度冲突。多次提交相同的管理制度，只

保存最后一次提交的数据。

省共享平台对上报的管理制度数据进行验证，验证通过则进行数据库存储，若数据已报过，

则进行数据更新，并返回响应状态码。

7数据传输安全

在线服务平台与省共享平台之间的数据交换接口采用三方面的数据安全策略，具体要求如下：

——该省共享平台WebService接口采用Https协议进行访问；

——仪器的预约和用户跨平台登录采用oauth2.0接口，可以提升用户数据的安全性，防止非授权

单位平台获取用户的信息；

——仪器数据推送时，采用管理单位的唯一标识insCode进行验证。

7

DB44/T2192—2019

AA

附录A

（资料性附录）

服务订单信息表

表A.1规定了标准中所提及的服务订单的主要内容。表A.2规定了标准中所提及的服务订单详情的主

要内容。

表A.1服务订单信息表

字段名称字段中文名称类型长度描述

orderId订单IDVARCHAR255订单ID

demandName需方名称VARCHAR255需方名称

supplyName供方名称VARCHAR32供方名称（服务订单中为单位名称）

resourceName仪器名称VARCHAR255科研设施与仪器规范的中文全称

resourceCode所在单位仪器编号VARCHAR255管理单位资产管理部门赋予该仪器设备唯一的

资产编号

serviceCount服务金额VARCHAR255实际服务的总额，以元为单位

serviceTime实际服务时间VARCHAR255科研设施与仪器向用户实际提供服务的日期或

时间段

serviceCon实际服务内容VARCHAR255科研设施与仪器向用户实际提供的服务项目，如

样品测试、分析检测等

serviceType服务方式CHAR1服务方式（1占用共享：即需方自行操作；2技

术共享：即在供方的技术指导下，需方有限度地

自主操作；3委托共享：供方代为操作，只需提

交结果；4远程共享；5其他）（可多选）

serviceAmount服务量VARCHAR255根据订单，科研设施与仪器所提供的服务量，根

据仪器类型和服务方式的不同，可按所占用的时

长或次数（包含必要开机准备时间、测试时间和

必须的后处理时间，不包括空载运行的时间，计

量单位为小时）、样品测试数量、分析检测数量、

技术指导次数等该领域统计方法计算。

projectName支撑课题VARCHAR255支撑课题（没有则填写无）

countFrom经费来源VARCHAR255经费来源

subjectOne课题主要学科领域VARCHAR255课题主要学科领域（按GB/T13745-2009返回，

最多四个，返回到三级学科）

subjectCon课题研究内容VARCHAR512课题研究内容

applyPerson申请人姓名VARCHAR255申请人姓名

applyTel申请人电话VARCHAR255申请人电话

applyEmail申请人邮箱VARCHAR255申请人邮箱

applyUnit申请人单位VARCHAR255申请人单位

8

DB44/T2192—2019

表A.1服务订单信息表（续）

字段名称字段中文名称类型长度描述

evaluateUnit用户评价等级CHAR1用户评价等级（1非常满意；2基本满意；3一般；4

不满意；5极差)（单选）。

evaluateDesc用户评价VARCHAR512用户对本次服务的评价，具体的意见和建议

localStatus订单状态VARCHAR1订单状态（1等待提供方响应；2提供服务中；3服

务完成；4服务中止）

userInsCode用户在管理单位VARCHAR64用户在管理单位在线服务平台中的唯一标识

在线服务平台中

的唯一标识

innerId仪器在所属单位VARCHAR64仪器在所属单位内部的唯一编码

内部的唯一编码

resourceType仪器类型，包括科VARCHAR1仪器类型（1科学仪器中心；2重大科研基础设施；

学仪器中心、重大3科学仪器服务单元；4单台套科学仪器设备）

科研基础设施、科

学仪器服务单元、

单台套科学仪器

设备

表A.2服务订单信息详情表

字段名称字段中文名称类型长度描述

orderId订单IDVARCHAR256订单ID

resourceName资源名称（仪器名称）VARCHAR255资源名称（仪器名称）

innerId仪器所属单位内部编码VARCHAR256仪器所属单位内部编码

resourceOrganname资源所属机构名称VARCHAR256资源所属机构名称

resourceUserid资源提供用户IDVARCHAR64资源提供用户ID

资源类型（1科学仪器中心；2重大科研基础

resourceType资源类型VARCHAR32设施；3科学仪器服务单元；4单台套仪器；5

其他）

price单价NUMBER20单价，单位为元，保留两位小数

serviceAmount服务量VARCHAR255服务量

starDate开始日期TIMESTAMP9订单开始日期,格式为yyyy/MM/ddHH:mm:ss

endDate订单终止日期TIMESTAMP9订单终止日期,格式为yyyy/MM/ddHH:mm:ss

商品总价（单价X数量），单位为元，保留两

totalPrice商品总价（单价X数量）NUMBER(20,2)

位小数

评价状态（1双方已评；2使用方已评；3提

evaluationFlag评价状态VARCHAR2

供方已评；4双方未评）

serviceCycle服务周期NUMBER10服务周期

resourceUse资源用途VARCHAR10资源用途（1科学研究；2技术开发；3其他）

9

DB44/T2192—2019

表A.2服务订单信息详情表（续）

字段名称字段中文名称类型长度描述

实际服务内容（实际提供