1. 概述
1.1 版本
| FineBI 版本 | JAR 包 | 新增功能 |
|---|---|---|
| 5.1 | 2019-01-15 | - |
| 5.1 | 2020-01-15 | 支持将 Excel 数据集的原始 Excel 附件一起导出 |
| 5.1.11 | - | 新增「同时导出超链跳转模板」按钮，支持将目录子模板一起导出 |
| 5.1.15 | - | 资源导入时，自动检测导入资源与当前工程版本是否一致 |
1.2 应用场景
在使用数据决策系统时，往往会先使用测试环境系统进行部署开发，确定完全没问题后再迁移至正式系统。
因此就需要从测试环境往正式环境增量迁移仪表板、业务包等。
使用 FineBI 数据决策系统时，一般先在测试环境系统上进行开发部署，确认无误后再迁移到正式系统中。
FineBI 支持将模板文件和平台配置从测试系统增量迁移到正式系统。
1.3 功能简介
超管登录数据决策系统，点击「管理系统>智能运维>资源迁移」，分为「资源导出」、「资源导入」两部分。
本文仅介绍迁移资源类型为「目录」时的操作方法。
1.4 注意事项
1）资源迁移功能仅超级管理员支持，即使给次级管理员分配了智能运维的权限，也不能进行资源迁移。
2）正式工程需购买「智能运维」功能点才可使用「资源迁移」功能。
3）请确保在资源迁移过程中，没有其他人使用超级管理员账号，否则部分执行请求可能被取消。
4）不建议在个人 PC 端工程开发模板后，再以资源迁移的形式同步到公司工程。
因为个人 PC 端没有管理员维护，经常会因为 JAR 包不同步或资源以及配置不同步的问题导致资源迁移失败，运维成本会很高。
2. 准备工作
2.1 确认版本
资源迁移之前，请确保资源导入和导出的 FineBI 工程使用的版本一致（包括 JAR 包时间）。
管理员可在「管理系统>注册管理>版本信息」下查看 JAR 包时间，如下图所示：
若版本不一致，可通过升级来确保版本一致，详情参见：升级指南索引。
注：5.1.15 及之后版本的 BI 工程，在资源导入时，若上传资源对应的工程和当前工程版本不一致，则无法上传。
提示：无法导入，即将导入的资源需要的工程版本：XXX。当前工程版本：XXX。请确保工程版本一致！
2.2 系统备份
资源导入前建议对测试系统和正式系统均进行 系统备份，如下图所示：
注：备份迁移到的 MySQL 数据库需要选择 utf8_bin 的排序规则。
2.3 确认数据库大小写
若系统配置了 配置外接数据库 ，在资源迁移前，请确保正式系统和测试系统的「数据库默认字符校验规则」都为「大小写敏感」。
以 Mysql 为例：
2.3.1 进行设置
设置方式：若配置了外接数据库，连接 FineDB 数据库，打开 FINE_CONF_ENTITY 表，设置字符校验规则为 utf8_bin，输入命令如下：
ALTER TABLE fine_conf_entity MODIFY id VARCHAR(255) CHARACTER SET utf8 COLLATE utf8_bin; #设置列的默认校验规则
ALTER TABLE fine_conf_entity DEFAULT CHARACTER SET utf8 COLLATE utf8_bin; #设置表的校验规则
2.3.2 查看设置结果
如下图所示：
2.4 确认数据连接
若需要进行数据连接迁移，需要在资源迁移导入前，保证正式系统已创建好了数据连接，且该数据连接名需与测试系统一致，否则资源无法迁移成功。
若迁移的是服务器数据集创建的仪表板，则在迁移前需要保证正式系统上创建好相同名称的服务器数据集。
2.5 确认用户类型
在资源迁移过程中，需要仪表板的创建者的用户类型保持一致。
比如测试系统中仪表板创建者为 BI 数据分析用户，那么在正式系统中也需要将其添加到 BI 数据分析用户中。
2.6 迁移自定义地图
若模板中调用了自定义地图，需要将地图 json 文件拷贝到正式工程下。
在%FineBI%/webroot/WEB-INF/assets/map/image路径下，将需要迁移的 json 文件拷贝到正式工程对应路径下，如下图所示：
3. 测试系统下资源导出
3.1 选择目录
管理员登录系统后，进入「管理系统>智能运维>资源迁移」，选择「资源导出」，选择需要导出的目录/仪表板，如下图所示：
可导出的资源有：
仪表板使用到的基础表和自助数据集
仪表板的配置、原始名、转义名、所属用户、挂载目录、是否公共链接、分享情况等
注：并非系统下的所有仪表板/数据都会被导出。如不挂出仪表板，则不存在于导出的资源中。请务必先 挂出仪表板 再进行操作。
3.2 选择依赖资源
选择目录后，需要选择依赖资源。如下图所示：
比如将某仪表板从测试系统迁移到正式系统中，用户 Alice有查看该仪表板及业务包的使用权限，用户 demo 没有，因此需要先将其资源进行导出。
此时会获取该仪表板所使用的数据表（包含基础表和自助数据集）资源信息。如下图所示：
可选择对应的数据表资源同时导出。若正式系统已存在仪表板需要的数据表资源，在此处可不选择导出。
仪表板依赖资源支持导出范围有：
直接使用的分析表，基础表
使用的分析表、基础表和在关联路径上经过的相关表。组件间的联动和控件对组件的过滤，导出最短路径中的相关表
若依赖的资源来自我的自助数据集，在导出时也可以进行选择。后续导入时，也将导入到对应用户的我的自助数据集下
3.3 同时导出
用户可自行选择是否导出以下内容：
| 导出设置 | 说明 |
|---|---|
| 同时导出原始excel附件 | 若仪表板使用到 Excel 数据集制作，可勾选同时导出原始excel附件，直接将原始Excel 附件与仪表板资源一起导出，这样在后续的导入中不需要再重新上传 Excel 数据集，直接随仪表板导入 注：若导出的数据表原始名（即上图资源中数据表括号内的名称）与正式系统中一样，将覆盖掉正式系统中的数据表，因此此处需确认好再进行导出导入操作。 |
| 同时导出超链跳转模板 | 如不勾选，仅导出挂载在目录中的模板，模板中跳转的子模板不会同时导出，在「正式系统」中点击对应超链会报错。 如勾选该选项，导出挂载在目录中的模板时，模板中跳转的子模板会同时导出，子模板中若存在下级子模板，也同时导出，以此类推。 |
| 导出权限配置 | 导出权限配置会导出该仪表板对应的权限配置，包含 目录权限 及对应的 业务包权限 。在后续导入后，该仪表板对应的权限设置则不会发生变化 注：若不勾选「导出权限配置」，导入时可能会报错。比如缺少创建公共链接权限的时候，会报错「has no auth create public link」。 |
导出后会生成 resources.zip 文件，如下图所示：
4. 正式系统下资源导入
4.1 上传文件
超级管理员登录数据决策系统，选择「管理系统>智能运维>资源迁移>资源导入」，如下图所示：
注1：资源导入前建议进行 系统备份，其中备份迁移到的 MySQL 数据库需要选择 utf8_bin 的排序规则。
注2：单次只允许上传单个压缩文件。
系统会获取导入文件所包含的资源，包含类型、平台路径、物理资源、权限信息及导入方式。
| 设置 | 说明 |
|---|---|
| 类型 | 类型包括首页、目录、BI模板、BI数据表、BI模板子模板、报表模板、报表模板子模板、上报标签、链接 |
| 平台路径 | 平台路径为「导出系统」的目录路径，自动创建完整路径 |
| 物理资源 | 物理资源即为该模板/表在系统中实际存放的位置 |
| 权限信息 | 点击「详情」可查看权限信息 其中会提示是否有部门/角色/用户在被导入系统中的缺失情况 |
| 导入方式 | 在导入时，系统会对资源进行检测，检测是否与系统现有资源有冲突。 冲突检验以资源的原始名与其在平台中的路径名为准。 分为直接导入和覆盖导入 直接导入：与系统中已有资源没有冲突，默认选中。 覆盖导入：与系统中已有资源有冲突，默认不选中且高亮，点击 注：导入数据表的表名和被导入工程中原有的数据表表名不同，导入后却提示表冲突需要覆盖导入。此时需要判断导入前后数据表创建表时的表名是否相同。 例：资源导出工程 1 中的表创建时名称叫自助数据集 １ ，后来改成了表 A ；资源导入的时候会跟被导入工程中的自助数据集１冲突。 |
| 冲突检测 | 在导入时，系统会对资源进行检测，检测是否与系统现有资源有冲突，冲突检验以资源的原始名为准。 平台路径：路径冲突 物理资源：路径冲突 |
注：导入数据表的表名和被导入工程中原有的数据表表名不同，导入后却提示表冲突需要覆盖导入。此时需要判断导入前后数据表创建表时的表名是否相同。
例：资源导出时，表创建时名称叫「分析表 １」 ，后来改成了「互联网分析渠道统计数据」 。资源导入时，会跟被导入工程中的「分析表 １」冲突。如下图所示：
4.2 导入文件
勾选需要上传的资源，点击「导入」，点击「确定」。如下图所示：
若导入失败，显示失败的原因（如：导出工程和导入工程中存在同名同路径但是类型不同）；若导入成功，则资源即时生效。如下图所示：
注：由于对应的环境配置不同 IP 端口号会改变，资源迁移后的仪表板公共链接需要重新进行链接分享。
4.3 数据更新
若迁入的基础表资源为「抽取数据」，导入到新的系统中需要先进行数据更新，才能正常查看对应的仪表板。
在对应业务包下进行 数据更新 ，或者直接进行 全局更新 。更新后则能看到导入的数据表均正常显示，如下图所示：
注1：2020-01-15 之前的版本，若仪表板使用的是 Excel 数据，需要进入到资源使用的数据业务包中，在对应数据表下选择更新 Excel，并将源数据的 Excel 表重新上传并更新。
注2：若导入数据表为 Excel 数据集或者以 Excel 数据集为基础表制作的自助数据集，则必须进行业务包更新或者全局更新。
若导入的数据表为数据库表或者 SQL 数据集，则可以对导入的表进行单表更新。
如不进行数据更新操作，预览相关仪表板时，会提示「当前组件用到的自助数据集异常，无法正常显示」。如下图所示：
