可视化看板

通过 ThingsCloud 内置的可视化看板，您可以快速搭建已接入设备的数据可视化展示，以及可交互的控制界面。

可视化看板的优势包括：

• 简单易用的可视化布局。
• 数据绑定轻松搞定，无需任何代码。
• 支持几十个常用的看板组件，样式比较丰富。
• 响应式布局，支持 PC 和手机浏览器自动布局。
• 支持共享模式，可生成开放 URL。
• 可嵌入项目应用 SaaS，复用性强。
• 不断推出新看板组件。

视频教程

• 轻松搭建不同样式的可视化看板
• 1. 仪表盘 | 玩转 ThingsCloud 可视化看板
• 2. 开关量状态 | 玩转 ThingsCloud 可视化看板
• 3. 开关量控制 | 玩转 ThingsCloud 可视化看板
• 4. 开关量多路控制 | 玩转 ThingsCloud 可视化看板
• 5. 开关量定时反转 | 玩转 ThingsCloud 可视化看板
• 6. 历史数据折线图 | 玩转 ThingsCloud 可视化看板
• 7. 设备列表组件 | 玩转 ThingsCloud 可视化看板
• 8. 设备告警历史 | 玩转 ThingsCloud 可视化看板
• 9. 设备跟随模式 | 玩转 ThingsCloud 可视化看板
• 10. 设备位置地图 | 玩转 ThingsCloud 可视化看板
• 11. 设备地图跟随模式 | 玩转 ThingsCloud 可视化看板
• 12. 数值历史统计 | 玩转 ThingsCloud 可视化看板
• 13. 设备列表关联属性 | 玩转 ThingsCloud 可视化看板
• 14. 趋势图分段颜色 | 玩转 ThingsCloud 可视化看板
• 15. 数值属性下发 | 玩转 ThingsCloud 可视化看板

图文教程

• 可视化看板也能数据预处理，轻松生成碳排放量和电费
• 用 ThingsCloud 看板实现继电器多控，还能定时反转
• 用好设备跟随模式，让 ThingsCloud 可视化看板容纳更多设备
• 为平板触摸屏而生，看板 ThingsPad App 发布
• 设备历史数据分析，学会这几招就够用了
• 不懂设计？一键生成精美的物联网设备看板
• ThingsCloud 看板告警组件增强，控制台支持告警音效
• 10 分钟轻松玩转 ThingsCloud 看板仪表盘
• 可视化看板组件升级，全面支持设备枚举属性
• 在可视化看板和 App 中上传自定义图标
• ThingsCloud 可视化看板自定义样式全新升级

查看看板列表

创建可视化看板

进入 可视化 > 看板 > 创建看板，填写看板名称、描述，并选择看板公开性，即可创建一个新的可视化看板。

看板公开性包括：

• 私有看板：只有项目成员登录控制台后可以浏览和编辑。
• 公开看板：拥有公开 URL，任何人无需登录即可浏览。

创建完成后，系统会自动进入看板详情页。您可以继续添加组件、调整布局和设置看板样式。

添加组件

进入看板详情页后，点击右上角 添加组件，会打开组件编辑对话框。添加组件的基本流程如下：

1. 在 组件 中选择合适的可视化组件。
2. 在 数据源 中选择设备或设备组，并选择要展示或控制的数据项。
3. 在 选项 中调整当前组件的显示和交互参数。
4. 在 设置 中填写组件标题，并按需设置组件独立样式。
5. 点击 保存，组件会添加到当前看板。

新组件添加后，会自动放入看板网格中。看板采用响应式网格布局，在 PC 端默认按 24 列排列；手机浏览时会自动调整为适合小屏幕的布局。

选择组件

组件按用途分为以下几类：

• 仪表盘：用于展示温度、压力、液位、百分比等数值状态。
• 信息：用于展示数字、文本、状态灯、列表等当前数据。
• 控制：用于向设备下发属性、命令、任务或自定义数据。
• 设备：用于展示设备卡片、设备列表，或在看板中选择当前设备。
• 数据：用于展示设备历史数据曲线、历史数据表格等。
• 统计：用于展示柱状图、饼图、环形图、极坐标图等统计图表。
• 位置：用于展示设备当前位置、地图轨迹、平面定位等。
• 影像：用于展示图片、视频或摄像头画面。
• 告警：用于展示设备告警状态和告警历史。

部分组件属于付费版本能力，如果当前项目套餐不支持，组件会显示锁定状态，选择时会提示升级。

设置数据源

大部分组件需要绑定数据源。少数组件仅用于展示图片、文本、视频等固定内容，不需要设置数据源。

数据源类型包括：

• 设备：选择某一台设备，再选择设备属性、事件、命令或其他可用指标。
• 设备组：选择一个设备组，用于设备列表、告警历史、设备统计等面向多设备的组件。

一个组件可以添加多个数据项。每个数据项可以设置：

• 设备或设备组。
• 指标，例如设备属性、设备状态、告警状态等。
• 数据项名称，用于覆盖默认显示名称。
• 聚合函数，用于历史数据类组件，例如平均值、最大值、最小值等。
• 数据项选项，例如数值范围、单位、颜色、图标、自定义显示函数等。

例如：选择仪表盘组件，数据源设置多个设备的湿度属性，展示不同设备的湿度当前值，如下图：

在数据项列表中，可以对数据项执行以下操作：

• 点击 添加数据项 添加新的数据项
• 拖动排序按钮调整数据项顺序
• 点击复制按钮复制一个已有数据项
• 点击删除按钮移除数据项
• 点击设置按钮打开当前数据项的详细配置

部分设备列表类组件还支持设置 属性集，用于在设备列表中展示多个设备属性的当前值，如下图：

使用历史数据

历史数据类组件支持开启 使用历史数据。开启后，可以继续设置：

• 历史数据区间：例如最近一段时间，或自定义开始和结束时间。
• 聚合时间段：用于将历史数据按固定时间窗口聚合。
• 聚合函数：用于计算每个时间窗口内的数据，例如平均值、最大值、最小值等。
• 显示时间选择器：在组件上方显示时间选择器，浏览看板时可以临时调整时间范围。

例如：选择历史曲线组件，数据源设置多个设备的湿度属性，并设置时间范围和聚合方式，展示不同设备的湿度历史曲线，如下图：

如果使用自定义时间范围，开始时间必须早于结束时间，并且时间跨度不能超过 365 天。

跟随设备组件

部分组件支持 跟随设备组件。开启后，当看板中的设备组件选中某台设备时，当前组件的数据源会自动切换到该设备。

这个能力适合制作“设备总览 + 设备详情”的看板。例如：

1. 添加一个设备列表组件。
2. 添加一个历史曲线组件、仪表盘组件、告警历史组件或控制组件。
3. 在这些详情组件中开启 跟随设备组件。
4. 浏览看板时，在设备列表中选择不同设备，详情组件会随之切换数据。

如果只希望跟随某一类设备，可以在 限定跟随设备类型 中选择设备类型。

设置组件选项

在组件编辑对话框右侧点击 选项，可以配置当前组件的显示方式和交互行为。

不同组件的选项不同，常见选项包括：

• 仪表盘颜色、百分比分段颜色、指针样式、刻度样式。
• 数字、文本、列表、状态灯的颜色、图标、字号和显示方式。
• 开关、按钮、滑块等控制组件的样式和交互参数。
• 图表颜色、统计项、标线、表格行列统计。
• 地图图标、地图折线、位置显示方式。
• 图片上传、视频显示、摄像头相关配置。
• 设备任务、设备选择器、设备列表显示方式。
• 自定义函数，用于处理属性显示或属性下发值。

设置信息和样式

在组件编辑对话框右侧点击 设置，可以配置组件标题和独立样式。

标题栏设置包括：

• 组件标题
• 是否显示标题图标
• 选择标题图标

组件样式默认继承看板的通用样式。如果希望某个组件拥有不同的外观，可以开启 使用独立样式，然后单独设置：

• 背景色。
• 深色模式。
• 文字颜色。
• 阴影。
• 边框、边框宽度、边框颜色、边框样式、边框位置。
• 圆角大小。
• 数字字体。

独立样式适合突出关键组件，例如告警状态、核心指标或重要控制按钮。

调整组件布局

在 PC 端浏览看板时，项目成员可以直接调整组件布局。

• 将鼠标移动到组件上方，组件右上角会显示操作菜单。
• 按住组件顶部区域拖动，可以调整组件位置。
• 拖动组件边缘或角落，可以调整组件大小。
• 布局调整后会自动保存。

组件右上角菜单支持：

• 编辑：重新打开组件编辑对话框。
• 重新加载：刷新当前组件数据。
• 复制到新组件：在当前看板中复制一个相同组件。
• 复制到看板：将当前组件复制到其他看板。
• 移除：从当前看板中删除组件。

看板设置

点击看板详情页右上角 看板设置，可以打开看板设置面板。看板设置包括 基本信息、样式、顶栏、公开、用户 和 高级。

基本信息

在 基本信息 中，可以修改：

• 看板名称
• 看板描述

修改后点击 保存 生效。

样式

在 样式 中，可以设置整个看板的背景、布局和组件通用样式。

样式主题 提供多种预设主题，点击即可快速套用。

看板背景 支持：

• 纯色背景
• 渐变色背景
• 背景图片
• 背景图片透明度

渐变色背景支持线性渐变和中心渐变。线性渐变可以设置渐变方向。

看板布局 支持：

• 组件水平间距
• 组件垂直间距
• 悬浮布局

开启悬浮布局后，PC 端允许组件在垂直方向拖动到任意位置。手机浏览看板时不支持悬浮布局，会自动紧凑对齐。

组件通用样式 支持：

• 组件背景色。
• 深色模式。
• 文字颜色。
• 数字字体。
• 标题栏居左。
• 显示阴影和阴影大小。
• 显示边框。
• 边框宽度、颜色、样式和位置。
• 圆角大小。

如果想恢复默认外观，可以点击 恢复默认样式。

顶栏

在 顶栏 中，可以为看板显示统一顶部栏。

顶栏支持：

• 显示或隐藏顶栏
• 设置顶栏背景色
• 设置顶栏标题
• 显示或隐藏 Logo
• 上传 Logo
• 显示或隐藏时间筛选器
• 设置默认时间范围
• 设置默认自定义时间
• 设置默认聚合时间

开启顶栏时间筛选器后，浏览看板时可以在顶部统一调整历史数据时间范围。对于开启了历史数据并显示时间选择器的组件，顶栏时间筛选器可以统一影响这些组件的数据展示。

公开访问

看板支持共享，您可以在看板设置中开启共享，会自动生成共享的公开 URL，该 URL 可以在未登录的情况下直接访问。

同时也生成 URL 二维码，便于在手机上直接打开，看板会适配手机屏幕大小，生成便于手机浏览的布局。

在 公开 中，还可以设置公开页面语言。该设置仅影响看板中内置文字的语言，例如在线状态、告警状态等，不会自动翻译您手动填写的组件标题或文本内容。

关联用户

在 用户 中，可以将看板关联到一个或多个用户。关联后，用户可以登录 ThingsXS 浏览自己有权限访问的看板。

用户设置支持：

• 添加关联用户
• 移除关联用户
• 查看关联用户的登录名和最后访问时间
• 跳转到所有用户列表
• 跳转到应用管理

这个功能适合将同一个项目中的不同看板分配给不同客户、部门或运维人员。

高级设置

在 高级 中，可以执行以下操作：

• 复制看板：创建一个新的看板，并复制当前看板中的所有组件和布局。
• 移除看板：删除当前看板。

复制看板时，需要填写新看板名称。看板中的组件会被复制到新看板中，但看板关联用户不会自动复制。