数据源配置
数据源是系统中字段下拉选项的数据来源。系统提供了多种数据源配置方式，满足不同业务场景的需求。
数据源类型概览
| 数据源类型 | 适用场景 | 特点 |
|---|---|---|
| 系统数据源 | 常用的固定选项 | 开箱即用，无需配置 |
| 数据字典 | 静态的业务选项 | 可自定义维护，支持排序 |
| 实体数据源 | 动态的业务数据 | 与实体对象关联，支持权限过滤 |
| 组织数据源 | 组织架构选择 | 支持树形结构，支持分类筛选 |
系统数据源
系统已经提供了常用的数据源作为系统级数据源，开箱即用，方便业务配置场景下的重用。
使用方式
在数据源类型的字段中直接选择系统数据源使用。
已提供的系统数据源
| 数据源 | 说明 |
|---|---|
| 月份 | 月份数据（1-12月） |
| 星期 | 星期数据（周一至周日） |
| 性别 | 性别数据（男/女） |
| 审批状态 | 审批流状态 |
| 审批结果 | 审批流结果 |
| 启用停用状态 | 启用或停用选项 |
数据字典
通过数据字典，可以快速创建静态的数据源。
创建数据字典
- 进入 开发管理 > 数据字典
- 点击 新增字典
- 填写字典名称和编码
- 保存字典
维护字典项
通过新增或编辑弹窗维护字典项：
- 显示值：下拉列表中显示的文本
- 映射值：存储到数据库的值，默认预置，可自行修改
排序建议
如果数据源要在列表中进行排序，请自行维护有序的映射值，默认随 ID 生成的映射值对排序并不友好。
使用数据字典
定义好的数据字典可以在数据源类型的字段中直接作为数据源使用。
实体数据源
如果想要快速将一整个对象的数据作为数据源，可以在对象设置 中启用实体数据源。
基础配置
- 进入实体对象设置
- 开启实体数据源
- 选择一个字段作为数据源下拉列表中展示的字段
实体数据源返回的 label 值为选择的字段值，value 为当前数据的 _id 值。
适用场景
实体数据源最常见的使用场景为定义一些动态的类型，例如：
- 出版商
- 图书类型
- 产品分类
这类业务数据源需要人工维护，通常为非敏感数据，不需要数据过滤。
进阶功能
如果需要更复杂的数据过滤、排序、数据源扩展等功能，可以通过接口中的实体数据源类型提供实体数据。
使用数据源组件配置：
| 配置项 | 说明 |
|---|---|
| 数据源类型 | 实体数据源 |
| 目标实体 | 选择要作为数据源的实体 |
| 显示字段 | 选择下拉列表显示的字段 |
| 筛选条件 | 配置数据过滤条件 |
| 排序规则 | 配置数据排序方式 |
| 输出到最终结果 | 是 |
权限说明
实体数据源遵循系统数据权限，只会返回当前登录人员有权限的数据。
组织数据源
系统已经内置了全部组织数据源。如果需要定制组织数据源，可以通过新增一个数据源接口来实现。
接口配置
使用数据源组件配置：
| 配置项 | 说明 |
|---|---|
| 数据源类型 | 组织数据源 |
| 组织筛选类型 | 根据情况选择适当的值 |
| 数据结构 | 列表或树形 |
| 按组织分类筛选 | 选择仅筛选某些组织分类的组织 |
| 输出到最终结果 | 是 |
使用场景
- 部门选择
- 组织架构选择
- 多级组织筛选