设备类型维护 - 用户操作说明
设备类型维护 - 用户操作说明
模块概述
设备类型维护是设备管理系统中的基础配置模块,用于定义和管理不同类型的设备信息。每种设备类型可以配置专属的扩展字段,支持灵活的数据结构定义,为设备管理提供个性化的字段配置能力。
主要功能
- 设备类型基础信息管理
- 扩展字段动态配置
- 故障分类关联管理
- 数据库表结构同步
- 类型模板导入导出
设备类型基础管理
1. 设备类型列表查看
1.1 查看所有设备类型
功能说明:显示系统中所有已配置的设备类型,包括基础信息和统计数据。

操作步骤:
- 进入设备类型管理页面
- 在列表中查看所有设备类型信息
- 使用搜索条件快速筛选:
- 类型名称:输入类型名称进行模糊搜索
- 表后缀:根据扩展表后缀筛选
列表显示信息:
- 类型ID:系统自动生成的唯一标识
- 类型名称:设备类型的显示名称(如"集群式充电桩"、"变压器"等)
- 扩展表后缀:对应的数据库扩展表后缀(如"charger"、"transformer")
- 创建时间:类型创建的时间
- 操作:编辑、删除、配置字段等操作按钮
2. 设备类型添加
2.1 新增设备类型
功能说明:创建新的设备类型,定义该类型设备的基本属性。

操作步骤:
- 点击"添加设备类型"按钮
- 填写基础信息:
- 类型名称(必填):输入设备类型的显示名称
- 示例:"智能充电桩"、"配电变压器"、"环境监测设备"
- 扩展表后缀(必填):设置数据库扩展表的后缀名
- 示例:"charger"、"transformer"、"monitor"
- 注意:后缀名必须唯一,建议使用英文小写
- 类型名称(必填):输入设备类型的显示名称
- 点击"保存"按钮完成创建
- 系统返回新创建的类型ID
命名规范建议:
| 类型名称 | 扩展表后缀 | 完整表名 | 说明 |
|---|---|---|---|
| 集群式充电桩 | charger | inspection_extend_device_charger | 电动汽车充电设备 |
| 配电变压器 | transformer | inspection_extend_device_transformer | 电力变压设备 |
| 环境监测设备 | monitor | inspection_extend_device_monitor | 环境传感器设备 |
| 智能网关 | gateway | inspection_extend_device_gateway | 通信网关设备 |
注意事项:
- 类型名称应具有明确的业务含义
- 扩展表后缀不能包含特殊字符,建议使用英文单词
- 创建后表后缀不可修改,请谨慎填写
3. 设备类型修改
3.1 编辑设备类型信息
功能说明:修改已存在设备类型的基本信息。

操作步骤:
- 在设备类型列表中找到目标类型
- 点击"编辑"按钮
- 修改可编辑的字段:
- 类型名称:可以修改显示名称
- 扩展表后缀:创建后一般不可修改。如需变更,请新建设备类型并迁移数据。
- 点击"保存"完成修改
修改限制:
- 类型ID不可修改
- 扩展表后缀为扩展表的核心标识,创建后不支持直接修改
- 如果该类型下已有设备,建议谨慎修改
4. 设备类型查看详情
4.1 查看类型详细信息
功能说明:查看单个设备类型的完整信息和配置状态。
操作步骤:
- 在设备类型列表中点击类型名称
- 查看详情页面显示的信息:
- 基础信息(类型ID、名称、表后缀)
- 创建时间
- 关联的扩展字段列表
- 使用该类型的设备数量
- 关联的故障分类
5. 设备类型删除
5.1 删除不需要的设备类型
功能说明:移除不再使用的设备类型定义。
操作步骤:
- 在设备类型列表中找到要删除的类型
- 点击"删除"按钮
- 系统显示删除确认对话框
- 确认删除影响范围:
- 该类型下的设备数量
- 关联的扩展字段
- 相关的维护计划
- 确认无误后点击"确定删除"
删除限制:
- 如果该类型下还有设备,无法直接删除
- 需要先删除或转移所有关联设备
- 删除后相关的扩展表和字段配置也会被清理
扩展字段配置管理
1. 扩展字段概述
扩展字段是设备类型的核心功能,允许为不同类型的设备定义专属的数据字段,实现灵活的数据模型配置。
1.1 支持的字段类型
| 数据类型 | 说明 | 示例 | 用途 |
|---|---|---|---|
| varchar | 短文本字段 | 设备型号、序列号 | 存储较短的文本信息 |
| text | 长文本字段 | 设备描述、备注信息 | 存储较长的描述性文本 |
| int | 整数字段 | 功率等级、端口数量 | 存储整数数值 |
| decimal | 小数字段 | 电压值、电流值 | 存储精确的数值 |
| date | 日期字段 | 保修到期日、检测日期 | 存储日期信息 |
| datetime | 日期时间字段 | 最后检测时间 | 存储精确的时间信息 |
| enum | 枚举字段 | 设备等级、工作模式 | 存储预定义的选项值 |
2. 扩展字段列表查看
2.1 查看某类型的所有扩展字段
功能说明:显示指定设备类型下配置的所有扩展字段。

操作步骤:
- 在设备类型详情页面点击"扩展字段管理"
- 或在设备类型列表中点击"配置字段"按钮
- 查看字段列表信息:
- 字段ID(系统生成)
- 数据库字段名
- 显示名称
- 数据类型
- 是否必填
- 排序顺序
- 字段说明
- 创建时间
2.2 字段列表筛选
操作步骤:
- 使用搜索框输入字段名进行筛选
- 按照字段类型进行分类查看
- 按照必填状态进行筛选
3. 扩展字段添加
3.1 为设备类型添加新字段
功能说明:为指定的设备类型添加新的扩展字段。

操作步骤:
在扩展字段管理页面点击"添加字段"
填写字段基本信息:
基础配置:
数据库字段名(必填):数据库中的字段名称
- 规则:只能包含字母、数字、下划线,以字母开头
- 示例:
power_level、serial_number、install_location
显示名称(必填):前端界面显示的字段名
- 示例:"功率等级"、"设备序列号"、"安装位置"
数据类型(必填):选择合适的数据类型
是否必填:设置该字段是否为必填项
- 0:非必填
- 1:必填
显示配置:
- 排序顺序:字段在表单中的显示顺序(数值越小越靠前)
- 字段说明:对该字段的详细描述,帮助用户理解
高级配置:
- 启用数值映射:是否将存储值映射为显示值
- 映射配置JSON:当启用映射时,配置值与显示文本的对应关系
配置数值映射(可选):
映射配置示例:
[ {"label": "低功率", "value": 1}, {"label": "中功率", "value": 2}, {"label": "高功率", "value": 3} ]点击"保存"完成字段添加
3.2 常见字段配置示例
充电桩设备字段配置:
| 字段名 | 显示名称 | 数据类型 | 必填 | 映射配置 |
|---|---|---|---|---|
| power_level | 功率等级 | int | 是 | 1:低功率,2:中功率,3:高功率 |
| charging_ports | 充电端口数 | int | 是 | 无 |
| max_voltage | 最大电压 | decimal | 是 | 无 |
| installation_type | 安装方式 | int | 是 | 1:立式,2:壁挂式,3:地埋式 |
| warranty_date | 保修到期日 | date | 否 | 无 |
变压器设备字段配置:
| 字段名 | 显示名称 | 数据类型 | 必填 | 映射配置 |
|---|---|---|---|---|
| rated_capacity | 额定容量 | decimal | 是 | 无 |
| voltage_level | 电压等级 | varchar | 是 | 无 |
| cooling_method | 冷却方式 | int | 是 | 1:油浸式,2:干式,3:气体绝缘 |
| connection_type | 接线方式 | int | 是 | 1:Y-Y,2:Y-Δ,3:Δ-Y |
| oil_volume | 油量 | decimal | 否 | 无 |
4. 扩展字段修改
4.1 编辑已有字段配置
功能说明:修改已配置的扩展字段属性。

操作步骤:
- 在扩展字段列表中找到要修改的字段
- 点击"编辑"按钮
- 修改允许变更的属性:
- 显示名称
- 是否必填
- 排序顺序
- 字段说明
- 映射配置
- 点击"保存"完成修改
修改限制:
- 字段ID不可修改
- 数据库字段名一般不建议修改(可能影响已有数据)
- 数据类型变更需谨慎(可能导致数据丢失)
5. 扩展字段详情查看
5.1 查看字段完整配置
功能说明:查看单个扩展字段的所有配置信息。
操作步骤:
- 在字段列表中点击字段名称或"查看详情"
- 查看字段详细信息:
- 字段基本信息
- 数据类型和约束
- 映射配置详情
- 字段使用统计
- 创建和修改记录
6. 扩展字段删除
6.1 删除不需要的字段
功能说明:移除不再使用的扩展字段。
操作步骤:
- 在字段列表中找到要删除的字段
- 点击"删除"按钮
- 确认删除影响:
- 该字段的所有数据将被删除
- 相关的表单配置将被清理
- 输入确认信息后点击"确定删除"
删除注意事项:
- 删除操作不可逆
- 建议在删除前导出相关数据
- 确认该字段不再被任何功能模块使用
数据库表结构同步
1. 表结构同步概述
功能说明:当设备类型的扩展字段配置发生变化时,需要同步更新对应的数据库表结构,确保数据存储的一致性。
2. 执行表结构同步
2.1 手动同步表结构
操作步骤:
- 在设备类型详情页面点击"同步表结构"按钮
- 或在扩展字段管理页面点击"同步到数据库"

- 系统检查字段配置变化:
- 新增的字段
- 修改的字段属性
- 删除的字段
- 显示同步预览信息
- 确认同步操作
- 查看同步结果
2.2 自动同步机制
触发条件:
- 添加新的扩展字段时
- 修改字段数据类型时
- 删除扩展字段时
同步内容:
- 在扩展表中添加新字段
- 修改已有字段的属性
- 删除不再使用的字段
- 更新字段注释和约束
3. 同步结果查看
3.1 检查同步状态
操作步骤:
- 查看同步操作日志
- 确认表结构变更是否成功
- 验证字段是否正确创建
- 测试新字段的数据读写
同步失败处理:
- 检查数据库连接
- 确认权限设置
- 查看错误日志详情
- 联系系统管理员
故障分类关联管理
1. 故障分类关联概述
功能说明:为不同的设备类型关联相应的故障分类,实现设备故障的精准分类和处理。
2. 查看设备类型关联的故障分类
2.1 查看当前关联关系
操作步骤:
在设备类型详情页面找到"故障分类"选项卡

关联故障分类 查看当前已关联的故障分类列表
显示信息包括:
- 故障分类ID
- 故障分类名称
- 分类级别
- 关联时间
3. 配置故障分类关联
3.1 添加故障分类关联
操作步骤:
- 点击"配置故障分类"按钮
- 在故障分类选择器中:
- 查看所有可用的故障分类
- 使用树形结构浏览分类层级
- 勾选适用于该设备类型的故障分类
- 确认选择的分类列表
- 点击"保存配置"完成关联
3.2 关联配置示例
充电桩设备故障分类:
- 电气故障
- 电源故障
- 充电接口故障
- 绝缘故障
- 机械故障
- 机械卡死
- 散热风扇故障
- 通信故障
- 网络连接故障
- 协议通信故障
变压器设备故障分类:
- 绝缘故障
- 绕组绝缘击穿
- 套管绝缘故障
- 机械故障
- 分接开关故障
- 冷却系统故障
- 油质故障
- 绝缘油老化
- 油温过高
4. 修改故障分类关联
4.1 更新关联关系
操作步骤:
- 在故障分类配置页面点击"编辑"
- 修改故障分类选择:
- 取消不适用的分类
- 添加新的适用分类
- 调整分类的优先级
- 保存更新的配置
注意事项:
- 移除故障分类可能影响已有的故障记录
- 建议在修改前备份相关数据
- 确认变更不会影响正在处理的故障工单
数据验证和质量控制
1. 字段配置验证
验证规则:
- 字段名称不能重复
- 数据库字段名必须符合命名规范
- 必填字段不能有空默认值
- 映射配置JSON格式必须正确
2. 数据一致性检查
检查项目:
- 扩展字段配置与数据库表结构一致性
- 设备数据与字段定义的匹配性
- 故障分类关联的有效性
3. 性能优化建议
字段配置优化:
- 合理设置字段排序,提升表单加载速度
- 避免过多的扩展字段,影响查询性能
- 适当使用索引,提升检索效率
常见问题和解决方案
1. 字段配置问题
问题1:添加字段时提示字段名重复
解决方法:
- 检查当前类型下是否已有同名字段
- 使用更具体的字段名称
- 遵循字段命名规范
问题2:表结构同步失败
解决方法:
- 检查数据库连接状态
- 确认用户具有DDL权限
- 查看数据库错误日志
- 联系系统管理员处理
2. 数据类型问题
问题1:数值映射配置无效
解决方法:
- 检查JSON格式是否正确
- 确认label和value的数据类型匹配
- 验证映射配置的完整性
问题2:字段数据显示异常
解决方法:
- 检查字段数据类型是否正确
- 确认数值映射配置
- 验证前端显示逻辑
3. 性能问题
问题1:字段列表加载缓慢
解决方法:
- 减少不必要的字段配置
- 优化字段排序设置
- 考虑分页显示
问题2:设备表单响应慢
解决方法:
- 检查扩展字段数量
- 优化映射配置查询
- 添加必要的数据库索引
最佳实践建议
1. 设备类型设计
命名规范:
- 类型名称使用业务术语,便于理解
- 表后缀使用英文单词,简洁明了
- 保持命名的一致性和规范性
字段设计:
- 根据实际业务需求设计字段
- 避免冗余和重复的字段定义
- 合理使用数据类型,节省存储空间
2. 扩展字段管理
字段规划:
- 提前规划字段结构,避免频繁变更
- 设置合适的字段排序,提升用户体验
- 建立字段变更审批流程
数据质量:
- 设置必要的字段验证规则
- 使用数值映射规范选项值
- 定期检查和清理无效字段
3. 运维建议
定期维护:
- 定期检查表结构一致性
- 清理无用的字段配置
- 备份重要的配置信息
变更管理:
- 重要变更前先在测试环境验证
- 建立变更记录和回滚机制
- 及时同步配置变更到相关环境
本文档将根据系统功能更新持续完善,如有疑问请联系系统管理员。