4. 字段映射关系

车辆主数据在ERP与TMS之间同步时，字段映射并非简单的“复制粘贴”。由于两个系统的业务视角不同（ERP侧重资产与财务，TMS侧重调度与在途执行），字段映射存在三种核心关系：一对一、多对一和派生字段。理解并正确配置这些映射规则，是保障数据一致性与业务闭环的关键。

4.1 字段映射关系总览

下表梳理了车辆主数据同步中最常见的字段映射类型及其典型示例：

4.2 一对一映射规则详解

一对一映射是最简单、最稳定的映射关系，通常用于车辆的核心静态属性。映射时需注意值编码的转换，而非简单的字段名对应。

• 直接复制型：如车牌号、VIN码、品牌型号等，ERP与TMS使用相同的数据格式和长度，直接映射即可。
• 值映射型：如车辆类型、燃料类型、排放标准等。ERP使用内部代码（如“01”代表柴油），TMS使用业务描述（如“柴油车”）。需建立值映射表，在同步中间件中完成转换。
• 格式转换型：如日期格式（ERP: YYYYMMDD → TMS: YYYY-MM-DD）、数字精度（ERP: 载重保留2位小数 → TMS: 保留1位小数）。

4.3 多对一映射规则详解

多对一映射用于将ERP中分散的、不同单位的字段合并为TMS所需的单一业务字段。核心难点在于单位换算与数据聚合逻辑。

典型场景示例：

• 载重合并：ERP可能同时维护“核定载质量(kg)”和“核定载质量(t)”两个字段，TMS只需“最大载重(吨)”。映射规则：IF ERP.核定载质量(t) IS NOT NULL THEN TMS.最大载重 = ERP.核定载质量(t) ELSE TMS.最大载重 = ERP.核定载质量(kg) / 1000。
• 尺寸合并：ERP存储车长、车宽、车高（单位mm），TMS需要“车厢容积(立方米)”。映射规则：TMS.车厢容积 = (ERP.车长 / 1000) * (ERP.车宽 / 1000) * (ERP.车高 / 1000)。
• 联系人合并：ERP可能分别存储“驾驶员1姓名”、“驾驶员1电话”、“驾驶员2姓名”、“驾驶员2电话”，TMS只需“主驾驶员姓名”和“主驾驶员电话”。映射规则：优先取驾驶员1，若为空则取驾驶员2。

4.4 派生字段映射规则详解

派生字段是TMS基于ERP源数据通过计算、逻辑判断或外部数据引用生成的字段，这些字段在ERP中不存在或含义不同。派生字段是TMS实现精细化调度和智能分析的基础。

常见派生规则分类：

• 计算派生：如车龄（当前日期-购置日期）、下次年检日期（上次年检日期+1年）、剩余里程（总里程-已行驶里程）。
• 状态派生：如车辆可用状态。ERP状态为“在库”且无未关闭运单 → TMS状态为“空闲”；ERP状态为“出车”且有在途运单 → TMS状态为“在途”；ERP状态为“维修”且维修天数>3天 → TMS状态为“停用”。
• 组合派生：如车辆唯一标识（发动机号+底盘号后6位）、车辆全称（品牌+型号+排量）。
• 外部引用派生：如根据VIN码调用第三方接口获取车辆排放标准、根据车牌号查询车辆违章次数。这类派生依赖外部系统，需设计异步同步或定时刷新机制。

4.5 字段映射关系架构图

下图展示了ERP车辆字段经过一对一、多对一、派生三种映射规则后，生成TMS车辆主数据的完整链路：

4.6 映射规则配置示例（JSON Schema）

在实际集成项目中，字段映射规则通常以配置化方式管理。以下是一个简化的映射规则JSON示例，展示了三种映射类型的配置结构：

{
  "mappingRules": {
    "vehicleId": {
      "type": "ONE_TO_ONE",
      "sourceField": "plateNumber",
      "targetField": "plateNumber",
      "transform": "direct"
    },
    "vehicleType": {
      "type": "ONE_TO_ONE",
      "sourceField": "vehicleTypeCode",
      "targetField": "vehicleType",
      "transform": "valueMapping",
      "valueMap": {
        "01": "厢式货车",
        "02": "平板车",
        "03": "冷藏车"
      }
    },
    "maxLoad": {
      "type": "MANY_TO_ONE",
      "sourceFields": ["ratedLoadKg", "ratedLoadTon"],
      "targetField": "maxLoadTon",
      "transform": "coalesceWithUnit",
      "rules": [
        {"condition": "ratedLoadTon IS NOT NULL", "expression": "ratedLoadTon"},
        {"condition": "ratedLoadKg IS NOT NULL", "expression": "ratedLoadKg / 1000"}
      ],
      "defaultValue": 0
    },
    "vehicleAge": {
      "type": "DERIVED",
      "sourceFields": ["purchaseDate"],
      "targetField": "vehicleAgeMonths",
      "transform": "dateDiff",
      "expression": "DATEDIFF(MONTH, purchaseDate, GETDATE())",
      "refreshPolicy": "daily"
    },
    "availableStatus": {
      "type": "DERIVED",
      "sourceFields": ["erpStatus", "activeOrderCount"],
      "targetField": "availableStatus",
      "transform": "stateMachine",
      "stateMachine": {
        "states": [
          {"erpStatus": "在库", "activeOrderCount": 0, "result": "空闲"},
          {"erpStatus": "出车", "activeOrderCount": ">0", "result": "在途"},
          {"erpStatus": "维修", "repairDays": ">3", "result": "停用"}
        ],
        "defaultState": "未知"
      }
    }
  }
}

4.7 映射规则验证与异常处理

字段映射过程中，数据质量直接影响TMS调度决策。必须建立以下验证与异常处理机制：

• 空值校验：对于必填字段（如车牌号、车辆类型），若ERP源数据为空，应拒绝同步并记录告警日志。
• 格式校验：如VIN码长度必须为17位，日期格式必须符合预期，不符合则标记为“数据异常”。
• 值域校验：值映射时，若ERP代码不在映射表中，应使用默认值或触发人工审核流程。
• 一致性校验：同步完成后，定期对比ERP与TMS的关键字段（如车牌号、VIN码），发现不一致时自动触发重新同步。
• 异常补偿：对于派生字段计算失败的情况（如外部接口超时），应保留上次成功值，并记录失败原因，待下次同步时重试。