在对账、主数据回填与价目生效管理中，分析师经常需要按编码、名称或区间条件，从查找表把单价、部门、客户编码等字段写回业务底表。Excel 的 VLOOKUP / XLOOKUP 在「只填空、不覆盖」「按下单日落在生效～失效区间」「名称带错字还要对上」等场景里公式冗长、易误伤已有值，也容易改到未点名的表。

「匹配填充」算子专为解决此类跨表回填与区间匹配问题而设计。本案例提供了一套完整的工业测试数据包，带您由浅入深验证算子的仅填空、精确键回填、区间生效日匹配、档位区间、近似匹配、覆盖已有值以及防误伤机制。

一、 案例数据集说明

本案例包含 15 份典型的业务数据表。测试前，建议一键下载全部数据并导入至当前工作流的工作空间中：

下载本案例全部表格（ZIP）

数据声明：本页提供的全部案例表格均为测试数据，由 AI 生成，不对应任何真实个人、机构或业务记录，仅供功能演示与操作练习，请勿作为真实业务依据。

1. 测试表结构速览

数据表名称 业务场景角色 初始包含字段列表 测试重点验证方向
订单表.xlsx 待回填的销售订单底表 订单号, SKU, 下单日, 客户名称, 门店 精确键多列/单列回填、区间生效日取单价、客户名称近似补编码
价目表.xlsx 当前价目查找表（只读） SKU, 单价, 品名 按 SKU 精确回填；查找表不得被改写
历史价目表.xlsx 分段生效价目查找表（只读） SKU, 生效日, 失效日, 单价 下单日落在生效日～失效日（上界可空）时取当时单价
客户主数据表.xlsx 客户标准名称与编码（只读） 客户名称, 客户编码 近似 / 严格近似匹配补编码；未知客户必须空
考勤表.xlsx 待回填的考勤底表 工号, 姓名, 部门 仅填空 vs 覆盖已有值；工号 trim；不得新增未点名的 岗位 列
员工花名册表.xlsx 工号维表（只读） 工号, 部门, 岗位 按工号回填部门；查找表只读
对账表.xlsx 待回填的对账底表 订单号, 行号, 物流单号 已有物流单号与空值并存时的填空/覆盖对照
发货表.xlsx 发货查找表（只读） 订单号, 行号, 物流单号, 发货日 按订单号+行号对齐回填
销售明细.xlsx 销售流水底表 日期, SKU, 数量 异名键回填对照（SKU ↔ 商品编码）
商品主数据.xlsx 商品维表（只读） 商品编码, 商品名称, 品类 异名键：SKU ↔ 商品编码
门店现价表.xlsx 门店维度现价查找表（只读） 门店, SKU, 生效日期, 单价 同门店同 SKU 多条生效日时的匹配对照
金额表.xlsx 待回填折扣的金额底表 订单号, 金额 金额落入档位下限～档位上限时回填折扣
折扣档位表.xlsx 折扣档位查找表（只读） 档位下限, 档位上限, 折扣 上界可空（无上界）的区间命中
大小写订单.xlsx 编码大小写对照底表 单号, 商品码 编码大小写匹配对照
干扰表.xlsx 干扰对照表 备注, 内容 确认未点名的表不被改写

也可以按需单表下载：

二、 测试上手步骤指引

按照以下标准步骤进行交互式测试：

  1. 导入案例数据：在 DT-Bot 界面左侧「工作空间」区域，点击【导入】，批量上传上述 15 个 Excel 表格。
  2. 部署算子节点：在左侧算子库中找到「数据处理」分类下的 「匹配填充」 算子，将其拖拽至中间画布区域。
  3. 录入测试指令：单击选中该「匹配填充」节点，在右侧弹出的属性配置面板中，将下方测试用例中的【测试提示词】复制粘贴至提示词框中。
  4. 执行并核验：点击节点右上角的【运行】按钮。运行完成后，双击节点输出或在「AI 表编辑器」中核对被填表的回填结果、未命中行是否仍在，以及查找表是否只读未改。
  5. 测试复原技巧：
    - 「匹配填充」默认就地改被填的表；查找表只读，不应被改写。
    - 提示词里的表名不要带 _Sheet1。
    - 为避免前一条回填结果污染后续用例，建议在测下一个用例前重新导入原始表格。

三、 核心测试用例集（由浅入深）

用例 1：仅填充空值（已有单元格严格保全）

  • 测试目的：验证按工号从花名册回填部门时，只改空单元格，已有部门不得被覆盖，且未点名的 岗位 列不得落入考勤表。
  • 测试提示词：
按 “工号” 匹配，从 “员工花名册表” 找，把 “部门” 填到 “考勤表” ，仅填充空值。
  • 预期输出结果对比：
  • 修改后「考勤表」部门：张三 → 人事部（原空）；李四 → 销售部（原有值，不得改成别的）；王五 → 财务部（原空）；赵六 → 行政部（工号前有空格，默认 trim 后应对上 004）
  • 核验重点：考勤表不应新增「岗位」列；员工花名册表只读不变；李四原有部门保持原值。

用例 2：精确键多列回填（未命中行保留、查找表只读）

  • 测试目的：验证按 SKU 从价目表同时回填单价与品名；未命中行必须留在表内且对应单元格为空，查找表与未点名表不得改写。
  • 测试提示词：
按 “SKU” 匹配，从 “价目表” 里面把 “单价” 、 “品名” 填到 “订单表” 。
  • 预期输出结果对比：
  • 修改后「订单表」：1 → 单价 10、品名水杯；2 → 单价 20、品名毛巾；3 → 单价 10、品名水杯；4 → 单价/品名空（A99 未命中，行仍在）
  • 行数：订单表仍 4 行
  • 核验重点：价目表、干扰表完全不变；未命中的第 4 行不得被删除。

用例 3：精确键单列回填（未点名列不落表）

  • 测试目的：验证只点名回填「品名」时，订单表仅新增该列，不得顺带落下「单价」。
  • 测试提示词：
按 SKU 匹配，从价目表把品名填到订单表。
  • 预期输出结果对比：
  • 修改后「订单表」：新增「品名」列；1 水杯、2 毛巾、3 水杯、4 空
  • 核验重点：无「单价」列。

用例 4：区间生效日匹配（按下单日落在生效～失效）

  • 测试目的：验证同一 SKU 多段价目时，按下单日落入「生效日～失效日」取当时单价；失效日为空视为无上界。
  • 测试提示词：
按 “SKU”匹配， 从 “历史价目表” 里面把 “下单日” 落在 “生效日” ～ “失效日” 之间的 “单价” 填到 “订单表” 。
  • 预期输出结果对比：
  • 修改后「订单表」单价：1（3月10日）→ 10；2（6月20日 A02）→ 20；3（6月20日 A01，失效日为空=无上界）→ 12；4（A99）→ 空
  • 核验重点：A01 在 6 月 20 日应取第二段单价 12，而不是第一段的 10；历史价目表只读不变。

用例 5：档位区间回填（金额落入上下限）

  • 测试目的：验证按金额落入折扣档位表的「档位下限～档位上限」回填折扣；上界为空视为无上界。
  • 测试提示词：
按金额落在折扣档位表的档位下限到档位上限之间，把折扣填到金额表。
  • 预期输出结果对比：
  • 修改后「金额表」：1 金额 50 → 0.95；2 金额 200 → 0.90；3 金额 800 → 0.80（上界为空，无上界）
  • 核验重点：三档均按区间命中，不得按等值键去对「金额=档位下限」。

用例 6：客户名称近似匹配（错字纠偏补编码）

  • 测试目的：验证客户名称带重复用字等轻微差异时，仍能从客户主数据回填编码；完全对不上的「未知客户」必须空。
  • 测试提示词：
按 “客户名称” 近似匹配，从 “客户主数据表” 里面把 “客户编码” 填到 “订单表” 。
  • 预期输出结果对比：
  • 修改后「订单表」客户编码：1 华为技术有有限公司 → C01；2 阿里巴巴集团有有限公司 → C02；3 腾讯科技有限公司 → C03（完全一致）；4 未知客户 → 空
  • 核验重点：主数据侧无「有有」错字，近似匹配应纠偏到标准名称对应编码；未知客户不得误填。

用例 7：严格近似匹配（少误伤未知客户）

  • 测试目的：验证「严格近似」在尽量对上可对齐记录的同时，未知客户必须保持空，避免过度模糊造成误伤。
  • 测试提示词：
按客户名称严格近似匹配，从客户主数据表把客户编码填到订单表。
  • 预期输出结果对比：
  • 修改后：能对上的仍应对上；未知客户必须空
  • 核验重点：若过于严格导致华为/阿里也对不上，记为阈值偏严（未知客户为空仍是硬条件）。

用例 8：覆盖已有值（空值与非空一并回写）

  • 测试目的：验证显式要求「已有值也要覆盖」时，考勤表部门按花名册整列回写，而不是只填空。
  • 测试提示词：
按工号匹配，从员工花名册表把部门填到考勤表，已有值也要覆盖。
  • 预期输出结果对比：
  • 修改后「考勤表」部门：张三人事部、李四销售部（保持或仍为销售部）、王五财务部、赵六行政部
  • 核验重点：与用例 1 对照，本条允许覆盖；李四结果应为销售部，不得写成其它部门。

四、 常见测试问题与操作贴士（FAQ）

  • Q1：导入 Excel 文件后，工作空间里的表名带上了 _Sheet1（如 订单表_Sheet1），提示词该怎么写？
    答：DT-Bot 具备智能表名模糊匹配能力，在提示词中直接书写 订单表 或 订单表_Sheet1 均可精确命中。本案例提示词按不带 _Sheet1 的表名编写。

  • Q2：为什么运行完成后，左侧工作空间没有出现新的表格？
    答：匹配填充默认就地改被填的表（如考勤表、订单表、金额表）。查找表（价目表、员工花名册表、客户主数据表等）只读，不会被改写。双击当前节点或打开「AI 表编辑器」查看被填的那张源表，即可看到回填结果。

  • Q3：连续测多条回填提示词时发现结果“对不上”？
    答：默认就地改被填表，上一条已经写入的单价、品名、部门或客户编码会留在表里，下一条再跑时基线已变。建议每次切换测试用例前重新导入原始表格，再只粘贴一条提示词运行。