全局数据源
全局数据源集中维护可复用的选项数据,支持静态与远程。单选、多选、下拉等在选项数据里选用「全局数据源」,避免每个字段重复维护同一套选项。

在哪里找
也可在组件「选项数据」里通过管理入口打开同一列表。
创建与维护
- 打开 设置数据源(左侧功能栏 → 全局配置)。
- 点 创建数据源,选择 静态数据 或 远程数据。

- 输入描述(如「紧急程度」「员工列表(远程)」)并确认,在右侧维护内容后点 保存,再点弹窗 确定。

静态数据
适合少而稳的选项。选中静态源后,在右侧编辑器中维护 label / value 列表(界面也可能以 JSON 展示)。
示例:紧急程度
text
普通 / normal
紧急 / urgent
特急 / critical
远程数据
创建时选 远程数据。右侧是与组件选项数据 · 远程数据同一套 请求配置 面板(FetchTabs):四个页签为 请求配置、前置处理、数据处理、错误处理。
请求配置
| 项 | 作用(界面文案) |
|---|---|
| 请求链接 | 接口地址(必填) |
| 请求方式 | GET / POST |
| 数据类型 | 请求体:JSON / FormData |
| 请求头部 | 键值表,如鉴权头 |
| 请求参数 | GET 参数(走 URL) |
| 附带数据 | 请求体键值(多为 POST) |
顶部说明:可用双大括号(如 {{token}})引用全局变量等;对象可用 {{变量名.属性名}}。

请求头部 / 请求参数 / 附带数据 用「键名 / 值」表维护,可点 添加。下方 预览响应数据 区点 测试请求 试调。

TIP
改完先 测试请求,再写 数据处理。鉴权变量在预览环境也要有值,否则头部会失败。组件侧远程选项的细项说明见选项数据。
前置处理 / 数据处理
- 前置处理:发送前改请求(形如
beforeFetch(config, data)),或返回false终止。 - 数据处理:把接口响应转成选项数组(形如
parse(res, rule, api)),通常return带label/value的对象数组。 - 错误处理:请求失败时的脚本(参数多为错误对象),按需配置。


在组件中引用
- 选中下拉 / 单选等选项类组件。

- 组件配置 → 选项数据 → 类型选 全局数据源。

- 再选具体数据源(如「紧急程度」「省份列表」)。

- 预览检查选项;源更新后刷新预览。

场景示例
入门:紧急程度静态源
背景:请假单、故障单都要「普通 / 紧急 / 特急」,不想每张表各维护一份。
步骤:
- 打开 设置数据源,在列表中选中「紧急程度」静态源。

- 在右侧维护选项(如普通 / 紧急 / 特急),点 保存。

- 回到画布,选中「紧急程度」选择器。

- 组件配置 → 选项数据 → 类型选 全局数据源,再选用「紧急程度」。

- 点 预览,确认下拉里出现上述选项。

预期:新增「特急」只改全局源,各表预览后一起看到。
入门:省份下拉共用
背景:多张地址类表单都有省份字段。
步骤:
- 打开 设置数据源,选中「省份列表」。

- 在右侧维护各省份
label/value,点 保存。

- 选中画布上的「省份」选择器。

- 选项数据 → 全局数据源,再选用「省份列表」。

- 在画布上确认字段已挂上全局源(右侧显示全局数据源与具体源名)。

预期:一处改省份名称,多处下拉同步。
常用:远程员工选择
背景:审批人下拉要从人事接口拉人,多张审批表共用。
步骤:
- 打开 设置数据源,点 创建数据源,选 远程数据。

- 输入描述(如「员工列表(远程)」)并确认,列表中选中该远程源。

- 在 请求配置 填写 请求链接(以及方式、数据类型)。

- 按需添加 请求头部 / 请求参数 / 附带数据(可用 {{token}} 等变量)。

- 点 测试请求,确认能拿到响应。

- 切到 数据处理,把响应映射成姓名 / 工号选项后 保存。

- 各审批表的选人字段 → 选项数据 → 全局数据源 → 选该远程源。

预期:接口与映射只维护一处;token 等见全局变量。
常用:选项文案变更同步
背景:业务把「普通」改成「一般」,引用了「紧急程度」源的表单都要看到新文案。
步骤:
- 打开 设置数据源,选中「紧急程度」。

- 在右侧只改选项的
label(value尽量保持不变),点 保存。

- 打开引用了该源的表单,点 预览 核对下拉文案。

预期:新文案生效;历史单据若存的是值,含义仍稳定。
管理建议
- 命名见名知意:
data_province_list、data_urgency_list或中文标签「省份列表」。 - 改远程解析前必做 测试请求。
- 删除数据源前检查是否仍被引用。
- 仅单字段用一次 → 用组件内静态即可,不必进全局。
注意点
- 引用后以界面显示的数据源标签为准。
- 静态源改
value可能影响已存单据;优先改label。 - 远程源失败时先看 测试请求 与权限 / 跨域;{{变量}} 在预览环境也要有值。
- 创建数据源 分 静态数据 与 远程数据;远程源右侧是请求面板,静态源是选项编辑器,不要混用同一键名硬改类型。


