设备
目录
概述
设备菜单以卡片形式一览所有已注册的设备(Equipment)。每张卡片包含设备图像、连接·健康·注册状态指示灯、今日报警计数、标签数、资产树链接。左侧边栏的站点·区域·产线筛选器可快速筛选出所需设备。
运营人员可通过此界面快速判断以下情况：
- 哪些设备通信已断开
- 哪些设备在健康诊断中显示警告/危险
- 今天哪些设备发生了严重报警
路径：左侧菜单 > Equipment > 设备列表 (内部 URL /equipment/index)
界面组成
┌──────────────────────────────────────────────────────────────────┐
│ 설비 총 N개 설비 — 사이트별 모니터링 [타임라인 분석] [↻] │ ← ① 상단
├──────────┬───────────────────────────────────────────────────────┤
│ 🔎 검색 │ ⚙ [검색된 설비: N] 설비 목록 │
│ 조건 입력 │ 필터 조건에 맞는 설비 │
│ 후 검색 │ ─────────────────────────────────────────────────────│
│ [사이트▼] │ ┌──────┐ ┌──────┐ ┌──────┐ ┌──────┐ │
│ [구역 ▼] │ │ 카드 │ │ 카드 │ │ 카드 │ │ 카드 │ │ ← ③ 카드 그리드
│ [라인 ▼] │ │ ... │ │ ... │ │ ... │ │ ... │ │
│ │ └──────┘ └──────┘ └──────┘ └──────┘ │
│ [공통유형▼]│ │
│ [설명] │ │
│ [↺][검색] │ │
└──────────┴───────────────────────────────────────────────────────┘
| 区域 | 位置 | 显示内容 |
|---|---|---|
| ① 顶部 | 全宽 | 页面标题·设备总数·时间线分析/刷新按钮 |
| ② 左侧边栏 | col-lg-2 | "搜索"筛选面板 — 站点/区域/产线 + 搜索选项，底部有重置·搜索按钮 |
| ③ 右侧 | col-lg-10 | 设备卡片列表(搜索到的设备数 + 卡片网格) |
顶部 — 页面标题·工具
| 项目 | 形式 | 显示内容 |
|---|---|---|
| 页面标题 | 左侧 | "设备" + 副标题 총 N개 설비 — 사이트별 모니터링 |
| 时间线分析 | 右侧主按钮 | "时间线分析" — 调用多设备时间线比较界面(openTimeline()) |
| 刷新 | 右侧辅助按钮 + ↻ | 保留左侧筛选条件，仅重新加载卡片列表 |
进入页面时卡片列表为空，需在左侧边栏设置搜索选项后点击搜索才能填充。
左侧边栏 — 搜索·筛选
面板标题为搜索，副标题为"输入条件后搜索"。表单分为 2 个组，底部有 2 个按钮。
1) 站点 / 区域 / 产线
三个选择器作为一个组统一包装。
| 选择器 | ID | 选项 |
|---|---|---|
| 站点 | site_id | "全部站点" + 已注册的站点列表 (사이트명 [설명]) |
| 区域 (Area) | area_id | "选择区域" + 站点所属的区域列表 (자산명 [설명]) |
| 产线 (Line) | line_id | "选择产线" + 区域所属的产线列表 (자산명 [설명]) |
更改站点时(
changedSite())，该站点所属的区域(area_list)和产线(line_list)会自动重新填充。 更改区域时(changedArea())，产线选择器中仅会填充该区域所属的产线，更改产线时(changedLine())，该产线资产会立即反映在搜索条件中。
2) 搜索选项
| 输入项 | ID | 形式 | 说明 |
|---|---|---|---|
| 公共类型 | common_table_type | 选择器 — "全部类型" + 已注册的公共类型列表 | 按分配给设备的域公共类型进行筛选 |
| 描述 | description | 文本输入 — placeholder "描述关键词" | 设备描述文本关键词 |
公共类型不是自由输入框，而是下拉列表。列表中仅显示系统中实际注册的类型，如果找不到所需类型，说明还没有该类型的设备。
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 个指示灯。每个指示灯在 hover 时通过工具提示显示含义。
| 图标 | 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 个灯用竖分线分隔)以 3 种颜色显示今日报警计数。
| 颜色 | 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)
在单一时间轴上并排比较多个设备的域事件(状态/集计/事件/命令)。
顶部搜索区域
🔁 타임라인 비교 [기간] [타임라인 유형 ▼] [알람 표시 ▼] [건수 ▼] [조회][전체 출력][필터][↻]
| 控件 | 宽度 | 说明 |
|---|---|---|
时间段 (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, 默认隐藏) | placeholder: 컨디션 : 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 合计·圆环图·下级资产列表 |
| 区域 | 该区域所属产线·设备的运行状态综合 |
| 产线 | 产线所有设备单屏网格显示 |
不单独提供详细手册，采用与此资产仪表板(设备)相同的模式，熟悉后会自然掌握其他级别的使用。
应用模式
| 分析流程 | 界面流程 |
|---|---|
| 现场运营者监控界面 | 设备仪表板 → 新窗口全屏显示 → 现场显示屏 |
| 故障发生直后的精细分析 | 设备卡片 → 仪表板 → 选择日期 → 时间线 + 趋势 + 报警综合分析 |
| 与其他设备快速对比 | 设备仪表板 → 右上角其他设备下拉框 → 同产线其他设备 |
应用场景
| 场景 | 使用方法 |
|---|---|
| 站点级夜间巡检 | 用站点选择器选择夜班运营站点 → 搜索 → 快速识别红灯指示(连接断开/严重报警)的卡片 |
| 特定产线的设备状态 | 依次缩小站点 → 区域 → 产线范围搜索 → 产线内所有设备单屏显示 |
| 按设备类型监控 | 在搜索选项"公共类型"下拉框中选择类型 → 仅搜索该类型设备 |
| 识别报警激增的资产 | 通过排序·筛选，从红色报警计数大的卡片开始查看 |
| 通过图像快速识别设备 | 用卡片缩略图进行视觉快速匹配 |
| 修改资产元数据 | 点击卡片页脚的 ⚙ 按钮进入资产树界面 |
常见问题
问：我进入页面，但卡片是空的。 答：进入页面时搜索结果为空，需在左侧边栏点击搜索按钮才能显示卡片。即使站点保留为"全部站点"，也可直接点击搜索。
问：我选了站点，但区域选择器是空的。 答：该站点可能未注册区域，或区域在页面进入时未完成加载。请再次更改站点选择器，区域列表会重新填充。如果确实没有区域，请在工厂管理 > 模型中注册区域。
问：卡片的指示灯都是灰色的。 答：该设备可能未注册标签/事件/集计，或从未接收到通信数据。请先在工厂管理 > 标签中确认标签是否已注册。
问：报警计数都显示为 -。
答：报警数据还未加载。请稍候或点击右上角的刷新按钮。如仍未显示，请在报警界面确认该设备的报警发生情况。
问：设备图像位置只显示占位符。 答：该设备未注册图像。可在资产树界面选中设备后上传图像。
问：点击卡片会跳转到哪里？ 答：点击图像区域会在新窗口打开该设备的单台仪表板界面。卡片页脚的 ⚙ 按钮跳转到资产树编辑界面。
问：搜索结果太多，页面很慢。 答：依次缩小站点 → 区域 → 产线，同时结合"设备公共类型"搜索选项，可减少结果数量。
问：能改变搜索结果的排序吗？ 答：界面按资产树注册顺序显示。若需改变排序，请在资产树界面调整顺序。
问：我想一次比较多台设备的运行时间。 答：使用顶部时间线分析按钮打开多设备比较界面。