反馈已提交

网络繁忙

您好,只有最新版本的6.X支持在线编辑修改,如果想创建/编辑文档,请移步到 *最新版本*

资源迁移目录

  • 文档创建者:Carly
  • 历史版本:6
  • 最近更新:Carly 于 2023-09-14
  • 1. 概述

    1.1 版本

    FineBI 版本JAR 包      新增功能
    5.1
    2019-01-15
    -
    5.12020-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 查看设置结果

    如下图所示:

    1579240842669112.png

    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 文件,如下图所示:

    222

    4. 正式系统下资源导入

    4.1 上传文件

    超级管理员登录数据决策系统,选择「管理系统>智能运维>资源迁移>资源导入」,如下图所示:

    注1:资源导入前建议进行 系统备份,其中备份迁移到的 MySQL 数据库需要选择 utf8_bin 的排序规则。

    注2:单次只允许上传单个压缩文件。

    系统会获取导入文件所包含的资源,包含类型、平台路径、物理资源、权限信息及导入方式。

    设置
    说明
    类型

    类型包括首页、目录、BI模板、BI数据表、BI模板子模板、报表模板、报表模板子模板、上报标签、链接

    平台路径平台路径为「导出系统」的目录路径,自动创建完整路径
    物理资源物理资源即为该模板/表在系统中实际存放的位置
    权限信息

    点击「详情」可查看权限信息

    其中会提示是否有部门/角色/用户在被导入系统中的缺失情况

    导入方式

    在导入时,系统会对资源进行检测,检测是否与系统现有资源有冲突。

    冲突检验以资源的原始名与其在平台中的路径名为准。

    分为直接导入和覆盖导入

    直接导入:与系统中已有资源没有冲突,默认选中。

    覆盖导入:与系统中已有资源有冲突,默认不选中且高亮,点击按钮可以查看到详细说明

    注:导入数据表的表名和被导入工程中原有的数据表表名不同,导入后却提示表冲突需要覆盖导入。此时需要判断导入前后数据表创建表时的表名是否相同。

    例:资源导出工程 1 中的表创建时名称叫自助数据集 1 ,后来改成了表 A  ;资源导入的时候会跟被导入工程中的自助数据集1冲突。

    冲突检测

    在导入时,系统会对资源进行检测,检测是否与系统现有资源有冲突,冲突检验以资源的原始名为准。

    平台路径:路径冲突

    物理资源:路径冲突

    注:导入数据表的表名和被导入工程中原有的数据表表名不同,导入后却提示表冲突需要覆盖导入。此时需要判断导入前后数据表创建表时的表名是否相同。

    例:资源导出时,表创建时名称叫「分析表 1」 ,后来改成了「互联网分析渠道统计数据」 。资源导入时,会跟被导入工程中的分析表 1冲突。如下图所示:

    4.2 导入文件

    勾选需要上传的资源,点击「导入」,点击「确定」。如下图所示:

    若导入失败,显示失败的原因(如:导出工程和导入工程中存在同名同路径但是类型不同);若导入成功,则资源即时生效。如下图所示:

    注:由于对应的环境配置不同 IP 端口号会改变,资源迁移后的仪表板公共链接需要重新进行链接分享。

    4.3 数据更新

    若迁入的基础表资源为「抽取数据」,导入到新的系统中需要先进行数据更新,才能正常查看对应的仪表板。

    在对应业务包下进行 数据更新 ,或者直接进行 全局更新 。更新后则能看到导入的数据表均正常显示,如下图所示:

    注1:2020-01-15 之前的版本,若仪表板使用的是 Excel 数据,需要进入到资源使用的数据业务包中,在对应数据表下选择更新 Excel,并将源数据的 Excel 表重新上传并更新。

    注2:若导入数据表为 Excel 数据集或者以 Excel 数据集为基础表制作的自助数据集,则必须进行业务包更新或者全局更新。

             若导入的数据表为数据库表或者 SQL 数据集,则可以对导入的表进行单表更新。

    如不进行数据更新操作,预览相关仪表板时,会提示「当前组件用到的自助数据集异常,无法正常显示」。如下图所示:

    附件列表


    主题: 管理员指南
    已经是第一篇
    已经是最后一篇
    • 有帮助
    • 没帮助
    • 只是浏览

    售前咨询电话

    400-811-8890转1

    在线技术支持

    请前往「服务平台」,选择「在线支持」

    热线电话:400-811-8890转2

    在线QQ(将在2023.01.03关停):800049425

    总裁办24H投诉

    热线电话:173-1278-1526

    文 档反 馈

    鼠标选中内容,快速反馈问题

    鼠标选中存在疑惑的内容,即可快速反馈问题,我们将会跟进处理。

    不再提示

    10s后关闭