4. 创建第一个仪表板：仪表板创建流程、添加数据源、选择可视化小部件、保存与发布
本章将引导你完成从零创建第一个 ThingsBoard 仪表板的完整流程。你将掌握仪表板的核心创建步骤、数据源绑定方法、小部件选择策略以及发布共享机制。通过本节的动手实践，你将建立起对 ThingsBoard 仪表板设计工作流的系统性认知。
4.1 仪表板创建流程概览
创建仪表板遵循一个清晰的五步流程，从入口到发布环环相扣。下表总结了每个阶段的核心任务与产出物：
| 步骤 | 操作入口 | 核心任务 | 产出物 |
|---|---|---|---|
| 1. 新建仪表板 | 左侧菜单 → 仪表板 → "+" | 输入名称、描述、选择默认布局 | 空白仪表板容器 |
| 2. 添加数据源 | 小部件编辑 → 数据源配置 | 选择设备、遥测/属性、时间范围 | 数据绑定关系 |
| 3. 选择小部件 | 小部件库 → 类别浏览 | 按场景筛选、预览效果 | 可视化组件实例 |
| 4. 布局与配置 | 拖拽放置、属性面板 | 调整大小、对齐、设置样式 | 排版完成的仪表板 |
| 5. 保存与发布 | 右上角保存按钮 → 发布 | 保存草稿、设置公开/私有 | 可访问的仪表板实例 |
4.2 新建仪表板：从空白到容器
登录 ThingsBoard 后，在左侧导航栏找到 "仪表板" 菜单项，点击右上角的 "+" 按钮，选择 "创建新的仪表板"。在弹出的对话框中，你需要填写以下信息：
- 标题： 仪表板的显示名称，例如"车间温湿度监控"。
- 描述： 可选，用于说明仪表板的用途或版本。
- 默认布局： 选择"桌面"、"平板"或"手机"作为主要设计视图。
点击"添加"后，系统会创建一个空白的仪表板容器，并自动进入编辑模式。此时你看到的是一个带有网格背景的空白画布，所有后续的小部件都将放置在这个网格上。
4.3 添加数据源：让仪表板"活"起来
数据源是仪表板的核心驱动力。没有数据源的小部件只是静态装饰。在 ThingsBoard 中，数据源通常指向设备上报的 遥测数据 或 属性数据。添加数据源的步骤如下：
- 在编辑模式下，点击画布上的 "添加小部件" 按钮。
- 从小部件库中选择一个合适的小部件（例如"数字显示"或"时序图"）。
- 在小部件编辑器的 "数据源" 标签页中，点击 "添加数据源"。
- 配置以下关键参数：
| 参数 | 说明 | 示例值 |
|---|---|---|
| 类型 | 数据来源类型：设备遥测、设备属性、实体字段等 | 设备遥测 |
| 设备 | 选择已注册到平台的设备实体 | 温度传感器_01 |
| 键 | 遥测或属性的具体字段名称 | temperature |
| 标签 | 数据系列在图表中的显示名称 | 车间温度 |
| 时间范围 | 数据回溯的窗口长度 | 最近 1 小时 |
temp 但你在数据源中填写了 temperature，小部件将无法获取数据。请务必与设备端上报的字段名保持一致。
4.4 选择可视化小部件：匹配数据与场景
ThingsBoard 提供了丰富的小部件库，按功能分为多个类别。选择小部件时，需要根据数据特性和展示目标进行匹配。下表列出了常用小部件类别及其适用场景：
| 类别 | 代表小部件 | 适用场景 | 数据要求 |
|---|---|---|---|
| 数字 | 数字显示、仪表盘 | 实时数值监控（温度、压力） | 单点遥测值 |
| 图表 | 时序折线图、柱状图 | 趋势分析、历史对比 | 时间序列数据 |
| 地图 | 设备位置地图 | 资产定位、轨迹回放 | 经纬度属性 |
| 控制 | 开关、滑块 | 远程设备控制（继电器、阀门） | RPC 命令 |
| 状态 | 指示灯、状态卡片 | 设备在线/离线、报警状态 | 布尔值或枚举属性 |
选择小部件时，可以点击小部件卡片上的 "预览" 按钮，查看其在默认数据下的渲染效果。这能帮助你快速判断该小部件是否符合你的视觉预期。
4.5 保存与发布：从草稿到生产
完成小部件的添加和布局调整后，最后一步是保存并发布仪表板。ThingsBoard 的保存机制分为两个层级：
- 保存草稿： 点击右上角的 "保存" 按钮，将当前编辑状态保存为草稿。草稿仅对编辑者可见，适合进行迭代修改。
- 发布仪表板： 保存草稿后，点击 "发布" 按钮（或通过仪表板列表页的发布操作），使仪表板对具有相应权限的用户可见。
发布时，你可以设置仪表板的 访问权限：
| 权限级别 | 可见范围 | 适用场景 |
|---|---|---|
| 私有 | 仅创建者可见 | 开发调试、个人监控 |
| 公开 | 所有登录用户可见 | 团队协作、管理层展示 |
| 指定客户 | 仅特定客户用户可见 | 项目交付、客户门户 |
4.6 完整创建示例：温湿度监控仪表板
为了巩固上述知识，下面通过一个完整的示例演示从零创建"温湿度监控仪表板"的过程。假设你已有一个上报 temperature 和 humidity 遥测数据的设备。
- 新建仪表板： 标题输入"车间环境监控"，描述可选，选择桌面布局。
- 添加第一个小部件： 点击"添加小部件"，在"数字"类别中选择"数字显示"。
- 配置数据源：
- 类型：设备遥测
- 设备：选择你的温湿度传感器设备
- 键：
temperature - 标签：当前温度
- 时间范围：最新值
- 复制小部件： 按住 Ctrl 拖拽复制一个数字显示小部件，将数据源键改为
humidity，标签改为"当前湿度"。 - 添加时序图： 添加一个"时序折线图"小部件，数据源添加两个系列：
temperature和humidity，时间范围设为最近 1 小时。 - 布局调整： 将两个数字显示小部件并排放在顶部，时序图放在下方，拉伸至合适宽度。
- 保存并发布： 点击保存，然后点击发布，选择"公开"权限。
完成上述步骤后，你的第一个 ThingsBoard 仪表板就正式上线了。你可以通过仪表板列表页点击进入，实时查看设备上报的温湿度数据。