工作台操作手册

项目工作台简介

项目工作台用于对当前项目进行管理。

单项目模式下通过以下方式进行【工作台】操作界面。

访问控制

账号中心

点击右上角的账号名称，进入账号中心，如下图所示：

如果开通了短信服务和邮件服务，可以绑定手机号和邮箱。绑定手机号和邮箱后，可用于找回密码，接收告警通知等。

组织管理

按组织架构可以对用户进行分级管理；可以创建下级组织，指定的组织层级的用户，只允许访问该组织及以下级别的数据。

角色管理

创建角色，可以设置每个角色的操作权限，用户拥有其所属角色的所有权限。角色管理中分别可以从权限和角色两个视角去管理和授权权限，权限视角将列出所有的权限，从权限的角度去决定哪些角色拥有权限；而角色视角，可以根据角色去分配权限。

单击新建角色，开始添加一个角色：

用户管理

用于对登录平台的账号进行管理。多租户模式下，项目级用户只允许访问当前项目。

创建角色

新增账号可以设置用户、姓名、邮箱、手机号码以及该账号所属组织和角色，不同的角色决定了该用户可以使用的功能点。

编辑角色

打开角色编辑窗口，可以修改角色的名称和对这个角色权限进行重新分配，生效以后，角色下辖的账号会自动获得对应的权限。

删除角色

在角色列表中，可以单击角色的删除按钮清理不需要的角色。

日志管理

操作日志

点击【日志管理】【操作日志】菜单，进入操作日志管理，可查看用户操作记录。支持以下检索条件：

按操作日期进行检索；
按操作对象进行检索；
按操作类型类型进行检索；
按操作人姓名进行检索；
按操作人用户名进行检索；

下发记录

用于查询“指令下发操作”相关的所有记录，可根据时间范围、执行对象（设备、点位）进行筛选。

所有指令下发操作都会被记录，包括手动执行、自动执行。

可记录操作终端 IP 地址。

设备互联

设备模型

设备模型用来对业务数据进行集中建模，点击【设备互联】【设备模型】菜单，进入设备模型管理界面，如下图所示：

模型分组

模型分组用于对设备模型进行分组管理，点击【创建模型分组】按钮，创建一个模型分组，如下图所示：

新建模型

点击模型分组上的创建按键，创建一个新的设备模型，如下图所示：

字段说明：

模型标识：模型的标识信息，由英文和数字组成。
模型名称：可输入除空格外的任意字符。
设备模型分组：模型所属的分组。
资产：选择“是”表示可用于设备维护管理。该选项仅在启用了“资产管理模块”时可见。
设备绩效：选择“是”表示可用于设备绩效管理。该选项仅在启用了“设备绩效模块”时可见。
模型描述：对设备模型的说明。

导入导出

点击模型列表中的【导入】【导出】按钮，可以实现批量导入、导出模型基本信息。

注意：导入导出只针对模型基本信息和测点列表，可用于设备模型的快速创建。

基本信息

在模型列表中，点击“编辑”按钮可对模型分组或设备模型的基本信息进行进行修改。

删除模型

在模型列表中，点击“编辑”按钮可删除模型分组或设备模型。

地理信息

通过绑定经纬度对应的测点，可以实现经纬度信息自动更新，用于实时更新设备的位置信息。

注意：地理信息不是必填内容，如果设备没有对应到经纬度的测点，可以不进行设置。

属性信息

用于定义设备模型的静态业务属性。在新建设备时，可根据设备模型定义的属性信息设置相应的业务属性值。

测点信息

用于定义设备模型的测点信息。设备模型的测点信息只作用于启用了点表模板的设备。

指标管理

对设备模型下要进行统计计算的指标进行管理。

支持的指标类型如下：

开关统计：对布尔变量的变化时间进行记录，并统计变化次数。可用于统计“开关变化次数”、“故障次数”等。
抄表统计：对累计量的测点进行统计，记录单位时间内的变化值。支持日、周、月 3 种统计周期。

设备接入

平台支持以下几种方式实现设备接入：

直连接入：可在本地部署时使用，可不依赖物联网网关直接与 PLC、仪表等设备直接进行通讯。
网关接入：可应用于适用于物联网场景，平台部署在云服务器无法直接与设备进行通讯，需要通过 MQTT 物联网网关实现平台与设备的互联互通。
自主接入：在不依赖网关的情况下，实现设备直接跟平台进行通讯，支持 MQTT、CoAP、HTTP 三种协议。

直连接入

设备直连接入需要添加【接入通道】，根据不同的通讯规约，设置相应的通道连接参数。

目前可以支持以下几种通讯规约：

Modbus RTU：串口/以太网/透传
Modbus TCP：以太网通讯
西门子 PLC：以太网通讯，S7-200-Smart，S7-200, S7-300, S7-400, S7-1200, S7-1500
三菱 PLC、基恩士 PLC：以太网通讯 MC 协议
欧姆龙 PLC：以太网通讯 FINS/TCP 协议
AB PLC：以太网通讯 CIP 协议
OPC DA
OPC UA
IEC-60870-104：电气规约
DLT-645-1997：电气规约
DLT-645-2007：电气规约

IMPORTANT

不同通讯规约的接入配置，请参考《数采实施手册》

通道管理

为方便对接入通道进行管理，可以创建通道分组。选中通道分组，可以修改其基本信息。选中通道，可以修改通道基本信息。

通道禁用重启

选中通道后，对通道进行“禁用”和“重启”。

通道“禁用”后，将关闭通道并停止与设备的通讯。

通道“重启”后，将重新扫描点表，并重新与设备建立通讯。

通道导入导出

可以通过Excel表格的方式一次性导入多个通道，单击导入选择相应的通道规则，然后下载Excel模板，根据模板内容录入通道和点表信息，完成Excel文件后再上传文件并导入：

通讯点表

选中通道后，点击“点表”选项卡，进入该通道下的点位管理界面。

点表参数说明：

参数名称	必填	说明
设备标识	是	点位关联的设备
测点标识	是	点位关联的测点
仿真表达式	否	仿真模式下用于生成仿真数据
设备地址	否	设备通讯地址
点位地址	是	虚拟点表达式或点位寄存器地址
数值类型	是	点位的数值类型
存储周期	否	点位数据存储周期
扫描周期	否	采集频率
死区值	否	如果测点输出值变化量未超过死区值，则认为数据未变化
死区时间	否	当测点输出值数据保持不变时，如果超过了死区时间，侧强制更新
计算公式/取反	否	计算公式：用于浮点型或整数型测点，通过设置基值和系数，对采集值进行计算输出测点值。取反：用于布尔型测点，表示是否对采集值进行取反处理。
虚拟点位	否	是否是虚拟点位。

仿真模式

选中通道后，可修改仿真模式选项，如果启用了“仿真模式”，通道将停止与设备进行通讯，不再采集设备数据，改为模拟生成仿真数据。详细使用，请参考《数采实施手册》。

实时数据

选中通道后，点击“实时数据”选项卡，可查看该通道下采集到的的测点实时数据。可修改测点值，实现指令下发。可查看测点历史数据。

实时日志

选中通道后，点击“实时日志”选项卡，可查看当前通道的实时通讯日志、通讯报文。

历史日志

选中通道后，点击“历史日志”选项卡，可按时间范围查询当前通道的历史日志（历史日志默认保存 1 天）。

网关接入

网关是指物联网网关，主要用于云边协助，网关和平台之间采用 MQTT 协议进行通讯（最新版本的协议为 TopLink V3 协议）。

可应用于适用于物联网场景，由于平台部署在云服务器无法直接与设备进行通讯，需要通过物联网网关实现平台与设备的互联互通。

我们将网关分为纳管型和非纳管型。

纳管型网关，是指集成了Edge软件的网关，支持在平台对其进行数采配置，网关应用安装&升级及运行监控等管理；
非纳管型网关，只允许接入网关及其子设备，对网关的资源，配置等管理由第三方软件完成。

在【设备接入】界面，切换到【网关接入】页签，如下图所示：

MQTT 配置

在网关接入前需要先设置 MQTT 连接参数，配置界面位于【平台管理】【MQTT配置】，详细使用方式请参考平台设置。配置界面如下图所示：

网关导入

通过导入 excel 文件，实现批量创建网关。

导入的文件必须是xlsx 且文件大小不超过5MB。

操作步骤：

点击【导入】按键，弹出导入对话框，如下图所示：

如没有模板需要先【下载模板文件】，按照模板填入信息后【点击上传】完成导入，如下图所示：

网关导出

将查询的所有网关信息导出到 excel 文件中。

操作步骤：

按需要查询出网关信息后，点击【导出】按钮，如下图所示：

报文监测

通过网关报文监测，可以实时查看 MQTT 通讯消息内容。

选中相应的网关，点击【更多】【报文】，如下图所示：

子设备管理

如果想对网关下的子设备进行管理，请先选中相应的网关，点击【更多】【设备】，如下图所示：

弹出设备列表，在设备列表中可对网关子设备进行管理：

纳管型网关

纳管型网关是指集成了Edge软件的网关，支持在平台对其进行数采配置，网关应用安装&升级及运行监控等管理。

如果想对纳管型网关进行管理，请先选中相应的网关，点击【查看】按钮，如下图所示：

弹出【网关详情】界面，如下图所示：

主机监控

显示网关的基本信息、CPU 使用情况、内存使用情况、网络带宽占用情况。

数据通道

对网关下的数据采集通道进行管理。

部署

远程方式对网关进行配置，将平台侧设置的通道、点表信息下载到网关。

离线部署

将网关配置信息导出为离线包，可用于在网关边缘侧单独进行离线部署。

上载

将网关的配置内容读取到平台。

自主接入

自主接入适用于，在不依赖网关的情况下，由设备直接跟平台进行通讯，支持 MQTT、CoAP、HTTP 三种协议。

在【设备接入】界面，切换到【自主接入】页签，如下图所示：

在【自主接入】界面，可以对接入的【通道】进行管理，创建【通道】时需要指定相应的接入协议，每个通道下可以关联多个设备。不同的接入协议的实现方式请参考《开发手册》。

注：多个设备可以共用一个自主接入通道。

设备管理

对设备进行管理。

基本属性

点击【创建】按钮，可以创建一个新设备。

名称	说明
设备标识	设备唯一识别信息，每台设备都有固定的识别编码
设备名称
设备编码
设备模型
用户组	如果设置了用户组，则表示只有用户组内成员才可以管理该设备
设备分组
接入方式	接入设备数据的方式
所属网关	当接入方式为“网关”时有效
所属通道	自主接入对应的通道

设备导入导出

除了单个创建设备外，可以选择用Excel文件方式批量导入设备。可以下载导入设备的Excel模板文件，在文件中编辑相应内容，然后上传Excel文件批量创建设备：

设备属性设置

用于设置在设备模板中定义的静态属性。点击设备列表中“操作”按钮，点击【属性】弹出属性配置界面，如下图所示：

设备标签

设备标签可用于按不同的维度对设备进行检索。

点击设备列表中“操作”按钮，点击【标签】弹出设备标签设置窗口。

查看测点数据

点击设备列表中“操作”按钮，点击【数据】弹出测点实时数据窗口，如下图所示：

定时任务

定时任务可用于向多个设备定时下发控制指令。

方案管理

管理定时任务需要先创建一个方案，每个方案下可以添加多个任务。点击【方案列表】的“+”按钮，可以创建一个任务方案，如下图所示：

选中一个“任务方案”点击操作按钮，可弹出操作菜单，对实现任务方案的“编辑”、“启用”、“停用”、“删除”操作。

任务管理

点击【创建】按钮，可以创建一个新的任务。

添加任务时，可以选择以下几触发模式：

单次触发：指定具体的触发时间，触发一次后不再触发。
以分钟为间隔触发：自生效时间开始，每间隔固定的分钟数触发一次，直到时间超过结束时间为止。
以小时为间隔触发：自生效时间开始，每间隔固定的小时数触发一次，直到时间超过结束时间为止。
每天触发：在生效时间到结束时间指定的时间范围内，每天固定时间触发。
每周触发：在生效时间到结束时间指定的时间范围内，每周固定一天的固定时间触发。
每月触发：在生效时间到结束时间指定的时间范围内，每月固定一天的固定时间触发。

上述结束时间（单次触发除外）可以省略，表示触发后永久生效。

注意：对于每月触发模式，如果选择了29、30、31日触发而某月没有29、30、31日时，则此月不会触发。

在列表中点击方案右侧的 设备操作 按钮打开面板，点击面板右上角的加号添加一条设备操作。选择设备、点位，填写输出值后，点击面板右下角的确定按钮保存。

任务启停

任务在创建后默认启动，点击修改按钮，可以停止任务。

停止的任务点击修改可以再次启动。

任务还可以以方案为单位启动和停止。

左侧方案列表中带有绿色圆点的为启用中的方案，右键方案名称，点击右键菜单中的 停用方案 即可停用方案。

停用的方案带有红色圆点，点击右键菜单中的 启用方案 即可再次启用方案。

任务触发需要同时满足以下条件才会触发：

方案状态为启用
任务状态为运行中
满足任务自身触发模式指定的触发条件

当方案被停用时，其下的任务不会触发，但任务的运行状态不会统一改为停止，而是保留现有的设置为了方案再次启用时使用。

控制策略

支持全局控制策略和设备控制策略，通过自动或手动方式实现设备控制参数批量发下，可预定义常用标准指令，例如唤醒、关机、重启、校时、休眠等。

OTA 升级

OTA（Over-the-Air Technology）即空中下载技术，基于无线网络对设备固件、软件或驱动进行更新。通过OTA升级，可以对物联网设备更新功能、修复漏洞、优化性能。

使用限制

使用OTA功能的设备必须使用MQTT协议接入物联网平台，设备可以选择MQTT协议或HTTP协议下载升级包。

升级包的数量、大小、格式和地域限制。
- HTTP协议下载：可以包括一个或多个文件。仅支持.bin、.dav、.tar、.gz、.zip、.gzip、.apk、.tar.gz、.tar.xz、.pack格式的文件。
- MQTT协议下载：仅包含一个文件，且文件大小不超过16 MB。

管理升级包

产品管理

在【设备互联】【OTA升级】页面，左侧显示的是产品列表。

模块管理

OTA模块是同产品下设备的不同可升级模块，例如固件、软件、驱动等。默认（default）模块表示整个设备的固件，支持自定义其他OTA模块。

选中相应的产品后，在模块列表页签，单击添加模块，配置模块信息，单击确认。

参数	说明
所属产品	选择模块所属产品。
模块名称	设置模块名称。模块名称需要在产品下唯一，创建后不可修改。支持英文字母、数字、半角句号（.）、短划线（-）和下划线（_），长度限制为1~64个字符。
模块别名	设置模块别名。支持英文字母、数字、半角句号（.）、短划线（-）和下划线（_），长度限制为4~64个字符。
模块描述	可描述该模块的用途等信息。描述长度不超过100个字符，一个中文计为一个字符。

升级包管理

在OTA升级页面，选中相应的产品，单击升级包列表页签，单击添加升级包。

配置升级包信息，上传升级包文件，单击确认。

参数	描述
升级包类型	整包：您上传的升级包文件是完整的升级包文件，会推送整包升级包给设备进行升级。差分：您上传的升级包文件仅包含新版本升级包与之前版本的差异部分，仅推送差异部分至设备，设备进行差分还原，还原为完整升级包。差分升级可有效减少升级对设备资源的占用，和减少下发升级包的流量消耗。
升级包模块	选择升级包所属OTA模块。您可以单击添加模块，在弹出的对话框中新增一个模块。
升级包版本号	设置该升级包的版本号。版本号支持英文字母、数字、半角句号（.）、短划线（-）和下划线（_），长度限制为1~64个字符。升级包类型选择为整包时，需设置的参数。
待升级版本号	输入或选择待升级设备的OTA模块版本号。下拉列表中，会展示当前产品下所有设备的OTA模块版本号，选择一个待升级的版本。升级包类型选择为差分时，需设置的参数。
签名算法	支持MD5和SHA256算法。
上传升级包	上传升级包文件。最多支持上传20个文件，总文件大小不能超过1,000 MB。文件格式仅支持`.bin`、`.dav`、`.tar`、`.gz`、`.zip`、`.gzip`、`.apk`、`.tar.gz`、`.tar.xz`、`.pack`。上传多个升级包文件时，需注意：文件名称不能重复，单个文件名称长度不能超过32个字符。物联网平台会校验多个文件的签名是否一致，若文件签名一致，则视其为重复的文件。
升级包描述	可描述该升级包的功能等信息。描述长度不超过1024个字符，一个中文计为一个字符。添加升级包成功后，可在升级包详情页面的升级包信息页签，单击编辑，修改升级包描述。

OTA 升级步骤

步骤一：设备上报版本号

设备上报当前版本号。设备需要在首次升级前上报版本号，建议只在系统启动过程中上报一次，不需要周期循环上报。仅支持每次上报一个模块及对应的模块版本，如果需要上报多个模块的版本，请分次上报。上报的Topic和消息格式参见 TopLink-V3 协议说明。

步骤二：推送升级包信息

添加升级包：为产品添加OTA模块和升级包。
- **模块：**由用户自定义，是同产品下设备的不同可升级模块，例如固件、软件、驱动等。默认（default）模块表示整个设备的固件。
- **整包：**完整的升级文件，可以添加单个或多个升级包。
- **差分：**仅包含新版本升级包与之前版本的差异部分，设备需要本地进行差分还原，并还原为完整升级包进行升级。差分升级前，设备必须上报OTA模块版本。
发起升级批次任务：物联网平台向设备下发升级相关信息（升级包URL、版本、大小等）。发起批量升级后，在控制台显示的设备状态是待升级或待确认。当物联网平台接收到设备上报的升级进度时，设备升级正式开始，在控制台显示的设备状态是升级中。

步骤三：设备下载升级包

设备离线时不能接收OTA服务端推送的升级消息，设备再次上线后，OTA服务端验证该设备是否需要升级。如果需要升级，平台再次推送升级消息给设备，否则不推送消息。
- 平台推送升级包信息。平台对设备发起OTA升级请求后，设备通过该 MQTT 收到升级信息。
- 设备主动拉取升级包信息。设备向平台发布 MQTT 消息，平台收到消息并通过 MQTT 推送升级包信息。
- 平台发给设备的HTTP协议、MQTT协议的下载消息格式参见 TopLink-V3 协议文档。
设备使用HTTP协议或MQTT协议下载升级包。
设备上报升级进度。
设备上报最新版本号。设备升级完成后，建议立即重启设备，设备上线后，立即上报新的版本号。设备上线请求和上报版本请求间隔不能超过2秒。

IMPORTANT

如果设备上报的版本与OTA服务要求的版本一致就认为升级成功，反之认为失败，这是平台判断设备升级成功的唯一条件。即使升级进度上报为100%，如果不上报新的版本号，可能因为超过设备升级超时时间导致升级失败。

数据管理

数据开放

在左侧菜单栏中，选择【数据管理】【数据开放】，进入数据开放管理界面。平台提供了两种开放方式，分别是“数据订阅”和“数据导出”。

数据订阅

数据订阅功能用于将【测点实时值】、【告警信息】转发到【消息中间件】，第三方平台可以通过【消息中间件】订阅【测点实时数据】和【告警数据】。

目前支持将数据转发到以下消息中间件：

Kafka
AMQP
Pulsar
MQTT

添加订阅

在【数据开放】页面，切换到【数据订阅】页签，点击【添加订阅】按钮，打开创建对话框。如下图所示：

字段说明

名称	说明
订阅名称
资源类型	每项订阅只能选择一种资源类型包括：测点值和告警信息。
转发目的地	转发的消息中间件类型。
其它字段	用于配置消息中间件的连接参数。

设置订阅资源

添加好订阅后，点击【数据资源】按钮，可对需要订阅的资源内容进行选择。

CAUTION

每项订阅只能选择一种资源类型包括：测点值、告警信息。

消息格式

不同的资源类型转发的消息格式不同

测点值

json

{
  "deviceID": "D01",
  "pointID": "P01",
  "value": 1,
  "quality": 0,
  "timestamp": 1655342160703,
  "gatewayID": "G01"
}

字段说明

名称	类型	说明
gatewayID	string	网关标识
deviceID	string	设备标识
pointID	string	测点标识
value	string\|number\|bool	测点值
quality	number	数据质量
timestamp	number	时间戳毫秒值

告警信息

{
    "id": "cak5i5te97ejrjko7qe0",
    "status": "handled", // unhandled/handled/ignored
    "createdAt": "2022-06-14T17:47:02.461192+08:00",
    "recoveredAt": null,
    "handledAt": "2022-06-14T17:47:09.123729+08:00",
    "handler": "admin",
    "orderCreated": true,
    "title": "告警标题",
    "content": "告警内容",
    "remark": "确认信息备注"
    "ruleTemplateID": "告警规则ID",
    "deviceID": "c",
    "pointID": "TEST",
    "mode": "property",
    "duration": 1,
    "inputValue": "111",
    "compareMode": ">",
    "compareValue": "2",
}

字段说明

名称	类型	说明
id	string	告警记录标识
status	string	告警状态：unhandled/handled/ignored
createdAt	string	告警发生时间，ISO8601 格式
recoveredAt	string	告警解除时间，ISO8601 格式，空表示新产生的告警，不为空表示告警解除或者状态更新。
handledAt	string	确认告警时间
handler	string	告警确认人
remark	string	确认信息备注
orderCreated	boolean	是否创建工单
title	string	告警标题
content	string	告警内容
ruleTemplateID	string	告警规则ID
deviceID	string	设备标识
pointID	string	测点标识
inputValue	string	告警值
duration	number	持续时长（秒）
mode	string	触发方式：point：单测点not_upload：长时间不上传not_change：长时间数据不变化offline：设备离线expression：表达式
compareMode	string	比较方式如下：>>=<<==!=区间内(between)：测点值处于区间外时，触发告警。区间格式：(100, 200), [100,200]区间外(not_between)：测点值处于区间内时，触发告警。数值偏差(diff)：测点值与阈值的差值大于偏差值时，触发告警。
compareValue	string	告警阈值
deadBand	number	死区值
diff	number	偏差值

CAUTION

recoveredAt 为空时表示新告警

转发目的地

Pulsar

转发到Apache Pulsar。

Kafka

转发到Apache Kafka。

AMQP

转发到AMQP 1.0协议的broker。

连接地址示格式为 amqp[s]://<host name of AMQP 1.0 broker>，例如：amqp://192.168.0.24

常用 AMQP Broker：

CAUTION

AMQP 1.0 has no equivalent of AMQP 0-9-1 virtual hosts. A virtual host on the broker may be addressed when opening an AMQP 1.0 connection by setting the hostname field, prefixing with "vhost:". Setting the hostname field to "vhost:/" addresses the default virtual host. If the hostname field does not start with "vhost:" then the default_vhost configuration setting will be consulted.

MQTT

转发到 MQTT 消息中间件。

连接地址格式示例：mqtt://192.168.3.10:1883

数据导出

数据导出功能用于定时将测点数据写入到第三方关系型数据库，目前支持导出以下数据库：

MySQL
SQLServer

创建导出任务

切换到【数据导出】页签，点击【创建】按钮，弹出【添加任务】对话框，如下图所示：

相对时间

数据时间相对于导出启动时间前多久开始，填充数据格式为：中划线（-）+ 数字（1-3位）+ 单位。

单位：

天：d或D；
时：h或H；
分：m或M。

例：

-1h，表示任务启动前 1 小时内的数据。
-1d, 表示任务启动前 1 天内的数据。
-20m, 表示任务启动前 20 分钟内的数据。

数据抽样

数据抽样未启用时，导出原始数据。

数据抽样启用时，每间隔指定的时间段抽取一条数据，需要设置抽样间隔和抽样方法。

抽样方法：

FIRST：抽样间隔内的第一条数据；
LAST：抽样间隔内的最后一条数据；

例如：在小时的原始数据中，设置抽样间隔为 1 分钟，抽样方法为 FIRST ，在执行导出任务时，最多采集出60条数据进行导出。

任务类型

任务类型包括【单次任务】和【定时任务】。

单次任务：在指定的具体时间执行一次导出任务。
定时执行：在指定的时间范围内，周期性地执行任务。

时间类型

时间类型用于定义数据导出的时间范围，支持两种设置方式：

绝对时间，导出固定时间段内的测点数据。
相对时间，每次任务执行时，导出任务运行前一段时间内的测点数据。

【相对时间】需按固定格式填写：

以一个减号-开头
一到三位整数
单位：h、m、d其中之一，分别表示小时、分钟、天

例如：

-1d：每次任务执行时导出向前一天的测点数据
-12h：每次任务执行时导出向前12小时的数据
-30m：每次任务执行时导出向前30分钟的数据

导出目标

导出目标可选择MySQL或SQLServer。

同时需要配置目标数据库的连接参数，包括地址、端口、用户名、密码、数据库名称。

CAUTION

导出到SQLServer时，加密传输的选择：

由于 TLS 1.0 存在安全漏洞，条件允许时，应尽量在服务器段开启 TLS 1.2 支持并设为默认。

微软官方文档

开启 TLS 1.2 对于 SQLServer < 2008 不支持，SQLServer < 2016 需要安装安全补丁。

如果服务端无法支持 TLS 1.2，可在导出目标的连接参数中关闭加密传输，或者改用 TLS 1.0 传输。

数据资源

选择将哪些数据进行导出。

先选择设备模型，然后对每个设备模型选择要导出的设备和测点。

数据表

导出的数据将以设备模型分组，相同设备模型下的设备测点导出到同一个表。

表名可以在任务属性中进行设置，{device_model_id}的部分会替换为设备模型的标识。

例如数据源选择了标识为DT1、DT2的两个设备模型，表名模板为export_{device_model_id}_data，对应的测点数据对应导出到export_DT1_data和export_DT2_data两个表。

表的列要求如下：

表应当自动生成主键
列device_id保存设备标识
列time保存数据时间
对于设备模型上定义的每一个测点，按其测点标识对应目标表的一列，可以为NULL

如果缺少device_id、time、任意测点对应的列，或者值与列类型不兼容，都会导致导出失败。

可以在列表页中点击“建表”完成自动建表。

自动建表以点击时数据资源中各设备模型现有测点进行建表，以自增列id作为主键。

外部数据源

外部数据源用于读取第三方数据库或应用中的数据，并在组态画面和报表中进行使用。

数据源分为HTTP类型和数据库类型，数据源下可以创建多个数据集。

数据库数据源

点击左侧【数据源管理】中“+”按键，在【创建数据源】弹窗中输入“数据源名称”、“数据源类型”与“描述”，点击【确定】按钮完成数据源创建操作。

字段说明：

数据源名称：必填项。
数据源类型：必选项。在数据源创建后无法修改。
描述：选填项。根据需求填写数据库的描述文字。

刚创建的数据源只包含“数据源名称”等基础信息，需要选中数据源进行设置连接参数。

设置连接参数

点击左侧【数据源管理】列表中选中相应的数据源。在右侧的数据源详情页面进行设置。

字段说明：

数据库类型：必填项。
数据库名称：必填项。数据库的实际名称。
主机地址/IP：必填项。数据库的主机地址/IP。
端口：必填项。数据库的主机地址/IP端口。
schema：选填项。当数据库为PostgreSQL时可以填写PostgreSQL 模式（schema）。
用户名：选填项。若数据库设有密码，则需要在此处填写登录用户名。
密码：选填项。若数据库设有密码，则需要在此处填写登录密码。

测试连接

点击数据库数据源详情页的【测试连接】按钮，测试已配置好的数据库数据源是否能正常。连接失败时消息提示会包含错误信息，方便查找连接失败原因。

删除数据源

点击左侧【数据源管理】列表中需要删除的数据源的“操作”按键。在操作弹窗中点击“删除”按钮。在【删除确认】弹窗中点击“确定”完成删除操作。

创建数据集

一个数据集对应一条 SQL 语句的查询结果。

点击左侧【数据源管理】列表中数据源的“操作”按键，在操作弹窗中点击“创建”按钮。

字段说明：

数据集名称：必填项。
数据集标识：选填项。作为操作数据集的唯一标识，不填则会由系统自动生成。
描述：选填项。根据需求填写数据集的描述文字。

刚创建的数据集只包含“数据集名称”等基础信息，需要编辑数据集进行其它内容的设置。

编辑数据集

点击左侧【数据源管理】列表中需要编辑的数据集，在右侧的数据集详情页面进行编辑，点击【保存】按钮对修改的内容进行保存。

变量

定义变量参数，可在数据库数据集中的"查询语句"和“总数查询语句”中使用。

点击【添加变量】可以添加新的变量，变量支持字符串、数值、布尔型类型，且可以设置不传参时的默认值。offset与limit为默认变量不可删除，可在开启分页时使用。

字段

用于定义查询后返回的结果集中每条数据的字段，至少需要设置一个字段。

字段类型

支持以下几种类型：字符串、布尔型、整数型、浮点型、日期、日期时间、时间。

字符串与整数型可以添加枚举项，枚举值为对应返回值，枚举名称对应显示名称。
布尔型可以填写返回值为false或true时的字段名称。
浮点型可以选择返回值精度。
日期、日期时间、时间型可以按照时间格式回显。时间格式："%Y"代表年，"%m"代表月"%d"代表日"%H"代表时"%M"代表分"%S"代表秒。如想表示时间格式为"2022-01-01 01:01:01"，则写为"%Y-%m-%d %H:%M:%S"。

分页

默认为开启分页。可设置是否启用分页查询，启用分页后将显示“总数查询语句”。

总数查询语句

仅在启用分页时显示，且为必填项。依照数据源中数据库类型的语法填写分页查询的sql语句。可以使用变量，格式为“${变量名称}”。

查询语句

必填项。依照数据源中数据库类型的语法填写分页查询的sql语句。可以使用变量，格式为“${变量名称}”。

数据集预览

点击数据集右下角的【预览】按钮。在【预览】弹窗中点击右下角的【查询】按钮进行数据预览。

若有变量则可以填写变量值作为参数进行数据查询。

若在选项中开启分页则会在页面底端显示分页。

删除数据集

点击左侧【数据源管理】列表中数据集的“删除”按键。在操作弹窗中点击“删除”按钮。在【删除确认】弹窗中点击“确定”完成删除操作。

HTTP 数据源

HTTP类型数据源用于通过 HTTP 方式获取数据。

创建数据源

点击左侧【数据源管理】中“+”按钮，在【创建数据源】弹窗中将“数据源类型”设置为“HTTP”，如下图所示：

字段说明：

数据源名称：必填项。
数据源类型：必选项。在数据源创建后无法修改。
描述：选填项。根据需求填写数据库的描述文字。

数据源设置

点击左侧【数据源管理】列表中选中需要设置的数据源，在右侧的数据源详情页面进行设置。

全局变量

全局变量可以被该数据源下的所有数据集使用。

点击【添加变量】可以添加新的变量，支持字符串、数值、布尔型类型，如下图所示：

变量赋值

调用数据集发出 HTTP 请求时，可以通过传参对变量进行赋值。如果不传参，需要设置变量的默认值。

数据源设置中使用变量

可以在数据源的以下设置中引用全局变量：

在Headers下的 key 和 value 中引用全局变量，格式为 {{变量名称}}
在 Authorization 下的用户名、密码、Token、Key、Value中使用引用全局变量，格式为 {{变量名称}}

数据集设置中使用变量

可以在数据集的以下设置中引用全局变量：

在请求地址的 URL Path 中引用全局变量，格式为{{变量名称}}
在Headers下的 key 和 value 中引用全局变量，格式为 {{变量名称}}
在Params下的 key 和 value 中引用全局变量，格式为{{变量名称}}
在Body中引用全局变量，格式为${变量名称}。

Headers 参数

Header 参数用于定义所有数据集公用的请求头，设置后 key 和 value 的值将添加到所有数据集的 HTTP 请求头中。

引用全局变量

在Headers下的 key 和 value 中可以引用全局变量，格式为 {{变量名称}}

Authorization

用于设置 HTTP 请求的认证方式。支持以下几种认证方式：

无需认证。
Basic Auth。
Bearer Token
API Key

引用全局变量

在 "用户名"、"密码"、"Token"、"Key"、"Value"中可以使用全局变量，格式为：{{变量名称}}

删除数据源

删除数据源会连同删除在此数据源下创建的数据集，请谨慎操作。

创建数据集

每个数据集对应一个 HTTP 请求。

常规的 http 数据集要求返回的是 JSON 格式的数据，下面是一个示例：

json

[
  { product: 'Matcha Latte', count: 823, score: 95.8 },
  { product: 'Milk Tea', count: 235, score: 81.4 },
  { product: 'Cheese Cocoa', count: 1042, score: 91.2 },
  { product: 'Walnut Brownie', count: 988, score: 76.9 }
]

点击左侧【数据源管理】列表中数据源的“操作”按键，在操作弹窗中点击“创建”按钮。

字段说明：

数据集名称：必填项。
数据集标识：选填项。作为操作数据集的唯一标识，不填则会由系统自动生成。
描述：选填项。根据需求填写数据集的描述文字。

刚创建的数据集只包含“数据集名称”等基础信息，需要编辑数据集进行其它内容的设置。

编辑数据集

点击左侧【数据源管理】列表中需要编辑的数据集，在右侧的数据集详情页面进行编辑，点击【保存】按钮对修改的内容进行保存。

请求方法和请求地址

请求方法

默认为“GET”方法。请求方法包含“GET”、“POST”、“PUT”、“HEAD”、“DELETE”、“OPTIONS”和“PATCH”。选择“POST”、“PUT”和“PATCH”方法时可以填写Body属性。

请求地址

填写请求地址，可以引用变量，格式为{{变量名称}}。

本地变量

变量参数可以在数据集设置中引用。

点击【添加变量】可以添加新的变量，如下图所示：

变量的使用方法可参考数据源中的“全局变量”。

如果数据源变量与数据集变量的名称相同，则优先使用数据集变量。

预置变量

数据集中默认提供了一些预置的变量：

offset：可在开启分页是使用，用于定义分页查询的数据偏移量。
limit：可在开启分页是使用，用于定义分页查询的最大数据量。

Headers 参数

Header 参数用于定义数据集的请求头，通过 key、value 键值对的形式进行设置。

如果数据源Headers与数据集Headers的key值相同，则优先使用数据集Headers。

引用变量

在Headers下的 key 和 value 中可以引用全局变量和本地变量，格式为 {{变量名称}}

Params 参数

Params 设置的 key 和 value 会作为参数被添加到请求地址“？”之后。

引用变量

key 和 value 可以使用全局变量和本地变量，格式为{{变量名称}}

Body 参数

Body 参数用于定义 HTTP 请求体，支持 FormData、x-www-form-urlencoded、json 类型。

引用变量

form-data 和 x-www-form-urlencoded 类型的 body ，键和值可以以{{变量名称}}格式引用全局变量和本地变量。

json 类型的 body ，字符串可以以${变量名称}格式引用全局变量和本地变量。

特别地，当：

字符串不是 object 的键
字符串中有且仅有一个变量引用
字符串在变量引用的两侧没有其他字符

满足以上条件时，数字和布尔型的变量会以对应的类型替换原本的字符串，且未定义的变量替换为 null。

否则，字符串在替换过变量引用后仍以字符串形式出现在请求体中。

例如，如果变量 x 为数值 3：

{ "x": "${x}" }变量替换后为{ "x": 3 }，object 值的部分被替换，且替换为数值。如果想要替换为{ "x": "3" }，应当将变量 x 定义为字符串类型。

{ "${x}": "${x}" }变量替换后为{ "3": 3 }，object 键和值的部分被替换，但只有值的部分被替换为数值，键的部分仍为字符串。

{ "x": "value = ${x}" }变量替换后为{ "x": "value = 3" }，object 值的部分被替换，但由于变量引用的两侧还有其他字符，替换后仍为字符串形式。

{ "x": "${x}${x}" }变量替换后为{ "x": "33" }，object 值的部分被替换，但由于引用了不止一个变量，因此替换后仍为字符串形式。

raw 参数中可以使用全局变量和本地变量，格式为${变量名称}。

Content-Type

如果 headers 中没有设置 Content-Type，根据 body 的类型，请求会按如下规则自动设置 Content-Type：

form-data 类型的 body：自动设置 Content-Type 为 multipart/form-data
x-www-form-urlencoded 类型的 body：自动设置 Content-Type 为 application/x-www-form-urlencoded
json 类型的 body：自动设置 Content-Type 为 application/json
raw 类型的 body：如果 body 非空，自动设置 Content-Type 为 text/plain；如果 body 为空，不自动设置 Content-Type

分页参数

可设置是否启用分页查询，启用分页后将显示“数据项总数”，默认为开启分页。

数据项内容：在启用分页时显示为必填项，禁用分页时为选填项。用以确认返回数据的数据内容的JsonPath。
数据项总数：仅在启用分页时显示，且为必填项。用以确认返回数据的数据项总数的JsonPath。

字段

用于定义查询后返回的结果集中每条数据的字段，至少需要设置一个字段。

字段类型

支持以下几种类型：字符串、布尔型、整数型、浮点型、日期、日期时间、时间。

字符串与整数型可以添加枚举项，枚举值为对应返回值，枚举名称对应显示名称。
布尔型可以填写返回值为false或true时的字段名称。
浮点型可以选择返回值精度。
日期、日期时间、时间型可以按照时间格式回显。时间格式："%Y"代表年，"%m"代表月"%d"代表日"%H"代表时"%M"代表分"%S"代表秒。如想表示时间格式为"2022-01-01 01:01:01"，则写为"%Y-%m-%d %H:%M:%S"。

数据集预览

点击数据集右下角的【预览】按钮。在【预览】弹窗中点击右下角的【查询】按钮进行数据预览。

若有变量则可以填写变量值作为参数进行数据查询。

若在选项中开启分页则会在页面底端显示分页。

删除数据集

点击左侧【数据源管理】列表中数据集的“删除”按键。在操作弹窗中点击“删除”按钮。在【删除确认】弹窗中点击“确定”完成删除操作。

全局变量

全局变量是用户自定义的一种变量。可以用于在逻辑开发、告警规则、虚拟点计算、组态开发等各种场景中使用。

NOTE

全局变量功能需要 v5.6.0 及以上版本。

命名空间

定义全局变量需要先定义命名空间，同一个命名空间下，变量名不可重复。

点击命名空间列表中的“+”按钮，弹出创建命名空间对话框，输入命名空间名称即可创建一个新的命名空间。

变量管理

选中命名空间，可以在右侧的表格中查看该命名空间下的变量。

点击“添加”按钮，可创建变量。

变量字段说明：

名称	说明
名称	变量名称，只能包含字母、数字和下划线，必须以字母开头，长度1-20个字符。
变量类型	支持 4 种常用类型：字符串、布尔型、数值型、JSON
描述	变量的描述信息

点击“查看值”按钮，可显示该变量的当前值，在输入框中输入新值，并点击“确定”按钮，可以对变量值进行修改。

告警中心

告警规则

告警规则用于定义在什么情况下触发告警。告警规则建立在【设备模型】之上，选中设备模型，点击【创建】按钮，弹出创建规则窗口，如下图所示：

参数说明

项目	说明
规则名称	告警规则名称，必填项。
规则描述	告警规则的描述。
告警类型	选择告警规则所属的告警类型，必填项。
触发方式	告警规则的触发方式，必填项，详见触发方式说明。
区间值	当触发方式为单点触发，且比较方式为“区间内”或“区间外”时有效。区间值的格式示例：[0,100]。
持续时长	当满足触发条件后，持续一定的时间后才会触发告警，不填则默认实时触发。
死区值	死区值可以防止由于测点值不断跨越比较值而产生的告警状态反复变化。
告警设备	告警设备的范围：全部设备，勾选后该设备类型下所有设备都会应用此规则；指定设备，勾选后需要选择需要触发告警的设备；
时间条件	告警规则触发的时间条件，不填则随时都可以触发；
设备联动	告警触发后的设备联动，可以控制设备下发；
报警处理	开启后可对报警信息进行报警确认及报警处理的操作；
启用	取消勾选，则表示该告警规则不生效。

TIP

死区值可以防止由于测点值不断跨越比较值而产生的告警状态反复变化。例如：为电机工作温度设置告警，其低设置点为50，高设置点为70，死区为2。如果该值介于50和70之间，则警报将激活，当值低于48或高于72时，警报才会被清除。

CAUTION

注意：死区和持续时长不能同时使用。

触发方式说明

触发方式	说明
单点触发	基于单个测点值设置触发条件。
通讯状态触发	当设备通讯状态发生变化时触发告警。
公式触发	以逻辑表达式的方式判断是否满足触发条件。
长时间不上传数据	当测点数据长时间不更新时，触发告警。
长时间数据不变化	当测点数据长时间不变化时，触发告警。

IMPORTANT

单点触发的特殊触发方式：

持续上升：当检测到该测点在一定时间内持续上升超过一定数值时触发告警。
持续下降：当检测到该测点在一定时间内持续下降超过一定数值时触发告警。
数值偏差：当检测到测点值与比较值的差值大于偏差值时，触发告警。

指定告警设备

如果告警规则设置的是“指定设备”，可以点击“指定设备”按钮，在弹窗中勾选应用于该规则的设备。

批量导入

当需要批量配置告警规则时，可以使用 excel 方式进行配置，批量导入告警规则。点击【导入】按钮，弹出导入对话框，如下图所示：

在【导入对话框】中，点击【下载模板文件】，将 Excel 模板文件下载到本地。

在 Excel 文件中，我们按不同的触发方式分成了多个 Sheet 页，每个触发方式需要配置的字段有所区别。

大部分字段根据名称进行填写即可。

本文档只对几个特殊的字段进行说明：

指定告警设备：如果设置为空，该规则应用到所属模型下的所有设备。如果需要指定设备，可以输入设备标识并用英文逗号（“,”）进行分隔。
设备联动点位：输入需要进行联动输出的点位标识，只支持同模型下的点位标识，空表示不进行联动输出。

告警推送

通过创建通知规则，当发生告警，且满足通知规则中设置的条件时，向指定的通知组推送告警通知。

点击【创建】按钮，弹出创建通知规则窗口，如下图所示：

推送条件

当同时满足以下条件时推送告警通知：

告警等级：不选择，表示所有告警等级。
告警类型：不选择，表示所有告警类型。
设备分组：触发告警的设备所属的分组。
指定设备：触发告警的设备为指定设备时。
设备标签：触发告警的设备标签满足设定的标签条件时。

通知模式

通知模式支持以下几种方式：

简单通知：立即发出通知。
重复通知：立即发出通知，如果N分钟未恢复，则重新发出通知，最多通知M次。
升级通知：立即发出通知，如果N分钟未恢复，则向另一个通知组发出通知。
延迟通知：若告警产生N秒后仍未自动消除，则发送通知。

告警通知组

告警通知组用于管理接收告警通知的用户。

当产生告警后，系统会根据推送规则向“通知组成员”推送告警通知。

可以创建多个通知组，每个通知组可以设置接收通知的方式和成员。

点击【创建】按钮，弹出创建通知组窗口，如下图所示：

钉钉机器人设置

参考官方文档创建自定义机器人获取签名密钥，安全设置请选择【加签】方式，并将用于签名的密钥复制出来。

点击完成，获取 Webhook 地址，已创建过的消息机器人可以参考官方文档获取自定义机器人 Webhook 地址。Webhook 地址格式为：https://oapi.dingtalk.com/robot/send?access_token=xxxxxxxxxxxxxxxxx，红色文本的内容为认证密钥。

飞书机器人

请参考官方文档创建自定义机器人并获取 Webhook 地址。

飞书机器人的 Webhook 地址格式如下：https://open.feishu.cn/open-apis/bot/v2/hook/xxxxxxxxxxxxxxxxx，红色文本的内容为认证密钥。

安全设置请选择签名校验，并将用于签名的密钥复制出来。

企业微信机器人

企业微信机器人只需要设置认证密钥，不需要签名密钥。

请参考官方文档创建消息机器人并获取 Webhook 地址。

企业微信机器人的 Webhook 地址格式如下：https://qyapi.weixin.qq.com/cgi-bin/webhook/send?key=xxxxxxxxxxxxxxxxx，红色文本的内容为认证密钥。

Telegram（非正式简称TG或电报、纸飞机），是跨平台的即时通讯软件，支持用户相互交换加密与自毁消息，发送照片、影片等所有类型文件。官方提供手机版、桌面版和网页版等多种平台客户端。Topstack 支持通过消息机器人向 Telegram 的一个群组中发送消息通知。

使用 Telegram 发送消息通知，需要设置认证密钥和群组标识。

下面介绍下获取 Telegramp 认证密钥和群组标识的方法。

与 @BotFather 对话，发送指令 /start 开始，/newbot 申请一个新的 Bot 账号。
接着，BotFather 会要求你输入这个 Bot 的名字和 ID。创建完成后，BotFather 会同时给你一个 token，记住这个 token（这个 token 就是认证密钥）。
此时消息机器人已创建成功，接下来我们就要创建群组（Channel）用于接收消息通知，然后将把这个消息机器人（Bot）设置为 Channel 的管理员。
由于 Channel 是 private，我们需要获取这个 Channel 的 ID 来（群组标识），将 Channel 内的消息转发给 @JsonDumpBot 可以查看到 Channel ID。可以在 forward_from_chat中看到此 Channel 的 ID 是 -1001790411176，这个 Channel ID 就是我们要的群组标识。

告警记录

告警引擎会根据用户设置告警规则对设备数据进行实时监测，当满足告警规则条件时会生成告警记录。TopStack 提供了告警记录查询页面，用户可以对告警记录进行检索。

业务逻辑

业务逻辑是物联网平台的一个开发工具。通过编排服务节点的方式快速完成简单的物联网业务逻辑的设计。适用于以下场景：设备联动、设备数据处理、设备与服务联动、生成API 、生成App的后端服务等。

功能特点

简单易用。对不熟悉服务端开发的用户，提供免代码开发物联网服务的方案，只需简单学习即可使用；对高阶用户提供JS脚本、扩展库等高阶能力。
基于云组态平台提供的物联网云服务。可以使用图扑物联云组态平台提供的基础服务I，也可以接入您自定义的API。
易读易理解，沉淀企业核心业务。可视化的流程图更利于业务人员理解，避免人员交接造成信息丢失，有利于沉淀企业核心业务能力。
易快速定位、修复故障。节点之间的依赖项清晰可见，便于您快速定位服务的问题，快速地进行热修复。
云端完全托管服务。云组态平台提供云端托管能力，服务开发完成即可使用，您无需额外购买服务器。并且，支持在线调试。

服务管理

服务是业务逻辑的配置单元。在左侧菜单栏中选择【业务逻辑】【服务管理】进入业务逻辑服务管理界面。如下图所示：

点击【创建】按钮，可创建一个业务逻辑服务节点。

点击服务节点的【编辑】按钮，可修改服务名称和描述。

点击服务节点的【开发】按钮，进入业务逻辑开发环境，具体操作方式，请参考《业务逻辑开发手册》。

维护管理

工单管理

工单流程如下图所示：

应用管理

用于管理第三方业务应用，支持新增、修改、删除等，通过应用管理实现对应用的状态管理。平台将应用分为【桌面端】和【移动端】，桌面端适用用于 PC 端访问，移动端应用用于手机端访问。

创建应用

点击【创建】按钮，打开新建应用对话框，如下所示：

字段说明：

字段名	说明
应用名称	业务应用的名称，用于在首页中显示。
跳转地址	第三方应用集成单点登录后的跳转地址，详细使用方式请参考开发手册中的单点登录。
优先级	用于控制业务应用在首页中的显示顺序。
访问终端	用于设置业务应用的类型，桌面端或移动端。
用户组	默认为空，如果设置了用户组，则只有用户组成员可以访问该应用。
应用图标	在首页中显示应用时所使用的图标。
描述	应用的描述说明。

禁用应用

点击状态栏中的【修改】按钮，可以将应用设置为禁用状态。被禁用的应用将不允许访问。

可视化

组态画面

打开【可视化管理】【组态画面】界面。如下图所示，左侧为组态画面目录，右侧显示的是选中的画面目录下的所有图纸画面。

占击右上方的“应用开发”按钮，进入可视化应用管理界面。

点击右上方的“组态开发”按钮，进入组态开发编辑器。

新建图纸

点击右上方的“新建图纸”按钮，可以创建一个指定名称的空白图纸。

编辑图纸

点击图纸的编辑按钮，如下图所示，可进入组态开发编辑器并该图纸进行编辑。关于组态开发的详细使用请参考《开发手册》中的相关内容。

预览图纸

点击预览按钮，可在新窗口中单独访问该图纸的组态画面，如下图所示。

发布图纸

点击发布按钮，弹出图纸发布对话框，可实现免登录访问该图纸画面，如下图所示。

删除图纸

点击删除按钮，将会删除该图纸画面，如下图所示。

报表管理

概述

报表管理页面中可以创建自定义格式的报表模板。如支持以下 3 种报表形式：

行式报表：通过关联一个指定的数据集生成报表，以行为单位进行渲染。
自由报表：通过关联一个指定的数据集生成报表，以整页单位进行渲染。
填报报表：用户可以通过自定义表单内容，实现数据填报，以行式报表的模式进行渲染。

行式报表和自由报表引用的是数据集中的数据，用户需要在数据源管理界面提前定义好数据集。

行式报表

以行为单位，进行报表渲染，数据来源于所选的数据集。

自由报表

以整张表为单位，进行报表渲染，数据来源于所选的数据集。

填报报表

与行式报表相同，但数据源为填报数据源

报表文件

报表管理界面以“目录”和“文件”和形式对报表进行管理。如下图所示，左侧为报表目录，右侧显示的是选中的目录下所有的报表。

选中一个目录，点击右上方的创建可以创建新的报表模板。

报表设计

点击“编辑”按钮，打开报表设计器。报表设计器界面如下图所示：

基本信息

名称：当前报表的名称。[必填]
用户组：哪些用户组下的用户可以看到这个报表。
描述：对当前报表的描述。
数据集：当前报表的数据来源。[必填]

选中数据集后可以通过点击属性列表中的字段来在当前选中的单元格中快速设置属性

变量格式为：${变量名}

填报参数（填报报表）

当报表类型为填报报表时出现此选项，用来配置当前填报报表中需要录入哪些字段。

查询参数

通过配置查询参数来设置报表预览时所需的过滤条件，字段来源于数据集中配置的查询参数，当报表类型为填报报表时，字段来源于设置的填报参数中。

预览设置

分页查询：当报表类型为填报报表是强制开启，其余情况则通过数据集配置开启
以PDF方式显示表格：开启后预览页面表格为 PDF 样式。
宽度溢出：
不处理：当宽度超出纸张宽度时，不进行任何处理
分页显示：当宽度超出纸张宽度时，超出部分新建一页显示
缩放：缩放表格比例，强制保持一页显示

数据填报

当报表类型为填报报表时，需要报表数据进行增、删、改操作。

点击【数据管理】按钮打开数据管理对话框，如下图所示：

工作台操作手册 ​

项目工作台简介 ​

访问控制 ​

账号中心 ​

组织管理 ​

角色管理 ​

用户管理 ​

日志管理 ​

操作日志 ​

下发记录 ​

设备互联 ​

设备模型 ​

模型分组 ​

新建模型 ​

导入导出 ​

基本信息 ​

删除模型 ​

地理信息 ​

属性信息 ​

测点信息 ​

指标管理 ​

设备接入 ​

直连接入 ​

通道管理 ​

通道禁用重启 ​

通道导入导出 ​

通讯点表 ​

仿真模式 ​

实时数据 ​

实时日志 ​

历史日志 ​

网关接入 ​

MQTT 配置 ​

网关导入 ​

网关导出 ​

报文监测 ​

子设备管理 ​

纳管型网关 ​

自主接入 ​

设备管理 ​

基本属性 ​

设备导入导出 ​

设备属性设置 ​

设备标签 ​

查看测点数据 ​

定时任务 ​

方案管理 ​

任务管理 ​

任务启停 ​

控制策略 ​

OTA 升级 ​

使用限制 ​

管理升级包 ​

产品管理 ​

模块管理 ​

升级包管理 ​

OTA 升级步骤 ​

步骤一：设备上报版本号 ​

步骤二：推送升级包信息 ​

步骤三：设备下载升级包 ​

数据管理 ​

数据开放 ​

数据订阅 ​

添加订阅 ​

设置订阅资源 ​

消息格式 ​

测点值 ​

告警信息 ​

转发目的地 ​

Pulsar ​

Kafka ​

AMQP ​

MQTT ​

数据导出 ​

创建导出任务 ​

相对时间 ​

数据抽样 ​

任务类型 ​

时间类型 ​

导出目标 ​

工作台操作手册

项目工作台简介

访问控制

账号中心

组织管理

角色管理

用户管理

日志管理

操作日志

下发记录

设备互联

设备模型

模型分组

新建模型

导入导出

基本信息

删除模型

地理信息

属性信息

测点信息

指标管理

设备接入

直连接入

通道管理

通道禁用重启

通道导入导出

通讯点表

仿真模式

实时数据

实时日志

历史日志

网关接入

MQTT 配置

网关导入

网关导出

报文监测

子设备管理

纳管型网关

自主接入

设备管理

基本属性

设备导入导出

设备属性设置

设备标签

查看测点数据

定时任务

方案管理

任务管理

任务启停

控制策略

OTA 升级

使用限制

管理升级包

产品管理

模块管理

升级包管理

OTA 升级步骤

步骤一：设备上报版本号

步骤二：推送升级包信息

步骤三：设备下载升级包

数据管理

数据开放

数据订阅

添加订阅

设置订阅资源

消息格式

测点值

告警信息

转发目的地

Pulsar

Kafka

AMQP

MQTT

数据导出

创建导出任务

相对时间

数据抽样

任务类型

时间类型

导出目标