主题
业务字典管理
功能概述

业务字典管理用于维护流程表单中的字典数据,为表单设计中的"字典选择器"组件提供数据源。业务字典采用 两级结构:字典类型(上级)和字典数据(下级)。
两级结构说明
| 层级 | 名称 | 说明 | 示例 |
|---|---|---|---|
| 第一级 | 字典类型 | 字典的分类,定义一组字典数据的集合 | "请假类型"、"费用类型"、"审批级别" |
| 第二级 | 字典数据 | 具体的字典项,归属于某个字典类型 | "事假"、"病假"、"年假"(归属"请假类型") |
数据结构关系
字典类型:请假类型
├── 字典数据:年假
├── 字典数据:事假
├── 字典数据:病假
├── 字典数据:婚假
└── 字典数据:产假
字典类型:费用类型
├── 字典数据:差旅费
├── 字典数据:办公费
├── 字典数据:招待费
└── 字典数据:培训费字典类型管理
查询字典类型
- 进入 工作流程 > 业务字典管理 页面
- 页面上方提供搜索栏,可按字典类型名称或编码进行模糊搜索
- 查询结果以列表形式展示,包含以下信息:
| 信息项 | 说明 |
|---|---|
| 类型名称 | 字典类型的显示名称 |
| 类型编码 | 字典类型的唯一编码标识 |
| 状态 | 启用 / 停用 |
| 数据数量 | 该类型下的字典数据条数 |
| 排序 | 显示顺序 |
| 更新时间 | 最近一次修改时间 |
| 操作 | 编辑、删除、管理字典数据 |
新增字典类型
- 点击页面右上角的 新增字典类型 按钮
- 在弹出的对话框中填写以下信息:
| 字段名称 | 说明 | 验证规则 |
|---|---|---|
| 类型名称 | 字典类型的显示名称 | 必填,长度 1-50 个字符 |
| 类型编码 | 字典类型的唯一编码 | 必填,仅支持字母、数字、下划线,唯一性校验 |
| 状态 | 启用或停用 | 必填,默认启用 |
| 排序 | 显示顺序,数值越小越靠前 | 选填,默认 0 |
| 备注 | 字典类型的用途说明 | 选填 |
编辑字典类型
- 在字典类型列表中,点击目标类型对应的 编辑 按钮
- 修改需要变更的字段
- 点击 确认 保存修改
注意:类型编码创建后不可修改。
删除字典类型
- 在字典类型列表中,点击目标类型对应的 删除 按钮
- 系统进行删除前校验:
- 检查该类型下是否存在字典数据
- 如存在字典数据,需先删除所有字典数据后才能删除字典类型
- 检查是否有流程模型引用了该字典类型
- 如有关联流程,需先修改相关流程配置
- 确认后执行删除
字典数据管理
查询字典数据
可通过以下两种方式查看字典数据:
- 从字典类型列表进入:点击字典类型对应的"管理数据"按钮
- 直接搜索:在字典数据管理页面,按数据标签或数据值搜索
字典数据列表展示以下信息:
| 信息项 | 说明 |
|---|---|
| 所属类型 | 该字典数据归属的字典类型名称 |
| 数据标签 | 字典数据的显示名称,如"年假" |
| 数据值 | 字典数据的值,用于系统存储和传递 |
| 状态 | 启用 / 停用 |
| 排序 | 显示顺序 |
| 更新时间 | 最近一次修改时间 |
| 操作 | 编辑、删除 |
新增字典数据
- 在字典数据管理页面,点击 新增字典数据 按钮
- 在弹出的对话框中填写以下信息:
| 字段名称 | 说明 | 验证规则 |
|---|---|---|
| 所属类型 | 字典数据绑定的字典类型 | 必填,自动关联当前选中的字典类型 |
| 数据标签 | 字典数据的显示名称 | 必填,长度 1-50 个字符 |
| 数据值 | 字典数据的存储值 | 必填,支持字母、数字、下划线 |
| 颜色类型 | 在表单中展示时的颜色样式 | 选填(默认 / 成功 / 警告 / 危险 / 信息) |
| CSS 类名 | 自定义样式类名 | 选填 |
| 状态 | 启用或停用 | 必填,默认启用 |
| 排序 | 显示顺序 | 选填,默认 0 |
| 备注 | 数据项的用途说明 | 选填 |
编辑字典数据
- 在字典数据列表中,点击目标数据对应的 编辑 按钮
- 修改需要变更的字段
- 点击 确认 保存修改
删除字典数据
- 在字典数据列表中,点击目标数据对应的 删除 按钮
- 系统检查是否有流程模型引用了该字典数据
- 确认后执行删除
字典类型与数据绑定关系
字典数据必须绑定到某一个字典类型下,绑定规则如下:
| 规则 | 说明 |
|---|---|
| 绑定方式 | 新增字典数据时选择所属字典类型 |
| 数据隔离 | 不同字典类型下的数据相互独立 |
| 数据迁移 | 字典数据不支持跨字典类型迁移 |
| 类型删除 | 删除字典类型时需先清空其下所有字典数据 |
| 引用校验 | 删除字典数据时需检查是否有流程引用该数据 |
在流程表单中使用业务字典
业务字典在流程表单设计中通过"字典选择器"组件使用:
- 在表单设计中,从组件区拖入"字典选择器"组件
- 在右侧属性区选择需要绑定的字典类型
- 流程发起时,该组件自动展示所选字典类型下的所有启用状态的字典数据
注意事项
- 编码唯一性:字典类型编码在同一租户下必须唯一
- 数据值唯一性:同一字典类型下的字典数据值必须唯一
- 状态控制:停用的字典数据在表单选择器中不展示
- 引用检查:删除字典类型或数据时,系统会自动检查是否有流程引用
- 排序规则:字典数据在下拉列表中按照排序值升序排列
- 颜色配置:颜色类型在流程审批表单中用于标签展示,便于区分不同状态的数据项
