【视频教程】NeuronEX 仪表盘功能使用指南

进入单个仪表盘后，您将看到一个可交互的界面，用于展示和配置数据。

此页面会根据右上角的配置，定时向后端发送请求数据，然后将其展示到对应的 Panel 中。

点击「进入编辑模式」，具体功能效果如下：

• 添加面板：点击左上角的 添加面板
   按钮，向当前仪表盘中添加新的数据展示单元 (Panel)。

• 取消：如果对仪表盘的布局或 Panel 进行了修改但不想保存，可以点击「取消」
  按钮放弃更改。

• 保存仪表盘：对仪表盘的任何修改（如添加/删除 Panel、调整布局、更改 Panel 配置）都需要点击「保存仪表盘」
  按钮才会生效。

在仪表盘右上角，可以控制整个仪表盘的数据展示范围和刷新频率。

时间范围选择器:

• 全局控制：定义所有 Panel 中数据的查询时间跨度。

• 预设范围：提供多种常用的预设时间范围，例如截图中的「最近1小时」。

• 自定义时间段：允许用户选择精确的开始和结束日期与时间。

刷新机制 :

• 自动刷新间隔：选择一个预设的自动刷新时间间隔，例如截图中的「30s」，仪表盘将按此频率自动更新数据。

• 手动刷新：点击刷新图标，立即获取最新数据并更新所有 Panel。

Panel 是仪表盘上显示单个图表、统计值或表格的基本单元。

• 拖拽调整：支持在仪表盘上通过拖拽 Panel 的右下角控制点来调整其大小，或拖动 Panel 头部调整其位置，灵活定制布局。

• 网格对齐：仪表盘使用网格系统（如截图背景所示的虚线网格），帮助 Panel 自动对齐，使布局更加整洁美观。

• Panel 操作菜单：每个 Panel 的右上角通常会有一个三点菜单图标，点击后可对该 Panel 进行编辑、复制、删除等操作。

点击仪表盘视图中的添加面板按钮后，会弹出一个「添加面板」对话框，用于详细配置新的 Panel。

具体对话框布局如下：

1. 左侧 - 查询配置区：

• Query Tabs：例如「Query 1」，允许为一个 Panel (除 Table 类型外) 配置多个数据查询。每个查询对应图表中的一个系列。可以通过点击 +
   来增加新的 Query。

• SQL 输入区：为当前选中的 Query Tab 输入 SQL 查询语句。

• Alias by：为当前 Query 的结果系列指定一个显示别名。这对于区分 Panel 中的多条曲线非常有用。通常要求 SQL 查询结果包含时间戳和单个值列。

2. 右侧 - 面板选项：

• 面板标题：为该 Panel 指定一个有意义的名称（必填项）。

• 图表类型：选择数据的展示方式，当前版本支持：

• Line（折线图）： 适用于展示时序数据的趋势。

• Bar（柱状图）：适用于比较不同类别或时间点的数据量。

• Stat（统计值）：以醒目的方式显示单个关键数值。

• Table（表格）：以表格形式展示详细数据 (Table 类型只支持一个 Query)。

• 单位（Unit）：例如 °C
  , RPM
  , MPa
   等。此信息会显示在图表上或作为数值的后缀。

3. 底部选项：

• SQL 查询使用 $timeFilter 变量：

• 启用/禁用开关：控制是否在 SQL 查询中启用 $timeFilter
   变量。

• 启用时：用户的 SQL 语句中必须包含 $timeFilter
  。

  NeuronEX 会将其替换为基于仪表盘全局时间或该 Panel 预览时间选择器所选定的时间范围条件。

• 禁用时：NeuronEX 会自动在用户 SQL 的基础上拼接时间范围条件。

• 对话框顶部控制：

• 该对话框内也可能包含独立的时间范围选择器和执行查询/刷新按钮，用于在确认添加 Panel 前，针对当前配置的 Query 进行数据预览和测试。

• 对话框操作按钮：

• 取消（Cancel）：关闭「添加面板」对话框，不保存任何配置。

• 执行查询（Execute Queries）：（在截图底部，也可能在对话框顶部）执行当前配置的 SQL 查询，并在对话框内预览结果，帮助用户验证查询的正确性。

• 确认（Confirm）：保存 Panel 配置，并将其添加到仪表盘上。

结语