数据绑定
编辑器有两套数据配置面板，根据组件类型自动切换。所有数据绑定均在右侧面板的「数据」Tab 中完成。
数据面板类型
编辑器根据组件类型自动选择数据面板：
| 面板 | 适用组件 |
|---|---|
| 简化数据面板（SimplifiedDataPanel） | 基本图表（柱状图、折线图、饼图、散点图、表格类等）、自定义组件（form / table / composite 模式）、单值组件（文字、翻牌器、进度图、水球图、表盘、雷达图等）、组件编辑模式、分组隔离编辑下的子图表 |
| 标准数据面板（ChartData） | 预置 IoT 组件（Presets，chartFrame=composite）、增强组合容器、其他未匹配组件 |
装饰组件、图标组件无「数据」Tab。标准分组组件的数据由子组件各自管理。
进入方式：画布上选中组件 → 右侧面板点击「数据」标签页。
简化数据面板（主要）
简化数据面板覆盖大多数图表和自定义组件，是主力数据配置面板。提供三种数据源：
静态
直接编辑组件的内嵌数据，与标准面板的「静态数据」使用相同的 JSON 编辑器（详见 5.3.1）。格式随组件类型匹配：
- 表单模式（form）：字段-值对编辑
- 表格模式（table）：行列表格编辑器，支持增删行列
- 复合模式（composite）：组合适配器配置
IoT 设备（推荐）
连接物联网平台设备数据，是自定义组件和预置 IoT 组件推荐的业务数据源。
查询类型
面板顶部「查询类型」下拉选择：
| 类型 | 说明 | 支持图表 |
|---|---|---|
| 属性数据（property） | 查询设备物模型属性值，支持最新值和历史时序 | 全部图表 |
| 设备状态统计（deviceStatus） | 统计在线 / 离线 / 未激活设备数及比率 | 指标卡、表格 |
| 设备信息（deviceInfo） | 获取设备元数据（信号强度、网络类型等） | 设备详情、对比视图 |
数据模式（传统设备模式）
属性数据支持两种数据模式，通过「数据模式」切换：
| 模式 | 说明 | 典型场景 |
|---|---|---|
| 最新值（轮询） | 读取设备属性 Shadow 缓存，返回当前最新值，支持轮询刷新 | 实时仪表盘、设备状态卡片 |
| 历史时序 | 按时间范围查询属性历史记录，支持后端/前端分桶聚合 | 趋势折线图、柱状对比图 |
最新值模式返回
[{ name, value }]格式，历史时序返回[{ time, prop1, prop2 }]格式。
历史时序聚合粒度（仅限 log 模式）：
| 粒度 | 示例 | 说明 |
|---|---|---|
| 分时 | 10m、1h | 短时间范围推荐 |
| 按天 | 按天聚合 | 7~30 天趋势 |
| 按周 | 按周聚合 | 长期趋势 |
| 按月 | 按月聚合 | 年度对比 |
时间范围快捷选项：1 小时 / 6 小时 / 24 小时 / 7 天 / 30 天 / 自定义。自定义模式下支持日期时间选择器。
聚合函数（历史时序）：最新值（last）/ 平均值（avg）/ 最大值（max）/ 最小值（min）/ 累计（sum）。
统计范围与设备选择
区域过滤：下拉选择区域（支持多选），设备列表按区域精确过滤。选择「按区域」时系统自动展开子区域设备。
产品：下拉选择已创建的产品。若当前区域无产品则回退到全量产品列表。
设备：支持按名称或别名搜索（远程搜索），单选或多选取决于图表类型。
属性字段选择
选择产品后自动加载该产品物模型的属性列表，按标识符（identifier）展示：
- 勾选需要查询的属性（支持多选）
- 系统自动提取属性单位，填充图表坐标轴标签和后缀
- 部分图表类型（饼图最新值、胶囊图、单系列折线图）仅支持单选
属性选择后自动触发静默预览，右侧图表实时渲染。
模板聚合模式（高级）
当「数据模式」选择非「传统设备模式」时，支持以下聚合模式：
| 模式 | 说明 | 配置项 |
|---|---|---|
| 单值统计卡（singleStat） | 单一指标数值展示 | 属性字段 + 时间范围 + 聚合函数 |
| 趋势图（trend） | 时间序列趋势 | 属性字段 + 时间范围 + 聚合粒度 + 分组维度 |
| 聚合统计（aggregate） | 排行/占比 | 属性字段 + 时间范围 + 分组维度（区域/设备）+ 排序（升/降）+ TopN |
字段来源可选「按产品」（从具体产品的物模型属性中选）或「通用物模型字段」（跨产品通用属性，推荐用于多产品聚合场景）。
限制：历史时序最大 300 个时间桶，超限自动校正聚合粒度或时间范围。最大数据获取量 1000 条。
数据视图
系统根据查询条件自动推导输出视图，无需手动选择：
| 查询条件 | 输出视图 | 列结构 |
|---|---|---|
| 1 个设备 + N 个属性 | 单设备多属性 | 宽表，列为属性名 |
| N 个设备 + 1 个属性 | 多设备同属性 | 宽表，列为设备名 |
输出字段（设备状态 / 设备信息）
设备状态统计可选择以下指标：总设备数、在线/离线/未激活设备数、在线率/离线率/未激活率、系统运行天数/小时、系统启动时间。
设备信息查询选择产品 → 选择设备 → 自动加载该设备的信号强度、网络类型等字段，勾选后渲染。
图表兼容矩阵
不同图表类型对 IoT 查询类型的支持不同，系统会自动灰选不兼容的选项：
| 图表 | 属性数据 | 属性最新值 | 属性历史时序 | 设备状态统计 | 设备信息 |
|---|---|---|---|---|---|
| 折线图（LineCommon / LineGradients / LineGradientSingle / LineLinearSingle） | ✅ | ❌ | ✅ | ❌ | ❌ |
| 柱状图（BarCommon / BarCrossrange / BarLine） | ✅ | ✅ | ✅ | ✅ | ❌ |
| 饼图（PieCircle / PieCommon） | ✅ | ✅ | ❌ | ✅ | ❌ |
| 胶囊柱图（CapsuleChart / CapsuleCommon） | ✅ | ✅ | ❌ | ✅ | ✅ |
| 表格（TablesBasic / TableScrollBoard） | ✅ | ✅ | ✅ | ✅ | ✅ |
| 滚动列表（TableList） | ✅ | ✅ | ✅ | ❌ | ✅ |
| 文字组件（TextCommon） / 翻牌器（FlipperNumber） | ✅ | ✅ | ✅ | ✅ | ✅ |
| 雷达图（Radar） | ✅ | ✅ | ✅ | ✅ | ❌ |
| 进度图（Process） / 水球图（WaterPolo） | ✅ | ✅ | ✅ | ✅ | ❌ |
| 数字/表盘/倒计时（Number / Dial / CountDown） | ✅ | ✅ | ✅ | ✅ | ✅ |
选中不兼容组合时，查询类型下拉和模式单选会自动灰选禁用项，并显示提示文字。
动态数据（高级/通用 API）
适用于通用 HTTP 接口、公共数据池或非 IoT 场景的数据。选中后首先选择「获取途径」：
| 获取途径 | 说明 | 配置项 |
|---|---|---|
| 从公共数据池 | 引用已创建的数据集，分组过滤 | 选择分组 → 选择数据集 → 动态参数（API 传参） → 预览返回数据 |
| 自定义专属请求 | 临时 HTTP 请求，仅对当前组件生效 | 请求类型（GET/POST/PUT/PATCH/DELETE） → 接口地址 |
两种途径共用的后续配置：
| 配置区 | 说明 |
|---|---|
| 启用轮询 | 开关 + 间隔数值 + 单位（秒 / 分钟） |
| 数据提取与过滤 | 可视化条件过滤（字段选择 + 匹配规则 + 目标值）+ JS 高级脚本过滤 |
| 字段绑定映射 | 维度（X 轴/分类）下拉 + 指标（Y 轴/数值）多选下拉 |
| 执行请求并渲染图表 | 手动触发数据拉取和图表刷新按钮 |
面板顶部有警告提示：「动态数据适用于通用 HTTP 接口、公共数据池或非 IoT 场景的系统级指标。强业务语义场景建议优先使用『IoT 设备』。」
标准数据面板
预置 IoT 组件和增强组合容器使用标准数据面板（ChartData），提供三种数据源类型：
| 类型 | 适用场景 |
|---|---|
| 静态数据 | 固定 Mock 数据，JSON 编辑器直接编辑 |
| 动态请求 | 对接外部 HTTP API，支持 GET/POST/PUT/PATCH |
| 公共接口 | 全局共享数据源，一处配置多处复用 |
IoT 设备数据绑定仅在简化数据面板中可用（见 5.2.2）。
静态数据
直接编辑 ECharts dataset 格式的 JSON 数据：{ dimensions: string[], source: any[][] }。
动态请求
| 配置项 | 说明 |
|---|---|
| 请求地址 | 完整的 API URL |
| 请求方法 | GET / POST / PUT / PATCH |
| 请求头（Headers） | 自定义 HTTP Header |
| 请求参数（Params） | URL 查询参数 |
| 请求体（Body） | POST 请求体 JSON |
| 轮询间隔 | 组件级刷新间隔（秒） |
公共接口
添加方式：页面配置 → 全局请求配置 → 新建条目。引用时在「公共接口」类型下拉选择。一处修改、全局生效。
字段映射
适用面板：简化面板（动态数据模式） / 标准面板（动态请求、设备属性模式）
数据加载后，配置字段映射告知图表如何读取数据。简化面板在「数据提取与过滤」下方展示「维度」和「指标」两个下拉选择器：
| 映射模式 | 适用图表 | 配置 |
|---|---|---|
| XY 模式 | 折线图、柱状图、散点图 | X 轴字段（维度）+ Y 轴字段（指标，可多选） |
| nameValue 模式 | 饼图、漏斗图 | 名称字段 + 值字段（单选） |
系统根据图表类型智能推导默认映射，IoT 数据自动附带元数据填充坐标轴标签。部分图表仅支持单指标（最多选 1 个），面板会给出提示。
适配器系统
适用面板：全部（所有图表组件自动匹配）
数据加载后，系统按图表类型自动匹配专用适配器，将原始数据转换为 ECharts 可用的配置。自定义组件封装时可指定适配器类型，实例化时自动绑定：
| 适配器 | 适用图表 |
|---|---|
| 柱状图适配器 | 柱状图、柱状图&折线图 |
| 横向柱适配器 | 横向柱状图 |
| 折线图适配器 | 折线图、面积图、散点图 |
| 饼图适配器 | 饼图、环形图、漏斗图 |
| 雷达图适配器 | 雷达图 |
| 默认适配器 | 未注册图表兜底 |
自动刷新机制
适用面板：全部（动态数据源模式）。静态数据无需刷新。
| 层级 | 位置 | 说明 |
|---|---|---|
| 全局 | 页面配置 → 全局请求配置 | 所有动态数据源组件默认生效 |
| 组件 | 组件「数据」Tab → 启用轮询 | 优先级高于全局，可设为 0 不刷新。简化面板为开关 + 间隔（秒/分钟），标准面板为间隔下拉 |
保护机制：配置变更递增版本号，过期响应自动丢弃；编辑模式下预览开关开启时跳过真实请求。
JS 过滤脚本
适用面板：简化面板（动态数据模式 →「选项2：JS 高级脚本过滤」）/ 标准面板（动态请求模式）
支持自定义 JavaScript 脚本在数据返回后、渲染前动态转换数据格式。
简化面板中位于「数据提取与过滤」区域内，提供开关 + 代码编辑区（textarea），预设默认过滤函数骨架。首选 Worker 线程池执行（超时 3s），降级至白名单 Proxy 沙箱（40 个安全全局对象）。执行前需通过安全策略检查。
组合组件数据绑定
适用组件：增强组合容器（Groups），使用 SimplifiedDataPanel 的 CompositeAdapterEditor。
增强组合容器使用组合适配器：
| 概念 | 说明 |
|---|---|
| 数据源（DataSource） | 顶层统一数据源（dynamic / iot / static） |
| 输出口（DataOutput） | identity / pick / aggregate / toDataset / script |
| 子组件绑定（ChildBinding） | 输出映射到子组件属性路径 |
数据源密码安全
不属于数据绑定面板，在「数据源管理」中生效（详见 2.6 节）。
编辑数据源连接信息时，密码类字段以 *** 脱敏回显。未修改时后端自动保留原始值。
更新日志
2026/8/4 15:04
查看所有更新日志
7e927-于
