宜搭如何实现审批单关联？

Question

在使用宜搭搭建审批流程时，常遇到“如何实现多个审批单之间的数据关联与联动”这一问题。例如，采购申请单需关联对应的合同审批单，以便在审批过程中查看合同详情并校验金额一致性。用户希望在表单提交或审批节点中自动获取其他审批单的数据，但不清楚如何配置关联字段或调用跨单据数据。此外，在审批完成后，如何自动更新关联单据状态也是一大难点。请问宜搭是否支持通过关联表单、API连接器或业务规则实现审批单之间的双向关联？具体应如何配置才能确保数据实时同步且权限可控？

Answer 1

宜搭中实现审批单据间数据关联与联动的深度解析

1. 背景与核心挑战

在企业数字化转型过程中，低代码平台如宜搭（Yida）被广泛用于快速构建审批流程。然而，随着业务复杂度提升，单一表单已无法满足跨单据协同需求。典型场景包括：采购申请需关联合同审批单，报销单需引用差旅申请等。

用户面临的核心问题集中在：

• 如何建立不同审批单之间的数据关联？
• 如何在提交或审批节点自动获取关联单据数据？
• 如何确保金额、数量等关键字段的一致性校验？
• 审批完成后如何反向更新源单状态？
• 权限控制下如何保障数据可见性与安全性？

2. 宜搭支持的数据关联机制概述

宜搭提供了三种主要方式实现跨单据数据联动：

机制	适用场景	实时性	开发成本	权限可控性
关联表单字段	简单引用，如选择合同编号	高	低	中
API连接器	复杂逻辑、跨系统集成	中	高	高
业务规则 + 自动化	状态同步、条件触发	可配置	中	高

3. 方案一：通过“关联表单”实现基础数据引用

在采购申请单中添加“合同审批单”作为关联字段，用户可在填写时从已有合同中选择。

配置步骤如下：

1. 进入表单设计界面，添加“关联表单”控件；
2. 选择目标表单（如“合同审批单”）；
3. 设置显示字段（如合同编号、金额、供应商）；
4. 启用“仅可选已通过审批的记录”以保证数据有效性；
5. 在详情页使用“子表单”展示所选合同详情。

该方式适用于静态引用，但无法动态获取最新数据或反写状态。

4. 方案二：利用API连接器实现跨单据数据读取与校验

当需要在提交前校验采购金额是否超过合同总额时，可通过API连接器调用宜搭开放接口。

{
  "action": "queryRecord",
  "appID": "appldKQxxxxx",
  "recordID": "{{form.contract_id}}",
  "fields": ["contract_amount", "status"]
}
    

结合“业务规则”，可在“提交前”触发此API，并判断返回值：

• 若 status ≠ “已通过”，则阻止提交；
• 若 contract_amount < purchase_amount，则提示超限。

5. 方案三：基于业务规则与自动化实现双向状态同步

为实现审批完成后的状态回写，需配置自动化规则。

示例：合同审批通过后，自动将所有关联的采购申请单中标记为“合同已生效”。

// 触发条件：当前表单【合同审批单】状态变更为“已通过”
// 执行动作：调用【更新记录】API 更新采购申请单
{
  "targetAppId": "appPurchase",
  "operation": "updateRecord",
  "filter": {
    "contract_id": "{{currentRecord._id}}"
  },
  "data": {
    "contract_status": "已生效"
  }
}
    

6. 数据实时性与权限控制策略

为确保数据一致性与安全访问，建议采用以下组合策略：

维度	技术手段	说明
实时性	Webhook + 缓存失效	审批变更触发事件通知，清除前端缓存
数据隔离	行级权限 + 组织架构过滤	限制用户只能查看本部门合同
字段级权限	动态表单规则	财务角色可见金额，普通员工不可见
审计追踪	操作日志 + 变更记录	记录谁在何时修改了关联关系

7. 典型应用场景流程图

以下为采购申请与合同审批联动的完整流程：

graph TD
            A[用户提交采购申请] --> B{是否关联合同?}
            B -- 是 --> C[选择已审批合同]
            C --> D[调用API校验合同金额]
            D --> E{金额是否足够?}
            E -- 否 --> F[驳回并提示超限]
            E -- 是 --> G[进入审批流]
            G --> H[审批通过]
            H --> I[触发自动化规则]
            I --> J[更新合同使用额度]
            J --> K[标记采购单为“已核销”]
            B -- 否 --> L[走普通审批流程]

8. 高阶实践：构建统一主数据管理中心

对于大型企业，建议将合同、项目、资产等关键实体抽象为独立的“主数据应用”，并通过唯一编码进行全局引用。

优势包括：

• 避免数据冗余与不一致；
• 便于后续扩展BI分析与报表统计；
• 支持多层级审批链路追踪；
• 可通过API网关统一对外暴露服务。

例如，在主数据中维护“合同台账”，所有业务单据通过 contract_code 关联，形成星型模型结构。

9. 常见问题与避坑指南

在实际落地过程中，常遇到以下问题：

1. 循环引用导致死锁 —— 应避免A关联B、B又反向强依赖A；
2. 性能瓶颈 —— 大量API调用应加入异步队列与重试机制；
3. 权限错配 —— 注意API调用身份是“当前用户”还是“系统账号”；
4. 历史数据迁移 —— 新增关联字段后需批量补录映射关系；
5. 版本兼容 —— 表单结构调整后需验证自动化规则是否仍有效。

10. 总结与展望

宜搭完全支持通过关联表单、API连接器和业务规则实现审批单之间的双向数据联动。关键在于根据业务复杂度选择合适的技术路径，并在设计初期考虑数据模型的可扩展性与权限体系的完整性。

未来随着宜搭对GraphQL查询、事件驱动架构的支持增强，跨应用数据编织（Data Fabric）将成为可能，进一步降低集成成本。