切换查询策略版本
同一张报表可能存在多个查询策略版本，不同版本在字段、取数范围和计算逻辑上并不完全相同。客户端支持自动检测云端策略版本：检测到新版本时提示升级，也可以锁定当前版本、不再接收升级提示。本文说明版本设置窗口中各项的含义，以及自动升级、手动切换和版本回退的处理方式。
一、功能说明
| 能力 | 说明 |
|---|---|
| 版本检测 | 进入报表或版本设置窗口时，比对本地策略与云端最新版本 |
| 升级提示 | 检测到新版本时提示云端版本号与 MD5，可立即升级或锁定当前版本 |
| 自动跟随最新版 | 检测到新版本时提示是否升级，保持与云端版本同步 |
| 锁定当前版本 | 不再检测和下载新版本，报表口径保持不变 |
| 手动选择版本 | 打开版本清单，按文件版本与版本备注指定要使用的版本 |
| 版本信息比对 | 显示当前本地版本 MD5 与云端最新版本号、MD5，可手动刷新 |
| 确认后立即升级 | 勾选后在确认设置时直接升级到云端最新版本 |
| 重进后生效 | 版本切换完成后重新进入报表窗口，查询结果才按新版本输出 |
版本更新方式、云端版本信息与提示文字在不同客户端版本上可能略有差异，以实际界面为准。
二、界面说明
1. 升级提示
检测到新版本时，客户端会弹出提示，显示云端版本号与 MD5，并提供两个选择：
- 【是】：立即升级到云端最新版本。
- 【否】：锁定当前版本，以后不再提示升级。
需要跟上云端口径时选【是】。希望这张报表的取数方式保持不变时选【否】，该报表随即转为锁定状态，后续不再检测和下载新版本。锁定不是永久决定，之后仍可在版本设置窗口里改回自动跟随或手动升级。
2. 查询策略版本设置
在报表窗口点【工作】→【切换查询策略版本】，打开“查询策略版本设置”窗口。
| 区域 | 说明 |
|---|---|
| 当前本地版本 | 显示当前报表正在使用的策略版本 MD5 |
| 云端最新版本 | 显示云端最新版本号、MD5 与状态；两边 MD5 一致时显示“已是最新” |
| 刷新 | 重新向云端查询最新版本信息 |
| 版本更新方式 | 单选项：自动跟随最新版（检测到新版本时提示是否升级）、锁定当前版本（不再检测和下载新版本） |
| 选择其他版本... | 打开“请选择策略版本”清单，指定要使用的文件版本 |
| 确认后立即升级到云端最新版本 | 勾选后，点【确认】时直接升级，不再等下一次提示 |
| 帮助 / 还原退出 / 确认 | 帮助打开说明；还原退出放弃本次修改并关闭窗口；确认保存设置 |
本地与云端 MD5 一致，说明当前使用的就是云端最新版；不一致说明本地版本落后，或者已被指定为其他版本。MD5 只是版本指纹，不需要记住具体值，看两边是否一致即可。刚收到新版本通知或切换过网络环境时，先点【刷新】再判断。
3. 请选择策略版本
点【选择其他版本...】后进入版本清单，用于指定某个确定的文件版本。
- 文件版本：策略的版本序号，序号越大通常越新。
- 版本备注：发布时填写的改动说明，例如“最新策略改了实付金额计算逻辑”“添加来源字段，方便客户对账”。
窗口底部显示当前过滤状态，【定制显示效果】可调整列表的显示内容；双击一行可快速返回并选中该版本；点【确定】使用选中版本，点【取消】返回且不改动当前版本。
选版本时先读版本备注。备注会写明这一版改了什么，只看文件版本号容易选到不需要的口径。
三、操作流程
打开需要调整的报表，例如 POS 收款分析。
点报表窗口左上角的【工作】→【切换查询策略版本】。
在版本设置窗口查看当前本地版本与云端最新版本；云端信息不是最新时点【刷新】。
选择版本更新方式：需要跟进云端口径选“自动跟随最新版”；当前口径已固定、近期需要历史可比选“锁定当前版本”。
需要指定某个版本时点【选择其他版本...】，在清单中按文件版本与版本备注选择，双击该行或点【确定】返回。
需要立即用上云端最新版时，勾选“确认后立即升级到云端最新版本”，再点【确认】。
系统提示版本已切换，并提示需要重新进入当前窗口查询。
关闭并重新进入报表窗口查询，结果按新版本输出，新版本添加的字段会出现在查询结果中。
四、使用要点
- 先看版本备注再升级。 备注会写明这一版改了什么，例如计算逻辑调整或新增字段。计算逻辑变化会影响报表结果，不能只当作加了一列。
- 对外报表在周期内锁定。 月报、对账单、考核报表在统计周期内锁定版本，避免月中升级后前后数据不可比。
- 升级前留一份底稿。 把当前查询结果导出表格，或记录窗口显示的 MD5。升级后口径有疑问时，可以拿底稿逐项核对差异来源。
- 按报表分别确认。 版本设置在报表自己的窗口里完成，切换一张报表的版本不会改动其他报表，不要以为升过一次就全部生效。
- 由固定岗位统一管理。 版本决定报表的取数口径，建议由财务或数据管理岗位统一判断，收银和门店端不要各自切换。
- 升级避开月结、盘点和集中对账时段。 新版本首次查询需要按新策略取数，放在业务低峰操作更稳妥。
五、与其他功能的关系
| 环节 | 对应功能 |
|---|---|
| 策略字段与取数设计 | 查询策略学习 |
| 查询条件的设置 | 查询条件窗口 |
| 大数据量报表查询 | 大数据分析查询策略 |
| 报表参数与打印设置 | 报表参数用户特点 |
| BI 报表体系 | BI 报表分析 |
| 网页端筛选方案 | 查询条件与筛选方案 |
六、验收清单
| 检查项 | 通过标准 |
|---|---|
| 新版本提示 | 云端有新版本时弹出提示，显示云端版本号与 MD5 |
| 立即升级 | 提示中选【是】或勾选立即升级后，重进报表能查到新版本内容 |
| 锁定生效 | 提示中选【否】后，再次进入该报表不再弹出升级提示 |
| 自动跟随 | 更新方式设为自动跟随后，后续有新版本仍会提示 |
| 手动选版 | 版本清单可按文件版本与备注选择，确定后窗口内的版本信息随之变化 |
| 版本比对 | 本地与云端 MD5 一致时显示“已是最新” |
| 还原退出 | 修改设置后点【还原退出】，再次打开窗口时设置未改变 |
| 重进生效 | 切换版本后重新进入报表，查询结果按新版本输出 |
七、常见问题
提示里点了【否】，以后还会提示吗？ 不会。选【否】会把这张报表的更新方式改为锁定当前版本，之后不再检测和下载新版本。需要恢复自动升级时，重新打开“查询策略版本设置”，把更新方式改回自动跟随最新版，或勾选“确认后立即升级到云端最新版本”。
锁定以后还能手动升级吗？ 可以。锁定只停止自动检测与提示，不影响在版本设置窗口里点【刷新】、选择其他版本或立即升级。
升级后报表的列或数字变了，正常吗？ 正常。新版本可能新增字段，也可能调整计算逻辑，例如实付金额的统计方式发生变化，字段数量和数值都会与旧版不同。先看版本备注确认改动内容，再拿升级前的导出结果逐项核对。
本地和云端 MD5 不一样，要马上处理吗？ 不一定。MD5 不一致只说明本地不是云端最新版，不等于报表有问题。对外报表如果在统计周期内需要保持口径，可以先锁定；内部报表需要新字段或修正时再升级。
为什么显示“已是最新”，还是没有我要的字段？ “已是最新”只代表本地与云端版本一致，不代表这一版包含你要的字段。字段是否出现在报表里还取决于策略中的“选中”“可见”设置，需要到查询策略修改窗口里核对；策略本身没有的字段，要靠升级或定制解决。
同一张报表在不同电脑上看到的版本不一致，怎么办？ 先各自打开版本设置窗口点【刷新】，比对窗口里的云端最新版本号与 MD5，找出哪一台与本机不一致，再在需要统一的电脑上选择版本或立即升级。不要只看报表结果判断版本，字段相同不代表策略版本相同。