数据点
目录
- 概述
- 公共左侧区域 — 标签树面板
- 流界面 (
/stream/index) - 趋势界面 (
/storage/index) - 快照界面 (
/snapshot/index) - 数据输出界面 (
/data/index) - 应用场景
- 常见问题
- 相关界面
概述
Data 组是用于按 4 种视角查询和分析已采集时序数据的界面集合。
| 子菜单 | 内部 URL | 用途 |
|---|---|---|
| 流 | /stream/index | 以折线图显示所选标签的实时传入数据 |
| 趋势 | /storage/index | 以图表和表格分析所选时间段内的标签数据 |
| 快照 | /snapshot/index | 以表格形式查询按固定间隔采样的代表值 |
| 数据输出 | /data/index | 以 CSV/Excel 格式批量提取数据 |
四个界面共享左侧样式相同的 标签树面板，仅右侧区域根据各界面功能有所不同。
公共左侧区域 — 标签树面板
流、趋势、快照均使用左侧 col-lg-3 宽度的相同标签树面板。
┌─────────────────────────────┐
│ 🗂 모델 [💬] [🔍] [📋] │ ← 헤더 + 도구 3개
│ ─────────────────────────── │
│ 🏭 [ 사이트 ▼ ] │ ← 사이트 셀렉터
│ ─────────────────────────── │
│ [에셋] [연결] │ ← 탭 (ADMIN만 연결 탭 표시)
│ ─────────────────────────── │
│ 🔍 검색... │ ← 토글 시 노출
│ ─────────────────────────── │
│ ▶ 자산 트리 │ ← 자산/태그 계층 트리
│ ▶ MOTOR-001 │
│ ▼ MOTOR-001.SPEED │
│ ▼ MOTOR-001.TEMP │
│ ... │
│ ─────────────────────────── │
│ 오브젝트 ID : (hover 시 표시) │ ← 푸터
└─────────────────────────────┘
3 个头部工具
| 按钮 | 图标 | 操作 |
|---|---|---|
| 标签说明显示选项 | 💬 | 切换在树中标签旁是否同时显示说明 |
| 标签搜索 | 🔍 | 切换树上面的搜索输入框 |
| 复制所选标签名 | 📋 | 将已勾选的标签名复制到剪贴板 |
站点选择器
| 项 | 形式 | 操作 |
|---|---|---|
| 输入组左侧 | 🏭 (工业图标) | — |
| 选择器 | 사이트명 [설명] 选项 | 更改时(changeSite()) 将该站点的资产/连接重新加载到树中 |
标签页 (资产 / 连接)
| 标签页 | 可见用户 | 树内容 |
|---|---|---|
| 资产 (默认) | 所有 | 站点 → 区域 → 产线 → 设备 → 标签 资产树 |
| 连接 | ADMIN | OPC 服务器 → 通道 → 标签 (通信单元树) |
每个标签页都有可切换展开的独立搜索输入框(assetSearchInput / opcSearchInput)。
底部 — 对象 ID 预览
将鼠标悬停在标签或资产上时，底部 对象 ID 栏会显示该项的标识符，使操作员无需查看资产名，也能快速确认 ID。
流界面 (/stream/index)
在左侧树中勾选标签并点击 开始流式传输 ，即可在右侧图表中看到数据实时传入的画面。
顶部工具
🔀 스트림 [▶ 스트리밍 시작] [■] [↻]
| 按钮 | 操作 |
|---|---|
| 开始流式传输 (▶, 红色) | stream() — 开始订阅已勾选标签的实时推送 |
| 停止 (■) | stop() — 停止流式传输 (仅在开始后激活) |
| 刷新 (↻) | refresh() — 重置界面 |
图表显示选项
图表面板头部右侧工具。
| 项 | ID | 默认值 | 说明 |
|---|---|---|---|
| 显示 (分钟) | display_minutes | 5 | 图表中显示的时间跨度 (以分钟为单位) |
| 添加虚拟点 | (按钮) | — | addVPoint() — 向图表添加用户自定义虚拟点(基于脚本计算) |
| 设置 | (按钮) | — | setDisplayCount() — 显示数量及其他选项对话框 |
实时图表区域
图表面板正文包含以下区域。
| 项 | 显示 |
|---|---|
result_txt | 头部右侧小字 — 当前流式传输状态摘要 |
stream-content (列表) | 每个已勾选的标签一行，显示折线图 + 当前值 |
开始流式传输前，显示以下提示。
🖼 [流图标]
标签数据流 可以查看实时标签数据。 请在左侧标签树中选择标签名后，点击 [▶ 开始流式传输] 按钮。
使用步骤
- 在左侧树中勾选想要查看的标签 (可多选)
- 点击 开始流式传输
- 图表随实时传入数据自动更新
- 若所需时间跨度(分钟)不同，调整右上角的 显示 (分钟) 值
- 查看完毕后，点击 ■ 停止
趋势界面 (/storage/index)
用于以时序图表和聚合表分析所选时间段内标签数据的界面。
| 编号 | 位置 | 功能 |
|---|---|---|
| ① | 左上角 | 总数据 — 迄今累积的总点数及更新时间 |
| ② | 左侧 | 站点选择 + 资产 / 连接 标签页 — 选择以哪个轴查看树 |
| ③ | 左侧正文 | 标签树 — 使用复选框将多个标签放到同一张图表中 |
| ④ | 右上角 | 时间段 和 查询 |
| ⑤ | 图表标题栏 | 图表显示选项 — 线型 · 图例 · TR 显示 · 显示点数 · 设置 · Excel 下载 |
| ⑥ | 其下方 | 缩放预设 — 5M · 10M · 30M · 1H · 3H · 6H · 12H · 1D · 7D · 15D · 30D · All |
| ⑦ | 正文 | 时序图表 |
| ⑧ | 下方 | 标签聚合统计 — 时间段内条数 · 首/尾值 · 最低/最高 · 平均/总和 |
上图即此状态 — 「没有可显示的数据」。请在左侧树中勾选标签后， 点击 查询。
顶部搜索区域
📈 트렌드 [기간 ▭ ▭▭▭▭▭▭▭▭] [샘플링 ▼] [조회] [🎚️] [정지] [전체화면]
| 控件 | 宽度 | 说明 |
|---|---|---|
时间段输入 (search_time) | 280px | 开始~结束日期时间 (居中对齐，粗体). 点击时打开日期范围选择器。以隐藏字段 search_date_from / search_date_to 传递 |
采样选择器 (term) | 自动 | 默认禁用。通过 🎚️ 按钮激活 (请参阅下方 采样选项) |
查询 (submit_button) | 红色 + 🔍 | search() — 按条件更新图表 + 表格 |
采样选项切换 (sampling_button) | 红色 + 🎚️ | samplingOption() — 显示/隐藏采样选择器 |
停止查询 (cancel_button) | 红色 + ⏹ | cancel() — 取消进行中的查询 (仅在查询中激活) |
| 全屏 | 红色 + 🔗 | fullscreen() — 在新窗口全屏打开趋势界面 |
采样选项
采样选择器(term)默认隐藏，通过 🎚️ 按钮打开。当数据量过大导致图表缓慢时，用于通过采样仅获取轻量代表值。
| 选项 | 含义 | 建议使用 |
|---|---|---|
(빈 값) — 원본(RAW) | 所有数据 | 默认值。短时段(小时/天) |
LTTB [0.1%] | 使用 LTTB 算法仅提取 0.1% | 长期(月)趋势概览 |
LTTB [0.5%] | 仅提取 0.5% | 长期(月)分析 |
LTTB [1%] | 仅提取 1% | 中期(周)分析 |
LTTB [5%] | 仅提取 5% | 短期(天)分析 |
LTTB [10%] | 仅提取 10% | 详细精确分析 |
1분 주기 | 1 分钟间隔简单采样 | 短期(天)采样 |
5분 주기 | 5 分钟间隔 | 中期(周)采样 |
30분 주기 | 30 分钟间隔 | 长期(月)采样 |
1시간 주기 | 1 小时间隔 | 长期趋势采样 |
LTTB(Largest-Triangle-Three-Buckets) 是一种最有效保留时序视觉形态的降采样算法，专为图表显示优化。
图表显示选项
图表面板头部右侧的内联工具栏。
| 项 | ID | 选项 | 说明 |
|---|---|---|---|
| 图表类型 | chart_type | 折线 · 面积 · 柱状 · 平滑折线 · 平滑面积 | 图表序列的表现方式 |
| 阶梯折线 | show_step_line | 标准折线 / 阶梯折线 | 像数字信号一样的阶梯形表现 |
| 报警显示 | show_alarm_flags | 显示报警 / 不显示 | 在图表上标出报警发生时刻的标记 |
| TRIP 显示 | show_trip_line | 显示 TRIP / 不显示 | 仅在多 Y 轴模式下显示跳闸临界线 |
| C.HEIGHT | chart_height | 100/150(默认)/200/250/300/400/500 | 图表高度 (px) |
| 设置 | (按钮) | — | configure() — 附加图表设置对话框 |
| Excel 下载 | (按钮) | — | downloadXLS() — 将结果下载为 Excel |
图表区域
| 项 | ID | 说明 |
|---|---|---|
| 图表 | result_chart | 600px 高度的时序图表 |
| 结果计数 | result_count_txt / result_time_txt | 图表右上角 — 显示的数据点数量及查询耗时 |
| 无数据提示 | chart_no_data | "没有可显示的数据。" (未选择标签或结果为空时) |
| 加载指示 | ws_wait_text | "正在查询数据..." (旋转图标) |
| 执行时间 | exec_time_txt | 面板底部小字 — 上次查询耗时 |
标签聚合表
图表下方以表格形式显示所选标签的聚合统计(storage_table)。
┌──────────────────────────── 헤더 (그룹) ────────────────────────────┐
│ 태그ID │ 태그명 │ 데이터 타입 │ 단위 │ 집계 (4 컬럼) │ 액션 │
│ │ │ │ │ 카운트 │첫|끝│최저|최고│평균|합계│ │
└────────────────────────────────────────────────────────────────────┘
| 列 | 宽度 | 显示 |
|---|---|---|
| 标签ID | 90px | 标签标识符 |
| 标签名 | 220px+ | 便于人类阅读的标签名称 |
| 数据类型 | 80px | INT/FLOAT/BOOL/STRING 等 |
| 单位 | 50px | 测量单位 (例如: °C, kPa, rpm) |
| 计数 | 60px | 查询时段内的数据点数量 |
| 首值 | 末值 | 60px | 开始/结束时刻的值 |
| 最低 | 最高 | 60px | 最小 · 最大值 |
| 平均 | 总和 | 60px | 平均值 · 总和 |
| 操作 | 40px | 行级工具按钮 |
时间线添加对话框
可在图表上叠加显示资产单位的事件时间线。
| 项 | 说明 |
|---|---|
| 触发方式 | 图表工具中的独立按钮 (位置可能因图表而异) |
| 弹窗标题 | 🎯 "添加时间线" |
| 提示 | "将资产事件时间线添加到图表中。请选择资产后，点击 [添加时间线] 按钮。" |
| 资产选择 | t_asset_id 选择器 (240px) — 从已注册设备列表中选择 |
| 确认 | 添加时间线 按钮 |
时间线添加后，图表底部将用彩色条带绘制该资产的事件(运行/停止/异常)，便于与时序数据进行对比。
快照界面 (/snapshot/index)
快照与趋势结构类似，但专用于以表格形式查看**按固定间隔(分钟)**采样的值，为此进行了优化。
顶部搜索区域
🔪 스냅샷 [기간 ▭▭▭▭] [간격 ▼] [조회] [↻]
| 控件 | 说明 |
|---|---|
时间段输入 (search_time) | 与趋势相同 (280px, 居中对齐) |
间隔选择器 (term) | 系统定义的快照周期选项 (例如: 1_MIN/5_MIN/30_MIN/1_HOUR/1_DAY) |
| 查询 | search() — 按条件更新表格 |
| 刷新 | refresh() — 重置界面 |
左侧区域
与流/趋势相同的标签树面板 (站点选择器 · 资产/连接标签页 · 搜索)。
右侧区域
按时间顺序显示在左侧树中勾选的标签的快照值。呈现为表格形式，每行为一个时刻，每列为一个标签的值。
应用示例: 以 1 分钟间隔观察 5 个标签一周 → 整理为 1 万行 × 5 列的形式，便于导入外部工具。
数据输出界面 (/data/index)
用于查询单个标签的时序数据并以 CSV 下载的界面。
| 编号 | 位置 | 功能 |
|---|---|---|
| ① | 顶部 | 标签名输入 — 通过自动完成选择一个标签 |
| ② | 时间段 — 开始 ~ 结束 | |
| ③ | 条数 — 最近 100 / 200 / 300 / 500 / 1,000 条 | |
| ④ | 查询 | |
| ⑤ | 最右侧 | CSV 下载 · 查询条件选项 · 刷新 |
| ⑥ | 正文 | 数据列表 — 8 列 (如下) |
| ⑦ | 表格底部 | 条数显示及上一页/下一页 |
上图即此状态 — 「无数据」。需选择标签并点击 查询 才会填充。
数据列表 — 8 列
| 列 | 内容 |
|---|---|
| 时间 | 数据点时间戳 |
| 值 | 采集到的值 |
| 单位 | 标签的单位 |
| 数据类型 | String / Integer / Double / Boolean … |
| 质量 | OPC 质量代码 |
| 错误码 | 采集错误代码 |
| 延迟[MS] | 发生时刻与接收时刻的差值 |
| 属性 | 附加属性 |
查询条件
通过右侧 🎚️ 按钮展开条件输入区域。可按界面占位符所示的
컨디션: VALUE > 10 AND VALUE < 50 形式对值进行筛选查询、输出。
界面副标题已明确说明 — 「标签时序数据查询 / CSV 输出」。
此界面没有通过 .xlsx 接收的功能。如需在 Excel 中打开，请打开下载的 CSV。
(将标签列表导出为 Excel 的功能是在 标签界面 的
「Excel 下载」，与本界面功能不同。)
标签数据输出上限为 1,000,000 行，资产数据输出上限为 100,000 行
(POINT_EXPORT_LIMIT · ASSET_DATA_EXPORT_LIMIT)。达到上限时，会静默输出被截断的文件，不会报错，
请分时段多次下载。
资产数据输出 (/data/as-index)
相同操作，但以资产而非标签为单位。界面副标题为「按资产的时序数据查询 / CSV 输出」，输入的是资产名而非标签名。
标签数据输出 (/data/index) | 资产数据输出 (/data/as-index) | |
|---|---|---|
| 选择对象 | 单个标签 | 单个资产 |
| 输出列 | 时间 · 值 · 单位 · 类型 · 质量 · 错误码 · 延迟 · 属性 | 资产ID · 资产名 · 数据映射 · 时间戳映射 |
| 上限 | 1,000,000 行 | 100,000 行 |
| 附加面板 | — | 时间线 — 按资产时间段显示数据活动 |
由于映射到资产的各标签值会以映射形式合并到一行中输出，如需按设备查看某一时刻的整体状态，使用此界面更为方便。
应用场景
| 场景 | 界面 | 设置示例 |
|---|---|---|
| 当前产线运行监控 | 流 | 在产线资产树中勾选核心 5 个标签 → 显示 5 分钟 → 开始 |
| 昨日夜班时段趋势分析 | 趋势 | 时间段 21:00~07:00 / 采样 1 分钟 / 图表类型折线 |
| 一个月远程产线对比 | 趋势 | 时间段 1 个月 / 采样 LTTB 1% / TRIP 显示 ON |
| 报警发生前状况还原 | 趋势 | 时间段报警时刻 ±10 分钟 / 报警显示 ON / 添加时间线 |
| 30 分钟间隔的日报数据 | 快照 | 时间段 24 小时 / 间隔 30_MIN |
| 迁移数据至外部分析工具 | 数据输出 | 1 周 + 核心 5 个标签 → CSV 下载 |
常见问题
Q. 已开始流式传输，但图表未填充数据。 A. 请确认是否已在左侧树中勾选标签。另外，请检查 仪表板 的管道卡是否为 0 — 可能是数据接入本身已中断。
Q. 趋势查询太慢。 A. 这是数据量过大的情况。请通过 🎚️ 按钮打开 采样 选择器，使用 LTTB (例如 1%) 或按时间周期 (例如 5 分钟) 进行降采样。
Q. 图表序列过多，难以阅读。 A. 在图表右上角的图例中点击序列名称，可切换该序列的显示/隐藏。此外，在左侧树中取消勾选标签即可从图表中移除该标签。
Q. 已开启报警显示选项，但图表上未出现标记。 A. 表示在查询时间段内该标签未发生报警。请先在 报警 界面中确认发生历史。
Q. 未看到 TRIP 线。 A. TRIP 线仅在多 Y 轴模式（多个标签各自拥有独立 Y 轴时）下显示。在单 Y 轴模式下，为了图表可读性，不显示该线。
Q. 流和趋势的区别是什么？ A. 流查看的是当前正在传入的实时数据，趋势查看的是过去已存储的数据。此外，流会自动更新，而趋势需操作员显式点击查询才会更新。
Q. 什么是虚拟点？ A. 虚拟点并非实际传感器标签，而是通过计算其他标签的值生成的自定义点。例如：两个温度传感器的差值、压力×流量等。在流界面的 添加虚拟点 按钮中定义。
Q. Excel 下载得到的是空文件。 A. 当图表为空或查询结果为空时，会生成空文件。请先确认图表正常绘制后再下载。
Q. 在一个界面勾选过多标签会怎样？ A. 为确保图表可读性和渲染速度，建议一次勾选不超过 10~20 个。若需更多，请使用 LTTB 采样以减少数据量。