FlyFlow

💎明细【PRO】

# 功能概述

明细表组件用于将多个数据表单聚合为一张可动态增删行的表格，适用于需要批量录入或展示结构化数据的场景。支持 Excel 批量导入、字段汇总、节点权限控制等能力。

# 显示页面

明细表在表单中的呈现效果如下图所示：

# 配置页面

明细表组件配置界面如下图所示：

# 基本配置

  1. 数据来源
    明细表由多个数据表单聚合而成，可通过拖拽左侧已定义的数据表单至明细组件区域进行添加。

  2. 动态行数
    支持运行时动态增加或删除明细行，满足用户按需录入的需求。

# Excel 批量导入

明细表支持通过 Excel 文件批量导入数据，提升录入效率。

# 导入模板

  • 支持上传自定义 Excel 模板，用于规范导入列格式。
  • 用户下载模板后按格式填写数据，再上传完成导入。

# 远程接口配置

为实现 Excel 导入功能，需配置远程接口，系统会将解析后的 Excel 数据发送至该接口，接口需按指定格式返回处理后的明细数据。

# 请求参数

系统调用接口时，会传递以下 JSON 结构：

{
    "excelDataList": [
        ["1", "张三"],
        ["2", "李四"]
    ],
    "flowId": "",
    "processInstanceId": "",
    "formId": ""
}
字段名 类型 说明
excelDataList Array<Array<string>> FlyFlow 解析 Excel 后生成的二维数组，每个子数组代表一行数据
flowId string 当前流程 ID
processInstanceId string 流程实例 ID（发起后存在）
formId string 当前表单 ID

接口收到数据后，需按实际业务逻辑将数组数据转换为对应的表单字段值，并返回给前端用于展示。

# 返回数据格式

接口需返回如下 JSON 结构：


{
    "code": 0,
    "ok": true,
    "msg": "success",
    "data": [
        {
            "flyflow_form_565773932949": "张三",
            "flyflow_form_565773932948": 18
        },
        {
            "flyflow_form_565773932949": "李四",
            "flyflow_form_565773932948": 20
        }
    ]
}

# 数据格式注意事项

返回的字段值必须与对应表单组件的数据类型严格匹配，否则会导致解析失败。常见类型示例：

多选字段：

[
    { "key": "option_1", "value": "选项一" },
    { "key": "option_2", "value": "选项二" }
]

数字 / 金额 字段：直接返回数值类型（如 18、99.50）

文本 字段：返回字符串类型

各表单字段的具体数据格式，可参考本目录下对应表单组件的独立文档。

# 节点权限控制

在流程节点的明细表权限设置中，支持以下控制项：

权限类型 说明
只读 明细表为只读状态，不可新增、删除或编辑行数据
内部表单独立控制 明细表中的每个字段可单独设置是否可编辑、可见等权限，支持精细化管控

# 字段汇总

明细表支持对指定类型的字段进行汇总计算，汇总结果可用于流程条件判断。

# 支持汇总的字段类型

  1. 数字
  2. 金额
  3. 公式

配置方式 每个字段需单独开启汇总开关，默认为关闭状态。开启后，该列底部会自动显示汇总值。

# 数据格式（值格式）

明细表在流程中提交或存储时，其数据格式为 对象数组，每个对象对应一行明细数据，Key 为表单字段 ID，Value 为该字段的值。

[
    {
        "cxygzl_040705364741": "试试"
    },
    {
        "cxygzl_040705364741": "阿斯蒂芬"
    }
]

当明细表包含多个字段时，每个对象中会包含所有字段的 Key-Value 对。

# 流程分支条件

在流程条件节点中，可对明细字段进行以下逻辑判断，以控制流程走向：

明细行数

条件 说明
等于 数值相等
不等于 数值不等
大于 大于目标值
大于等于 大于或等于目标值
小于 小于目标值
小于等于 小于或等于目标值
为空 字段无值（未填写）
不为空 字段已填写

如果有汇总表单，比如数字，也可以对该数字表单求和做条件分支

条件 说明
等于 数值相等
不等于 数值不等
大于 大于目标值
大于等于 大于或等于目标值
小于 小于目标值
小于等于 小于或等于目标值
为空 字段无值（未填写）
不为空 字段已填写

# 注意事项

  1. 修改明细表配置后，请保存并重新发布流程，否则更新不生效。

  2. Excel 导入时，请确保模板列与表单字段类型匹配，避免数据转换异常。

  3. 若接口返回数据格式有误，系统会提示导入失败，请参照返回格式规范调整。

💎地区【PRO】