企业级产研文档库

外观

如何配置对象导入规则 ​

配置对象数据导入前的预处理、校验和流程触发方式。

概述 ​

对象导入规则用于在对象数据导入前执行预处理或校验逻辑。管理员可以按对象配置导入前预处理 APL、导入前验证 APL，也可以统一管控前台导入时是否触发工作流、阶段推进器和审批流。

适用场景：

  • 导入订单时，先汇总订单行金额并写入订单头字段。
  • 导入前按业务类型校验字段是否必填。
  • 导入前分批处理数据，避免一条异常数据影响整批导入。
  • 统一管控某个对象导入时是否触发流程。

入口 ​

在 管理后台 > 对象管理 > 自定义对象管理 > 导入设置 中配置对象导入规则。

对象导入规则入口

WARNING

原始资料以自定义对象为主。预设对象是否支持同等配置能力，需要按当前版本人工确认。

导入数据预处理 ​

导入数据预处理用于在正式导入前提前处理数据。预处理 APL 会在前验证 APL 之前执行。

预处理适合处理：

  • 批量计算并写入临时结果。
  • 按导入任务缓存中间数据。
  • 对一批数据进行统一清洗或转换。
  • 为后续前验证逻辑准备上下文。

处理特点：

  • 系统按批次执行预处理。
  • 原始资料中说明每批 20 条数据，保存在 context.dataList 中。
  • 可通过缓存保存预处理结果，供前验证 APL 读取。
  • 预处理返回失败时，可以终止本次导入。

导入预处理和前验证

导入前验证 ​

导入前验证用于在数据写入前执行校验。它与新建、编辑页面的前验证类似，可以返回错误信息并阻断导入。

前验证适合处理：

  • 校验导入数据是否符合业务规则。
  • 按业务类型控制字段必填。
  • 校验字段组合是否有效。
  • 将校验失败原因写入导入失败文件。

前验证返回值类型为 validateResult。校验失败时，错误信息会回填到 Excel 失败列表中。

处理时机 ​

对象导入规则按导入方式区分处理时机：

处理时机说明
新建导入前台选择“添加新数据”时执行
更新导入前台选择“更新现有数据”时执行

每种处理时机下，只能配置一个预处理 APL 和一个前验证 APL。若有多个业务判断，请在同一段代码中完整处理。

导入处理时机

管控导入方式 ​

管理员可以在后台统一管控前台导入时的流程触发选项。

导入方式可管控内容
新建导入是否触发工作流和阶段推进器、是否触发审批流
更新导入是否触发工作流

开启管控后，前台导入页面中的对应选项会同步后台配置，并且用户不可修改。

管控导入方式

配置建议 ​

  1. 先明确导入场景是新建导入、更新导入，还是两者都需要。
  2. 对简单字段校验，优先使用验证规则或字段必填。
  3. 对跨字段、跨行或需要缓存的复杂逻辑，再使用预处理和前验证 APL。
  4. 在测试环境用少量数据验证导入结果和失败文件提示。
  5. 上线后记录导入规则用途、维护人和影响对象。

风险提示 ​

  • 导入规则会影响对象数据导入成功率。
  • APL 逻辑异常可能导致导入失败。
  • 预处理和前验证需要考虑批量执行性能。
  • 流程触发管控会影响前台用户导入时的可选项。

相关主题 ​