控制台导航与通用界面
目录
概述
本文档说明登录后所有界面通用的控制台框架。当前控制台由顶部域搜索、右侧实时工具栏、左侧业务分组菜单、基于卡片·图表·表格的正文组成。
完整菜单地图与业务流程图可在全部菜单结构与运维流程图中一览。
操作员通常按以下流程使用。
- 在仪表板中确认站点地图、管道、KPI 和基础设施健康状况。
- 点击异常 KPI,下钻到连接状态、报警、设备、每日统计。
- 通过顶部域搜索直接查找站点·资产·标签·OPC·边缘·流程·报警配置 ID,跳转到详情界面。
- 在右上角 LIVE·报警·提示中确认新的异常信号。
旧文档中的"摘要"首页在当前 UI 中已整合为仪表板。内部 URL 仍为
/map/index。
整体界面框架
┌──────────────┬────────────────────────────────────────────────────────────┐
│ PlantPulse │ ☰ [도메인 검색 사이트 / 에셋 / 태그 / OPC / ... CTRL+K] │
│ 좌측 메뉴 │ [LIVE] [알람] [전체] [설정] [매뉴얼] [사용자] │
├──────────────┼────────────────────────────────────────────────────────────┤
│ Overview │ 페이지 제목 / 현재 업무 설명 │
│ Connectivity │ ┌────────────────────────────────────────────────────────┐ │
│ Factory │ │ 지도·카드·차트·테이블·트리·드로어 등 선택 화면 본문 │ │
│ ... │ └────────────────────────────────────────────────────────┘ │
└──────────────┴────────────────────────────────────────────────────────────┘
| 区域 | 作用 |
|---|---|
| 顶部栏 | 菜单折叠、全局域搜索、LIVE 状态、报警、全屏、环境设置、手册、用户菜单 |
| 左侧菜单 | 基于实际服务器 Web nav-role/admin.jsp 的业务分组菜单 |
| 正文顶部 | 页面标题、当前站点/业务上下文、查询·刷新·跳转按钮 |
| 正文区域 | 地图、卡片、图表、表格、树、详情面板 |
| 提示区域 | 在右上角简短显示实时诊断·报警事件 |
顶部栏
顶部栏在所有界面中行为一致。
| 顺序 | 元素 | 用法 |
|---|---|---|
| 1 | 菜单切换 | 折叠或展开左侧菜单。在窄屏下用于腾出正文空间。 |
| 2 | 域搜索 | 点击或按 Ctrl+K / Mac Cmd+K 打开。搜索整个控制台的域 ID。 |
| 3 | LIVE 状态 | WebSocket 连接状态。正常时 LIVE 圆点以脉冲形式显示。 |
| 4 | 报警 | 显示最近报警数量与预览。可从菜单页脚跳转到报警。 |
| 5 | 全屏 | 切换浏览器全屏。 |
| 6 | 环境设置 | 打开画面缩放、报警弹窗、诊断日志显示等用户界面设置。 |
| 7 | 手册 | 在新标签页中打开 GitBook 手册。 |
| 8 | 用户菜单 | 提供个人资料、修改密码、退出登录。 |
顶部搜索与各界面的搜索表单不同。各界面搜索用于过滤当前列表,域搜索则用于查找整个控制台的主要 ID 并跳转到详情界面。
域集成搜索
域搜索调用 /api/v4/domain/search 并以 DataTable 显示结果。点击 ID 单元格会复制到剪贴板,操作按钮则跳转到各域的详情界面。
搜索对象
| 域 | 示例 | 跳转目标 |
|---|---|---|
| SITE / AREA / LINE | S1_LOTTE_CS_DJ_SITE | 仪表板、资产树、模型 |
| EQUIPMENT / ASSET | ASSET_LINE_01 | 资产树、设备详情 |
| TAG | TAG_EDGE_00303_90000 | 标签、数据查询、趋势 |
| OPC | OPC_MAIN_01 | 连接详情 |
| EDGE | EDGE-303 | 边缘详情 |
| ALARM_CONFIG | 报警配置 ID | 高级 EQL 报警 |
| FLOW | 流程 ID | 流程列表·编辑 |
| USER / SECURITY | 用户·安全策略 ID | 系统·安全管理 |
| EMPLOYEE / CUSTOMER / PRODUCT | 生产主数据 ID | 生产管理界面 |
搜索结果的使用
| 操作 | 结果 |
|---|---|
Ctrl+K / Cmd+K | 无论焦点在哪个输入框,都会打开域搜索对话框。 |
| 点击域标签 | 仅过滤该域。 |
| 点击 ID | 将 ID 复制到剪贴板。 |
| 点击详情跳转按钮 | 跳转到各域的详情界面或列表界面。 |
| 点击最近搜索词 | 用相同关键词重新搜索。 |
运维过程中,直接搜索报警消息或诊断提示中出现的 ID,可大幅缩短定位到问题对象的时间。
左侧菜单结构
当前左侧菜单按服务器 Web 的集成菜单渲染标准排列如下。菜单分组名以英文显示,实际菜单名以中文标签显示。
Overview
| 菜单 | 内部 URL | 用途 |
|---|---|---|
| 仪表板 | /map/index | 站点地图、数据管道、平台健康、核心 KPI |
| 统计 | /statistics/index | 年度热力图与所选日期的运营统计 |
Connectivity
| 菜单 | 内部 URL | 用途 |
|---|---|---|
| 协议 | /connect/index | 注册 OPC/PLC/Modbus/DB/API 等数据源 |
| 连接状态 | /connect/status | 监控全部连接的正常·延迟·异常·断开·未连接状态 |
| 边缘 | /edge/index | 现场边缘设备状态与详细控制 |
Factory Model
| 菜单 | 内部 URL | 用途 |
|---|---|---|
| 模型 | /model/index | 站点·区域·产线·设备层级模型 |
| 资产 | /asset/tree/index | 资产树与详细属性 |
| 标签 | /tag/index | 采集标签定义与状态 |
| 本体 | /ontology/index | 语义模型·关系定义 |
| 元数据 | /metadata/index | 各域的扩展属性 |
| 基准信息 | /basedata/index | 运营基准值与通用代码 |
Production
| 菜单 | 内部 URL | 用途 |
|---|---|---|
| 客户 | /customer/index | 客户主数据 |
| 产品 | /product/index | 产品主数据 |
| 员工 | /employee/index | 作业人员·负责人信息 |
| 排班表 | /calendar/index | 班次与运营排程 |
| 工单 | /order/index | 生产作业指令 |
Equipment
| 菜单 | 内部 URL | 用途 |
|---|---|---|
| 设备列表 | /equipment/index | 设备卡片与进入设备级仪表板 |
| 数据查询 | /asset/data/index | 按资产·标签查询采集数据 |
| 时间线对比 | /timeline/index | 标签·设备之间的时间轴对比 |
ISO
| 菜单 | 内部 URL | 用途 |
|---|---|---|
| ISO 数据 | /asset/plugin/index | 用于 OEE/RAM/EMS 计算的各设备原始数据 |
| ISO 分析 | /analysis/index | 基于 ISO 22400 的 KPI 分析 |
Data
| 菜单 | 内部 URL | 用途 |
|---|---|---|
| 流 | /stream/index | 实时时序流式图表 |
| 趋势 | /storage/index | 标签时序趋势与采样分析 |
| 快照 | /snapshot/index | 按间隔的时序快照 |
| 数据导出 | /data/index | 标签时序数据查询·CSV 导出 |
| 对象 (BLOB) | /blob/store | 图像·文档·二进制文件存储库 |
Alarm
| 菜单 | 内部 URL | 用途 |
|---|---|---|
| 报警 | /alarm/index | 实时报警列表。左侧菜单显示信息·警告·严重计数徽章 |
| 报警高级检索 | /alarm/advsearch/index | 按时间段·标签·状态·优先级条件检索 |
| 报警可视化分析 | /alarm/analysis/index | 矩阵、热力图、排行、趋势分析 |
| 高级 EQL 报警 | /alarm/config/index | 基于 EQL 的报警规则设置 |
Visualization
| 菜单 | 内部 URL | 用途 |
|---|---|---|
| 画布 | /canvas/index | 基于 SVG 的现场监控界面 |
Automation
| 菜单 | 内部 URL | 用途 |
|---|---|---|
| 流程 | /flow/index | 自动化图列表·编辑。左侧菜单显示错误计数徽章 |
| 流程执行历史 | /flow/log | 流程执行日志与失败历史 |
| EQL 查询 | /query/index | 执行实时事件查询 |
| 语句 | /statement/index | 管理已部署的 EQL statement |
Standard
| 菜单 | 内部 URL / 外部端口 | 用途 |
|---|---|---|
| 命名空间 | /uns/tree | Unified Namespace 层级与 Kafka/MQTT/SparkplugB 主题预览 |
| 目录 | /catalog/index | 数据目录 |
| OPC-UA | http://[현재호스트]:12780 | 在新窗口中打开 OPC-UA 标准工具。 |
| AAS V3 | http://[현재호스트]:8091/ui/ | 在新窗口中打开 AAS V3 UI。 |
System
| 菜单 | 内部 URL / 外部端口 | 用途 |
|---|---|---|
| 用户 | /user/index | 用户账户管理 |
| 安全策略 | /security/index | 密码·访问安全策略 |
| API 令牌 | /token/index | 用于外部集成的 API 令牌 |
| 监控 | /monitoring/index | 基础设施健康·管道·引擎指标 |
| 诊断 | /diagnostic/index | 系统诊断事件 |
| 日志 | /log/index | 应用日志 |
| 设置 | /config/index | 系统键值设置 |
| 环境信息 | /env/view | 按属性查询环境配置 |
| 集群 | /cluster/index | 集群节点状态 |
| HA | /ha/index | 高可用配置状态 |
| 审计 | /audit/index | 审计日志 |
实时通知与提示
右上角的提示会简短显示新的诊断事件或设备状态变化。
진단 · 192.168.0.41
설비 상태 변경 - 설비=[ASSET_DJ_M_16_2], RUN -> FAULT
| 项目 | 含义 |
|---|---|
| 标题 | 通知种类与发生的设备或模块 |
| 正文 | 状态变化、报警内容、诊断消息摘要 |
| 颜色 | 按信息·警告·严重级别进行强调 |
| 后续确认 | 报警在报警、设备状态在设备、系统事件在诊断中追踪 |
提示只是信号。在实际采取措施前,请在相关界面重新确认时间、对象 ID 与详细日志。
通用界面模式
状态颜色
| 颜色 | 一般含义 | 示例 |
|---|---|---|
| 绿色 | 正常 | 连接正常、基础设施 UP、设备健康正常 |
| 橙色 | 注意·延迟 | 连接延迟、警告报警、处理延迟 |
| 红色 | 异常·严重 | 连接异常、严重报警、引擎错误 |
| 灰色 | 未连接·未确认 | 无数据、尚无采集记录 |
准确的代码含义请以状态代码定义为准。
列表与详情
大多数业务界面采用 顶部搜索 → 列表表格 → 点击行查看详情 的模式。
| 步骤 | 说明 |
|---|---|
| 选择搜索条件 | 时间段、站点、状态、关键词、显示条数 |
| 查询 | 按当前条件刷新列表或卡片 |
| 点击行 | 打开该域的详情界面或抽屉 |
| 刷新 | 对实时数值存疑时,按上次条件重新查询 |
时间范围
报警·诊断·日志·数据查询界面提供快捷时间范围。
| 按钮 | 用途 |
|---|---|
10M / 30M | 追踪刚刚发生的故障 |
1H / 6H / 12H | 分析当日班次时段 |
ALL | 显示搜索条件的全部时间段 |
推荐运维动线
交接班开始
- 在仪表板中确认通信连接率、当日采集、当日报警、设备开动率、设备可用率、OEE。
- 在地图上确认是否有红色·橙色站点或连接状态标签。
- 在右侧健康栏中确认缓存、WS、MQTT、Kafka、事件DB、时序状态。
- 在每日统计中对比前一日与今日的采集量·报警量。
报警发生
- 通过右上角提示或报警徽章确认新报警。
- 在报警中缩小时间段与站点范围并打开详情。
- 将标签·资产 ID 输入域搜索,跳转到设备·数据查询界面。
- 若为重复报警,检查高级 EQL 报警、流程、EQL 帮助,巡检规则与自动化状态。
连接异常
权限与菜单显示
左侧菜单与角色无关,对所有人都相同。 三种角色看到的菜单列表完全一致。
权限差异不体现在菜单上,而体现在界面内部。即使能打开菜单,查询·修改·删除·控制也可能因角色和服务器安全策略而被禁止。
| 角色 | 一般范围 |
|---|---|
| ADMIN | 全部运营·配置·安全·系统管理 |
| API | 用于外部系统集成的账户。需同时授予安全策略 |
| USER | 以查询为主。无变更权限 |
因无权限而功能受限时,请向安全管理员申请变更角色。详细的账户管理请参考安全管理。
常见问题
Q. 看不到以前的"摘要"菜单。
A. 界面改版后,首页菜单名已整合为仪表板。内部 URL 仍为 /map/index。
Q. 도구 菜单中的时序引擎·SQL 项目消失了。
A. 左侧菜单中以新窗口打开的外部项目只有 Standard 的 OPC-UA 和 AAS V3 两项。一般的时序查询请使用 Data 分组的趋势、数据导出、快照界面。
Q. 菜单能看到,但没有保存按钮或点击后被阻止。
A. 菜单列表与角色无关,均相同显示;实际可执行的操作则在界面内部按角色区分。如需权限,请向安全管理负责人申请变更角色。
Q. 用顶部搜索查询了数据,但当前表格没有变化。
A. 顶部搜索用于全局域跳转。若要过滤当前表格,请使用各界面正文顶部的搜索表单。
Q. 提示消失后还能再看到内容吗?
A. 报警可在报警、系统事件在诊断、详细应用日志在系统的日志界面中重新查询。
Q. 看不到左侧菜单。
A. 请点击左上角的菜单切换按钮。浏览器窗口较窄时可能会自动折叠。