CDM是可自我描述、语义激活的底层数据框架，通过定义传感器观测值表达、时间戳时区、单位制等本质约束实现跨系统语义互通；CDMMapping.xml是IBM Control Desk中对接DIS的映射配置文件，须符合预定义schema且修改后需重启DIS生效。
CDM（Common Data Model）不是一种“规范”本身，而是一个**可自我描述、语义激活的底层数据框架**——它不强制统一所有字段名或业务逻辑，而是通过明确定义“传感器观测值怎么表达”“时间戳带不带时区”“单位用 SI 还是工程制”这类本质约束，让不同系统能真正“读懂彼此的数据”，而不是只靠字段名硬对。
它在 XML 映射中不直接出现，但起着关键支撑作用：XML 文件（比如 CDMMapping.xml）之所以能稳定工作，正是因为背后有 CDM 提供的语义锚点。没有 CDM，maximo.assetnum 和 DIS.assetIdentifier 的映射就只是字符串替换；有了 CDM，它们才被共同锚定到“资产唯一标识”这个业务语义上，哪怕将来字段名全换，只要语义不变，映射规则依然有效。
CDMMapping.xml 是什么？为什么不能手写改错就上线
这是 IBM Control Desk 中用于对接 DIS（Data Integration Service）的配置文件，核心作用是把 Maximo 数据库字段（如 workorder.status）映射到 DIS 要求的命名属性（如 DIS.workOrderStatus），最终生成 NRS 集成标识。
- 它不是自由格式 XML：必须符合预定义的 schema，根节点是
<CDMMapping>，每个<mapping>必须含source和target属性，且target值必须是 DIS 已注册的命名属性 - 修改后必须重启 DIS 服务才能生效——改完 XML 不重启，等于没改
- 如果
target写了 DIS 不认识的名字（比如拼错成DIS.workOrderStaus），DIS 启动时会静默跳过该条映射，不报错也不警告，但数据就丢了 - 字段为空时是否参与映射？CDMMapping.xml 默认不处理空值逻辑，空值会原样传过去；如需过滤，得靠 DIS 的清洗规则或前置 XSLT
XML 映射 ≠ CDM，但 CDM 决定映射能不能长期维护
你在 Integration Composer 或自研 ETL 中写的 XSLT 或 XmlDocument.Load() + XPath 处理，属于技术层映射；而 CDM 是业务层契约。两者脱节时，典型问题如下：
Pandas 配置文件报告生成器
下载
使用ydata-profiling（前身为pandas-profiling）生成全面的数据质量报告，包含相关性分析、缺失值模式和基数检测。导出交互式HTML仪表板和JSON摘要。
- 某银行把
loan.interestRate映射为DIS.annualInterestRatePct，但 CDM 定义里后者单位是“百分比数值”（如 4.5），而源系统存的是小数（0.045）——映射代码没做乘100，结果利率全错 100 倍 - CDM 规定
sensor.timestamp必须是 ISO 8601 带时区格式（2026-01-14T12:10:00+08:00），但 XML 映射脚本直接用了DateTime.Now.ToString("yyyy-MM-dd HH:mm:ss")，导致下游解析失败 - 不同团队各自维护 XML 映射，A 团队把客户地址拆成
addr.street/addr.city，B 团队用一个addr.fullText字段——表面都能跑通，但 CDM 要求结构化地址以便地理编码，这种“能跑≠合规”
如何验证你的 XML 映射真正在 CDM 框架下工作
别只测“XML 能生成”，要测“语义没漂移”。实操建议：
- 用
System.Xml.Schema.XmlSchemaSet加载 CDM 官方提供的 XSD（如有），再用XmlReader.Create(..., settings)开启 DTD 和 Schema 验证，强制校验输出 XML 是否满足 CDM 结构要求 - 在映射逻辑里加断言：例如读取
source字段后，立刻检查其值是否符合 CDM 对该字段的约束（如非空、长度≤50、正则匹配手机号格式），不符合就抛InvalidOperationException并带 CDM 字段 ID - 把 CDM 的语义定义（比如 “
DIS.assetLifecycleStage取值只能是 'commissioned'/'decommissioned'/'maintenance'”）写成单元测试的[TestCase]，每次更新映射都跑一遍 - 避免在 XSLT 里硬编码业务逻辑（如用
<xsl:if test="status='APPR'">），应提取为参数或引用外部 lookup 表——因为 CDM 约束可能随监管变化，硬编码会让映射和 CDM 脱钩
