1.1 版本

1.2 应用场景

使用 FineDataLink 时，一般先在测试环境系统上进行开发部署，确认无误后再迁移到正式系统中。

用户希望能够批量迁移在测试环境制作的的定时任务或快速复用官方定时任务。

1.3 功能简介

FineDataLink 提供资源迁移功能，支持将数据连接、服务器数据集、定时任务资源从测试系统增量迁移到正式系统。

管理员登录 FineDataLink ，点击「管理系统>智能运维>资源迁移」，分为「资源导出」、「资源导入」两部分，如下图所示：

• 资源导出：将需要迁移到其他系统的资源从服务器中导出，以供后续迁移。
  

• 资源导入：将需要迁移的资源在新系统中导入，即迁移至新系统。

1）资源迁移功能仅支持超级管理员，次级管理员。

2）次管在进行「资源导出」时不支持「同时导出权限配置」。

3）正式工程需购买「智能运维」功能点才可使用「资源迁移」功能。

4）请确保在资源迁移过程中，没有其他人使用超级管理员账号，否则部分执行请求可能被取消。

5）不建议在个人 PC 端工程开发定时任务后，再以资源迁移的形式同步到公司工程。

因为个人 PC 端没有管理员维护，经常会因为 JAR 包不同步或资源以及配置不同步的问题导致资源迁移失败，运维成本会很高。

6）4.1.5.3 之前版本不支持导出 调度计划；4.1.5.3 及之后版本支持导出 调度计划

7）4.1.5.3 之前版本，导入/导出定时任务仅支持在独立部署工程、FR 与 FDL集成工程使用，BI 与 FDL 集成工程暂不支持；4.1.5.3 及之后版本支持 BI 与 FDL 集成的工程导入/导出定时任务和调度计划。

3.1 权限限制

非超级管理员用户想要使用资源迁移，需要为其分配「资源迁移」的使用权限，如下图所示：

注：必须开启资源迁移父节点「智能运维」节点权限。

将「数据平台」中数据开发的使用权限分配给用户，如下图所示：

同时需要将定时任务的管理权限分配给用户，该用户才能有指定定时任务的资源迁移权限，如下图所示：

3.2 确认版本

资源迁移之前，请确保资源导入和导出的 FineDataLink 工程使用的版本一致（包括 JAR 包时间）。

管理员可在「管理系统>注册管理>版本信息」下查看 JAR 包时间，如下图所示：

若版本不一致，可通过升级来确保版本一致。

注：在资源导入时，若上传资源对应的工程和当前工程版本不一致，则无法上传。

       提示：无法导入，即将导入的资源需要的工程版本：XXX。当前工程版本：XXX。请确保工程版本一致！

3.3 系统备份

资源导入前建议对测试系统和正式系统均进行 系统备份，如下图所示：

注：备份迁移到的 MySQL 数据库需要选择 utf8_bin 的排序规则。

3.4 确认数据库大小写

若系统配置了 外接数据库 ，在资源迁移前，请确保正式系统和测试系统的「数据库默认字符校验规则」都为「大小写敏感」。

以 Mysql 为例：

3.4.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;  #设置表的校验规则

3.4.2 查看设置结果

如下图所示：

3.5 确认插件和驱动

1）若数据连接需依赖第三方插件，目前只支持 JSON 数据集和 Mysql8 数据连接，其他插件类型不适配，会导入失败。

2）数据连接迁移只迁移配置。驱动 jar 包、kerberos 认证文件、JNDI 配置文件等都不会迁移，需要手动配置/放置。

• 请在进行数据连接迁移前，确认正式工程下是否提前安装依赖的相关数据连接插件，否则将导致导入失败。

• 请在进行数据连接迁移前，确认正式工程下是否提前安装依赖的相关数据连接驱动，否则将导致导入的数据连接不可使用。

3.6 确认数据连接

• 若需要进行数据连接迁移，需要在资源迁移导入前，保证正式系统已创建好了数据连接，且该数据连接名需与测试系统一致，否则资源无法迁移成功。

• 服务器数据集若依赖相关数据连接，请确认将相关数据连接导入正式工程，否则导入的服务器数据集无法使用。
  

4.1 选择资源

管理员登录 FineDataLink 后，进入「管理系统>智能运维>资源迁移」，选择「资源导出」。

选择需要导出的资源类型，选择每种类型下需要导出的具体内容，支持多选。如下图所示：

注：导出定时任务时，可选择将该任务使用到的数据连接一起导出，则在正式系统导入资源包后，可直接复用定时任务。

可导出的资源如下：

4.2 选择同时导出的资源

1）FDL与FR集成工程、FDL 独立部署工程中，在导出时若勾选「同时导出权限配置」，即可同时导出资源的权限配置，权限配置类型包括：使用、管理权限。如下图所示：

同时导出权限配置说明如下：

2）FDL 与 BI 集成工程中，可同时导出Finereport链接跳转模板、原始Excel附件、定时更新任务等，详情请参见： 选择同时导出的资源

3）4.1.5.3 及之后版本，支持导入导出 调度计划 。如下图所示：

• 事件调度依赖的任务在新工程中根据任务 id 匹配，若没有跟随导入，允许资源导入，导入后提示用户缺少依赖任务。

• 导入后提示列表为「定时任务」和「调度计划」两个独立检测项。如下图所示：

• 定时任务的检测项不包括调度计划中任务的缺失。

• 若定时任务中使用了「调用任务」节点，支持只导入父任务。

• 若事件调度和定时调度计划名冲突，或者单个任务调度和批量调度计划名冲突，则调度计划名后递增加1。

• 定时任务设置了批量事件调度或批量定时调度，若即将导入的调度计划名和已有工程的调度计划名冲突：
  

4.3 导出的文件

导出后会生成 resources.zip 文件。

5.1 上传文件

超级管理员登录 FineDataLink ，选择「管理系统>智能运维>资源迁移>资源导入」，如下图所示：

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

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

5.2 导入文件

勾选需要上传的资源，点击「导入」。如下图所示：

若导入失败，显示失败的原因（如：导入不支持的插件类型数据连接或者导入工程没有安装插件）；若导入成功，则资源即时生效。如下图所示：

注：若导入的资源中包含多个定时任务，导入完成后，显示 0 项导入成功， 0 项导入失败，可尝试分批导入。

点击「数据开发」，可看到导入成功的定时任务，如下图所示：