【升级注意事项】V9.7➜V10.5

以便把数据抽取到高速缓存库，例如在数据模型中创建跨库查询、存储查询等操作，系统会切换到抽取模式。

（1）数据来源：数据集、数据源层的表、透视分析、即席查询。

（2）参数：直接使用数据集设置的参数。

（1）数据来源：默认为模型查询、SQL查询。

（2）参数：无法直接使用数据集设置的参数。需要在“参数管理”中设置参数的映射关系才能使用。详情请参考 电子表格⬝ 参数管理 。

（1）虽然这次ECharts版本升级能在性能上得到提升、它的新版也修复一些问题；但同时会带来图形样式等改变，有些用户会关心如何恢复旧图形效果，详情变更说明与恢复操作请查阅ECharts升级注意事项（V8、9.5升级V10.5）

（2）相比4.X版本，ECharts V5.1.2对部分图形的图形配置项做了调整，因此，旧版本的图形宏代码如果调整过图形配置项可能会存在不兼容的情况，届时需要联系官方支持或者参考ECharts官方图形配置项进行修改，对此进一步评估是否兼容或改造。

V10.5 合并自助仪表盘与大屏可视化入口，更名为“交互式仪表盘”：

• 原大屏可视化，现更改为“自由布局”；
• 原自助仪表盘，现更改为“自适应布局”。

V10.5仪表盘默认编辑方式修改为新窗口编辑：

• 保留Tab页编辑：右键资源更多菜单，点击“编辑”依旧为Tab页编辑。
• 增加新窗口编辑：右键资源更多菜单，点击“新窗口编辑”为新窗口编辑。

V10.5.12版本中，对标线功能进行完善，增强了标线功能的易用性，完整性。

3、可通过图层区的组件图标区分新旧组件，下图以“交叉表”组件为例：

• V10.5 将“联机帮助”更名为“帮助文档”。
• 新增“帮助”入口，并将“帮助文档”放置在“帮助”入口下，同时新增“问题反馈”与“我的反馈”功能。

• 注意：若曾对【联机帮助】进行过定制处理，依旧存在该入口。

V10.5 ETL界面布局方式修改为横版：

• 左侧数据处理节点按常用功能归类，能更方便快捷找到所需功能
• 界面布局改成横版，留出画布下方空间放节点配置面板和查看数据面板
• 配置面板上增加“执行此节点”按钮，配置完成之后可直接执行查看效果
• 优化了节点UI，增加背景颜色和放大了图标，更容易区分不同节点

V9.7数据预处理存在过滤和行处理节点；

V9.7数据预处理存在空值处理、值替换、数据清理节点；

V10.5 不再支持infobright作为高速缓存库。

对于从旧版本升级到V10.5的用户，使用管理员账号初次访问升级后的 V10.5 环境，会进行系统检查，当检测到当前的高速缓存库为infobright时：

① 为了确保功能的正常使用，请参考文档 切换高速缓存库，重新抽取。

② 如需正常访问原本基于 Infobright 建立的资源，请根据 Smartbi 部署方式进行选择

• 使用 Windows安装包 进行覆盖升级的，请参考文档 Infobright 数据迁移到 SmartbiMppMD 进行数据迁移。
• 其它部署方式，请参考文档 Infobright数据迁移到SmartbiMPP 进行数据迁移。

① 针对 V10.5版本的新用户（或空库部署V10.5）：

• 提供系统的高级设置项控制自助仪表盘是否来源于业务主题。在系统选项>高级设置 中添加"DISABLE_BUSINESS_THEME_IN_DASHBOARD=false"，表示允许在仪表盘中使用业务主题。

② 针对 V9.7 升级到V10.5的用户：

• 默认可以用业务主题作为自助仪表盘数据来源，不用额外添加上述设置项；

（1）数据来源：数据集、数据源层的表、透视分析、即席查询。

（2）参数：直接使用数据集设置的参数。

（1）数据来源：默认为模型查询、SQL查询。

（2）参数：无法直接使用数据集设置的参数。需要在“参数管理”中设置参数的映射关系才能使用。详情请参考 电子表格⬝ 参数管理 。

V10.5 版本中，电子表格、Excel融合分析的数据来源仅支持模型查询、SQL查询，默认不再支持数据源层的表、旧数据集、透视分析、即席查询作为其数据来源。

“目标表”的“插入或更新”节点，当数据源为Clickhouse数据库时，只能使用order by字段作为更新依据字段

V10.5 版本中，当“目标表”的“插入或更新”节点数据源为 Clickhouse 数据库时，用户可以自由指定任意字段作为更新依据字段。

针对从 V9.7 升级到 V10.5 的用户：

• 对于只有order by字段，没有主键字段的表，升级到V10.5 后会报错，需要用户访问编辑界面手动重新指定哪些字段作为更新依据字段；
• 对于order by字段跟主键字段不一致的表，版本升级后的逻辑变化会导致数据异常，需要用户通过数据库客户端工具把主键字段改成跟order by字段一致。

（1）虽然这次ECharts版本升级能在性能上得到提升、它的新版也修复一些问题；但同时会带来图形样式等改变，有些用户会关心如何恢复旧图形效果，变更详细说明与恢复操作请查阅ECharts升级注意事项（SmartbiV8、9.5升级V10.5）

（2）相比4.X版本，ECharts V5.1.2对部分图形的图形配置项做了调整，因此，旧版本的图形宏代码如果调整过图形配置项可能会存在不兼容的情况，届时需要联系官方支持或者参考ECharts官方图形配置项进行修改，对此进一步评估是否兼容或改造。

V10.5 对自助仪表盘的整体风格进行了调整，调整如下：

• 统一图形入口，将所有组件进行统一整理收纳到“组件”内；
• 将图形的子图类型单独作为一种图形类型。

V9.7 筛选器提供"应用于组件 > 高级设置"选项，以此创建筛选器与图表组件之间的关联关系。

自助仪表盘布局方式：高度自适应、宽度自适应、自由布局。

自助仪表盘布局方式：高度自适应、宽度自适应。

大屏可视化布局方式：自由布局。

V10.5 版本中，自助仪表盘的布局方式“自由布局”独立出来作为“大屏可视化”，专门用于大屏报表的制作。

通过大屏可视化制作的报表资源类型依旧是自助仪表盘。

针对从V9.7升级到V10.5的用户：

如果旧资源选择了浅色的仪表盘主题，筛选器组件背景为透明，并设置深色的仪表盘背景色/背景图时，升级后，下拉面板背景色自动变成深色。

如果旧资源选择了深色的仪表盘主题，筛选器组件背景为透明，并设置浅色的仪表盘背景色/背景图时，升级后，下拉面板背景色自动变成浅色。

针对从V9.7升级到V10.5的用户：

如果旧资源在仪表盘主题中设置了筛选器颜色，升级后，此颜色效果将只会影响到筛选器边框。

（1）按钮“查看SQL”：查看原始SQL语句

（2）按钮“查看执行SQL”：查看后台最终执行的SQL语句

（1）按钮“查看SQL”：查看后台最终执行的SQL语句

（2）删除按钮“查看执行SQL”。

若用户需要开放 即席查询、仪表分析、多维分析、电子表格、地图分析、灵活分析 对分析报告的支持，需要申请更换包含相应资源授权的license。

V9.7 在资源导入时候，如果包含了导入环境License没授权的功能，虽可正常导入相关资源，但无法查找到无授权的资源。

（1）V10.5 在导入资源时，如果包含license没有授权的功能，系统会自动过滤不允许导入无授权的相关资源。

（2） V10.5 在导出资源时，如果包含license没有授权的功能（如旧版本的数据集），系统不支持导出相关旧数据集资源。

若用户在PC端对资源外链分享添加了访问限制，移动端上分享的链接同样也会受PC上的分享限制影响。

V10.5 支持所有报表层添加水印，涉及数据预览的地方就有水印。 已去除系统选项中电子表格的水印设置项、电子表格插件端的水印设置项。

• 一旦“水印设置“开启，系统默认使用新水印。
• 若想启用电子表格旧水印，在系统选项的高级设置中写入USE_SPREADSHEET_REPORT_LEVEL_WATERMARK=true语句，清空缓存；设置了报表级别水印的电子表格，走旧版水印逻辑，没有设置的电子表格走新水印逻辑。

升级到V10.5版本后，需要向Smartbi官方支持申请授权包含相应功能模块的License

在V9.7版本中：

●  公共参数、条件参数、筛选器的备选值列表中，会默认把过滤掉null和空串

●  报表的表格和图形上不区分null和空串

V10.5版本中：

●  公共参数、条件参数、筛选器的备选值列表中，如果字段有null和空串时，在备选值列表中显示null和空串

●  报表的表格和图形上区分null和空串

重要：此变更可能会导致原有报表的参数过滤结果不一致，请详细阅读。

1、在V9.7版本上参数默认值是null或空串时，在部分场景下会查询全部数据；但升级到V10.5版本后，将根据null或空串去过滤数据。

2、当参数或筛选器备选值中含null或空串时，在V10.5版本上参数和筛选器的备选值中会默认置顶null和空串，备选值的顺序会和V9.7版本不一致。

在V9.7版本中：

●  weblogic部署smartbi。需要删除xmlbeans-3.0.0.jar，wstx-asl-3.2.4.jar，cglib-nodep-2.1_3.jar，xml-apis-1.4.01.jar这4个jar包

在V10.5版本中：

●  weblogic部署smartbi。需要删除xmlbeans-3.0.0.jar，wstx-asl-3.2.4.jar，cglib-nodep-2.1_3.jar，xml-apis-1.4.01.jar这4个jar包

●  weblogic部署smartbi，需要增加jaxb.properties

V10.5 不再支持infobright作为高速缓存库。

针对从旧版本升级到V10.5的用户，使用管理员账号初次访问升级后的 V10.5 环境，会进行系统检查，当检测到当前的高速缓存库为infobright时：

① 为了确保功能的正常使用，请参考文档 切换高速缓存库，重新抽取。

② 如需正常访问原本基于 Infobright 建立的资源，请根据 Smartbi 部署方式进行选择

• 使用 Windows安装包 进行覆盖升级的，请参考文档 Infobright 数据迁移到 SmartbiMppMD 进行数据迁移。
• 其它部署方式，请参考文档 Infobright数据迁移到SmartbiMPP 进行数据迁移。

V10.5中，高速缓存库尽量承载缓存的作用，不承载业务库的作用，因此对于V10.5 新用户（空库部署），默认不允许通过【加载文件数据】功能将文件导入高速缓存库内

针对旧版本升级上来用户，默认允许文件导入高速缓存库，无需配置。

（1）数据源下面不支持显示业务视图>新建可视化数据集/SQL数据集

（2）文本数据源导入数据后，不支持显示新建自助数据集按钮

（3）数据连接默认不支持创建JAVA数据源，若希望在V10.5版本中继续使用，需更新授权包含Java数据集的license文件。

针对 V10.5版本的新用户（空库部署V10.5），提供系统的高级设置项控制自助仪表盘是否来源于业务主题。

V10.5 版本中，即席查询、透视分析作为报表时不支持数据快查。因此在分析展现中，即席查询、透视分析资源的右键菜单中屏蔽了“数据快查”功能。

V10.5 自助仪表盘中移除了默认的层次联动关系，具体如下：

（1）在 V9.5 自助仪表盘中，当使用存在层次关系的字段作为筛选器时，筛选器之间会自动建立层次联动关系，即父级筛选器默认影响子级筛选器。
（2）在 V10.5 中自助仪表盘中，当使用存在层次关系的字段作为筛选器时，筛选器之间不存在层次联动关系，即父级筛选器默认不影响子级筛选器。若是父级筛选器需影响子级筛选器，需前往“应用于组件”列表中手动勾选。

在系统选项的高级设置中，保留 ENABLE_LANGUAGE_SETTINGS 多语言配置项，去除以下两个重复的配置项：

•  ENABLE_RESTREE_MULTI_LANGUGE 
•  SUPPORTED_LANGUAGES 

在导出功能中去除了导出HTML类型，主要包括以下功能模块：

• 报表的导出按钮：透视分析、即席查询、电子表格、Word分析报告、PPT分析报告、页面、灵活分析、多维分析、多维探索；
• 报表右上角的更多中：透视分析、即席查询、电子表格、Word分析报告、PPT分析报告、页面、灵活分析、多维分析、多维探索、仪表分析、地图分析；
• 数据集预览界面的导出按钮：原生SQL数据集、SQL数据集、可视化数据集、Java数据集、存储过程数据集；
• 计划任务：任务的报表导出。