工厂管理

概述
画面构成 — 6个子菜单
模型画面 (/model/index)
资产画面 (/asset/tree/index)
- 左侧 — 资产树
- 右侧 — 资产详情表单 + 子表格
标签画面 (/tag/index)
本体画面 (/ontology/index)
元数据画面 (/metadata/index)
基准信息画面 (/basedata/index)
确定工厂模型
应用场景
常见问题
相关画面

概述

Factory Model 组是用于注册、修改和删除工厂结构及领域元信息（资产·标签·本体·元数据·基准信息）的区域。它由 6 个子画面组成，全部与运营元存储直接连接。

子菜单	内部 URL	用途
模型	`/model/index`	添加站点 + 逻辑/物理模型映射 + 确定模型
资产	`/asset/tree/index`	编辑资产树 (站点→区域→线→设备)
标签	`/tag/index`	已注册标签列表·搜索·批量删除·导出 Excel
本体	`/ontology/index`	注册资产分类体系 (类别·元属性)
元数据	`/metadata/index`	按领域自定义的元属性键值
基准信息	`/basedata/index`	注册代码主表·基准值

在开始运营前，必须在此菜单中注册所有站点、资产和标签，仪表板、数据点、报警等其他画面才具有实际意义。

画面构成 — 6个子菜单

运营流程：

[모델]   →   [에셋]   →   [태그]
사이트 추가      자산 계층 등록      태그 등록·매핑
   │              │                  │
   └─────[온톨로지·메타데이터·기준정보 보강]──────┘
   │
   └→ [팩토리 모델 확정] (배포)

画面	使用频率	开启时机
模型	中	重新添加站点或调整逻辑↔物理映射时
资产	高	更改资产层级·资产元数据时
标签	非常高	注册/修改标签·设置报警带 — 使用最频繁
本体	中	整理分类体系时
元数据	低	添加自定义元属性时
基准信息	低	调整代码主表时

模型画面 (`/model/index`)

顶部工具

🗂 모델                     [✓ 팩토리 모델 확정] [💾 메타 스토어 백업] [↻]

按钮	动作
确定工厂模型	`deployAssetToEvent()` — 将注册的资产/标签应用于事件规则并反映在规则引擎中 (参考下方确定工厂模型)
元存储备份	`backup()` — 备份整个元存储 (供管理员保管)
刷新	`refresh()`

指南框

🏭 添加站点及设置物理/逻辑模型 请注册需要连接工业数据的工厂 (站点)。然后连接到该站点关联的 OPC 或其他工业协议，完成物理模型。之后将物理模型转换为逻辑模型，即可完成站点结构设置。

站点列表 (卡片网格)

사이트 목록 [전체 N개의 사이트]                    [➕ 사이트 추가]
─────────────────────────────────────────────────
[ 사이트 카드 ] [ 사이트 카드 ] [ 사이트 카드 ] ...

每个站点卡片 (site-panel, 240px) 显示以下内容：

区域	显示
顶部 (site-title)	站点 ID (黄色背景)
正文 (site-body)	🏭 站点图标 + 站点名称 + 说明 — 点击时在下方加载该站点的资产/连接树 (`loadTreeData()`)
页脚 (site-footer)	🔧 修改 (`editSite()`) / 📁 删除模型 (`deleteModels()`) / 🗑 删除站点 (`deleteSite()`)

添加站点表单

输入	说明
企业名称	站点所属企业。安装环境下仅有一家企业
站点 ID	仅允许英文大写/数字/`_` — 以 `SITE_` 开始
站点名称	人类可识别的名称
位置	通过 [在地图中选择] 确定坐标
说明	自由文本
运行状态	运行状态的大阶段
站点代码 (ERP/MES)	ERP·MES 调用的工厂代码 (可选)
地址	营业场所地址 (可选)

逻辑·物理模型 (左·右树形图)

选择站点卡片后，下方会展开左右两个树形图。

左侧 — 资产 [逻辑模型] (`assetTreeDiv`)

动作	动作 ID	说明
刷新模型树	`loadTreeData(last_tree_site_id)`	重新加载树形图
资产搜索	`searchItem('Asset')`	切换树顶部的搜索输入框
添加资产	`showAddModal('Asset')`	新资产添加模态框
修改资产	`showModifyModal('Asset')`	修改所选资产
删除资产	`deleteItem('Asset')`	删除所选资产

逻辑模型树显示为站点→区域→线→设备，标签附加在设备上。这是由运营人员根据业务语义构成的层级。数据层级在其之上多设了一层企业 (共五层，出现在 V5 · MCP 响应中)，但控制台的树形图中不显示企业 — 企业在地图 (/map/index) 和站点表单中修改。

右侧 — 连接 [物理模型] (`opcTreeDiv`)

动作	动作 ID	说明
连接搜索	`searchItem('OPC')`	切换树顶部的搜索输入框
添加连接	`addOpc()`	跳转至连接管理的注册表单

物理模型是以 OPC 服务器→通道→标签形式的通信单位树。

逻辑 ↔ 物理映射

通过拖拽/映射将左侧的逻辑资产节点与右侧的物理 OPC 标签连接。这样映射后，系统即可知道逻辑资产 (例如：A 线的电机) 产生的数据来自哪个物理标签 (例如：OPC-LINE-A 的 PDI_001)。

添加/修改资产模态框

点击左侧工具栏的 添加资产 或 修改资产 按钮将打开标准模态框。应用 V2026.05 设计系统，模态框所有表单统一为 fieldset + form-stack 结构。

┌─🏭 에셋 추가 및 수정─────────────────── × ─┐
│                                          │
│  ┌─🗂 상위 에셋──────────────────────┐   │
│  │ 상위 에셋 ID    [읽기 전용]          │   │
│  │ 상위 에셋 명    [읽기 전용]          │   │
│  └──────────────────────────────────┘   │
│  ┌─📦 에셋 정보─────────────────────┐   │
│  │ 에셋 ID         [입력]               │   │
│  │ 에셋 명         [입력]               │   │
│  │ 설명            [입력]               │   │
│  └──────────────────────────────────┘   │
│                                          │
├──────────────────────────────────────────┤
│                       [× 취소] [💾 저장]  │
└──────────────────────────────────────────┘

区域	显示
模态框页眉	🏭 图标 + 标题 + × 关闭
上级资产 fieldset	父节点的 ID·名称 (只读 — 显示树形图选择值)
资产信息 fieldset	新资产的 ID·名称·说明 (输入)
模态框页脚	× 取消 / 💾 保存 (保存时执行 `saveForm('Asset')`)

所有输入框标签统一使用 form-label control-label 类，确保宽度和对齐一致。其他画面的模态框 (工作单·事件·排班表等) 同样采用 fieldset + form-stack 模式。

资产画面 (`/asset/tree/index`)

用于深度编辑资产树，并在同一画面中定义资产单位的元数据·标签·连接关系。左侧为树形图，右侧为详情表单 + 时间轴 + 子表格/标签页。

资产画面 — 数字为阅读顺序

数字	位置	作用
①	左上	站点选择器 — 选择要查看哪个站点的树形图
②	左侧正文	资产树 — 站点 → 区域 → 线 → 设备。选择节点后右侧内容随之更改
③	左下	对象 ID — 在树中悬停鼠标时，该节点的领域 ID 将在此显示
④	右上	资产信息 — 所选节点的基本信息·状态卡片·图像。上图为选择单个设备的状态，未选择任何内容时仅显示 «请选择资产» 引导
⑤	右上边缘	保存 — 保存 ④ 中修改的内容
⑥	右下	时间轴 — 该资产的连接·健康状态趋势
⑦	画面右上	确定工厂模型 — 将编辑后的模型反映到引擎中 (下方)

如果在树中未选择任何内容，右侧为空是正常现象

上图即为此状态 — 「未选择资产」。并非故障。

左侧 — 资产树

🗂 모델 — 사이트 → 구역 → 라인 → 설비   [💬] [🔍] [📋]
사이트: [▼]
[에셋 트리 / 연결 트리]
─────────────────────
🔗 오브젝트 ID:  -      ← 트리에서 호버 시 도메인 ID 표시 (footer)

页眉图标	动作
💬 (气泡) — 显示标签说明	切换是否在树中显示标签节点的说明
🔍 搜索	切换树内文本搜索输入框
📋 复制	将所选标签名复制到剪贴板

右侧 — 资产详情表单 + 时间轴 + 子/标签页

空状态 — 未选择资产

如果在左侧树中未选择任何节点，右侧详情区域将显示空状态引导。

       🟦 (큐브 아이콘)
   에셋이 선택되지 않았습니다
왼쪽 에셋 트리에서 [에셋명을 선택]하여 주십시오.

资产信息面板 — 全彩渐变状态卡片 2 个

选择资产后，面板正文最顶端将显示一行元信息 (类型 + 注册/修改日期) + 连接状态 / 健康状态 两个卡片（位于左侧）。

卡片	图标	显示
连接状态 (`connection_status`)	📶 Wi-Fi	全彩渐变 — 🟢 正常 / 🟡 延迟 / 🔴 异常 / ⬛ 断开 / ⚪ 未知
健康状态 (`health_status`)	💗 心跳	全彩渐变 — 🟢 正常 / 🟡 注意 / 🔴 危险

每个卡片采用图标 + 标签 + 值 (例如："正常连接", "危险") 的形式显示在渐变背景上，以便远距离通过颜色立即确认状态。

资产图像 (右侧)

若已注册图像，则以 SVG/PNG 格式显示。无图像时显示空状态：

       🖼 (이미지 아이콘)
       이미지 없음
선택한 노드에 등록된 이미지가 없습니다.

基本信息面板 (输入)

输入	path	placeholder/说明
资产 ID	`asset_id`	只读
资产名称	`asset_name`	placeholder: `예) 조립 1라인 (한글·영문·숫자·공백·_ . - ( ) & , / :)`
设备分类	`asset_class_code`	该层级的分类 — 选择器。列表来自基准信息的该层分类标签页
说明	`description`	自由文本

资产图像面板

控件	动作
📂 选择文件	选择 PNG/SVG (建议 640×320)
☁ 上传	将所选图像注册至该资产

时间轴面板 — 时间趋势

选择资产后，下方将显示时间轴面板。面板页眉显示期间 (from_to) 引导，正文为横向条形时间轴 + 右侧 5 种图例。

图例	颜色	含义
未知	⚪ 灰色	无接收记录
正常	🟢 绿色	无异常
注意	🟡 黄色	存在警告报警
危险	🔴 红色	存在严重报警
断开	⬛ 深红	超过 24 小时未接收

将鼠标悬停在面板正文左上角的 ⓘ 信息图标上，将以大号工具提示形式显示 连接状态 5 级 + 健康状态 3 级映射表。

固有属性标签页 — 各层级拥有的属性

选择站点 · 区域 · 线时，右侧标签页仅显示 固有属性 一个。设备则与其他标签页一同显示在最后。在此修改仅该层级拥有的属性和共用项，并点击下方的 保存固有属性 进行保存。此操作仅限 ADMIN 执行。

固有属性标签页 — 设备选中状态，数字为阅读顺序

数字	位置	作用
①	标签页末端	固有属性标签页
②	标签页正文	分层属性 (图为设备) · 负责人 · 运行状态 · 外部编号
③	右下	保存固有属性

层级	项目
站点	时区 (留空则为安装时区) · 国家 · 站点代码 · 地址 · 纬度 · 经度
区域	功能 (生产 / 存储 / 公用事业) · 负责人
线	类型 (生产线 / 工艺单元 / 生产单元) · 设计速度 (每小时，值与单位一同输入) · 负责人
设备	制造商 · 型号 · 序列号 · 功能位置 · 重要度 (A高 / B中 / C低) · 安装日 · 运行开始日 · 保修截止日
共用	外部系统 + 外部 ID (同时输入或同时留空) · 运行状态

栏目	注意事项
运行状态	计划 · 试运行 · 运行中 · 待机 · 停用 · 报废 (ISO 14224)。属于运行状态的大阶段，与运行·停止等实时状态以及报警的服务排除不同
功能位置	该设备承担的位置编号。必须在站点内唯一
实际负责人	出现在区域·线·设备中的只读栏目。若自身负责人为空，则继承最接近的上级 (线 → 区域) 的负责人。负责人输入框仅存在于区域·线中

下级资产列表 (选择 SITE/AREA/LINE 时)

仅在选择 SITE / AREA / LINE 节点时显示。

列	宽度	显示
资产 ID	250px	子资产 ID (领域徽章)
资产名称	250px	子资产名称
说明	自动	备注

选择 EQUIPMENT 时 — 13 个标签页面板

选择设备 (EQUIPMENT) 节点时，将显示 13 个标签页面板而非子表格。

标签页	图标	面板	内容
① 连接	🌐	映射连接列表	连接至此设备的 OPC/PLC/Modbus 等数据源 — 连接状态·ID·名称·类型·服务器 IP
② 标签	🏷	映射标签	映射至设备的标签及其当前值·单位·数据类型·最后更新时间
③ 数据	🗄	最近数据	最近采集的时序快照 (时间戳 · 数据 JSON) + [跳转趋势]
④ 报警	🔔	最近报警列表	设备映射标签产生的报警 (SEQ · 激活 · 重要度 · 内容) + [跳转报警]
⑤ 事件	📅	最近事件列表	由语句·插件触发的事件 (事件名称 · 颜色 · 开始时间 · 持续时间 [MS])
⑥ 状态	👁	最近状态列表	由语句跟踪的键·值上下文
⑦ 聚合	🥧	最近聚合列表	由语句加载的聚合键·值
⑧ 命令	🎮	执行命令 + 最近命令列表	在此设备上执行已定义命令 — 设备命令
⑨ 注册表	💻	资产语句 + 命令注册表	EQL 语句·ISO 插件注册 · 此设备的语义命令定义
⑩ 文档	📄	资产文档	设备附件文档管理
⑪ 维修	🔧	设备维修	此设备的维修工单
⑫ 基准值	📏	基准值	此设备的标准值剖面
⑬ 固有属性	☑	固有属性	上述章节 + QR 标签

若 ⑤⑥⑦ 为空，则表示没有语句

事件 · 状态 · 聚合这三个标签页显示的是 由语句 (或 ISO 插件) 产生的内容。如果该设备未关联任何语句，这三个标签页为空是正常现象 — 请在 ⑨ 注册表标签页中使用 [添加语句] · [ISO 插件] 进行关联。

⑦ 聚合与标签的 «聚合» 设置不同。 标签聚合 (1分/5分/…) 在趋势画面中查看。

⑧ 命令标签页实际会操作设备

选择已定义命令并点击 [执行] 后，值将 实际写入 PLC。权限·参数·前置条件·连锁门与拒绝代码在设备命令中单独处理。执行面板仅对 ADMIN · MANAGER 可见。

标签画面 (`/tag/index`)

用于搜索、批量删除和导出 Excel 所有已注册标签的画面。

顶部工具

🏷 태그 [전체 N개]                                [✓ 팩토리 모델 확정]

按钮	动作
全部 N 个	注册标签数 (千分位逗号)
确定工厂模型	`deployAssetToEvent()` — 与模型画面相同

列表面板页眉右侧有 删除所选标签 / 导出 Excel / 刷新 3 个按钮。

搜索表单 (多重过滤器)

输入	id	宽度	选项
站点	`site_id`	180px	已注册站点 — 始终选择一个
区域	`area_id`	180px	所有区域 + 区域 (站点更改时自动刷新)
线	`line_id`	180px	所有线 + 线 (区域更改时自动刷新)
设备	`equipment_id`	180px	所有设备 + 设备
连接	`opc_id`	180px	选择 OPC + 已注册 OPC
标签 ID	`tag_id`	180px	placeholder: "标签 ID"
标签名称	`tag_name`	180px	placeholder: "搜索标签名称 ..." (自动完成)
数据类型	`java_type`	180px	INT/FLOAT/STRING/BOOL 等选择器

标签表格 (10列 + 操作)

列	宽度	显示
选择	50px	批量删除用复选框
No.	40px	行号
标签 ID	100px	领域标识符
标签名称	300px	人类可读名称
数据类型	80px	String/Short/Integer/Long/Float/Double/Boolean/Date
数据点数量	80px	累计接收数量
报警数量	60px	累计报警数量
当前值	60px	最后接收值
单位	40px	测量单位 (°C, kPa, rpm 等)
最后更新时间	160px	最后接收时刻
操作	60px	🔧 修改 / 🗑 删除 — 仅对 `ADMIN` 可见

列表中没有说明和 延迟 [MS] 列。标签说明在标签详情中查看，延迟在连接管理的连接标签列表中查看。

操作列仅 ADMIN 可见。 在 USER 和 API 角色中，该列会整体消失，因此若看不到修改·删除图标，则是权限问题。

标签注册/修改样式 (`/tag/form`)

标签样式采用两段式结构：顶部为 基本信息面板 + 下部为 9 个标签页。

共有 10 个保存按钮 — 每个标签页独立保存

此画面 并非一个统一表单。基本信息面板和 9 个标签页 各自拥有独立的表单 (form-metadata, form-link, form-alarm …)，每个面板右下角的保存按钮仅将 该面板的内容 发送至服务器 (如 POST /tag/updateMetadata/{tag_id} 所示，采用标签页独立端点)。

若修改了多个标签页，但在最后一个标签页点击保存，其余标签页的更改将会丢失。 每次修改标签页时，请务必 在当前标签页点击保存。保存成功后右上角会出现绿色提示 — 若未看到提示，则表示未保存。

顶部 — 基本信息面板 (始终显示)

输入	说明
标签 ID	英文/数字/`_` (修改模式下为只读)
标签名称	必填。用于人类识别
数据类型	`String` / `Short` / `Integer` / `Long` / `Float` / `Double` / `Boolean` / `Date`
标签说明	自由文本 (100字)

面板页眉右侧有 查看标签 按钮 — 立即跳转至标签详情画面。面板底部的保存仅保存这四个项目 (/tag/updateBasic)。

下部 — 9 个标签页

编号为画面从左→右的排列顺序。

标签页	图标	保存对象	作用
① 标签属性	☀	`updateMetadata`	标签类型·标签源·别名·单位·显示格式·小数点·最低/最高值·周期[MS]·IO地址·原始标签名·经纬度
② 链接	🔗	`updateLink`	将此标签映射至设备 — 见下方
③ 报警带	🔔	`updateAlarm`	6级阈值 (数值型) / TRUE·FALSE 条件 (Boolean) + 消息·接收者·抑制·邮件/SMS
④ 计算	🧮	`updateCalculation`	虚拟标签计算式 (EQL, CodeMirror 编辑器) + 是否使用 — 虚拟标签
⑤ 采样	💉	`updateSampling`	仅包含是否使用 — 开启后将周期最后值采样并保存
⑥ 聚合	🪙	`updateAggregation`	是否使用 + 选择聚合周期 1分 / 5分 / 10分 / 30分 / 1小时
⑦ 人工智能	🧠	`updateAi`	基于 LLM 的实时异常诊断的目标列 / 分类列指定
⑧ 发布	📬	`updatePublish`	Kafka 发布 · MQTT 发布两个切换开关
⑨ 笔记	💬	`updateAttribute`	对标签的自由格式备注

① 标签属性标签页 — 4 个 fieldset

fieldset	项目
标签属性	标签类型 · 重要度 · 标签源 · 指标使用
数据属性	别名 · 单位 · 显示格式 · 小数点舍入模式 · 小数点位数 · 最低值 / 最高值 · 周期 [MS] · 读写
IO 及原始 OPC 标签名	IO 地址 (PLC 管理用) · 原始标签名
位置	纬度 / 经度 — 通过 [在地图中选择] 按钮弹出地图点选坐标

最低/最高值是 «量程» 而非 «验证»

min_value / max_value 不会拦截超出范围的值。正如画面帮助所示， «输入最低/最高值后，将作为 仪表盘图表的基准 显示» — 此值决定画布仪表小部件量程的两端。若要过滤值，请使用报警带或计算式。

周期 [MS] 也不是 «更改» 采集周期的值，而是 记录此标签大致以何种间隔进入的值。实际轮询间隔在连接 (OPC/Modbus/PLC) 端的设置中定义。

指定别名后，该名称将成为 事件和资产数据的列名 — 在通过 EQL 查询时显示的名称会改变，因此请勿随意更改已在使用的标签别名。

② 链接标签页 — 设备映射 (OEE·RAM·EMS 的前提条件)

项目	说明
设备搜索	通过设备 ID 或名称搜索并选择 (例如：`EQUIPMENT_000001`, `사출기 #3`)
当前映射设备 ID	只读 — 选择设备后 `linked_asset_id` 将自动更新
解除映射	清空映射关系

仅映射至设备

链接对象仅限 设备 (asset_type='M')。不会映射至线或区域。

映射的设备在 OEE / RAM / EMS 分析中使用此标签的数据。反之， 若不将标签链接至设备，则该标签不会被纳入 ISO 分析 — 当分析结果显示为空时，请首先检查此处。

③ 报警带标签页 — 5 个 fieldset

仅数值型和布尔型可设置带报警

正如画面警告文案所述 — «仅在数据类型为数字 (Short, Integer, Long, Float, Double) 或布尔 (Boolean) 类型时，才可设置带报警。» String · Date 标签无法设置带报警。若要监控此类标签，请使用高级报警。

报警设置挂在 单个标签 上。若要在多个标签组合的条件 (例如：入口 − 出口压力) 上设置报警，请先通过虚拟标签创建该组合，然后将报警挂在虚拟标签上。

阈值 / 布尔条件

数值型标签显示一个单线图形条，在保存前可确认 min_value ~ max_value 范围内 lo_lo · lo · hi · hi_hi 被映射到哪个颜色带。

[ ███ lo_lo ████ lo ════════════ 정상 ════════════ hi ████ hi_hi ███ ]
   🔴 심각        🟠 경고          🟢 정상           🟠 경고      🔴 심각

项目	说明
`lo_lo` / `hi_hi`	严重报警阈值 — 跳闸 (Trip) 前的最后警告线
`lo` / `hi`	警告报警阈值
`trip_lo` / `trip_hi`	跳闸 (设备停止命令) 阈值 — 超过报警将触发动作
`use_alarm`	报警带是否使用 — 关闭则忽略所有阈值

Boolean 标签则针对 TRUE·FALSE 分别指定 报警条件 (TRUE 时 / FALSE 时 / 不使用) · 报警等级 · 触发时机 · 重要度 · 消息。

报警消息 — 替换标记

默认文案为 {tag_name} 값이 임계치를 초과하였습니다 — 현재값 {value}。触发时，以下标记将被替换为实际值。

标记	替换值
`{tag_id}`	标签 ID
`{tag_name}`	标签名称
`{value}`	当前值
`{timestamp}`	发生时间
`{band}`	报警带 (`TRIP_HI` / `HI_HI` 等)

接收者 · 重复抑制 · 发送

fieldset	项目	说明
接收者	默认接收者	发送至注册者
	追加接收者	指定其他接收者
重复报警抑制	抑制时间 (分)	在此时间内抑制同类型报警推送
邮件 / SMS 发送	邮件	将报警发送至接收者的邮箱
	SMS	将报警发送至接收者的手机 — 必须有 SMS 网关

报警暴涨时，应优先考虑 «抑制时间» 而非阈值

在临界值附近波动时，同一报警会秒级重复产生。在扩大阈值范围之前，请先尝试增加 抑制时间 (分) — 若盲目扩大阈值，可能会漏掉真实的异常。

⑤ 采样 · ⑥ 聚合 — 两者区别

	采样	聚合
保存内容	每个周期的最后值	每个周期的统计值
统计种类	—	首值/末值, 最低·最高·平均·标准差·中位数
周期	10秒·30秒·1分·5分·10分·30分·1小时	从 1分 / 5分 / 10分 / 30分 / 1小时中选择
画面设置	仅是否使用	是否使用 + 周期

聚合周期设置过短会导致系统变慢

正如画面帮助所述 — «若数据点生成周期较快，可能会导致系统性能下降，请 注意选择较长的聚合周期。» 聚合由实时内存引擎运行，若对所有秒级标签开启 1 分钟聚合，内存和 CPU 负载将同步上升。

⑦ 人工智能标签页 — 选择多变量异常诊断的 «目标»

此标签页并非绑定预测模型的地方。正如画面副标题所示，用于定义 基于 LLM 的实时异常诊断 如何使用此标签，分为 目标 / 非目标 两个值。

项目	含义
目标列	作为多变量相关性分析的对象。设备内目标标签需 2 个及以上才激活
分类列	作为划分多变量数据的类别 (配方 · 设备模式 · 运行等)

若目标标签仅有一个，则不会发生任何操作

相关性仅在两个或多个变量之间定义。若一个设备仅开启一个 «目标» 标签，分析将不会激活 — 请将温度·压力·电流等 协同变动的标签一并 开启。

⑧ 发布标签页 — Kafka / MQTT

切换开关	作用
KAFKA 发布	通过 Kafka 协议发布数据点消息
MQTT 发布	通过 MQTT 协议发布数据点消息

OPC-UA 服务器插件必须开启 Kafka 发布才能接收数据

正如画面帮助所述 — «若要在 OPC-UA 服务器插件中接收数据，必须 激活 KAFKA 发布。» 若绑定插件后值未上传，请优先检查 标签的此切换开关 而非插件设置。

输入标签下方显示 行内帮助，提供格式和约束指引。

虚拟标签·虚拟数据点

标签画面有两种特殊注册方式。

画面	用途
`tag/add_vtag.jsp`	虚拟标签 — 在连接修改画面的连接标签列表 → [虚拟标签] 注册。值由该标签的计算标签页 EQL 基于其他标签值生成
`tag/add_vpoint.jsp`	虚拟数据点 — 在流画面点击 [虚拟数据点]，手动为单个标签输入时间和值

创建方法 · 示例 · 与报警的关系详见虚拟标签。

标签详情画面 (`/tag/view/{tag_id}`)

点击标签列表中的标签名称进入。该视图汇总了单个标签的所有运营信息，画面由 左侧 col-lg-3 (2 个面板) + 右侧 col-lg-9 (当前值面板 + 数据/报警标签页) 构成。

顶部 — 页面页眉

🏷 태그 | {태그명}                       [ 태그명 입력 ▼ ] [태그 이동 →] [← 목록] [↻]

控件	动作
标签名输入 + 标签跳转	通过自动完成搜索其他标签，立即跳转至该标签详情页 (`moveTag()`)
← 列表	返回标签列表 (`/tag/index`)
↻	刷新画面 (重新订阅实时数据)

左侧 ① 标签信息面板 — 4 段 ds-dl

面板页眉右侧有 ⚙ 齿轮 — 跳转至标签设置样式 (/tag/form)。仅具有修改权限的角色可保存。

段落 (view-section-title)	显示项目 (定义列表)
🪪 基本信息	标签 ID (领域徽章 TAG) · 标签名称 · 数据类型 · 标签说明 · 注册日
🔗 连接信息	连接 ID (领域徽章 OPC) · 连接名称
🏭 站点信息	站点 ID (徽章) · 站点名称
🟦 资产信息	资产 ID (徽章) · 资产名称

ID 均以领域颜色徽章显示，点击徽章跳转至该领域的详情画面 (例如：站点 → 站点画面)。

左侧 ② 统计信息面板 — 数据点·报警·按重要度报警

面板页眉右侧有 今天 / 昨天 切换按钮 — 切换统计期间。

段落	显示
📶 数据点	大数字 "今日数据点接收数" + 24小时火花图 (`point_24hh`) + 总数据点累计计数器
🔔 报警	大数字 "今日报警发生数" + 24小时火花图 (`alarm_24hh`) + 总报警累计计数器
❗ 重要度报警	3-卡片网格 — 信息 (蓝) · 警告 (黄) · 严重 (红) 分别显示大数字 + 标签

┌── 정보 ──┐  ┌── 경고 ──┐  ┌── 심각 ──┐
│   1,234   │  │    23     │  │     2     │
│  (파랑)   │  │ (노랑)    │  │  (빨강)   │
└──────────┘  └───────────┘  └───────────┘
       ↓ 그 아래에 도넛 차트
   [중요도별 점유율 도넛 차트]

右侧 ① 当前值面板 (5 列)

面板页眉右侧有快速跳转按钮组。

快速跳转	动作
🔀 流	在流中实时查看此标签
🗄 趋势	查看此标签的趋势
🔔 报警	查看此标签的报警记录

列	显示
当前值	大数字 — 质量颜色徽章 (good = 绿 · uncertain = 黄 · bad = 红)
最后更新	时刻 (yyyy-MM-dd HH:mm:ss)
延迟 [MS]	平均响应延迟
质量	OPC 质量代码 (例如：GOOD, BAD, UNCERTAIN)
错误码	最后一次接收出现错误时的代码

右侧 ② 数据/报警标签页

标签页	内容
📊 数据点	图表面板 (实时趋势线 — 数值型) 或状态时间轴 (Boolean) + 聚合表 (今日接收数据点 · 最低 · 最高 · 平均 · 合计 / Boolean 为首值 · 末值 · 合计)
🔔 报警	该标签产生的报警列表及其处理状态

数据标签页的图表通过 WebSocket 实时更新。图表加载期间，中央显示 "图表加载中..." 引导。

此详情画面是运营人员进行标签单位综合巡检 — 阈值审查·异常追踪·物理映射确认的入口。

本体画面 (`/ontology/index`)

高级元数据画面，用于可视化资产分类体系 (类别·元属性·关系) 和站点单位的知识图谱。经过设计系统重构，结构为 站点横幅 + 左侧侧边卡片 + 图谱正文。

顶部 — 站点横幅 (`onto-site-banner`)

页面页眉下方显示全彩横幅。

🏭 {사이트명} | {사이트 설명}                     [기준시간 : {gen_timestamp}]

站点变更时，横幅文本立即更新
基准时间为树形图·指标最后一次刷新的时刻

左侧 ① 站点面板 (col-w-280)

面板页眉

按钮	动作
❄ 径向切换	将面板正文的树形图在普通树 ↔ 径向图之间切换
↻ 刷新	重构树形图 (`createTree()`)

面板正文 — 2 种选择器

选择器	选项
站点选择	已注册站点 — 始终选择一个 (变更时树形图立即重构)
初始层级	站点 > 区域 / 站点 > 区域 > 线 / 站点 > 区域 > 线 > 设备 (默认)

面板页脚

显示全部站点数 — 🏭 전체 사이트 N개。

左侧 ② 资产计数卡片 4 种 (`onto-count-stack`)

站点面板下方显示全彩渐变 4-卡片网格 — 所选站点的资产数量。

卡片	图标	显示
AREA	🏭 车库	区域数 (`area_size`)
LINE	📜 传送带	线数 (`line_size`)
EQUIPMENT	📺 BetaMax	设备数 (`equipment_size`)
TAG	🏷 标签	标签数 (`tag_size`)

正文 — 本体图谱

在大型画布上可视化所选站点的资产树。

动作	快捷键
节点点击	显示该节点的元面板 (所选站点事件/状态/聚合容器)
放大/缩小	鼠标滚轮
节点拖拽	移动位置
节点悬停	onto-tip-* 工具提示 (领域 ID 徽章 + 元键预览) — 按 oklch 颜色区分领域

主要功能

类别树 / 径向图 — 构建资产分类 (例如：旋转机械 → 电机 → AC电机) 层级
元属性定义 — 定义按类别划分的资产应具备的元键 (例如：电机的额定输出·电压)
关系定义 — 表达资产间的关系 (上级/联动/替代)
验证规则 — 输入元数据时的验证规则 (必填/数字/范围)
领域 ID 徽章 — SITE/AREA/LINE/EQUIPMENT/TAG 颜色与领域 ID 综合搜索采用相同的 oklch 颜色统一

本体并非普通运营人员频繁使用的画面。由系统管理员在引入初期或整理资产类别时定义。

元数据画面 (`/metadata/index`)

轻量化画面，用于按领域注册自定义元键值。

使用示例

领域	元键	值
Asset	`manufacturer`	"ABC Industries"
Asset	`installed_year`	"2020"
Tag	`description_en`	"Pump discharge pressure"
Order	`customer_class`	"VIP"

输入形式

列	说明
领域类型	Asset/Tag/Order/Customer 等
领域 ID	该领域的标识符
元键	自定义
元值	自由文本/数字

与本体不同，元数据是不绑定类别的自由元信息。适用于需要快速临时元数据时。

基准信息画面 (`/basedata/index`)

代码主表·基准值注册画面。按标签页管理代码。

标签页构成

标签页	说明
资产类型	设备层级的层代码
站点分类 · 区域分类 · 线分类 · 设备分类	该层级的设备分类 (Asset class) 代码及其多语言名称 — 即资产画面的设备分类选择器列表
设备状态	设备状态代码
标签类型	标签类型代码
不良原因 · 停止原因 · 故障原因	原因代码
原因词典	原因词典
EQL 模板	EQL 模板
排班类型	排班类型代码

设备分类按层级独立

站点·区域·线·设备分别拥有各自的分类列表。设备仅能输入 设备分类标签页中的代码 — 若输入其他层级的代码，保存将被拒绝。分类以代码 (asset_class_code) 保存，名称按语言分开存放。 API 为 /api/v5/reference/asset-class。

基准信息定义系统标准值的画面，不经常变更。仅在整理标准代码时使用。

确定工厂模型

点击模型或标签画面顶部的 ✓ 确定工厂模型 按钮，注册的站点·资产·标签将批量反映到事件规则引擎 (CEP > 语句) 中。

动作流程

确认所有站点的资产树·标签·映射已按预期注册
点击顶部 ✓ 确定工厂模型
系统自动注册资产单位领域规则 (状态·聚合·事件·命令)
规则注册后，在 CEP > 语句中可见新规则

何时确定？

大规模注册新站点·资产后
极大变更资产分类·层级后
批量变更报警带·元属性后

请勿频繁点击 «确定工厂模型» (存在规则引擎重新注册成本)。建议在所有变更工作完成后一次性执行。

应用场景

场景	流程
新工厂搭建	模型 → 添加站点 → 在资产画面构建区域/线/设备树 → 注册 OPC 连接 → 自动/手动注册标签 → 确定模型
新增生产线	资产画面 → 选择站点的区域 → 添加线 → 在线下构建设备树 → 注册标签
标签批量清理	标签画面 → 通过搜索表单缩小至报废目标 → 选择 → 删除所选标签
强化资产元数据	元数据画面 → 领域 = Asset, 键 = manufacturer 等自由添加
资产类别标准化	本体画面 → 整理类别树 → 定义各类别元属性
新增单位	基准信息 → 单位主表标签页 → 添加
批量导出运营元数据	标签画面 → 搜索 → 导出 Excel

常见问题

Q. 添加了站点，但在仪表板地图上看不到标记。 A. 添加站点时若未注册经纬度，则不显示标记。请通过站点卡片的 🔧 修改 → 输入经纬度。

Q. 确定模型与元存储备份的区别？ A. 确定模型 是将资产/标签批量注册至规则引擎 (激活运营)，元存储备份 是将整个元存储保存为备份文件 (数据保存) 的独立操作。

Q. 能否在资产树中更改父资产？ A. 通常建议不更改资产的上级节点 (涉及历史·规则一致性)。若必须变更，请在与系统管理员协商后进行。

Q. 删除标签后历史数据也会消失吗？ A. 标签元信息会被删除，但时序数据将根据保存策略在一定时间内保留。具体保存策略请咨询系统管理员。

Q. 虚拟标签与普通标签的区别？ A. 普通标签 接收来自实际传感器/PLC 的数据，而 虚拟标签 是基于其他标签值计算得出的虚拟时序。例如：将 A 传感器与 B 传感器的差值定义为虚拟标签 C。创建方法请参阅虚拟标签。

Q. 不使用本体会怎样？ A. 对基本运营没有影响。本体用于在需要按分类体系管理资产时 (例如：所有电机的综合报告) 使用。

Q. 资产树中的确定模型时间过长。 A. 资产数量越多，所需时间越长 (数千个单位时需数分钟)。建议在非营业时间内执行确定模型。

Q. 标签搜索无法自动完成。 A. 必须先选择站点，自动完成才会生效。请先设置站点选择器。

Q. 在元数据中注册的键值在哪里查看？ A. 可在资产详情画面、资产树的元区域，以及流的领域 CRUD 节点中作为消息载荷的一部分使用。

Q. 更改基准信息的代码会对现有数据产生影响吗？ A. 是的，代码变更会对现有数据产生影响。变更前请与系统管理员协商。

目录​

概述​

画面构成 — 6个子菜单​

模型画面 (/model/index)​

顶部工具​

指南框​

站点列表 (卡片网格)​

添加站点表单​

逻辑·物理模型 (左·右树形图)​

左侧 — 资产 [逻辑模型] (assetTreeDiv)​

右侧 — 连接 [物理模型] (opcTreeDiv)​

逻辑 ↔ 物理映射​

添加/修改资产模态框​

资产画面 (/asset/tree/index)​

左侧 — 资产树​

右侧 — 资产详情表单 + 时间轴 + 子/标签页​

空状态 — 未选择资产​

资产信息面板 — 全彩渐变状态卡片 2 个​

资产图像 (右侧)​

基本信息面板 (输入)​

资产图像面板​

时间轴面板 — 时间趋势​

固有属性标签页 — 各层级拥有的属性​

下级资产列表 (选择 SITE/AREA/LINE 时)​

选择 EQUIPMENT 时 — 13 个标签页面板​

标签画面 (/tag/index)​

顶部工具​

搜索表单 (多重过滤器)​

标签表格 (10列 + 操作)​

标签注册/修改样式 (/tag/form)​

顶部 — 基本信息面板 (始终显示)​

下部 — 9 个标签页​

① 标签属性标签页 — 4 个 fieldset​

② 链接标签页 — 设备映射 (OEE·RAM·EMS 的前提条件)​

③ 报警带标签页 — 5 个 fieldset​

⑤ 采样 · ⑥ 聚合 — 两者区别​

⑦ 人工智能标签页 — 选择多变量异常诊断的 «目标»​

⑧ 发布标签页 — Kafka / MQTT​

虚拟标签·虚拟数据点​

标签详情画面 (/tag/view/{tag_id})​

顶部 — 页面页眉​

左侧 ① 标签信息面板 — 4 段 ds-dl​

左侧 ② 统计信息面板 — 数据点·报警·按重要度报警​

右侧 ① 当前值面板 (5 列)​

右侧 ② 数据/报警标签页​

本体画面 (/ontology/index)​

顶部 — 站点横幅 (onto-site-banner)​

左侧 ① 站点面板 (col-w-280)​

面板页眉​

面板正文 — 2 种选择器​

面板页脚​

左侧 ② 资产计数卡片 4 种 (onto-count-stack)​

正文 — 本体图谱​

主要功能​

元数据画面 (/metadata/index)​

使用示例​

输入形式​

基准信息画面 (/basedata/index)​

标签页构成​

确定工厂模型​

动作流程​

何时确定？​

应用场景​

常见问题​

相关画面​

目录

概述

画面构成 — 6个子菜单

模型画面 (`/model/index`)

顶部工具

指南框

站点列表 (卡片网格)

添加站点表单

逻辑·物理模型 (左·右树形图)

左侧 — 资产 [逻辑模型] (`assetTreeDiv`)

右侧 — 连接 [物理模型] (`opcTreeDiv`)

逻辑 ↔ 物理映射

添加/修改资产模态框

资产画面 (`/asset/tree/index`)

左侧 — 资产树

右侧 — 资产详情表单 + 时间轴 + 子/标签页

空状态 — 未选择资产

资产信息面板 — 全彩渐变状态卡片 2 个

资产图像 (右侧)

基本信息面板 (输入)

资产图像面板

时间轴面板 — 时间趋势

固有属性标签页 — 各层级拥有的属性

下级资产列表 (选择 SITE/AREA/LINE 时)

选择 EQUIPMENT 时 — 13 个标签页面板

标签画面 (`/tag/index`)

顶部工具

搜索表单 (多重过滤器)

标签表格 (10列 + 操作)

标签注册/修改样式 (`/tag/form`)

顶部 — 基本信息面板 (始终显示)

下部 — 9 个标签页

① 标签属性标签页 — 4 个 fieldset

② 链接标签页 — 设备映射 (OEE·RAM·EMS 的前提条件)

③ 报警带标签页 — 5 个 fieldset

⑤ 采样 · ⑥ 聚合 — 两者区别

⑦ 人工智能标签页 — 选择多变量异常诊断的 «目标»

⑧ 发布标签页 — Kafka / MQTT

虚拟标签·虚拟数据点

标签详情画面 (`/tag/view/{tag_id}`)

顶部 — 页面页眉

左侧 ① 标签信息面板 — 4 段 ds-dl

左侧 ② 统计信息面板 — 数据点·报警·按重要度报警

右侧 ① 当前值面板 (5 列)

右侧 ② 数据/报警标签页

本体画面 (`/ontology/index`)

顶部 — 站点横幅 (`onto-site-banner`)

左侧 ① 站点面板 (col-w-280)

面板页眉

面板正文 — 2 种选择器

面板页脚

左侧 ② 资产计数卡片 4 种 (`onto-count-stack`)

正文 — 本体图谱

主要功能

元数据画面 (`/metadata/index`)

使用示例

输入形式

基准信息画面 (`/basedata/index`)

标签页构成

确定工厂模型

动作流程

何时确定？

应用场景

常见问题

相关画面