枚举管理

功能概览

功能定位

枚举管理维护平台级共享的枚举类型与枚举项，为状态、类别等字段提供统一的可选值。先定义枚举类型，再为该类型维护标签与键值，后续业务数据类型及建模可以引用这些定义。

简单理解：把“只能从几个固定选项中选择”的内容整理成公共选项表，例如用户状态的“正常、禁用”。

主要特性

• 类型与取值分开维护：类型用于归类，枚举数据用于定义标签、键值和顺序。
• 平台级复用：基础管理中建立的枚举可作为平台公共定义，区别于项目内的枚举。
• 状态与唯一性控制：类型和枚举项分别维护正常/停用状态，同一类型下的键值不能重复。

作用范围

本页是平台级枚举管理。枚举类型和枚举数据分别受操作权限控制；能看到类型列表不表示一定能进入或维护枚举数据。项目专属枚举在【本体建模】的【语义资产】中维护。

前置步骤

前置条件

1. 已获得枚举管理的菜单及相应操作权限。
2. 已明确枚举名称、类型编码和每个选项的业务含义。
3. 新增枚举项前，先建立所属枚举类型。

导航路径

【基础管理】 > 【枚举管理】

页面总览

类型列表支持按【枚举名称】【枚举类型】【状态】查询。列表中的枚举类型编码是进入枚举数据的入口；枚举数据页面支持按【枚举标签】和【状态】查询，并提供新增、详情、修改、删除及关闭入口。

推荐操作流程

定义类型编码 → 新增枚举类型 → 点击类型编码 → 维护枚举项 → 核对标签、键值及状态 → 在业务类型或建模中引用。

功能操作说明

查询枚举类型

1. 在查询区填写枚举名称或枚举类型。
2. 按需选择【状态】。
3. 点击【查询】。
4. 需要清空筛选时点击【重置】。

操作结果：列表显示符合条件的枚举类型。

新增枚举类型

1. 点击【新增】。
2. 填写枚举名称和枚举类型编码。
3. 选择【状态】。
4. 按需填写【备注】。
5. 点击【确定】。

• 枚举名称：便于业务人员理解的名称，不超过 128 个字符。（必填）
• 枚举类型：唯一类型编码，字母开头，仅允许字母、数字、下划线，不超过 128 个字符。（必填）
• 状态：选择【正常】或【停用】。（必填）
• 备注：补充该类型的用途，不超过 512 个字符。（选填）

操作结果：显示“新增成功”，类型列表刷新。

查看、修改枚举类型

1. 查看信息时，在目标行点击【详情】。
2. 关闭详情后，需要调整时点击该行【修改】。
3. 修改名称、状态或备注等允许编辑的内容。
4. 点击【确定】。

操作结果：显示“修改成功”后，列表更新。

类型编码

已经存在枚举数据的类型不能修改类型编码。修改状态与删除是不同操作，不要通过删除重建来代替状态维护。

进入枚举数据

1. 点击目标行的枚举类型编码，例如 sys_user_status。
2. 查看该类型下的标签、键值、排序和状态。
3. 按需填写【枚举标签】或选择【状态】。
4. 点击【查询】。

操作结果：进入目标类型的枚举数据列表；【关闭】用于返回类型管理。

新增枚举项

1. 在枚举数据页面点击【新增】。
2. 核对自动显示、不可编辑的【枚举类型】。
3. 填写【枚举标签】。
4. 填写【枚举键值】。
5. 设置【排序】。
6. 选择【状态】。
7. 按需填写【备注】。
8. 点击【确定】。

操作结果：显示“新增成功”，枚举项出现在当前类型的数据列表。

字段名	说明	是否必填
枚举类型	由当前类型自动带入，不可手动变更。	自动带入
枚举标签	供用户理解的选项文字，不超过 128 个字符。	是
枚举键值	对应选项的实际取值，同一类型下不得重复，不超过 128 个字符。	是
排序	非负整数，用于表达显示次序。	是
状态	正常或停用。	是
备注	补充说明，不超过 512 个字符。	否

修改或删除枚举项

1. 需要查看时，点击枚举项行中的【详情】。
2. 需要调整时，点击该行【修改】。
3. 修改标签、键值、排序、状态或备注后，点击【确定】。
4. 需要删除时，点击目标行【删除】，或勾选多项后点击上方【删除】。
5. 核对确认提示后确认删除。

操作结果：修改成功后更新该项；删除成功后刷新当前枚举数据列表。所属枚举类型不能在修改枚举项时变更。

删除枚举类型

1. 先核对目标类型是否仍有枚举数据及业务用途。
2. 点击类型行中的【删除】，或勾选多种类型后点击上方【删除】。
3. 核对确认提示后确认删除。

操作结果：类型仍有枚举数据时，系统提示先删除数据；若被模型公理引用，还需先解除对应公理的绑定。满足删除条件后，显示“删除成功”并刷新列表。批量删除中任一类型不满足条件时，本次删除会被拒绝。

常见问题

• 枚举名称和枚举类型有什么区别？
  枚举名称是面向业务的名称，枚举类型是用于区分该组选项的编码。

• 为什么不能修改类型编码或删除类型？
  已有枚举数据时不能修改类型编码；删除类型前需要先处理其下的枚举数据。

• 同一类型下可以使用重复键值吗？
  不可以。同一类型下键值必须唯一，重复时会提示该键值已存在。

• 为什么枚举类型不是可点击链接？
  进入枚举数据还需要对应权限，请联系管理员核对枚举数据的访问权限。

总结

先维护类型，再维护标签与键值。对已有业务引用的枚举，修改前应核对取值含义，避免把展示名称和实际键值混用。