# WorkspaceMigration

**Repository Path**: gisvip/workspace-migration

## Basic Information

- **Project Name**: WorkspaceMigration
- **Description**: SuperMap iDesktopX 11i 扩展插件，主要用于对数据库型工作空间进行整体迁移
- **Primary Language**: Java
- **License**: Apache-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 2
- **Created**: 2023-06-16
- **Last Updated**: 2023-06-16

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# SuperMap iDesktopX 11i 桌面端扩展插件 - WorkspaceMigration（工作空间迁移）

## **1. 概述**

  **`SuperMap iDesktopX 11i`** 扩展插件，主要用于对数据库型工作空间进行整体迁移，包括：*工作空间*、*数据源*、*数据集*、*地图*、*场景*、*图表*、*模型*、*视频地图*、*大屏*、*表格* 以及 *资源* 等。

## **2. 环境准备**

|软件|版本|下载地址|说明|
|:----|:----:|:----:|:----|
|**`SuperMap iDesktopX`**|**11i**|[SuperMap iDesktopX 11i 下载地址](http://support.supermap.com.cn/DownloadCenter/ProductPlatform.aspx)|目前该插件仅支持 iDesktopX 11i 版本，不建议在之前的版本使用|
|**Java**|**1.8**|[JDK 1.8 下载地址](https://www.oracle.com/java/technologies/downloads/#java8-windows)|由于 SuperMap iDesktopX 是基于 JDK 1.8 开发的，建议插件编译也使用 JDK 1.8 版本</br>若使用更高版本的 JDK 编译后，运行时可能存在版本冲突|
|**Intellij IDEA**|**\***|[Intellij IDEA 下载地址](https://www.jetbrains.com/zh-cn/idea/download/#section=windows)|该插件是基于 IDEA 开发的，建议使用 IDEA 编译，如果使用 Eclipse 的话需要自行配置编译环境|
|**DM 管理工具**|**V8**|[达梦数据库镜像下载地址](https://www.dameng.com/list_103.html)|DM管理工具无单独下载地址，下载完整的达梦数据库镜像后安装时选择只安装 DM管理工具|

### **达梦客户端环境配置**

  - 达梦 V7 和 V8 的客户端并不通用，目前该工作空间迁移插件暂时仅支持 **DM V8** 版本；
  - 安装达梦客户端后，需要在将其安装路径配置到系统环境变量中（如：*C:\dmdbms\bin*）。

### **Intellij IDEA 环境配置**

- **配置项目依赖库**
  
  - 参考 **`SuperMap iDesktopX 11i`** 帮助文档，在 **Libraries** 中配置 *`SuperMap iDesktopX 11i`* 的 *\bin*、*\bundles\idesktop_bundles*、*\lib* 和 *\bundles\require_bundles* 依赖库；
  
  - 在 **Libraries** 中配置该项目自带的 *\libs* 依赖库；
    
    ![配置Libraries依赖库.png](./imgs/配置Libraries依赖库.png)
  
  - 修改 **Artifacts** 中配置的 *WorkspaceMigration.jar* 包的输出目录，将其改为 **`SuperMap iDesktopX 11i`** 安装目录下的 *\bundles\plugin_bundles* 目录；
    
    ![修改Artifacts的输出目录.png](./imgs/修改Artifacts的输出目录.png)
  
  - 在 **Run/Debug Configurations** 中配置 *Environment variables*，添加 `SuperMap iDesktopX 11i` 安装目录下的 *\bin* 目录，并添加 **DM 管理工具** 安装目录下的 *\bin* 目录。
    
    ![在调试配置中设置环境变量.png](./imgs/在调试配置中设置环境变量.png)

## **3. 编译**

  - 待项目编译环境配置好后，直接使用 **IDEA** 编译调试即可，编译成功后会在 **`SuperMap iDesktopX 11i`** 安装目录的 *\bundles\plugin_bundles* 目录下生成 WorkspaceMigration.jar 包。
    
    ![WorkspaceMigration.jar包输出.png](./imgs/WorkspaceMigration.jar包输出.png)

## **4. 安装**

### **打包 `SuperMap iDesktopX 11i` 扩展插件**
  
  - 从 **`SuperMap iDesktopX 11i`** 安装目录的 *\bundles\plugin_bundles* 目录下找到编译生成的 WorkspaceMigration.jar 包，直接压缩成 *.zip* 格式，如：WorkspaceMigration.zip 压缩包。

### **安装 WorkspaceMigration 插件**
  
  - 启动 **`SuperMap iDesktopX 11i`** 桌面端，进入 *视图 》 自定义 》 插件管理*；
  
  - 在 **插件管理** 对话框中选择 *本地插件 》 导入安装*，选择打好的 WorkspaceMigration.zip 压缩包安装扩展插件；
    
    ![导入扩展插件.png](./imgs/导入扩展插件.png)
  
  - 安装扩展插件成功后会自动重启 **`SuperMap iDesktopX 11i`** 桌面端，在启动界面可以看到 **`SuperMap iDesktopX 11i`** 加载 **工作空间迁移** 插件的信息输出。

    ![iDesktopX11i启动时加载工作空间迁移插件信息输出.png](./imgs/iDesktopX11i启动时加载工作空间迁移插件信息输出.png)

## **5. 使用**

- **`工作空间迁移`** 插件入口： *数据迁移 》 工具 》 工作空间迁移*
    
  ![工作空间迁移插件入口.png](./imgs/工作空间迁移插件入口.png)

- 点击 **工作空间迁移** 功能按钮，弹出 *工作空间迁移* 对话框

  ![工作空间迁移对话框.png](./imgs/工作空间迁移对话框.png)

- 根据 **工作空间迁移** 对话框中的内容填入需要迁移的 *源数据库* 和 *目标数据库* 的信息后，即可将待迁移数据库中的工作空间完整的迁移到目标数据库
  
  ![工作空间迁移过程示例.gif](./imgs/工作空间迁移过程示例.gif)

## **6. 注意**

- 该扩展插件目前仅适用与 **`SuperMap iDesktopX 11i`** 版本，暂不支持更低的版本！

- 对于 **达梦数据库** 支持，该扩展插件目前仅适用与 **V8** 版本，暂不支持其他版本的达梦数据库！

- 当迁移的目标数据库引擎为 **达梦 *（DM）*** 时，需要提前在运行 **`SuperMap iDesktopX 11i`** 的系统环境变量中配置达梦数据库客户端的安装目录 *\bin*！

- 当迁移的目标数据库引擎为 **达梦 *（DM）*** 时，需要输入具有 DBA 权限的管理员账户，该账户需要要有新建用户的权限！

- 批量迁移的时候，不同工作空间下的不同类型数据源不能重名！