Skip to content

全局数据源 ​

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

全局配置中的设置数据源入口

在哪里找 ​

左侧功能栏 → 全局配置 → 设置数据源。

也可在组件「选项数据」里通过管理入口打开同一列表。

创建与维护 ​

  1. 打开 设置数据源(左侧功能栏 → 全局配置)。
  2. 点 创建数据源,选择 静态数据 或 远程数据。

创建数据源:远程或静态

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

数据源列表

静态数据 ​

适合少而稳的选项。选中静态源后,在右侧编辑器中维护 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 的对象数组。
  • 错误处理:请求失败时的脚本(参数多为错误对象),按需配置。

前置处理

数据处理:响应映射成选项

在组件中引用 ​

  1. 选中下拉 / 单选等选项类组件。

选中紧急程度字段

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

选项数据区域

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

选用具体全局数据源

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

字段选项来自全局源

场景示例 ​

入门:紧急程度静态源 ​

背景:请假单、故障单都要「普通 / 紧急 / 特急」,不想每张表各维护一份。

步骤:

  1. 打开 设置数据源,在列表中选中「紧急程度」静态源。

选中紧急程度静态源

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

维护静态选项

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

选中紧急程度字段

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

选项类型选全局并选用紧急程度

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

预览下拉选项

预期:新增「特急」只改全局源,各表预览后一起看到。

入门:省份下拉共用 ​

背景:多张地址类表单都有省份字段。

步骤:

  1. 打开 设置数据源,选中「省份列表」。

选中省份列表源

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

维护省份选项

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

选中省份字段

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

省份选项选用全局源

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

省份已引用全局源

预期:一处改省份名称,多处下拉同步。

常用:远程员工选择 ​

背景:审批人下拉要从人事接口拉人,多张审批表共用。

步骤:

  1. 打开 设置数据源,点 创建数据源,选 远程数据。

创建数据源选远程

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

选中员工列表远程源

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

填写请求链接

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

配置请求头部

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

测试请求

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

数据处理映射选项

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

字段引用全局数据源

预期:接口与映射只维护一处;token 等见全局变量。

常用:选项文案变更同步 ​

背景:业务把「普通」改成「一般」,引用了「紧急程度」源的表单都要看到新文案。

步骤:

  1. 打开 设置数据源,选中「紧急程度」。

选中要改的紧急程度源

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

改选项标签

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

预览核对新文案

预期:新文案生效;历史单据若存的是值,含义仍稳定。

管理建议 ​

  • 命名见名知意:data_province_list、data_urgency_list 或中文标签「省份列表」。
  • 改远程解析前必做 测试请求。
  • 删除数据源前检查是否仍被引用。
  • 仅单字段用一次 → 用组件内静态即可,不必进全局。

注意点 ​

  • 引用后以界面显示的数据源标签为准。
  • 静态源改 value 可能影响已存单据;优先改 label。
  • 远程源失败时先看 测试请求 与权限 / 跨域;{{变量}} 在预览环境也要有值。
  • 创建数据源 分 静态数据 与 远程数据;远程源右侧是请求面板,静态源是选项编辑器,不要混用同一键名硬改类型。

相关阅读 ​

相关技术文档 ​