MarketingSystemDataExportTool/server/docs/field_mapping.md

1.3 KiB

字段映射与去重策略

目标

  • 避免导出的 Excel 中出现同名列导致语义冲突
  • 当不同表存在语义不同但中文名相同的字段时,消除歧义
  • 保证从主表提取的核心字段只出现一次

关键变更

  • ymt 数据源中 order_digit.order_type 的中文列名从“订单类型”调整为“商品类型”
  • 当同一导出模板中不同表出现相同列名时,对非主表字段自动添加前缀:<表显示名>.<列名>,例如:
    • order.type订单类型
    • order_digit.order_type直充卡密订单.商品类型

表显示名

  • order → 订单主表
  • order_detail → 订单详情
  • order_cash → 红包订单
  • order_voucher → 立减金订单
  • order_digit → 直充卡密订单
  • 其他参见后端 tableLabel 定义

使用建议

  • 如需仅导出“订单类型”,请选择主表字段 order.type
  • 如需区分直充/卡密的商品类型,可额外选择 order_digit.order_type,导出列名为“直充卡密订单.商品类型”

兼容性

  • 该变更仅影响导出列头的中文显示,不影响 SQL 字段来源与数据准确性
  • 现有模板无需修改;若模板包含两列“订单类型”,修复后其中一列会显示为带前缀的“直充卡密订单.商品类型`