XLCS 模板自动升级工具新手使用说明

📌 快速导航

导航	链接
⚡️ 模版下载	/categories/模版下载/
📑 版本矩阵	/categories/版本矩阵/
🚀 上手指南	/categories/上手指南/
❓ 更新日志	/categories/更新日志/
🛠 讨论求助	https://xlcs.de/

XLCS 模板自动升级工具 - 新手快速上手使用说明书

📖 核心概念与定位

XLCS 模板升级工具 是为 XLCS 房产项目全成本测算模板设计的独立升级工作台。它通过将迁移代码、版本规则、临时数据和升级报告封装在工具文件内，保证升级过程安全、可追踪、可复核：

升级工具：承载迁移规则、执行代码、临时数据、运行日志、迁移报告和体检报告。
旧模板：仅作为只读数据源，读取完成后自动关闭，不保存、不修改原文件。
新模板：作为纯净写入目标，写入完成后另存为升级副本，原新版模板不会被覆盖。

⚠️ 安全提示：请不要手工同时打开旧模板和新模板。工具会自动控制“选择旧模板 → 只读打开 → 读取数据 → 关闭旧模板 → 选择新模板 → 写入并另存副本”的流程，减少 VBA 工程冲突、链接更新和重计算卡死风险。

⚙️ 准备工作：自动宏配置

写入新模板后，工具可以按配置自动执行新版模板中的后处理宏，例如刷新城市状态、生成融资利息、生成前期工程支付计划等。

新版工具的自动宏配置已从首页单元格迁移到独立配置表：

1	AutoMacroConfig_自动宏配置

首页只显示自动宏配置摘要，不再把首页 C8/E8/G8/C9/E9/G9 作为真实配置来源。

如何修改自动宏配置

打开工具首页。
查看“写新后自动宏配置”摘要。
点击首页的 【编辑自动宏】 按钮。
在 AutoMacroConfig_自动宏配置 表中修改 D列 “是否执行”。
将需要执行的宏设置为“是”，不需要执行的设置为“否”。
修改会长期保存，刷新首页不会丢失。

自动宏配置项说明

配置项	宏名称	说明
刷新城市	`XLCS_刷新城市状态`	写新后刷新城市相关联动状态
更新副本	`UpdateDuplicateInfo`	刷新前期工程指标或副本信息
计算融资	`CalculateAllFinancing`	生成融资利息
非标贷款	`CalculateNonStandardLoan`	生成非标融资利息
生成支付	`GeneratePaymentPlan`	生成前期工程支付计划
全工作簿重算	`__CALCULATE_ALL__`	写新收尾阶段执行全工作簿重算

建议：首次测试升级时，可先只开启“刷新城市”和“生成支付”，确认结果无误后再按需要开启融资计算和全工作簿重算。

🚀 升级操作流程（二选一）

推荐方案：分步升级流程

适合初次使用、版本跨度较大、或需要中途核对旧数据时使用。

1. 打开工具

打开 XLCS模板升级工具V1.x.xlsm，并启用宏。

如使用 WPS，请确认已安装 VBA 插件，并允许宏运行。

2. 初始化或刷新首页

首次使用或工具界面异常时，点击首页 【刷新首页】。

初始化会检查核心工作表、规则表、日志表、迁移报告、迁移汇总和体检表是否存在，不会清空已有版本规则。

3. 读取旧模板数据

点击首页 【① 读旧文件】，选择旧版测算文件。

工具会自动：

只读打开旧模板；
识别旧模板版本；
匹配 VersionRule_版本规则 中的历史规则；
激活对应的 SimpleFieldMap_升级字段 和 AnchorMap_升级定位；
读取旧模板中的可迁移数据；
写入 LegacyData_临时读取；
关闭旧模板。

如果旧文件版本没有完全匹配的规则，工具会推荐接近版本规则，并弹出风险确认。确认后可继续读取，但升级完成后应重点复核关键数据。

4. 核对旧数据

读取完成后，可点击首页 【旧数据】，查看：

1	LegacyData_临时读取

重点可检查：

旧文件版本；
实际采用规则；
读取记录数；
主要业务对象是否已读取。

5. 写入新模板

点击首页 【② 写新模板】，选择纯净新版模板文件。

工具会自动：

打开新版模板；
识别新版模板版本；
激活新版模板对应写入规则；
弹出写新前规则确认；
将 LegacyData_临时读取 中的数据写入新版模板；
按 AutoMacroConfig_自动宏配置 执行写新后自动宏；
执行必要计算；
另存为升级副本；
生成 MigrationReport；
返回工具首页。

写新完成后，新版模板原文件不会被覆盖。

极速方案：一键升级流程

适合批量升级、规则已确认、或同类文件重复升级时使用。

打开工具并确认自动宏配置。
点击首页 【③ 一键升级】。
按提示选择旧版测算文件。
按提示选择新版测算模板。
工具自动完成完整流程：

1	读取旧数据 → 关闭旧模板 → 写入新模板 → 执行自动宏 → 另存副本 → 生成汇总 → 写新后体检

一键升级会尽量保持静默执行，不主动切换到规则页、日志页或体检页。中间过程写入运行日志，最终统一提示升级结果。

🧾 升级结果与生成文件说明

1. 升级副本命名规则

写入完成后，工具会将新版模板另存为带时间戳的升级副本。

命名格式：

1	新模板文件名_旧模板文件名_时间戳.xlsm

如果未能读取到旧文件名，则使用兜底格式：

1	新模板文件名_已升级_时间戳.xlsm

原旧模板和原新版模板都不会被覆盖。

2. 迁移报告

写新完成后，工具会生成：

1	MigrationReport

该表记录每一项写入结果，包括：

成功；
完成；
跳过；
失败；
字段编码；
字段名称；
对象类型；
目标地址；
说明。

如果存在“失败”项，请优先查看“说明”列。

3. 迁移汇总

点击首页 【生成汇总】，或执行一键升级后，工具会生成：

1	MigrationSummary_迁移汇总

汇总页用于快速查看：

总记录数；
成功数；
完成数；
跳过数；
失败数；
成功率；
对象类型统计；
失败明细；
跳过明细；
版本规则风险提示。

4. 写新后体检

一键升级完成后，工具会自动运行写新后体检，结果写入：

1	CheckReport_工具体检

体检会检查运行环境、核心工作表、版本规则、当前运行规则表、LegacyData、MigrationReport、MigrationSummary 和运行日志等内容。

如果体检发现失败项，请优先查看 CheckReport_工具体检 和 Log_运行日志。

⚠️ 关键注意事项

1. 城市状态刷新

如果自动宏配置中“刷新城市”设为“是”，工具会在写新后执行：

1	XLCS_刷新城市状态

该宏用于触发新版模板 02基本指标录入!G11 相关的城市联动逻辑。

如果升级后城市名称或城市状态仍不正确，请检查：

AutoMacroConfig_自动宏配置 中“刷新城市”是否为“是”；
新版模板中是否存在 XLCS_刷新城市状态 公开宏；
02基本指标录入!G11 的城市值是否正确；
必要时在升级后副本中手动执行一次 XLCS_刷新城市状态。

2. 车位售价单位自动转换

旧版模板中“非人防车位售价”单位为元/个，新版模板中“车位售价”单位为万元。

工具写入时会自动执行：

1	元/个 ÷ 10000 = 万元

无需人工换算。该规则已由管理员固化到规则表中，不会因普通升级操作丢失。

3. 无效产品过滤与老无新有处理

如果旧文件某产品“房源面积”为空或为 0，工具会判定该产品未实际启用：

该产品的产品属性不迁移；
该产品的户配数据不迁移；
该产品的部分工程指标不迁移；
新版对应产品行的房源面积会写为 0；
不会清空整行公式和默认值，避免破坏新版模板结构。

4. 前期工程指标有效产品过滤

工具根据旧模板 04.1工程指标 第 152 行“工程成本合计”是否非空、非 0、非“-”，识别实际启用的工程产品。

未启用的普通产品不会被带入新版前期工程指标区，避免旧模板全产品列污染新版模板。

5. 配套用房及附属/地下空间保护

配套用房及附属/地下空间区域按固定二维表迁移，但存在保护规则：

K:N 列为公式汇总列，禁止覆盖；
V9.1 及以前版本没有新版 O:P 新增手填列，工具会跳过并保持为空；
无明确新版指标列的旧版字段会被跳过，保留新版默认公式或默认值。

6. 新版模板版本号保护

新版模板版本号位于：

1	02基本指标录入!M1

写新时工具会跳过该单元格，保留新版模板原始版本号，防止被旧文件版本号覆盖。

7. 自动宏不是越多越好

自动宏会影响写新后的计算时间，也可能依赖新版模板自身宏权限和公式状态。

建议按实际需要开启：

只需要基础迁移：可全部设为“否”；
需要城市联动：开启“刷新城市”；
需要前期工程支付计划：开启“生成支付”；
需要融资测算结果：开启“计算融资”或“非标贷款”；
需要完整刷新：开启“全工作簿重算”。

8. 管理员功能不要随意点击

首页管理员维护区中的功能仅供规则维护人员使用，包括：

版本扫描；
版本固化；
版本备份；
字段映射诊断；
规则修复类宏。

普通用户只需使用：

1	读旧文件 → 写新模板

或：

一键升级

管理员功能执行前会自动备份规则，但仍不建议普通用户操作。

9. 升级后必须人工复核

工具负责迁移旧文件中的手工输入数据，并尽量保留新版模板公式、默认值和结构。

但新版模板中的以下内容可能与旧版不同：

税费逻辑；
城市库；
成本分摊逻辑；
融资计算逻辑；
销售去化模型；
前期工程支付计划；
汇总指标口径。

升级后的副本文件仍建议由测算人员进行关键指标复核。

✅ 建议复核清单

升级完成后，建议至少检查以下内容：

检查项	建议
城市名称/城市状态	确认城市联动已刷新
产品列表	确认有效产品保留，无效产品房源面积为 0
销售去化	检查产品销售模板和月度去化比例
地块信息	检查地块面积、容积率等关键参数
产品属性	检查房源面积、可售面积、售价等
产品户配	检查户型面积和户数
前期工程指标	检查有效产品列和工程成本指标
配套用房及附属/地下空间	检查手填列和公式列是否正常
融资利息	如开启自动宏，检查融资结果
支付计划	如开启自动宏，检查前期工程支付计划
迁移报告	优先查看失败项和关键跳过项
体检报告	一键升级后查看是否存在失败项

🛠 常见问题快速处理

1. 提示未找到版本规则怎么办？

说明工具中尚未固化该版本模板的升级规则。请联系管理员补充规则后再升级。

2. 提示使用替代规则怎么办？

可以继续，但升级后必须重点核查关键数据。替代规则只代表结构接近，不代表完全适配。

3. 自动宏显示已执行，但结果看起来没变化怎么办？

请检查新版模板宏是否为 Public Sub，宏权限是否开启，以及对应公式是否需要全工作簿重算。必要时可在 AutoMacroConfig_自动宏配置 中开启“全工作簿重算”。

4. 升级后副本打开提示循环引用怎么办？

先查看新版模板自身是否存在循环引用，再尝试手动 F9 重算。如果与前期工程、融资或支付计划相关，请检查对应自动宏是否已执行。

5. MigrationReport 有很多“跳过”是否代表失败？

不一定。跳过可能是正常保护逻辑，例如新版已删除的字段、公式列禁止覆盖、旧版本无来源的新增字段、无效产品过滤等。只有“失败”项需要优先排查。

🌐 官网与支持

类型	地址
官网	http://fccs.cc
官网	http://fckcs.cn
官网	http://fckcs.com
官网	http://fdc.sd
官网	http://fccsz.com
官网	http://cskits.com
求助建议	http://xlcs.de/
邮件联系	admin@fdc.sd