工作流平台的数据源分层设计：四类数据能力与多态接入

平台之上有表单、流程、大屏，平台之外有关系库与开放接口。本文介绍一种数据源组件的分层做法：连接归连接、定义归定义，并说明该设计适用与不适用的边界。

一、定位与价值

数据源是该引擎平台中面向业务应用的统一数据组件。单据、实体、流程、门户等上层应用不直接对接第三方系统，而是通过数据源完成数据读取、下拉展示、结果集查询与业务过程调用。

其核心使命可以概括为：

应用层（流程 / 表单 / 大屏 / 低代码）
        ↕
   数据源（枚举 / 字典 / 查询 / 过程）
        ↕
外部系统（本机库 / 关系数据库 / WebApi）

这与官方概念文档中的数据源结构图一致：数据源是应用与外部系统之间的桥梁，将异构的数据获取方式收敛为统一的四类能力。

二、工程全貌

2.1 目录与模块分层

前端工程采用「树表一体管理页 + 实体定义 + 向导创建 + 后端执行」的分层结构：

前端模块源码目录
├── TreeEns_DBSrc.ts          ← 管理入口：左侧树 + 右侧列表
└── FrmLogic/
    ├── SFDBSrc/              ← 数据源连接（根节点）
    │   ├── SFDBSrc.ts        ← 基础实体
    │   ├── SFDBSrcLocal.ts   ← 本机数据源
    │   ├── SFDBSrcSQL.ts     ← 关系数据库数据源
    │   ├── SFDBSrcWebApi.ts  ← WebApi 数据源
    │   └── GPN_*.ts          ← 新建向导
    ├── SFTable/              ← 字典
    ├── SFSearch/             ← 查询
    ├── SFProc/               ← 过程
    ├── SysEnum/              ← 枚举（仅本机数据源）
    └── Sync/                 ← 数据同步（基于查询结果落地）

2.2 管理界面：树表联动

对应前端实体 继承 PageBaseTreeEns，是数据源管理的唯一入口页：

每个数据源下固定挂载四类（本机额外含枚举）：

数据源（SFDBSrc）
 ├── 字典（SFTable）      nodeID: {srcNo},SFTable
 ├── 查询（SFSearch）     nodeID: {srcNo},Search
 ├── 过程（SFProc）       nodeID: {srcNo},Proc
 ├── 枚举（SysEnum）      nodeID: local,Enums（仅本机）
 └── 数据同步（Sync）     nodeID: {srcNo},Sync

GetDtls(nodeID) 根据节点后缀分发到不同实体，动态调整列与工具栏按钮；BtnClick 统一处理新建、编辑、删除、属性维护等操作，并通过 EnName 参数路由到具体编辑表单。

2.3 实体模型与数据表

所有子能力通过 FK_SFDBSrc（或 DBSrcNo）关联到父数据源；多租户场景下辅以 OrgNo 隔离。

2.4 多态实现：同一能力，多种接入

以字典为例，对应前端实体 是统一抽象，具体实现按接入方式拆分：

查询（对应前端实体 / 对应前端实体）、过程（对应前端实体 / 对应前端实体）同样遵循此模式。

新建时，对应前端实体 根据数据源类型选择向导：

• 本机 → GPN_Local
• 关系库 → GPN_DBSrcSQL
• WebApi → GPN_DBSrcWebApi

2.5 运行时执行链路

配置完成后，运行时由后端 BP.Sys.* 服务执行：

前端实体.GenerData / BSEntity.DoMethodReturnJSON
        ↓
后端 BP.Sys.SFTable / SFSearch / SFProc
        ↓
按 FK_SFDBSrc 选择连接 → 执行 SQL / 调用 WebApi
        ↓
返回 JSON → 表单下拉 / Pop 填充 / 流程事件

表达式支持系统变量与参数占位，例如：

• ~@Key~、~@WebUser.No~（SQL 字典）
• @Token、@WebUser.No、@WorkID（WebApi 路径与 POST 体）

2.6 与上层应用的集成点

数据源能力被表单、流程等模块引用式消费，而非硬编码：

• 表单字段 UIBindKey 绑定枚举或字典编号
• 查询支持 AddSln 将返回列智能映射到表单字段（对应前端实体）
• 过程支持 对应前端实体 将参数映射到表单属性
• 数据同步以 对应前端实体 为数据源，定时或手动写入目标表/实体

三、核心概念说明

以下定义与官方数据源文档保持一致。

3.1 数据源类型

3.2 四类数据能力

枚举（SysEnum）

用户定义的命名常量集合，由一组整型或字符串键值组成。

• 示例：性别 0=女、1=男；政治面貌 0=群众、1=团员、2=党员
• 支持 Int / String 两种类型，可配置显示颜色
• 仅挂载于本机数据源，存储在 平台系统表 / 平台系统表
• 删除前会检查 MapAttr.UIBindKey 引用，防止破坏已发布表单

字典（SFTable）

用于下拉框、级联选择、树形选择的数据结构。

支持无参/有参；有参时通过 SelectStatement 中的占位符实现级联，如按省份过滤城市。

查询（SFSearch）

输入参数，返回结果集。

支持参数定义（对应前端实体）、返回列定义（对应前端实体）及与表单字段的映射方案。

过程（SFProc）

输入参数，执行并返回结果，侧重「动作」而非「读取」。

• 示例：账户注销、出入库、修改密码、作废单据
• 支持 GET / POST（WebApi）
• 常用于流程事件、节点事件中的业务调用

数据同步（Sync）— 扩展能力

以已配置的查询为数据来源，按规则写入：

• 同步到数据库表 / 后端实体 / 前端实体
• 清空方式或追加方式
• 可配置定时任务规则（GPE_AutoSync）

四、典型应用场景

4.1 枚举

特点：值域稳定、变更少、无需访问外部系统，适合本机维护。

4.2 字典

特点：选项来自业务主数据，可能随组织、权限、上下文变化；支持动态参数。

4.3 查询

特点：面向读，返回结构化数据集；实体查询与集合查询分别服务「详情回填」与「列表展示」。

4.4 过程

特点：面向写/执行，强调副作用与事务性操作；参数通常来自表单字段或流程上下文。

4.5 组合示例

请假流程
  ├── 枚举：请假类型（事假/病假/年假）
  ├── 字典：申请人部门（树结构，本机 SQL）
  ├── 查询：年假余额（实体查询，按工号返回剩余天数）
  └── 过程：同步考勤系统（WebApi POST，流程结束时调用）

五、设计优点

5.1 统一抽象，降低集成成本

流程、表单、大屏只需认识「枚举 / 字典 / 查询 / 过程」四类接口，无需关心底层是 SQL 还是 HTTP。更换对接方式时，多数情况下只需调整数据源配置，上层绑定关系可保持不变。

5.2 连接与定义分离

对应前端实体 管理连接，对应前端实体 / 对应前端实体 / 对应前端实体 管理业务语义。同一 ERP 连接下可配置 dozens 个字典与查询，避免连接信息重复维护。

5.3 多态扩展清晰

通过 EnName + 独立实体类（如 对应前端实体、对应前端实体）实现编辑表单的差异化，公共字段收敛在基类实体，扩展新型接入时模式可复制。

5.4 参数化与上下文注入

统一支持 ~@Key~、@WebUser.No、@Token、@WorkID 等占位符，使级联、权限过滤、流程上下文传递可在配置层完成，减少定制代码。

5.5 与低代码体系深度耦合

• 查询/过程的 AddSln 可自动映射到表单字段
• 枚举删除前检查表单引用
• 字典创建时可指定默认字段名（FK_Val），加速表单设计

5.6 多租户友好

OrgNo 贯穿字典、查询、过程、同步；枚举在集团/SAAS 模式下支持组织隔离与共享策略。

六、设计局限与改进方向

6.1 树节点为 UI 层虚拟构造

二级节点（字典/查询/过程等）并非数据库记录，而是由 TreeEns_DBSrc.Init 动态 push 生成，nodeID 采用 {srcNo},{Type} 字符串拼接。

• 影响：节点解析逻辑分散在 includes('SFTable') 等字符串判断中，扩展新分类需改多处
• 建议：可考虑枚举化节点类型，或下沉为配置表驱动

6.2 EnName 路由的多态依赖

编辑入口依赖实体 AtPara.EnName 字段定位具体表单类，缺失时报「数据错误」。

• 影响：配置不完整时排错成本较高；全局搜索双击行需依次尝试多个实体类型
• 建议：建立类型注册表，或在一级元数据中显式存储 ItemType

6.3 枚举能力仅限本机

外部系统的码表只能通过字典（WebApi/SQL）模拟，无法使用枚举的轻量配置与颜色能力。

• 影响：概念上「固定小码表」与「外部码表」路径不统一
• 建议：文档中明确边界——枚举用于平台内常量，字典用于动态主数据

6.4 表达式能力强大但学习曲线陡

SQL 语句、API 路径、POST JSON、参数别名需同时掌握，对实施人员要求较高。

• 影响：配置错误往往在运行时暴露
• 建议：强化 对应前端实体 等编辑页中的「测试」按钮与 TestParas 用例（现有能力可进一步产品化）

6.5 同步模块与查询耦合

Sync 强依赖 对应前端实体 作为数据源，无法直接从字典或过程同步。

• 影响：部分「字典 → 本地缓存表」场景需先包装为查询
• 建议：评估是否支持字典直同步，或提供向导自动生成查询

6.6 代码层面的重复检索

部分 GetDtls 分支存在连续两次 Retrieve 调用（如过程、查询节点），属于可优化的实现细节。

七、架构关系图

7.1 模块依赖

7.2 数据流

九、总结该引擎数据源体系以 SFDBSrc 为根、四类能力为枝、多态实体为叶，在单一管理界面中完成了从连接配置到业务数据定义的全链路治理。它将「读」（枚举、字典、查询）与「写」（过程）清晰拆分，又通过统一的参数与上下文机制保持体验一致。

对于实施团队：枚举管常量、字典管选项、查询管数据集、过程管动作——按此分工配置，即可覆盖绝大多数表单与流程的数据交互需求。对于架构评审：优势在于抽象统一与低代码亲和；代价在于配置复杂度与 UI 层虚拟树的可维护性，需在文档、测试工具与类型注册方面持续加强。