在将 Dynamics 365 Supply Chain Management (SCM) 升级到 10.0.36 或更高版本后,若系统启用了“版本维度”(Version Dimension),此前安装的自定义解决方案可能出现 API 调用失效、地图映射错误以及 Commerce 渠道不支持等问题。以下是基于资料内容的检查与修复指南。

**版本维度的默认状态**
自 SCM 10.0.36 起,新版本系统默认启用版本维度,但旧系统升级至此版本后不会自动启用。若需启用,必须手动开启配置键。

**兼容性风险与检查重点**
启用版本维度前,若系统安装了其他自定义解决方案(特别是涉及库存维度的),部分功能可能失效。需重点检查以下内容:
1. **API 调用**:扩展类中的 API 调用若未包含版本维度,可能导致失效。资料列出了几个因引入版本维度而废弃的 API,需在启用前修复:`RetailTransactionServiceInventory::getProductRecordId`、`EcoResProductNumberIdentifiedProductVariantEntity::find`、`EGAISAlcoholProduction_RU::findByItemDim` 和 `PCVariantConfiguration::findByProductMasterAndDimensions`。
2. **地图映射**:任何使用库存维度的地图,其关系映射必须更新以包含版本维度。需在扩展模型或表扩展中检查包含库存维度的字段。
3. **自定义解决方案引用**:若代码显式引用了库存维度(如 `InventDimId` 以外的特定维度),需确保这些引用能正常工作。

**Commerce 渠道的局限性**
启用版本维度后,该维度会出现在 Commerce 相关代码中,但存在已知限制:
- **不支持销售/发货/退货**:Commerce 渠道(包括 POS、呼叫中心及电商应用)目前不支持按版本维度进行库存买卖、发货或收货操作。
- **库存查询**:Commerce 应用中的库存可用性查找功能无法区分按版本维度的库存。
- **其他限制**:版本维度产品无法添加到供应商目录;不支持成本对象月度报表、成本对象报表缓存及 MCR 单品销售统计。目前暂无 Commerce 订单支持的确认时间表。

**启用步骤**
1. 将系统置于维护模式。
2. 进入“系统管理 > 设置 > 许可配置”,在“配置键”选项卡下展开“贸易”部分,勾选“产品维度 - 版本”。
3. 关闭维护模式。

**重要提示**
启用后,若某些解决方案因引用库存维度而停止正常工作,需联系独立软件供应商(ISV)进行修复。此外,版本维度没有预定义的“版本组”概念,版本是在产品生命周期中按需创建的。

信息来源