设备
目录
概览
设备菜单以卡片形式直观地展示所有已注册的设备。每张卡片包含设备图像、连接·健康·注册状态指示灯、今日报警计数、标签数量以及资产树链接。通过左侧边栏的站点·区域·线路筛选，可以快速缩小范围查看所需设备。
该画面用于操作员快速判断以下事项：
- 哪些设备的通信中断了
- 哪些设备的健康诊断处于警告/危险状态
- 今日哪些设备发生了严重报警
路径：左侧菜单 > Equipment > 设备列表 (内部 URL /equipment/index)
画面构成
┌──────────────────────────────────────────────────────────────────┐
│ 설비 총 N개 설비 — 사이트별 모니터링 [타임라인 분석] [↻] │ ← ① 상단
├──────────┬───────────────────────────────────────────────────────┤
│ 🔎 검색 │ ⚙ [검색된 설비: N] 설비 목록 │
│ 조건 입력 │ 필터 조건에 맞는 설비 │
│ 후 검색 │ ─────────────────────────────────────────────────────│
│ [사이트▼] │ ┌──────┐ ┌──────┐ ┌──────┐ ┌──────┐ │
│ [구역 ▼] │ │ 카드 │ │ 카드 │ │ 카드 │ │ 카드 │ │ ← ③ 카드 그리드
│ [라인 ▼] │ │ ... │ │ ... │ │ ... │ │ ... │ │
│ │ └──────┘ └──────┘ └──────┘ └──────┘ │
│ [설비분류▼]│ │
│ [설명] │ │
│ [↺][검색] │ │
└──────────┴───────────────────────────────────────────────────────┘
| 区域 | 位置 | 显示 |
|---|---|---|
| ① 顶部 | 全宽 | 页面标题·设备总数·时间线分析/刷新按钮 |
| ② 左侧边栏 | col-lg-2 | “搜索”筛选面板 — 站点/区域/线路 + 搜索选项，底部为重置·搜索按钮 |
| ③ 右侧 | col-lg-10 | 设备卡片列表 (搜索到的设备数 + 卡片网格) |
顶部 — 页面标题·工具
| 项目 | 形式 | 显示 |
|---|---|---|
| 页面标题 | 左侧 | “设备” + 副标题 총 N개 설비 — 사이트별 모니터링 |
| 时间线分析 | 右侧主按钮 | “时间线分析” — 调用多设备时间线对比画面(openTimeline()) |
| 刷新 | 右侧辅助按钮 + ↻ | 保持左侧筛选条件，仅重新加载卡片列表 |
进入页面时卡片列表为空，必须在左侧边栏设置搜索选项后点击 搜索 才会填充。
左侧边栏 — 搜索·筛选
面板标题为 搜索，副标题为 “输入条件后搜索”。表单分为两个组，两个按钮位于面板底部（页脚）。
1) 站点 / 区域 / 线路
三个选择器被묶在 一个 组中。
| 选择器 | ID | 选项 |
|---|---|---|
| 站点 | site_id | 已注册站点列表 (사이트명 [설명]) — 始终选中一个 |
| 区域 (Area) | area_id | “所有区域” + 该站点的区域列表 (자산명 [설명]) |
| 线路 (Line) | line_id | “所有线路” + 该区域的线路列表 (자산명 [설명]) |
范围选择中没有 «所有站点»。留空的 «所有区域» · «所有线路» 表示 所选站点内的全部。 打开页面时的站点顺序为：地址(URL)中的站点 → 个人资料的 基准站点 → 第一个站点。系统不记录最后一次选择的范围。
更改站点(
changedSite())时，该站点所属的区域(area_list)和线路(line_list)会自动重新填充。 更改区域(changedArea())时，仅该区域所属的线路填充至线路选择器；更改线路(changedLine())时，该线路资产将立即反映在搜索条件中。
2) 搜索选项
| 输入项 | ID | 形式 | 说明 |
|---|---|---|---|
| 设备分类 | asset_class_code | 选择器 — “全部类型” + 已注册设备分类列表 | 缩小至设备指定的设备分类 |
| 描述 | description | 文本输入 — 占位符 “描述关键字” | 设备描述文本关键字 |
设备分类 不是直接输入框，而是下拉菜单。列表来自 基准信息 的设备分类页签。
3) 面板底部按钮
| 按钮 | 动作 |
|---|---|
| ↺ 重置 | resetFilter() — 清空上述所有筛选项和选项 |
| 搜索 | search() — 应用上述所有筛选项和选项以更新卡片列表 |
右侧 — 设备卡片列表
如果没有搜索结果，将显示以下引导：
⚙ 未搜索到设备
请在左侧筛选中调整站点·区域·线路或搜索选项后，点击搜索按钮。
如果有搜索结果，设备将以卡片单位显示在卡片网格(eq-card-list)中。
┌───────────── 우측 영역 헤더 ─────────────┐
│ ⚙ [검색된 설비: N] 설비 목록 │
│ 필터 조건에 맞는 설비 │
└────────────────────────────────────────────┘
| 标头项目 | 显示 |
|---|---|
| 标头标签 | [검색된 설비: N] 설비 목록 — N 为搜索到的设备数 (search_equipment_count)，数量显示在标题 之前 |
| 副标题 | “符合筛选条件的设备” — 固定文本（非搜索条件摘要） |
设备卡片构成
每张卡片(eq-card)由以下区域组成。
┌────────────────────────────────────┐
│ 설비명 (굵게) │ ← header
│ 설비 설명 │ ← desc
├────────────────────────────────────┤
│ 📶 ❤️ 🏷 📅 🥧 │ 🟢 🟡 🔴 │ ← status (점등 5종 + 알람 3종)
├────────────────────────────────────┤
│ │
│ 설비 이미지 (썸네일) │ ← thumb (클릭 시 설비 대시보드)
│ │
├────────────────────────────────────┤
│ 생산 상태 뱃지 │ ← OEE area (active 상태)
├────────────────────────────────────┤
│ 🏷 N ⚙ │ ← footer (태그 수 / 자산 트리 이동)
└────────────────────────────────────┘
卡片顶部 — 名称·描述
| 区域 | 类 | 显示 |
|---|---|---|
| 卡片标头 | eq-card-header | 设备名称(asset_name) — 加粗 |
| 卡片描述 | eq-card-desc | 设备描述(description) — 单行文本 |
5种状态指示灯
卡片状态区域(eq-card-status)左侧横向排列 5 个指示灯。每个指示灯在悬停时通过工具提示显示含义。
| 图标 | ID | 工具提示 | 含义 |
|---|---|---|---|
| 📶 (Wi-Fi) | ${asset_id}_status_connection | “连接状态” | 通信连接状态 (正常连接·连接延迟·连接异常·连接断开·未连接 5 阶段) |
| ❤️ (Heartbeat) | ${asset_id}_status_health | “健康状态” | 资产健康诊断结果 (正常·注意·危险·未知 4 阶段) |
| 🏷 (Tags) | ${asset_id}_status_tag_reg | “标签注册状态” | 设备是否注册了标签 |
| 📅 (Calendar) | ${asset_id}_status_event_reg | “事件注册状态” | 是否注册了资产事件规则 |
| 🥧 (Pie) | ${asset_id}_status_aggregation_reg | “采集注册状态” | 是否注册了资产采集(Aggregation)规则 |
前两个和后三个的颜色变化方式不同。
| 指示灯 | 颜色阶段 |
|---|---|
| 连接状态·健康状态 | 根据诊断结果分多阶段 (灰色 = 未知, 绿色 = 正常, 橙色 = 注意, 红色 = 异常) |
| 标签·事件·采集注册状态 | 仅有绿色或灰色两种 — 已注册为绿色，否则为灰色 |
后三个为灰色并不代表故障，仅表示该设备的标签·事件规则·采集规则尚未注册。
颜色含义请参考 状态代码定义。
3种今日报警计数
状态区域右侧（与左侧 5 个指示灯用竖线分隔）以三种颜色排列今日报警计数。
| 颜色 | ID | 工具提示 | 显示 |
|---|---|---|---|
| 🟢 绿色 | ${asset_id}_count_alarm_info | “今日信息报警” | 信息报警数量 |
| 🟡 橙色 | ${asset_id}_count_alarm_warn | “今日警告报警” | 警告报警数量 |
| 🔴 红色 | ${asset_id}_count_alarm_error | “今日严重报警” | 严重报警数量 |
在数值输入前，全部显示为 -。
设备图像·生产状态·页脚
设备图像 (eq-card-thumb)
- 以缩略图形式显示每台设备注册的图像 (
/asset/image/${asset_id}) - 点击后跳转至
/asset/dashboard/equipment/${asset_id}新窗口 — 设备单位仪表板画面 - 未注册图像的设备显示默认占位图
生产状态徽章 (eq-oee-area)
| ID | 显示 |
|---|---|
${asset_id}_status_active | 当前激活状态(运行/停止/待机/空闲/异常)徽章以颜色显示 |
卡片页脚 (eq-card-footer)
| 项目 | 显示 |
|---|---|
| 🏷 + 标签数 | ${asset_id}_tag_count — 该设备注册的标签数量 |
| ⚙ (齿轮) | 点击进入资产树画面(/asset/tree/index?sel=${asset_id}) — 修改资产元数据 |
时间线分析
顶部的 时间线分析 按钮打开多设备时间线对比画面(/timeline/index)。详细用法请参考下方 设备菜单子画面 — 时间线对比。
设备菜单子画面 (除列表外 2 种)
左侧菜单 Equipment 部分包含 3 个画面。
| 菜单 | 内部 URL | 用途 |
|---|---|---|
| 设备列表 (上述已详述) | /equipment/index | 设备卡片网格监控 |
| 数据查询 | /asset/data/index | 按设备查询领域数据(快照·报警·事件·状态·采集·命令) |
| 时间线对比 | /timeline/index | 多设备时间轴对比 |
ISO 数据(
/asset/plugin/index) 不在 Equipment 中，而是在左侧菜单的独立 ISO 部分 — 与同部分的 ISO 分析(/analysis/index) 在一起。 内容请参阅 ISO 数据及分析。
数据查询画面 (/asset/data/index)
该画面用于按设备单位查询 6 种领域数据之一。
顶部搜索区域
📋 데이터 조회 [기간] [데이터 유형 ▼] [시간 단위 ▼] [건수 ▼] [조회][전체 출력][↻]
| 控制项 | 宽度 | 说明 |
|---|---|---|
期间 (search_time) | 280px | 开始~结束 (中间，加粗)。hidden search_date_from/search_date_to |
数据类型 (data_type) | 120px | 6 个选项 — 快照·报警·事件·状态·采集·命令 |
时间单位 (time_unit) | 110px | 秒/分/时/日单位分组 |
数量 (limit) | 140px | 最近 100(默认)/1,000/2,000/5,000/10,000 条 |
| 查询·全部导出·刷新 | 红色 | search() / downloadCSV() / refresh() |
6 种数据类型
| 代码 | 标签 | 说明 |
|---|---|---|
DATA | 快照 | 定时采样得到的标签值 |
ALARM | 报警 | 该资产的报警历史 |
EVENT | 事件 | 资产单位事件(状态变更等) |
CONTEXT | 状态 | 资产状态(运行/停止/异常)的变更时间点 |
AGGREGATION | 采集 | 时间单位采集结果(平均·合计等) |
COMMAND | 命令 | 发送至资产的命令历史 |
左侧 (col-lg-2) — 资产树面板
与其他设备分析画面相同：站点选择器·资产树·搜索·页脚(资产 ID 预览)。
右侧 (col-lg-10)
1) 各时段数量图表 (hourly_chart, 140px)
| 项目 | 说明 |
|---|---|
| 标头 | 📊 “各时段数量” + 结果摘要(result_txt) |
| 图表 | 按数据类型的时段柱状图 |
| 空状态 | “请在资产树中选择设备并查询。” |
2) 查询结果表格 (data_table)
表格标头根据数据类型动态变更。
默认(快照)列：
| 列 | 宽度 | 说明 |
|---|---|---|
| 时间 | 200px | 测量时间 |
| 资产 ID | 150px | 资产标识符 |
| 数据映射 | 250px | 标签-值对的 JSON |
| 时间戳映射 | 250px | 每个标签的进入时间 |
当数据类型更改为 ALARM/EVENT/CONTEXT/AGGREGATION/COMMAND 时(onDataTypeChange())，标头将重新绘制为符合该类型的列。
时间线对比画面 (/timeline/index)
该画面将多个设备的领域事件(状态/采集/事件/命令)叠加在同一个时间轴上进行对比。
| 数字 | 位置 | 功能 |
|---|---|---|
| ① | 左侧最顶端 | 选择站点 |
| ② | 左侧正文 | 标签树 — 通过复选框 同时选择多个设备 |
| ③ | 顶部 | 期间 — 开始 ~ 结束 |
| ④ | 侧旁 | 时间线类型 · 显示报警 · 数量 |
| ⑤ | 右侧末端 | 查询 · 全部导出(CSV) · 刷新 |
| ⑥ | 时间线头部 | 显示宽度预设 — 10m · 30m · 1h · 6h · 12h · All |
| ⑦ | 正文 | 时间线 — 活动在时间轴上以色条显示 |
| ⑧ | 右侧下方 | 放大 · 缩小 · 左右移动 |
上图即为此状态。请在左侧树中勾选要对比的设备，然后点击 查询。
顶部搜索区域
🔁 타임라인 비교 [기간] [타임라인 유형 ▼] [알람 표시 ▼] [건수 ▼] [조회][전체 출력][필터][↻]
| 控制项 | 宽度 | 说明 |
|---|---|---|
期间 (search_time) | 280px | 开始~结束 |
时间线类型 (timeline_type) | 140px | 4 个选项 — 状态(CONTEXT) / 采集(AGGREGATION) / 事件(EVENT) / 命令(COMMAND) |
显示报警 (show_alarm) | 140px | 显示报警(Y) / 不显示(N, 默认) |
数量 (limit) | 140px | 100/200/300/500/1,000 条 |
| 查询 | 红色 + 🔍 | search() |
| 全部导出 | 红色 + 📄 | downloadCSV() |
条件筛选 (condition_button) | 红色 + 🎚️ | 数据查询条件选项 (默认隐藏, 通过 conditionOption() 展开) |
| 刷新 | 红色 + ↻ | — |
条件输入 (可选)
| 输入项 | 说明 |
|---|---|
condition (350px, 默认隐藏) | 占位符: 컨디션 : VALUE > 10 AND VALUE < 50 AND QUALITY = 192 形式的类 SQL 条件 |
左侧 (col-lg-2) — 资产树
与其他画面相同的树面板 (资产 / 连接页签)。
右侧 (col-lg-10) — 时间线
| 项目 | 说明 |
|---|---|
| 标头 | 🕐 “时间线” + 结果摘要(result_txt) |
| 快速时间范围 | 6 个按钮(10M/30M/1H/6H/12H/ALL) |
| 时间线区域 | 将左侧树中勾选的资产在同一时间轴上以彩色条显示 |
活用
用于同时对比多个设备的运行·停止模式，或分析同一线路内设备间状态变化的偏差。开启报警显示后，同一时间的报警标记将同步显示，便于分析因果关系。
资产单位仪表板 (/asset/dashboard/{level}/{asset_id})
点击设备卡片的图像，将在新窗口打开该资产的详细仪表板。根据资产层级(站点/区域/线路/设备)的 4 个阶段提供不同的仪表板画面。
| 层级 | 内部 URL | 用途 |
|---|---|---|
| 站点 | /asset/dashboard/site/{site_id} | 站点整体 KPI + 所有线路摘要 |
| 区域 | /asset/dashboard/area/{asset_id} | 区域内线路·设备综合 |
| 线路 | /asset/dashboard/line/{asset_id} | 该线路所有设备单页显示 |
| 设备 | /asset/dashboard/equipment/{asset_id} | 单台设备综合仪表板 (最详细) |
设备仪表板 (最详细) — 画面构成
顶部 — 仪表板标题栏
[로고] | 설비명 [▼ 다른 설비] [↻실시간] [<date>] [↻] [✕닫기]
사이트 / 구역 / 라인 / 설비 (브레드크럼)
| 区域 | 说明 |
|---|---|
| 其他设备下拉框 | “跳转至此位置的其他设备” — 同一线路内的其他设备列表 (equip_list) |
| 实时切换 | 点击激活/关闭旋转图标 |
日期选择 (sandbox-container) | 选择日期 — 以该日期的数据更新画面 |
| 前日/后日 | 通过 ← → 按钮切换日期 |
| 刷新 | pageRefresh() |
| 关闭窗口 | self.close() — 仅新窗口模式可用 |
| 面包屑 | 显示 站点 → 区域 → 线路 → 设备 路径 |
左侧 col-lg-8 — 正文面板
面板 1 — 资产信息 (蓝色边框 3px)
| 区域 | 显示 |
|---|---|
| 标头 | 📺 设备名 + (注册日·修改日) |
| 状态指示灯 | 资产状态(asset_status) + 连接状态(connection_status) — 以颜色表示 |
| 图像 | 资产图像或 SVG 图纸 (640×320) |
| OEE 迷你表 | 工作单·产品·班次等该日运行元数据以圆角表形式显示 |
面板 2 — 资产时间线及数据
| 项目 | 说明 |
|---|---|
| 标头 | 📊 “资产时间线及数据” + 结果摘要(result_txt) |
| 时间线跳转 | 右侧按钮 — 跳转至 时间线对比 画面 |
| 时间线区域 | 该日资产事件(状态/采集/事件/命令)的时间条 |
面板 3 — 标签及趋势图表
| 项目 | 说明 |
|---|---|
| 标头 | 📈 “标签及趋势图表 [全部标签 : N 个]” |
| 标签列表跳转 | 右侧按钮 — 跳转至 标签列表 画面 |
| 空状态 | “请在左侧标签列表中选择要显示的标签。” |
| 图表 | 所选标签的时序图表 |
面板 4 — KPI 迷你图表 3 种
| 图表 | 说明 |
|---|---|
| (左侧) OEE | 该日 OEE 趋势 — 空状态显示 “没有可显示的数据。” |
| (中间) RAM | 可靠性/可维修性趋势 |
| (右侧) EMS | 能源消耗趋势 |
面板 5 — 设备状态
| 区域 | 说明 |
|---|---|
| 标头 | 🔋 “设备状态 [全部报警数量 : N 件]” |
| 设备运行状态环形图 | RUN/IDLE/STOP/FAULT 比例 |
| 报警分布 | 按优先级统计的报警数量 |
面板 6 — 最近设备报警列表
| 项目 | 说明 |
|---|---|
| 标头 | 🔔 “最近设备报警列表” |
| 报警搜索 | 右侧按钮 — 跳转至 报警搜索 |
| 列表 | 按时间倒序显示最近 N 件报警 |
右侧 col-lg-4 — 侧边面板
资产单位的附加信息面板垂直排列。
| 面板 | JSP | 显示 |
|---|---|---|
| 报警 | pannel/alarm.jsp | 资产单位报警摘要 |
| 状态 | pannel/context.jsp | 资产上下文(当前运行状态) |
| 采集 | pannel/aggregation.jsp | 资产采集(平均/最大/最小) |
| 事件 | pannel/event.jsp | 资产事件历史 |
| 命令 | pannel/command.jsp | 发送至资产的命令历史 |
站点/区域/线路仪表板差异
上层级仪表板汇总显示子资产。
| 层级 | 差异点 |
|---|---|
| 站点 | 所有线路的 KPI 合计·环形图·子资产列表 |
| 区域 | 该区域所属线路·设备的运行状态综合 |
| 线路 | 该线路所有设备以格状单页显示 |
详细手册不再单独提供，其模式与本资产仪表板(设备)一致，熟练后即可自然使用其他层级。
活用模式
| 分析流程 | 画面流程 |
|---|---|
| 现场操作员监控画面 | 设备仪表板 → 开启新窗口全屏 → 现场显示屏 |
| 异常发生后精密分析 | 设备卡片 → 仪表板 → 选择日期 → 时间线 + 趋势 + 报警综合分析 |
| 与其他设备快速对比 | 设备仪表板 → 右上角其他设备下拉框 → 同线路其他设备 |
活用场景
| 场景 | 使用方法 |
|---|---|
| 站点单位夜间巡检 | 通过站点选择器选择夜间运行站点 → 搜索 → 快速识别红色指示灯(连接断开/严重报警)的卡片 |
| 特定线路的设备状态 | 按 站点 → 区域 → 线路 依次缩小范围搜索 → 在一个画面查看线路内所有设备 |
| 按设备分类监控 | 在搜索选项的 “设备分类” 下拉框中选择分类 → 仅搜索该系列设备 |
| 识别报警激增资产 | 通过排序·筛选，优先确认红色报警计数较高的卡片 |
| 通过图像识别设备 | 利用卡片的缩略图进行视觉快速匹配 |
| 修改资产元数据 | 通过卡片页脚的 ⚙ 按钮进入资产树画面 |
常见问题
Q. 进入页面后卡片为空。 A. 进入页面时搜索结果为空，必须在左侧边栏点击 搜索 按钮后才会显示卡片。将区域·线路设为 “所有区域” · “所有线路” 后点击搜索，将显示所选站点的全部设备。
Q. 选择了站点，但区域选择器为空。 A. 可能是该站点未注册区域，或进入页面时区域尚未加载。请再次尝试更改站点选择器，区域列表将重新填充。若确实无区域，请在 工厂管理 > 模型 中注册区域。
Q. 卡片的指示灯颜色全部为灰色。 A. 表示该设备未注册标签/事件/采集，或通信从未进入。请先在 工厂管理 > 标签 中确认标签是否已注册。
Q. 报警计数全部显示为 -。
A. 报警数据尚未加载。请稍候或点击右上角刷新按钮。若仍未显示，请在 报警 画面确认该设备是否发生报警。
Q. 设备图像处仅显示占位图。 A. 该设备未注册图像。可在资产树画面选择设备并上传图像。
Q. 点击卡片会跳转到哪里？ A. 点击图像区域将在新窗口打开该设备的单台仪表板画面。点击卡片页脚的 ⚙ 按钮将跳转至资产树编辑画面。
Q. 搜索结果过多导致画面卡顿。 A. 请按 站点 → 区域 → 线路 顺序缩小范围，并结合使用 “设备分类” 搜索选项以减少结果数。
Q. 可以更改搜索结果的排序吗？ A. 画面按资产树的注册顺序显示。如需更改排序，请在资产树画面中调整顺序。
Q. 想一次性对比多个设备的运行时间。 A. 请使用顶部的 时间线分析 按钮进入多设备对比画面。